कीमत, एपीआई की सीमाएं, और कोटा

Search Ads 360 Reporting API, एपीआई के काम करने की सीमाएं तय करता है, ताकि सभी उपयोगकर्ताओं के लिए सिस्टम की परफ़ॉर्मेंस बेहतर बनी रहे.

कीमत

Search Ads 360 Reporting API का इस्तेमाल करने पर, आपको Search Ads 360 की कुल कीमत चुकानी होगी. एपीआई का इस्तेमाल करने के लिए, कोई अतिरिक्त शुल्क नहीं लिया जाता.

क्वेरी की सीमाएं

Search या 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 वाली गड़बड़ी का मैसेज दिखेगा.