# 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 (int) | จำนวนครั้งที่คุณต้องการลองอีกครั้งเมื่อพบโค้ดตอบกลับใน retry_on_status |
retry_delay | 1500 (int) | จำนวน มิลลิวินาที ที่คุณต้องการพักก่อนที่จะลองอีกครั้ง |
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 เวอร์ชันอื่นได้ แต่ด้านล่างนี้คือเวอร์ชันแพลตฟอร์มและรันไทม์ที่เราสนับสนุนอย่างเป็นทางการและทดสอบเป็นประจำ
แพลตฟอร์ม | รุ่นต่างๆ |
---|---|
ซีไพทอน | 3.5, 3.6, 3.7 |
ปิ๊ปปี้ | 7.x |
การเผยแพร่ทั้งหมดเป็นไปตามเวอร์ชันเชิงความหมายที่เข้มงวด ตัวอย่างเช่น major.minor.patch-pre (aka. stick.carrot.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
เช่นเดียวกับคลาสการตอบสนองและคำขอ Ads API SDK จำลองออบเจ็กต์ข้อผิดพลาดทั้งหมดอย่างครบถ้วนเพื่อการจัดการข้อผิดพลาดที่ง่ายดาย
ใบอนุญาต MIT (MIT)
ลิขสิทธิ์ (C) 2015 ทวิตเตอร์ อิงค์
อนุญาตให้บุคคลใดก็ตามที่ได้รับสำเนาของซอฟต์แวร์นี้และไฟล์เอกสารที่เกี่ยวข้อง ("ซอฟต์แวร์") อนุญาตโดยไม่เสียค่าใช้จ่าย เพื่อจัดการกับซอฟต์แวร์โดยไม่มีข้อจำกัด รวมถึงแต่ไม่จำกัดเพียงสิทธิ์ในการใช้ คัดลอก ปรับเปลี่ยน ผสาน เผยแพร่ แจกจ่าย ให้อนุญาตช่วง และ/หรือขายสำเนาของซอฟต์แวร์ และอนุญาตให้บุคคลที่ได้รับซอฟต์แวร์นี้สามารถทำได้ ภายใต้เงื่อนไขต่อไปนี้:
ประกาศเกี่ยวกับลิขสิทธิ์ข้างต้นและประกาศการอนุญาตนี้จะรวมอยู่ในสำเนาทั้งหมดหรือส่วนสำคัญของซอฟต์แวร์
ซอฟต์แวร์นี้มีให้ "ตามที่เป็น" โดยไม่มีการรับประกันใดๆ ทั้งโดยชัดแจ้งหรือโดยนัย ซึ่งรวมถึงแต่ไม่จำกัดเพียงการรับประกันความสามารถในการค้าขาย ความเหมาะสมสำหรับวัตถุประสงค์เฉพาะ และการไม่ละเมิด ไม่ว่าในกรณีใดผู้เขียนหรือผู้ถือลิขสิทธิ์จะต้องรับผิดต่อการเรียกร้องค่าเสียหายหรือความรับผิดอื่นใดไม่ว่าในการกระทำของสัญญาการละเมิดหรืออย่างอื่นที่เกิดขึ้นจากหรือเกี่ยวข้องกับซอฟต์แวร์หรือการใช้งานหรือข้อตกลงอื่น ๆ ใน ซอฟต์แวร์.