twitter python ads sdk

Memulai

Instalasi

 # installing the latest signed release
pip install twitter-ads

Mulai Cepat

 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 )

Pembantu Baris Perintah

 # The twitter-ads command launches an interactive session for testing purposes
# with a client instance automatically loaded from your .twurlrc file.

~ ❯ twitter-ads

Untuk bantuan lebih lanjut silakan lihat Contoh dan Panduan kami atau periksa Dokumentasi Referensi online.

Opsi penanganan dan permintaan batas tarif

 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	Bawaan	Keterangan
handle_rate_limit	False (boolean)	Set True akan memeriksa header respons batas kecepatan dan tidur jika permintaan mencapai batas (429).
retry_max	0 (ke dalam)	Berapa kali Anda ingin mencoba lagi ketika kode respons ditemukan di retry_on_status .
retry_delay	1500 (int)	Jumlah milidetik Anda ingin tidur sebelum mencoba lagi.
retry_on_status	[500, 503] (daftar)	Kode respons yang ingin Anda coba lagi. Anda hanya dapat mengatur >= 400 kode status.
retry_on_timeouts	False (boolean)	Set True akan menangkap kesalahan batas waktu dan mencoba kembali permintaan tersebut.
timeout	None	Anda dapat menentukan nilai tunggal ATAU tupel. Jika nilai tunggal ditentukan, nilai batas waktu akan diterapkan pada batas connect dan batas waktu read . Lihat https://2.python-requests.org/en/master/user/advanced/#timeouts untuk detail penggunaan lebih lanjut.

Kompatibilitas & Versi

Proyek ini dirancang untuk bekerja dengan Python 3.5 atau lebih tinggi. Meskipun ini mungkin berfungsi pada versi Python lainnya, di bawah ini adalah platform dan versi runtime yang secara resmi kami dukung dan uji secara rutin.

Platform	Versi
CPython	3.5, 3.6, 3.7
PyPy	7.x

Semua rilis mematuhi versi semantik yang ketat. Misalnya, mayor.minor.patch-pre (alias stick.carrot.oops-peek).

Perkembangan

Jika Anda ingin berkontribusi pada proyek atau mencoba versi pengembangan proyek yang belum dirilis secara lokal, Anda dapat melakukannya dengan mudah dengan mengikuti contoh di bawah.

 # 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 .

Kami menyukai kontribusi komunitas! Jika Anda berencana mengirimkan permintaan penarikan kepada kami, harap pastikan untuk membaca Pedoman Berkontribusi kami terlebih dahulu.

Umpan Balik dan Laporan Bug

Menemukan masalah? Silakan buka masalah GitHub atau lebih baik lagi kirimkan permintaan penarikan kepada kami. Punya pertanyaan? Ingin mendiskusikan fitur baru? Ayo ngobrol dengan kami di Forum Komunitas Twitter.

Penanganan Kesalahan

Seperti kelas Respons dan Permintaan, Ads API SDK sepenuhnya memodelkan semua objek kesalahan untuk memudahkan penanganan kesalahan.

Lisensi

Lisensi MIT (MIT)

Hak Cipta (C) 2015 Twitter, Inc.

Izin dengan ini diberikan, secara gratis, kepada siapa pun yang memperoleh salinan perangkat lunak ini dan file dokumentasi terkait ("Perangkat Lunak"), untuk menggunakan Perangkat Lunak tanpa batasan, termasuk tanpa batasan hak untuk menggunakan, menyalin, memodifikasi, menggabungkan , mempublikasikan, mendistribusikan, mensublisensikan, dan/atau menjual salinan Perangkat Lunak, dan mengizinkan orang yang menerima Perangkat Lunak untuk melakukan hal tersebut, dengan tunduk pada ketentuan berikut:

Pemberitahuan hak cipta di atas dan pemberitahuan izin ini akan disertakan dalam semua salinan atau sebagian besar Perangkat Lunak.

PERANGKAT LUNAK INI DISEDIAKAN "APA ADANYA", TANPA JAMINAN APA PUN, TERSURAT MAUPUN TERSIRAT, TERMASUK NAMUN TIDAK TERBATAS PADA JAMINAN KELAYAKAN UNTUK DIPERDAGANGKAN, KESESUAIAN UNTUK TUJUAN TERTENTU, DAN TIDAK ADA PELANGGARAN. DALAM KEADAAN APA PUN PENULIS ATAU PEMEGANG HAK CIPTA TIDAK BERTANGGUNG JAWAB ATAS KLAIM, KERUSAKAN ATAU TANGGUNG JAWAB LAINNYA, BAIK DALAM TINDAKAN KONTRAK, HUKUM ATAU LAINNYA, YANG TIMBUL DARI, DARI ATAU SEHUBUNGAN DENGAN PERANGKAT LUNAK ATAU PENGGUNAAN ATAU HAL-HAL LAIN DALAM PERANGKAT LUNAK.