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

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

कीमत

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

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

Search या SearchStream तरीकों से की जाने वाली क्वेरी के ऑपरेशन पर ये सीमाएं लागू होती हैं.

• हर उपयोगकर्ता के लिए, हर प्रोजेक्ट के हिसाब से हर मिनट में 3,000 क्वेरी
• हर प्रोजेक्ट के लिए, हर मिनट में 3,000 क्वेरी
• हर प्रोजेक्ट के लिए, हर दिन 1,50,000 क्वेरी

एपीआई के ऑपरेशन की रोज़ाना की सीमाएं

एपीआई के इस्तेमाल की रोज़ाना की सीमाएं, हर Google Cloud प्रोजेक्ट के लिए किए गए एपीआई के ऑपरेशन की संख्या पर आधारित होती हैं.

किसी एक क्वेरी या रिपोर्ट को एक ऑपरेशन के तौर पर गिना जाता है. भले ही, नतीजे being streamed through SearchAds360Service.SearchStream or paged from a SearchAds360Service.Search कॉल से पेज किए जा रहे हों. ज़्यादा जानें.

यहां दी गई टेबल में, हिसाब-किताब के कुछ उदाहरण दिए गए हैं:

एपीआई अनुरोध	रोज़ाना की सीमा में गिने जाने वाले ऑपरेशन
ऑपरेशन: Search गिनती: 53 विज्ञापन ग्रुप सेवा: SearchAds360Service	1
ऑपरेशन: SearchStream गिनती: 45 कैंपेन सेवा: SearchAds360Service	1

इन सीमाओं का उल्लंघन करने वाले अनुरोधों को अस्वीकार कर दिया जाता है. साथ ही, गड़बड़ी का यह मैसेज दिखता है: RESOURCE_EXHAUSTED.

खोज के अनुरोध

Search या SearchStream का अनुरोध, उपयोगकर्ता के रोज़ाना के ऑपरेशन के कोटे के हिसाब से एक ऑपरेशन के तौर पर गिना जाता है. SearchStream का एक अनुरोध, बैच की संख्या के बावजूद एपीआई के एक ऑपरेशन के तौर पर गिना जाता है.

gRPC की सीमाएं

gRPC डिफ़ॉल्ट रूप से, gRPC में मैसेज का साइज़ 4 एमबी होता है.

जवाबों का साइज़ इस सीमा से ज़्यादा नहीं होना चाहिए. उदाहरण के लिए, खोज के ऐसे अनुरोध से 4 एमबी से ज़्यादा साइज़ का जवाब जनरेट हो सकता है जिसमें कई फ़ील्ड शामिल हों. इस सीमा से बचने के लिए, चुने गए फ़ील्ड की संख्या कम करें, पेज का साइज़ कम करें या स्ट्रीमिंग का इस्तेमाल करें.

इस सीमा का उल्लंघन करने वाले अनुरोधों से SearchAds360Error जनरेट नहीं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 गड़बड़ी का मैसेज दिखेगा.