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

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 विज्ञापन ग्रुप सेवा: 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 गड़बड़ी दिखेगी.