कोटा और सीमाएं

आपके कारोबारी खाते और Merchant API के इस्तेमाल पर, कोटा और सीमाएं लागू होती हैं.

नीति अपडेट करें

Merchant API, अपडेट के मामले में इन नीतियों को लागू करता है:

• प्रॉडक्ट की जानकारी को हर दिन सिर्फ़ दो बार अपडेट किया जा सकता है. आपको हर मिनट के हिसाब से तय सीमा का पालन करने के लिए, पूरे दिन में कॉल को बराबर बांटना चाहिए.
• उप-खातों को हर दिन सिर्फ़ दो बार अपडेट किया जा सकता है.
• अपने उप-खातों के लिए, डेटा सोर्स के तरीकों को कॉल किया जा सकता है. जैसे, list या create. हालांकि, हर उप-खाते के लिए, हर दिन सिर्फ़ दो बार ऐसा किया जा सकता है.

तरीके को कॉल करने के कोटा

Merchant API, कॉल के कोटा को अपने-आप इन चीज़ों के लिए अडजस्ट करता है:

• products और accounts को आपके इस्तेमाल के हिसाब से तय किया जाता है.
• datasources, उनके उप-खातों की संख्या के आधार पर ऐडवांस खातों के लिए.

हम आपके कोटे के इस्तेमाल को इस तरह ट्रैक करते हैं:

• कोटा, हर तरीके के लिए अलग-अलग होते हैं. उदाहरण के लिए, get तरीके का कोटा, update तरीके के कोटे से अलग होता है.
• हर अनुरोध को एक बार गिना जाता है, भले ही वह किसी भी तरह का हो. उदाहरण के लिए, हम 250 आइटम के list अनुरोध को एक बार गिनते हैं, न कि 250 get अनुरोधों के तौर पर.
• कोटा का शुल्क उस उपयोगकर्ता के हिसाब से लिया जाता है जो एपीआई का अनुरोध करता है. अगर उपयोगकर्ता, ऐडवांस खाते का सदस्य है, तो कोटा का शुल्क ऐडवांस खाते के लेवल पर लिया जाएगा.
• datasources सेवा के लिए, कोटा अपने-आप बढ़ने की सुविधा सिर्फ़ उन ऐडवांस खातों पर लागू होती है जिनके उप-खातों की संख्या के आधार पर कोटा तय किया जाता है. स्टैंडअलोन खातों और उप-खातों के लिए कोटा स्टैटिक होते हैं. आम तौर पर, इनमें बढ़ोतरी नहीं की जा सकती. datasource कोटे की सीमाएं देखने के लिए, accounts.limits तरीकों का इस्तेमाल करें.
• कोटा, Comparison Shopping Services (CSS) ग्रुप, सीएसएस, खाते या उप-खातों पर लागू होते हैं. इनके लिए, कॉल करते समय पुष्टि की जाती है. उदाहरण के लिए, अगर आपने ऐडवांस खाते के तौर पर पुष्टि की है, तो कॉल की संख्या को आपके ऐडवांस खाते के कोटे में गिना जाएगा. हालांकि, अगर आपने अपने किसी उप-खाते के तौर पर पुष्टि की है, तो कॉल की संख्या को उप-खाते के कोटे में गिना जाएगा.

इस डायग्राम में, सीएसएस ग्रुप, सीएसएस, खातों, और उप-खातों की हैरारकी दिखाई गई है.

Content API for Shopping के लिए, मेथड कॉल के कोटे में हुए बदलाव

अगर आपने Content API for Shopping का इस्तेमाल किया है, तो Merchant API में, तरीके के लिए कॉल के कोटे में हुए इन बदलावों पर ध्यान दें:

• कस्टम बैचिंग की सुविधा उपलब्ध न होने से, कोटा के हिसाब लगाने पर कोई असर नहीं पड़ता. उदाहरण के लिए, अगर किसी बैच अनुरोध में 500 इंसर्ट अनुरोध शामिल हैं, तो इसके लिए 500 अलग-अलग इंसर्ट अनुरोधों के हिसाब से शुल्क लिया जाएगा.
• खातों और प्रॉडक्ट के लिए, कोटा अपने-आप लागू होने की सुविधा चालू रहेगी.
• ऑटोमेशन और ओवरराइड करने की सुविधा के साथ-साथ, कोटा के मौजूदा इस्तेमाल और सीमाओं का पता लगाने के लिए, Quota.list तरीके का इस्तेमाल करें.

कॉल के कोटे देखना

किसी खाते के लिए कॉल के मौजूदा कोटे और इस्तेमाल की जानकारी देखने के लिए, खाते के name का इस्तेमाल करके quotas.list को कॉल करें.

ऑटोमैटिक कोटा, products, accounts, और datasources सेवाओं पर लागू होता है.

