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-adsWeitere Hilfe finden Sie in unseren Beispielen und Anleitungen oder in der Online-Referenzdokumentation.
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 )
})| Parameter | Standard | Beschreibung |
handle_rate_limit | False (boolesch) | Bei True wird der Antwortheader für die Ratenbegrenzung überprüft und in den Ruhezustand versetzt, wenn die Anforderung den Grenzwert erreicht (429). |
retry_max | 0 (int) | Die Häufigkeit, mit der Sie es erneut versuchen möchten, wenn in retry_on_status ein Antwortcode gefunden wird. |
retry_delay | 1500 (int) | Die Anzahl der Millisekunden, die Sie schlafen möchten, bevor Sie es erneut versuchen. |
retry_on_status | [500, 503] (Liste) | Die Antwortcodes, die Sie erneut versuchen möchten. Sie können nur >= 400 Statuscodes festlegen. |
retry_on_timeouts | False (boolesch) | Bei True wird der Zeitüberschreitungsfehler abgefangen und die Anforderung erneut versucht. |
timeout | None | Sie können entweder einen einzelnen Wert ODER ein Tupel angeben. Wenn ein einzelner Wert angegeben wird, wird der Timeout-Wert sowohl auf die connect als auch auf die read -Timeouts angewendet. Weitere Einzelheiten zur Verwendung finden Sie unter https://2.python-requests.org/en/master/user/advanced/#timeouts. |
Dieses Projekt ist für die Verwendung mit Python 3.5 oder höher konzipiert. Während es möglicherweise auf anderen Python-Versionen funktioniert, finden Sie unten die Plattform- und Laufzeitversionen, die wir offiziell unterstützen und mit denen wir regelmäßig testen.
| Plattform | Versionen |
|---|---|
| CPython | 3,5, 3,6, 3,7 |
| PyPy | 7.x |
Alle Veröffentlichungen unterliegen einer strikten semantischen Versionierung. Zum Beispiel „major.minor.patch-pre“ (auch bekannt als „stick.carrot.oops-peek“).
Wenn Sie zu dem Projekt beitragen oder eine unveröffentlichte Entwicklungsversion dieses Projekts lokal ausprobieren möchten, können Sie dies ganz einfach tun, indem Sie den folgenden Beispielen folgen.
# 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 .Wir lieben Community-Beiträge! Wenn Sie vorhaben, uns eine Pull-Anfrage zu senden, lesen Sie bitte zuerst unsere Beitragsrichtlinien.
Haben Sie ein Problem gefunden? Bitte eröffnen Sie ein GitHub-Issue oder, noch besser, senden Sie uns eine Pull-Anfrage. Haben Sie eine Frage? Möchten Sie eine neue Funktion besprechen? Chatten Sie mit uns in den Twitter-Community-Foren.
Wie die Response- und Request-Klassen modelliert das Ads API SDK alle Fehlerobjekte vollständig, um eine einfache Fehlerbehandlung zu ermöglichen.
Die MIT-Lizenz (MIT)
Copyright (C) 2015 Twitter, Inc.
Hiermit wird jeder Person, die eine Kopie dieser Software und der zugehörigen Dokumentationsdateien (die „Software“) erhält, kostenlos die Erlaubnis erteilt, mit der Software ohne Einschränkung zu handeln, einschließlich und ohne Einschränkung der Rechte zur Nutzung, zum Kopieren, Ändern und Zusammenführen , Kopien der Software zu veröffentlichen, zu verteilen, unterzulizenzieren und/oder zu verkaufen und Personen, denen die Software zur Verfügung gestellt wird, dies zu gestatten, vorbehaltlich der folgenden Bedingungen:
Der obige Urheberrechtshinweis und dieser Genehmigungshinweis müssen in allen Kopien oder wesentlichen Teilen der Software enthalten sein.
DIE SOFTWARE WIRD „WIE BESEHEN“ ZUR VERFÜGUNG GESTELLT, OHNE JEGLICHE AUSDRÜCKLICHE ODER STILLSCHWEIGENDE GEWÄHRLEISTUNG, EINSCHLIESSLICH, ABER NICHT BESCHRÄNKT AUF DIE GEWÄHRLEISTUNG DER MARKTGÄNGIGKEIT, EIGNUNG FÜR EINEN BESTIMMTEN ZWECK UND NICHTVERLETZUNG. IN KEINEM FALL SIND DIE AUTOREN ODER COPYRIGHT-INHABER HAFTBAR FÜR JEGLICHE ANSPRÜCHE, SCHÄDEN ODER ANDERE HAFTUNG, WEDER AUS EINER VERTRAGLICHEN HANDLUNG, AUS HANDLUNG ODER ANDERWEITIG, DIE SICH AUS, AUS ODER IN VERBINDUNG MIT DER SOFTWARE ODER DER NUTZUNG ODER ANDEREN HANDELN IN DER SOFTWARE ERGEBEN SOFTWARE.
