Search Ads 360 Reporting API, एपीआई के ऑपरेशन पर सीमाएं लागू करता है. इससे यह पक्का किया जा सकता है कि सभी उपयोगकर्ताओं के लिए सिस्टम की परफ़ॉर्मेंस बेहतर हो.
कीमत
Search Ads 360 Reporting API का इस्तेमाल, Search Ads 360 की कुल कीमत में शामिल है. एपीआई का इस्तेमाल करने के लिए, कोई अतिरिक्त शुल्क नहीं लिया जाता.
क्वेरी की सीमाएं
खोज या SearchStream तरीकों से की गई क्वेरी कार्रवाइयों पर ये सीमाएं लागू होती हैं.
- हर उपयोगकर्ता के लिए, हर प्रोजेक्ट के हिसाब से हर मिनट में 3,000 क्वेरी
- हर प्रोजेक्ट के लिए, हर मिनट में 3,000 क्वेरी
- हर प्रोजेक्ट के लिए, हर दिन 1,50,000 क्वेरी
एपीआई के रोज़ाना के ऑपरेशन की सीमाएं
एपीआई के इस्तेमाल की रोज़ाना की सीमाएं, Google Cloud प्रोजेक्ट के हिसाब से तय होती हैं.
किसी एक क्वेरी या रिपोर्ट को एक ऑपरेशन के तौर पर गिना जाता है. भले ही, नतीजे SearchAds360Service.SearchStream के ज़रिए स्ट्रीम किए जा रहे हों या SearchAds360Service.Search कॉल से पेज पर लाए जा रहे हों. ज़्यादा जानें.
यहां दी गई टेबल में, हिसाब-किताब के कुछ उदाहरण दिए गए हैं:
| एपीआई अनुरोध | रोज़ाना की सीमा में शामिल किए गए ऑपरेशन |
|---|---|
ऑपरेशन: Search
गिनती: 53 विज्ञापन ग्रुप सेवा: SearchAds360Service
|
1 |
ऑपरेशन: SearchStream
गिनती: 45 कैंपेन सेवा: SearchAds360Service
|
1 |
इन सीमाओं का उल्लंघन करने वाले अनुरोधों को इस गड़बड़ी के साथ अस्वीकार कर दिया जाता है:
RESOURCE_EXHAUSTED.
खोज के अनुरोध
Search या SearchStream अनुरोध को, उपयोगकर्ता के लिए तय किए गए रोज़ाना के कोटे में एक ऑपरेशन के तौर पर गिना जाता है. एक SearchStream अनुरोध को एक एपीआई ऑपरेशन माना जाता है, भले ही बैच की संख्या कितनी भी हो.
gRPC की सीमाएं
Search Ads 360 Reporting API की सभी क्लाइंट लाइब्रेरी, अनुरोध और जवाब जनरेट करने के लिए gRPC का इस्तेमाल करती हैं. डिफ़ॉल्ट रूप से, gRPC में मैसेज का साइज़ 4 एमबी होता है.
जवाबों की संख्या इससे ज़्यादा नहीं होनी चाहिए. उदाहरण के लिए, खोज के ऐसे अनुरोध के लिए 4 एमबी से ज़्यादा साइज़ वाला जवाब जनरेट हो सकता है जिसमें कई फ़ील्ड शामिल हों. इस सीमा से बचने के लिए, चुने गए फ़ील्ड की संख्या कम करें, पेज का साइज़ कम करें या स्ट्रीमिंग का इस्तेमाल करें.
इस सीमा का उल्लंघन करने वाले अनुरोधों से, SearchAds360Error जनरेट नहीं होगा. हालांकि, इससे 429 Resource Exhausted gRPC गड़बड़ी जनरेट होगी. 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 गड़बड़ी का मैसेज दिखता है.