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

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

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

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

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

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

Merchant API, आपके इस्तेमाल के आधार पर products और accounts के लिए कॉल कोटा को अपने-आप अडजस्ट करता है.

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

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

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

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

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

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

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

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

अपने-आप कोटा बढ़ने की सुविधा, सिर्फ़ products और accounts सेवाओं पर लागू होती है. अगर आपको किसी अन्य सेवा के लिए ज़्यादा कोटा चाहिए, products या accounts सेवाओं के लिए रोज़ाना का कोटा खत्म हो गया है या आपको accounts या services प्रॉडक्ट के लिए कुछ समय के लिए कोटा बढ़ाना है, तो हमसे संपर्क करें. इसके लिए, यह जानकारी दें:

• 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[]