twitter python ads sdk 다운로드 - twitter python ads sdk 소스 코드 다운로드

twitter python ads sdk

파이썬

v11.0.0

다운로드

시작하기

설치

 # installing the latest signed release
pip install twitter-ads

빠른 시작

 from twitter_ads . client import Client
from twitter_ads . campaign import Campaign
from twitter_ads . enum import ENTITY_STATUS

CONSUMER_KEY = 'your consumer key'
CONSUMER_SECRET = 'your consumer secret'
ACCESS_TOKEN = 'access token'
ACCESS_TOKEN_SECRET = 'access token secret'
ACCOUNT_ID = 'account id'

# initialize the client
client = Client (
    CONSUMER_KEY , CONSUMER_SECRET , ACCESS_TOKEN , ACCESS_TOKEN_SECRET )

# load the advertiser account instance
account = client . accounts ( ACCOUNT_ID )

# load and update a specific campaign
campaign = account . campaigns (). next ()
campaign . name = 'updated campaign name'
campaign . entity_status = ENTITY_STATUS . PAUSED
campaign . save ()

# iterate through campaigns
for campaign in account . campaigns ():
    print ( campaign . id )

명령줄 도우미

 # The twitter-ads command launches an interactive session for testing purposes
# with a client instance automatically loaded from your .twurlrc file.

~ ❯ twitter-ads

더 많은 도움이 필요하면 예제 및 가이드를 참조하거나 온라인 참조 문서를 확인하세요.

속도 제한 처리 및 요청 옵션

 client = Client (
    CONSUMER_KEY ,
    CONSUMER_SECRET ,
    ACCESS_TOKEN ,
    ACCESS_TOKEN_SECRET ,
    options = {
        'handle_rate_limit' : True ,
        'retry_max' : 3 ,
        'retry_delay' : 5000 ,
        'retry_on_status' : [ 404 , 500 , 503 ],
        'retry_on_timeouts' : True ,
        'timeout' : ( 1.0 , 3.0 )
    })

매개변수	기본	설명
`handle_rate_limit`	`False` (부울)	`True` 로 설정하면 속도 제한 응답 헤더를 확인하고 요청이 제한(429)에 도달하면 절전 모드로 전환됩니다.
`retry_max`	`0` (정수)	`retry_on_status` 에 응답 코드가 있을 때 재시도하려는 횟수입니다.
`retry_delay`	`1500` (정수)	재시도하기 전에 절전 모드로 전환할 시간 (밀리초) 입니다.
`retry_on_status`	`[500, 503]` (목록)	재시도하려는 응답 코드입니다. 400개 이상의 상태 코드만 설정할 수 있습니다.
`retry_on_timeouts`	`False` (부울)	`True` 설정하면 시간 초과 오류를 포착하고 요청을 다시 시도합니다.
`timeout`	`None`	단일 값 또는 튜플을 지정할 수 있습니다. 단일 값을 지정하면 시간 초과 값이 `connect` 및 `read` 시간 초과 모두에 적용됩니다. 사용법에 대한 자세한 내용은 https://2.python-requests.org/en/master/user/advanced/#timeouts를 참조하세요.

호환성 및 버전 관리

이 프로젝트는 Python 3.5 이상에서 작동하도록 설계되었습니다. 다른 버전의 Python에서도 작동할 수 있지만 아래는 공식적으로 지원하고 정기적으로 테스트하는 플랫폼 및 런타임 버전입니다.

플랫폼	버전
CPython	3.5, 3.6, 3.7
파이파이	7.x

모든 릴리스는 엄격한 의미 버전 관리를 준수합니다. 예를 들어 major.minor.patch-pre(일명 Stick.carrot.oops-peek)입니다.

개발

프로젝트에 기여하고 싶거나 이 프로젝트의 미공개 개발 버전을 로컬에서 사용해 보고 싶다면 아래 예제를 따르면 아주 쉽게 할 수 있습니다.

 # clone the repository
git clone [email protected]:twitterdev/twitter-python-ads-sdk.git
cd twitter-python-ads-sdk

# install dependencies
pip install -r requirements.txt

# installing a local unsigned release
pip install -e .

우리는 커뮤니티 기여를 좋아합니다! 우리에게 끌어오기 요청을 보낼 계획이라면 먼저 기여 지침을 읽어보세요.

피드백 및 버그 보고서

문제를 발견하셨나요? GitHub 문제를 공개하거나 풀 요청을 보내주시면 더 좋습니다. 질문이 있나요? 새로운 기능에 대해 논의하고 싶으십니까? Twitter 커뮤니티 포럼에서 우리와 대화를 나누세요.

오류 처리

응답 및 요청 클래스와 마찬가지로 Ads API SDK는 쉬운 오류 처리를 위해 모든 오류 개체를 완벽하게 모델링합니다.

특허

MIT 라이센스 (MIT)

본 소프트웨어 및 관련 문서 파일("소프트웨어")의 사본을 취득한 모든 사람에게 사용, 복사, 수정, 병합에 대한 권리를 포함하되 이에 국한되지 않고 제한 없이 소프트웨어를 취급할 수 있는 권한이 무료로 부여됩니다. , 소프트웨어 사본을 게시, 배포, 재라이센스 부여 및/또는 판매하고, 소프트웨어를 제공받은 사람에게 다음 조건에 따라 그렇게 하도록 허용합니다.

소프트웨어는 상품성, 특정 목적에의 적합성 및 비침해에 대한 보증을 포함하되 이에 국한되지 않고 명시적이든 묵시적이든 어떠한 종류의 보증 없이 "있는 그대로" 제공됩니다. 어떠한 경우에도 작성자나 저작권 보유자는 계약, 불법 행위 또는 기타 행위로 인해 소프트웨어나 사용 또는 기타 거래와 관련하여 발생하는 모든 청구, 손해 또는 기타 책임에 대해 책임을 지지 않습니다. 소프트웨어.

확장하다

추가 정보