• ऑटोमैटिक कोटा वाले संसाधनों के लिए (ऐडवांस खातों के लिए products, accounts, और datasources): खास स्थितियों में, सिर्फ़ कुछ समय के लिए कोटा बढ़ाने का अनुरोध किया जा सकता है. जैसे, किसी नए बाज़ार में लॉन्च करने या खरीदारी के सीज़न में जब ट्रैफ़िक ज़्यादा होता है. हम इस तरह के संसाधनों के लिए, कोटे में हमेशा के लिए बढ़ोतरी करने का अनुरोध स्वीकार नहीं करते.
• अपने-आप कोटा तय करने की सुविधा के बिना उपलब्ध अन्य सभी संसाधनों के लिए: ज़रूरत के मुताबिक, कोटा बढ़ाने का अनुरोध किया जा सकता है.

सहायता टीम से संपर्क करें फ़ॉर्म में मौजूद Quota increase request समस्या का इस्तेमाल करें और इसमें यह जानकारी भरें:

• Merchant Center का आपका आईडी
• जिन तरीकों के लिए आपने कोटे की सीमाएं पूरी कर ली हैं
• उन तरीकों के लिए, हर दिन ज़रूरी कॉल की संख्या का अनुमान
• कोटा बढ़ाने की वजह
• क्या यह बढ़ोतरी कुछ समय के लिए है या हमेशा के लिए

हमारा सुझाव है कि आप समय-समय पर अपने कोटे की जांच करें. इससे यह पक्का किया जा सकेगा कि आपके पास लागू करने के लिए ज़रूरी कोटा है या आपका कोटा अपने-आप कैसे अडजस्ट होता है.

गड़बड़ियां

कोटा पार होने पर, आपको ये गड़बड़ियां दिखेंगी:

• प्रति मिनट: quota/request_rate_too_high
• हर दिन: quota/daily_limit_exceeded

अपना कोटा और उसके इस्तेमाल की जानकारी देखने के लिए, कॉल के लिए तय किए गए कोटे की जांच करना लेख पढ़ें. साथ ही, हर दिन या हर मिनट के हिसाब से कोटा बढ़ाने का अनुरोध करें.

कोटा अपने-आप बढ़ने पर, यहां दी गई गड़बड़ियों को ठीक नहीं किया जा सकता. इसके लिए, आपको सामान, फ़ीड या उप-खातों का कोटा बढ़ाने का अनुरोध करना होगा:

• too_many_items: Merchant quota exceeded
• too_many_subaccounts: Maximum number of sub-accounts reached

खाता सीमाएं

accounts.limits.get और accounts.limits.list तरीकों से, खाता-लेवल की इकाइयों की सीमाएं देखी जा सकती हैं. प्रॉडक्ट की सीमाएं देखने के लिए, इन तरीकों का इस्तेमाल किया जा सकता है.

किसी खास प्रॉडक्ट की सीमा को वापस पाने के लिए, उदाहरण के लिए, किसी खाते का ईईए में विज्ञापन दिखाने का कोटा पाने के लिए, आपको accounts.limits.get को किए गए कॉल में खाता आईडी और सीमा आईडी बताना होगा. सीमा आईडी, सीमा के टाइप और स्कोप का कॉम्बिनेशन होता है. उदाहरण के लिए, ईईए में विज्ञापन दिखाने के लिए टारगेट किए गए प्रॉडक्ट के लिए products~ADS_EEA और ईईए के बाहर विज्ञापन दिखाने के लिए टारगेट किए गए प्रॉडक्ट के लिए products~ADS_NON_EEA.

यहां किसी खाते के लिए products~ADS_EEA की सीमा पाने का अनुरोध करने का उदाहरण दिया गया है:

GET https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/limits/products~ADS_EEA

अपने खाते के लिए उपलब्ध सीमा आईडी के बारे में जानने के लिए, accounts.limits.list का इस्तेमाल करें. साथ ही, type="products" के लिए फ़िल्टर का इस्तेमाल करें:

GET https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/limits?filter=type%3D%22products%22

प्रॉडक्ट के कोटे के बारे में ज़्यादा जानने के लिए, Google Merchant Center में कोटे के बारे में जानकारी लेख पढ़ें.

संसाधन दिखाए जाने से जुड़ी सीमाएं

यहां दी गई सीमाओं में, Merchant API में इस्तेमाल किए जाने वाले संसाधन दिखाने से जुड़ी कुछ स्ट्रिंग वैल्यू और कलेक्शन फ़ील्ड के लिए खास पाबंदियों के बारे में बताया गया है. ये सीमाएं, Merchant API और Merchant Center में मौजूद उससे जुड़ी सुविधा, दोनों के लिए एक जैसी हैं.

ध्यान दें कि ऐसा हो सकता है कि सीमाओं की यह सूची पूरी न हो. हम इन सीमाओं को नहीं बढ़ाएंगे.

रेट टेबल में पंक्ति या कॉलम की संख्या से, इन कलेक्शन फ़ील्ड पर असर पड़ता है:

• rowHeaders या columnHeaders में मौजूद कलेक्शन फ़ील्ड:
  • prices[]
  • weights[]
  • numberOfItems[]
  • postalCodeGroupNames[]
  • locations[]
  • rows[]
  • cells[]