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

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

ध्यान दें: कोटा और सीमाओं को बिना किसी सूचना के, किसी भी समय हटाया, कम या बदला जा सकता है.

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

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

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

अहम जानकारी: आम तौर पर, हर दिन के लिए कॉल का कोटा, मर्चेंट के पास मौजूद ऑफ़र के कोटा की संख्या का दोगुना होता है. साथ ही, यह किसी एक प्रॉडक्ट की जानकारी अपडेट करने से जुड़ा नहीं है.

मेथड कॉल के कोटा

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

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

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

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

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

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

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

ध्यान दें: accounts.list तरीके के लिए, कोटा और सीमाओं के इस्तेमाल का शुल्क, हर उपयोगकर्ता के हिसाब से लिया जाता है. यह शुल्क, Merchant Center आईडी या बेहतर खाते के आईडी के हिसाब से नहीं लिया जाता. उप-खातों की सूची देखने के लिए, accounts.listSubaccounts तरीके का इस्तेमाल करें. यह तरीका, इस मामले के लिए ज़्यादा सही है.

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

किसी खाते के लिए, कॉल के मौजूदा कोटा और इस्तेमाल की जानकारी देखने के लिए, खाते के 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 में मौजूद उससे जुड़ी सुविधा, दोनों के लिए एक जैसी हैं.

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

संसाधन	फ़ील्ड	सीमा
shippingsettings	हर देश के हिसाब से शिपिंग सेवाएं (services). हर शिपिंग सेवा के हिसाब से शिपिंग ग्रुप (rateGroups). हर शिपिंग ग्रुप के हिसाब से लेबल (applicableShippingLabels). हर शिपिंग ग्रुप के हिसाब से सबटेबल (subtables). किसी एक रेट टेबल में पंक्ति या कॉलम की संख्या. शिपिंग के लेबल की लंबाई.	20 20 30 100 150 100

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

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