twitter python ads sdk下载 - twitter python ads sdk源码下载

twitter python ads sdk

Python

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 .

我们热爱社区贡献！如果您打算向我们发送拉取请求，请务必先阅读我们的贡献指南。