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.キャロット.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 ライセンス (MIT)

本ソフトウェアおよび関連ドキュメントファイル (以下「ソフトウェア」) のコピーを入手した人には、使用、コピー、変更、マージする権利を含むがこれらに限定されない、制限なくソフトウェアを取り扱う許可が、ここに無償で与えられます。、以下の条件を条件として、本ソフトウェアのコピーを出版、配布、サブライセンス、および/または販売すること、および本ソフトウェアが提供される人物にそれを許可すること。

上記の著作権表示およびこの許可通知は、ソフトウェアのすべてのコピーまたは主要部分に含まれるものとします。

ソフトウェアは「現状のまま」提供され、明示的か黙示的かを問わず、商品性、特定目的への適合性、および非侵害の保証を含むがこれらに限定されない、いかなる種類の保証も行われません。いかなる場合においても、作者または著作権所有者は、契約行為、不法行為、またはその他の行為であるかどうかにかかわらず、ソフトウェアまたはソフトウェアの使用またはその他の取引に起因または関連して生じる、いかなる請求、損害、またはその他の責任に対しても責任を負わないものとします。ソフトウェア。

拡大する

追加情報