रेट लिमिटिंग

Advertiser API में, REST API v1.1 की तरह ही रेट लिमिट्स लागू होते हैं, जैसा कि यहाँ दस्तावेज़ीकृत है: v1.1 में REST API रेट लिमिटिंग. REST API v1.1 के विपरीत, प्रत्येक endpoint के लिए लिमिट्स की कोई प्रोग्रामेटिक इंडेक्स उपलब्ध नहीं है। endpoint रेट लिमिट्स और reset window की जानकारी HTTP response headers के माध्यम से दी जाती है। Ads API में सभी रेट लिमिटिंग के लिए OAuth 1.0A का उपयोग होता है।

यूज़र स्तर और विज्ञापन खाते के स्तर की सीमाएँ

रेट लिमिट्स के दो प्रकार होते हैं: यूज़र टोकन स्तर और विज्ञापन खाता स्तर। कुछ एंडपॉइंट्स पर विज्ञापन खाता स्तर की रेट लिमिटिंग सक्षम होती है। यूज़र टोकन वह OAuth access token है, जिसका उपयोग आप प्रमाणीकृत होने और Ads API को कॉल करने के लिए करते हैं। प्रत्येक यूज़र टोकन को एक या अधिक विज्ञापन खातों का ऐक्सेस मिल सकता है। डेवलपर्स को response headers में विज्ञापन खाता स्तर की रेट लिमिट मिलने पर उसी का उपयोग करना चाहिए, और यूज़र स्तर की सीमा का उपयोग केवल तब करना चाहिए जब विज्ञापन खाते की सीमा उपलब्ध न हो। यूज़र स्तर की रेट लिमिट्स इन headers के माध्यम से बताई जाती हैं: x-rate-limit-limit, x-rate-limit-remaining और x-rate-limit-reset जिन एंडपॉइंट्स पर विज्ञापन खाता स्तर की रेट लिमिटिंग सक्षम है, उनके लिए रेट लिमिट्स इन headers के माध्यम से बताई जाती हैं: x-account-rate-limit-limit, x-account-rate-limit-remaining और x-account-rate-limit-reset। विज्ञापन खाता स्तर की रेट लिमिट्स केवल GET एंडपॉइंट्स के लिए दी जाती हैं, ताकि ऐप्लिकेशन एक ही यूज़र टोकन से कई विज्ञापन खातों को ऐक्सेस करते हुए एंटिटी डेटा (जैसे campaign या line item objects) को सिंक कर सकें। यह ज़रूरी नहीं है कि write actions भी विज्ञापन खाता स्तर की वही रेट लिमिट्स इस्तेमाल करें। विज्ञापन खाता स्तर पर रेट-लिमिटेड एंडपॉइंट्स के लिए, यूज़र स्तर की रेट लिमिट एक उच्च मान पर सेट की जाती है, जो आपके पूरे ऐप्लिकेशन के लिए एक ग्लोबल कोटा दर्शाती है। जहाँ उपलब्ध हो, आपके अनुरोधों की मात्रा को नियंत्रित करने के लिए विज्ञापन खाता स्तर की रेट लिमिट को प्राथमिकता दी जानी चाहिए।

सर्वोत्तम प्रक्रियाएँ

अपने डेटाबेस में आख़िरी सिंक किए गए टाइमस्टैम्प को सहेजें। फिर, जहाँ लागू हो, डेटा का अनुरोध करते समय sort_by=updated_at-desc विकल्प का उपयोग करें, ताकि अपने आख़िरी सिंक किए गए टाइमस्टैम्प से पुराने डेटा तक पहुँचने पर आप सिंक प्रक्रिया रोक सकें। इससे एक ही डेटा को बार-बार अनावश्यक रूप से सिंक करने से बचा जा सकेगा।
एक ही अनुरोध में कई एंटिटी प्राप्त करें: कुछ एंडपॉइंट आपको कॉमा से अलग की गई मानों की सूची निर्दिष्ट करने देते हैं, जिससे आप एक जैसे कई डेटा आइटम प्राप्त कर सकते हैं। इससे आपके द्वारा की जाने वाली कुल कॉल की संख्या कम हो सकती है और rate limit का अधिक कुशलता से उपयोग किया जा सकता है।
अपने अनुरोधों में अधिकतम “count” का उपयोग करें: कुछ एंडपॉइंट, जैसे GET accounts/:account_id/targeting_criteria, को अधिकतम count मान के साथ कॉल करने की दृढ़ता से अनुशंसा की जाती है, ताकि डिफ़ॉल्ट 200 के बजाय 1000 ऑब्जेक्ट लौटाए जा सकें।

Analytics सिंकिंग

analytics endpoint की रेट लिमिट्स के बारे में अधिक जानकारी के लिए Analytics रेट लिमिटिंग गाइड देखें.

सामान्य प्रश्न

क्या किसी विशेष ऐड अकाउंट या हमारे एप्लिकेशन के लिए रेट लिमिट्स बढ़ाना संभव है? आम तौर पर हम रेट लिमिट्स नहीं बढ़ा सकते, और इन्हें सबसे बड़े ऐड अकाउंट्स का समर्थन करने के लिए निर्धारित किया गया है। पहले चरण के रूप में, कृपया इस दस्तावेज़ में सूचीबद्ध सर्वोत्तम प्रक्रिया लागू करें। यदि इसके बाद भी रेट लिमिट्स आपके स्केल करने या व्यावसायिक उद्देश्यों को हासिल करने की क्षमता को प्रभावित कर रही हैं, तो उपयोग के मामले और संबंधित अनुरोधों की पूरी जानकारी के साथ अपने X Ads API संपर्कों से संपर्क करें।