Search Ads 360 Reporting API, सभी उपयोगकर्ताओं के लिए सिस्टम की बेहतर परफ़ॉर्मेंस पक्का करने के लिए, एपीआई से जुड़ी कार्रवाइयों पर सीमाएं लागू करता है.
कीमत
Search Ads 360 की कुल कीमत में, Search Ads 360 Reporting API का इस्तेमाल शामिल होता है. एपीआई का इस्तेमाल करने के लिए, कोई शुल्क नहीं लिया जाता.
क्वेरी की सीमाएं
नीचे दी गई सीमाएं, Search या SearchStream के तरीकों से की गई क्वेरी की कार्रवाइयों पर लागू होती हैं.
- हर प्रोजेक्ट के लिए, हर उपयोगकर्ता के हिसाब से 3,000 क्वेरी प्रति मिनट
- हर प्रोजेक्ट के लिए हर मिनट 3,000 क्वेरी
- हर प्रोजेक्ट के लिए हर दिन 1,50,000 क्वेरी
हर दिन एपीआई के लिए कार्रवाइयां करने की सीमाएं
एपीआई के हर दिन के इस्तेमाल की सीमाएं, हर Google Cloud प्रोजेक्ट के लिए की गई एपीआई से जुड़ी कार्रवाइयों की संख्या के हिसाब से तय होती हैं.
एक क्वेरी या रिपोर्ट को एक कार्रवाई के तौर पर गिना जाता है, भले ही नतीजे
SearchAds360Service.SearchStream
के ज़रिए स्ट्रीम किए गए हों या
SearchAds360Service.Search कॉल से पेज किए गए हों.
ज़्यादा जानें.
नीचे दी गई टेबल में अकाउंटिंग के कुछ उदाहरण दिए गए हैं:
| एपीआई अनुरोध | कार्रवाइयों को 'रोज़ाना इस्तेमाल की सीमा' में गिना जाएगा |
|---|---|
ऑपरेशन: Search
संख्या: 53 विज्ञापन ग्रुप
सेवा: |
1 |
ऑपरेशन: SearchStream
संख्या: 45 कैंपेन
सेवा: |
1 |
इन सीमाओं का उल्लंघन करने वाले अनुरोध, इस गड़बड़ी के साथ अस्वीकार किए जाते हैं:
RESOURCE_EXHAUSTED.
खोज के अनुरोध
Search या SearchStream अनुरोध को, उपयोगकर्ता के रोज़ के काम करने के कोटे के ख़िलाफ़ एक कार्रवाई के तौर पर गिना जाता है. चाहे बैच की संख्या कुछ भी हो, एक SearchStream अनुरोध को एक एपीआई ऑपरेशन के तौर पर गिना जाता है.
gRPC की सीमाएं
Search Ads 360 Reporting API की सभी क्लाइंट लाइब्रेरी, अनुरोध और रिस्पॉन्स जनरेट करने के लिए gRPC का इस्तेमाल करती हैं. डिफ़ॉल्ट रूप से, gRPC का मैसेज 4 एमबी का होता है.
जवाब इस सीमा से ज़्यादा नहीं होने चाहिए. उदाहरण के लिए, अगर किसी खोज अनुरोध में कई फ़ील्ड शामिल हैं, तो वह चार एमबी से ज़्यादा साइज़ वाला रिस्पॉन्स जनरेट कर सकता है. इस सीमा से बचने के लिए, चुने गए फ़ील्ड की संख्या कम करें, पेज का साइज़ कम करें या स्ट्रीमिंग का इस्तेमाल करें.
इस सीमा का उल्लंघन करने वाले अनुरोध, SearchAds360Error जनरेट नहीं करेंगे, बल्कि 429 Resource Exhausted जीआरपीसी गड़बड़ी जनरेट करेंगे. gRPC गड़बड़ी कोड और मैसेज की सूची देखें.
पेज पर नंबर डाले गए अनुरोध
पेज पर नंबर वाले अनुरोध (उदाहरण के लिए, मान्य next_page_token वाले अनुरोध) को उपयोगकर्ता के हर दिन के ऑपरेशन कोटा में नहीं गिना जाता.
हालांकि, पेज पर नंबर डालने के ऐसे अनुरोध जिनमें कोई ऐसा पेज टोकन शामिल है जिसकी समयसीमा खत्म हो गई है या जो अमान्य है.
ऐसे अनुरोध एक अपवाद जनरेट करेंगे और इन्हें हर दिन के लिए इस्तेमाल किए जाने वाले कोटा में गिना जाएगा.
खोज के अनुरोध जैसे पेजों पर नंबर वाले अनुरोधों पर भी Page size cannot exceed 10,000 rows की सीमा लागू होती है. साथ ही, अगर इस सीमा का उल्लंघन होता है, तो इन्हें अस्वीकार कर दिया जाता है. इनमें यह गड़बड़ी होती है:INVALID_PAGE_SIZE.
पेजों को क्रम में लगाने के बारे में ज़्यादा जानकारी के लिए, नतीजों की मदद से पेज दिखाना पेज पर जाएं.
ऐसे अनुरोध जो एपीआई के अपवाद दिखाते हैं
SearchAds360Failure के साथ अस्वीकार किए गए अनुरोध, अब भी उपयोगकर्ता के रोज़ाना के ऑपरेशन कोटा में गिने जाते हैं.
ऐसे अनुरोध जो पूरे नहीं हो पाते, लेकिन SearchAds360Failure नहीं दिखाते, जैसे कि नेटवर्क लेवल पर होने वाली गड़बड़ी की वजह से, इन्हें उपयोगकर्ता के हर दिन के ऑपरेशन कोटा में नहीं गिना जाएगा. इसकी वजह यह है कि ये अनुरोध कभी भी सेवा को ऐक्सेस नहीं करेंगे. इसका एक उदाहरण,
नेटवर्क कनेक्टिविटी का ख़राब होना है.
दूसरी तरह की सीमाएं
अगर किसी अनुरोध में बहुत ज़्यादा आइटम शामिल किए गए हैं, तो दोहराए जाने वाले फ़ील्ड (जैसे, कार्रवाइयों की सूची) में यह गड़बड़ी हो सकती है:REQUEST_SIZE_LIMIT_EXCEEDED.
गड़बड़ी का यह मैसेज, दूसरी समस्याओं की वजह से भी मिल सकता है.
Search Ads 360 की क्वेरी भाषा के लिए क्वेरी करते समय, किसी IN क्लॉज़ में ज़्यादा से ज़्यादा 20,000 आइटम हो सकते हैं. अगर इस सीमा को पार कर लिया जाता है, तो आपको FILTER_HAS_TOO_MANY_VALUES गड़बड़ी मिलती है.