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

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

400:badRequest

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

400:invalid

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

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

  • अमान्य postalAddress.postalCode.
  • Google Workspace को फिर से बेचने के लिए, postalAddress.countryCode ज़रूरी शर्तें पूरी नहीं की गई हैं.
  • 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 Console पर जाएं और एपीआई चालू करें. ज़्यादा जानकारी के लिए, Google Workspace API चालू करना लेख पढ़ें.

404:notFound

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

412:conditionNotMet

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

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

  • ANNUAL_MONTHLY_PAY
  • ANNUAL_YEARLY_PAY

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

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

429:usageLimits.quotaExceeded

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

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