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 社群論壇中與我們聊天。
與 Response 和 Request 類別一樣，Ads API SDK 會對所有錯誤物件進行完全建模，以便於錯誤處理。
麻省理工學院許可證 (MIT)
版權所有 (C) 2015 Twitter, Inc.
特此免費授予任何獲得本軟體和相關文件文件（「軟體」）副本的人不受限制地使用本軟體，包括但不限於使用、複製、修改、合併的權利、發布、分發、再授權和/或銷售軟體的副本，並允許向其提供軟體的人員這樣做，但須滿足以下條件：
上述版權聲明和本授權聲明應包含在本軟體的所有副本或主要部分中。
本軟體以「現況」提供，不提供任何明示或暗示的保證，包括但不限於適銷性、特定用途的適用性和不侵權的保證。 IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE軟體.
