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-adsPara obtener más ayuda, consulte nuestros ejemplos y guías o consulte la documentación de referencia en línea.
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 )
})| Parámetro | Por defecto | Descripción |
handle_rate_limit | False (booleano) | Establecer True verificará el encabezado de respuesta de límite de velocidad y se suspenderá si la solicitud alcanzó el límite (429). |
retry_max | 0 (int) | La cantidad de veces que desea volver a intentarlo cuando se encuentra el código de respuesta en retry_on_status . |
retry_delay | 1500 (int) | La cantidad de milisegundos que desea suspender antes de volver a intentarlo. |
retry_on_status | [500, 503] (lista) | Los códigos de respuesta que desea volver a intentar. Solo puede configurar >= 400 códigos de estado. |
retry_on_timeouts | False (booleano) | Establecer True detectará el error de tiempo de espera y volverá a intentar la solicitud. |
timeout | None | Puede especificar un valor único O una tupla. Si se especifica un valor único, el valor del tiempo de espera se aplicará tanto al tiempo de espera connect como al read . Consulte https://2.python-requests.org/en/master/user/advanced/#timeouts para obtener más detalles sobre el uso. |
Este proyecto está diseñado para funcionar con Python 3.5 o superior. Si bien puede funcionar en otras versiones de Python, a continuación se muestran las versiones de plataforma y tiempo de ejecución que admitimos oficialmente y que probamos periódicamente.
| Plataforma | Versiones |
|---|---|
| CPython | 3,5, 3,6, 3,7 |
| PyPy | 7.x |
Todas las versiones cumplen con un estricto control de versiones semántico. Por ejemplo, major.minor.patch-pre (también conocido como stick.carrot.oops-peek).
Si desea contribuir al proyecto o probar una versión de desarrollo inédita de este proyecto localmente, puede hacerlo fácilmente siguiendo los ejemplos a continuación.
# 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 .¡Nos encantan las contribuciones de la comunidad! Si planea enviarnos una solicitud de extracción, asegúrese de leer primero nuestras Pautas de contribución.
¿Encontraste un problema? Abra una incidencia de GitHub o, mejor aún, envíenos una solicitud de extracción. ¿Tiene alguna pregunta? ¿Quieres hablar sobre una nueva característica? Ven a chatear con nosotros en los foros de la comunidad de Twitter.
Al igual que las clases Respuesta y Solicitud, el SDK de la API de anuncios modela completamente todos los objetos de error para facilitar el manejo de errores.
La licencia MIT (MIT)
Copyright (C) 2015 Twitter, Inc.
Por el presente se otorga permiso, sin cargo, a cualquier persona que obtenga una copia de este software y los archivos de documentación asociados (el "Software"), para operar con el Software sin restricciones, incluidos, entre otros, los derechos de uso, copia, modificación, fusión. , publicar, distribuir, sublicenciar y/o vender copias del Software, y permitir que las personas a quienes se les proporciona el Software lo hagan, sujeto a las siguientes condiciones:
El aviso de derechos de autor anterior y este aviso de permiso se incluirán en todas las copias o partes sustanciales del Software.
EL SOFTWARE SE PROPORCIONA "TAL CUAL", SIN GARANTÍA DE NINGÚN TIPO, EXPRESA O IMPLÍCITA, INCLUYENDO, PERO NO LIMITADO A, LAS GARANTÍAS DE COMERCIABILIDAD, IDONEIDAD PARA UN PROPÓSITO PARTICULAR Y NO INFRACCIÓN. EN NINGÚN CASO LOS AUTORES O TITULARES DE DERECHOS DE AUTOR SERÁN RESPONSABLES DE NINGÚN RECLAMO, DAÑO U OTRA RESPONSABILIDAD, YA SEA EN UNA ACCIÓN CONTRACTUAL, AGRAVIO O DE OTRA MANERA, QUE SURJA DE, FUERA DE O EN RELACIÓN CON EL SOFTWARE O EL USO U OTRAS NEGOCIOS EN EL SOFTWARE.
