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-adsPour plus d’aide, veuillez consulter nos exemples et guides ou consulter la documentation de référence en ligne.
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 )
})| Paramètre | Défaut | Description |
handle_rate_limit | False (booléen) | Set True vérifiera l'en-tête de réponse de limite de débit et dormira si la demande a atteint la limite (429). |
retry_max | 0 (entier) | Nombre de fois que vous souhaitez réessayer lorsque le code de réponse est trouvé dans retry_on_status . |
retry_delay | 1500 (int) | Le nombre de millisecondes pendant lesquelles vous souhaitez dormir avant de réessayer. |
retry_on_status | [500, 503] (liste) | Les codes de réponse que vous souhaitez réessayer. Vous ne pouvez définir que >= 400 codes d'état. |
retry_on_timeouts | False (booléen) | Définir True détectera l’erreur de délai d’attente et réessayera la demande. |
timeout | None | Vous pouvez spécifier soit une valeur unique OU un tuple. Si une seule valeur est spécifiée, la valeur du délai d'attente sera appliquée aux délais d'attente connect et read . Voir https://2.python-requests.org/en/master/user/advanced/#timeouts pour plus de détails sur l'utilisation. |
Ce projet est conçu pour fonctionner avec Python 3.5 ou supérieur. Bien que cela puisse fonctionner sur d'autres versions de Python, vous trouverez ci-dessous les versions de plate-forme et d'exécution que nous prenons officiellement en charge et contre lesquelles nous testons régulièrement.
| Plate-forme | Versions |
|---|---|
| CPython | 3.5, 3.6, 3.7 |
| PyPy | 7.x |
Toutes les versions adhèrent à un contrôle de version sémantique strict. Par exemple, major.minor.patch-pre (alias stick.carrot.oops-peek).
Si vous souhaitez contribuer au projet ou essayer localement une version de développement inédite de ce projet, vous pouvez le faire assez facilement en suivant les exemples ci-dessous.
# 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 .Nous aimons les contributions de la communauté ! Si vous envisagez de nous envoyer une pull request, assurez-vous de lire d'abord nos directives de contribution.
Vous avez trouvé un problème ? Veuillez ouvrir un problème GitHub ou, mieux encore, envoyez-nous une pull request. Vous avez une question ? Vous souhaitez discuter d'une nouvelle fonctionnalité ? Venez discuter avec nous sur les forums de la communauté Twitter.
À l'instar des classes Response et Request, le SDK de l'API Ads modélise entièrement tous les objets d'erreur pour faciliter la gestion des erreurs.
La licence MIT (MIT)
Copyright (C) 2015 Twitter, Inc.
L'autorisation est accordée par la présente, gratuitement, à toute personne obtenant une copie de ce logiciel et des fichiers de documentation associés (le « Logiciel »), d'utiliser le Logiciel sans restriction, y compris, sans limitation, les droits d'utilisation, de copie, de modification, de fusion. , publier, distribuer, accorder des sous-licences et/ou vendre des copies du Logiciel, et permettre aux personnes à qui le Logiciel est fourni de le faire, sous réserve des conditions suivantes :
L'avis de droit d'auteur ci-dessus et cet avis d'autorisation doivent être inclus dans toutes les copies ou parties substantielles du logiciel.
LE LOGICIEL EST FOURNI « TEL QUEL », SANS GARANTIE D'AUCUNE SORTE, EXPRESSE OU IMPLICITE, Y COMPRIS MAIS SANS LIMITATION LES GARANTIES DE QUALITÉ MARCHANDE, D'ADAPTATION À UN USAGE PARTICULIER ET DE NON-VIOLATION. EN AUCUN CAS LES AUTEURS OU LES TITULAIRES DES DROITS D'AUTEUR NE SERONT RESPONSABLES DE TOUTE RÉCLAMATION, DOMMAGES OU AUTRE RESPONSABILITÉ, QUE CE SOIT DANS UNE ACTION CONTRACTUELLE, DÉLIT OU AUTRE, DÉCOULANT DE, DE OU EN RELATION AVEC LE LOGICIEL OU L'UTILISATION OU D'AUTRES TRANSACTIONS DANS LE LOGICIEL.
