الصفحة الرئيسية>المتعلقة بالبرمجة>بايثون
تنزيل

ابدء

تثبيت 

 # 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 (منطقي) سيتحقق Set True من رأس استجابة حد المعدل وينام إذا وصل الطلب إلى الحد الأقصى (429).
retry_max 0 (كثافة العمليات) عدد المرات التي تريد فيها إعادة المحاولة عند العثور على رمز الاستجابة في retry_on_status .
retry_delay 1500 (عالمي) عدد المللي ثانية التي تريد النوم فيها قبل إعادة المحاولة.
retry_on_status [500, 503] (قائمة) رموز الاستجابة التي تريد إعادة المحاولة عليها. يمكنك فقط تعيين >= 400 رمز حالة.
retry_on_timeouts False (منطقي) سيكتشف Set 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
PyPy 7.x

تلتزم جميع الإصدارات بالإصدارات الدلالية الصارمة. على سبيل المثال، Major.minor.patch-pre (ويعرف أيضًا باسم.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 أو الأفضل من ذلك إرسال طلب سحب إلينا. هل لديك سؤال؟ هل تريد مناقشة ميزة جديدة؟ تفضل بالدردشة معنا في منتديات مجتمع تويتر.

معالجة الأخطاء

كما هو الحال مع فئتي الاستجابة والطلب، تعمل Ads API SDK على تصميم نماذج كاملة لجميع كائنات الأخطاء لتسهيل التعامل مع الأخطاء.

رخصة

رخصة معهد ماساتشوستس للتكنولوجيا (MIT)

حقوق الطبع والنشر (C) لعام 2015 محفوظة لشركة Twitter, Inc.

يُمنح الإذن مجانًا لأي شخص يحصل على نسخة من هذا البرنامج وملفات الوثائق المرتبطة به ("البرنامج")، للتعامل في البرنامج دون قيود، بما في ذلك، على سبيل المثال لا الحصر، حقوق الاستخدام والنسخ والتعديل والدمج. ونشر و/أو توزيع وترخيص من الباطن و/أو بيع نسخ من البرنامج، والسماح للأشخاص الذين تم توفير البرنامج لهم بالقيام بذلك، وفقًا للشروط التالية:

يجب تضمين إشعار حقوق الطبع والنشر أعلاه وإشعار الإذن هذا في جميع النسخ أو الأجزاء الكبيرة من البرنامج.

يتم توفير البرنامج "كما هو"، دون أي ضمان من أي نوع، صريحًا أو ضمنيًا، بما في ذلك، على سبيل المثال لا الحصر، ضمانات القابلية للتسويق والملاءمة لغرض معين وعدم الانتهاك. لا يتحمل المؤلفون أو أصحاب حقوق الطبع والنشر بأي حال من الأحوال المسؤولية عن أي مطالبة أو أضرار أو مسؤولية أخرى، سواء في إجراء العقد أو الضرر أو غير ذلك، الناشئة عن أو خارج أو فيما يتعلق بالبرنامج أو الاستخدام أو المعاملات الأخرى في برمجة.

يوسع
معلومات إضافية
تطبيقات ذات صلة
نوصي لك
أخبار ذات صلة الكل