रीसेलर एपीआई से जुड़ी समस्याओं को हल करना

इस पेज पर, Reseller API से जुड़ी कुछ सामान्य समस्याओं के बारे में बताया गया है.

400:badRequest

यह गड़बड़ी तब दिखती है, जब सदस्यता निलंबित या रद्द कर दी जाती है. ज़्यादा जानकारी के लिए, सदस्यता चालू करना लेख पढ़ें.

400:invalid

यह गड़बड़ी कई वजहों से हो सकती है.

अगर customers.insert तरीके का इस्तेमाल किया जा रहा है, तो इनमें से कोई एक ग्राहक ऑब्जेक्ट पैरामीटर अमान्य है:

  • अमान्य postalAddress.postalCode.
  • postalAddress.countryCode, Google Workspace को फिर से बेचने की ज़रूरी शर्तें पूरी नहीं करता.
  • alternateEmail और customerDomain एक ही डोमेन में नहीं हो सकते

इस समस्या को हल करने के लिए, पुष्टि करें कि ज़रूरी पैरामीटर मौजूद हों और वे खरीदार के लिए मान्य हों.

अगर subscriptions.changeSeats तरीके का इस्तेमाल किया जा रहा है, तो हो सकता है कि इनमें से किसी एक वजह से यह गड़बड़ी हुई हो:

  • सालाना प्लान के लिए, सीटों की संख्या कम नहीं की जा सकती. रिन्यूअल की सेटिंग बदलें. सदस्यता के रिन्यूअल के समय, खाते में मौजूद सक्रिय उपयोगकर्ताओं की संख्या के बराबर सीटें अपने-आप सेट हो जाएं.
  • आपने सीटों की जो संख्या के लिए अनुरोध किया है वह खाते में मौजूद मौजूदा उपयोगकर्ताओं की संख्या से कम है. ग्राहक को मैसेज भेजें कि सीटों की संख्या कम करने से पहले, उन्हें किसी उपयोगकर्ता को हटाना होगा.
  • आपने सीट के गलत पैरामीटर को बढ़ाया है. FLEX प्लान के लिए, maximumNumberOfSeats पैरामीटर को बढ़ाएं और ANNUAL प्लान के लिए, numberOfSeats पैरामीटर को बढ़ाएं.
  • आपने licensedNumberOfSeats पैरामीटर को बदलने की कोशिश की है, जो कि सिर्फ़ पढ़ने के लिए है.
  • मुफ़्त में आज़माने की अवधि के दौरान, ग्राहकों के पास ज़्यादा से ज़्यादा 10 सीटें होती हैं. मुफ़्त में आज़माने की सुविधा वाली सदस्यता से पैसे चुकाकर ली जाने वाली सेवा शुरू करें, ताकि ट्रायल की अवधि तुरंत खत्म हो जाए, बिलिंग शुरू हो जाए, और ज़्यादा से ज़्यादा 10 सीटों की सीमा हट जाए.

403:forbidden

यह गड़बड़ी तब होती है, जब आपके पास ग्राहक का मालिकाना हक न हो या आपके ग्राहक ने अपने Admin console के लिए, रीसेलर का ऐक्सेस बंद कर दिया हो.

403:usageLimits.dailyLimitExceeded

यह गड़बड़ी तब होती है, जब इस एपीआई को कॉल करने के लिए तय किया गया हर दिन का कोटा पूरा हो जाता है. इस समस्या को हल करने के लिए, बैकऑफ़ देरी लागू करें. ज़्यादा जानकारी के लिए, इस्तेमाल की सीमाएं और कोटा देखें.

अगर आपको कई सदस्यताओं को वापस लाना है, तो customerId या subscriptionId पैरामीटर के बारे में बताए बिना, subscriptions.list तरीके का इस्तेमाल करें. हर कॉल में ज़्यादा से ज़्यादा 100 सदस्यताएं लौटाई जा सकती हैं. रीसेलर खाते में मौजूद सभी सदस्यताओं को फिर से पाने के लिए, pageToken पैरामीटर का इस्तेमाल करें.

403:usageLimits.accessNotConfigured

यह गड़बड़ी तब होती है, जब Google Cloud प्रोजेक्ट में एपीआई चालू नहीं होता. इस समस्या को हल करने के लिए, Google Cloud कंसोल पर जाएं और एपीआई को चालू करें. ज़्यादा जानकारी के लिए, Google Workspace के एपीआई चालू करना लेख पढ़ें.

404:notFound

customers.get तरीके का इस्तेमाल करते समय, गड़बड़ी का यह मतलब है कि ग्राहक या डोमेन, किसी भी Google Workspace खाते के लिए मौजूद नहीं है और डोमेन उपलब्ध है.

412:conditionNotMet

यह गड़बड़ी कई वजहों से हो सकती है.

अगर आपको subscriptions.changeRenewalSettings तरीका इस्तेमाल करते समय यह गड़बड़ी दिखती है, तो पक्का करें कि आपने इसे सिर्फ़ यहां दिए गए, कमिटमेंट वाले पेमेंट प्लान के लिए कॉल किया हो:

  • ANNUAL_MONTHLY_PAY
  • ANNUAL_YEARLY_PAY

अगर आपको subscriptions.delete तरीके का इस्तेमाल करते समय यह गड़बड़ी दिखती है, तो इसका मतलब है कि Google Workspace खाते में कोई एडमिन उपयोगकर्ता मौजूद नहीं है. इस समस्या को ठीक करने के लिए, कुछ समय के लिए किसी एडमिन उपयोगकर्ता को जोड़ें और फिर से कोशिश करें.

अगर subscriptions.insert तरीके का इस्तेमाल करते समय आपको यह गड़बड़ी दिखती है, तो इसका मतलब है कि चुने गए SKU को फिर से बेचा नहीं जा सकता या उसे उभरते हुए बाज़ार के ग्राहक को नहीं बेचा जा सकता. इस समस्या को हल करने के लिए, लागू होने वाली सेवा की शर्तें स्वीकार करें.

429:usageLimits.quotaExceeded

यह गड़बड़ी तब होती है, जब हर सेकंड में की जाने वाली क्वेरी की सीमा पार कर ली जाती है. इस समस्या को हल करने के लिए, बैकऑफ़ की रणनीति लागू करें या एपीआई कॉल कम करने के लिए नतीजों को कैश मेमोरी में सेव करें. ज़्यादा जानकारी के लिए, इस्तेमाल की सीमाएं और कोटा देखें.

अगर आपको कई सदस्यताओं को वापस लाना है, तो customerId या subscriptionId पैरामीटर के बारे में बताए बिना, subscriptions.list तरीके का इस्तेमाल करें. हर कॉल में ज़्यादा से ज़्यादा 100 सदस्यताएं लौटाई जा सकती हैं. रीसेलर खाते में मौजूद सभी सदस्यताओं को फिर से पाने के लिए, pageToken पैरामीटर का इस्तेमाल करें.