डायरेक्ट्री एपीआई की समस्याएं हल करना

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

400:badRequest

यह गड़बड़ी तब होती है, जब मेथड में गलत पैरामीटर वैल्यू दी जाती है.

users.get तरीके का इस्तेमाल करने पर, पुष्टि करें कि userKey पैरामीटर में दी गई वैल्यू, उपयोगकर्ता का मुख्य ईमेल पता, उपनाम वाला ईमेल पता या यूनीक उपयोगकर्ता आईडी हो.

users.list तरीके का इस्तेमाल करने पर, इन पैरामीटर की पुष्टि करें:

• customer पैरामीटर: सिर्फ़ उस customerId का इस्तेमाल करें जिसे Google ने जनरेट किया है. ग्राहक के असली डोमेन का इस्तेमाल न करें. हमारा सुझाव है कि आप इस पैरामीटर का इस्तेमाल करें, क्योंकि अगर किसी ग्राहक के पास सेकंडरी डोमेन हैं, तो domain पैरामीटर का इस्तेमाल करने पर, सिर्फ़ उस डोमेन पर मौजूद ईमेल पते वाले उपयोगकर्ता दिखते हैं.
• domain पैरामीटर: सिर्फ़ ग्राहक के असल डोमेन का इस्तेमाल करें. Google की ओर से जनरेट किए गए
  customerId का इस्तेमाल न करें.

403:domainCannotUseApis

यह गड़बड़ी तब होती है, जब आपके ग्राहक ने रीसेलर के लिए, Admin SDK API का ऐक्सेस बंद कर दिया हो. इस समस्या को हल करने के लिए, अपने ग्राहक से कहें कि वह 'एडमिन SDK' के एपीआई का ऐक्सेस फिर से चालू करे. ज़्यादा जानकारी के लिए, एपीआई का ऐक्सेस कंट्रोल करना लेख पढ़ें.

अगर आपको लाइसेंस वाले मौजूदा उपयोगकर्ताओं की संख्या जाननी है और आपको यह गड़बड़ी दिखती है, तो users.list तरीके को कॉल करने के बजाय, सदस्यता संसाधन के licensedNumberOfSeats फ़ील्ड का इस्तेमाल करें.

403:forbidden

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

इस समस्या को हल करने के लिए, ग्राहक के रीसेलर मालिकाना हक की पुष्टि करने के लिए कॉल करने से पहले, customers.get तरीके का इस्तेमाल करें. इसके अलावा, अपने ग्राहक से कहें कि वह अपने Admin console में रीसेलर ऐक्सेस को फिर से चालू करे. ज़्यादा जानकारी के लिए, ग्राहक के Admin console को ऐक्सेस करना लेख पढ़ें.

403:usageLimits.accessNotConfigured

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

409:duplicate

यह गड़बड़ी तब होती है, जब किसी नए उपयोगकर्ता को जोड़ने की कोशिश की जा रही हो, लेकिन ग्राहक का मुख्य ईमेल पहले से ही इनमें से किसी एक में मौजूद हो:

• वह मौजूदा Google Workspace खाता जिसमें आपको उन्हें जोड़ना है.
• Google का कोई अन्य प्रॉडक्ट (Google Workspace नहीं).

इस समस्या को हल करने के लिए, यह तरीका अपनाएं:

1. users.get वाले तरीके को कॉल करें.

   अगर आपको 200 जवाब मिलता है, तो इसका मतलब है कि उपयोगकर्ता, ग्राहक के Google Workspace खाते में पहले से मौजूद है. इस उपयोगकर्ता को खाते में नहीं जोड़ा जा सकता.

   अगर आपको 403 forbidden जवाब मिलता है, तो इसका मतलब है कि प्राइमरी ईमेल पैरामीटर में मौजूद डोमेन, फिर से बेचा गया ग्राहक नहीं है या प्राइमरी ईमेल का इस्तेमाल पहले किसी दूसरे Google प्रॉडक्ट के लिए किया गया है. साथ ही, इस उपयोगकर्ता को जोड़ने से पहले, ग्राहक के डोमेन की पुष्टि करना ज़रूरी है.

2. अगर आपके पास ग्राहक के डोमेन की पुष्टि करने का विकल्प है, तो ये काम करें:

   1. users.insert तरीके का इस्तेमाल करके, अस्थायी एडमिन उपयोगकर्ता बनाएं और डोमेन की पुष्टि करने के आखिरी चरण तक प्रोवाइज़न जारी रखें.
   2. डोमेन की पुष्टि करते समय, कुछ समय के लिए जोड़े गए उपयोगकर्ताओं को webResource.insert कॉल के लिए, अनुरोध बॉडी के owners[] पैरामीटर में जोड़ें. जब तक आपको 200 का जवाब न मिल जाए, तब तक यह कॉल करें.
   3. डोमेन की पुष्टि हो जाने के बाद, अस्थायी उपयोगकर्ता नाम का नाम बदलें. इसके लिए, users.patch या users.update में से किसी एक तरीके का इस्तेमाल करें.

3. अगर आपको ग्राहक के डोमेन की पुष्टि करने में समस्या आ रही है, तो ये काम करें:

   1. users.insert तरीके का इस्तेमाल करके, कुछ समय के लिए एडमिन बनाना.
   2. अपने ग्राहक को अस्थायी उपयोगकर्ता के तौर पर साइन इन करने के लिए कहें. इसके बाद, Admin console की मदद से, उसके डोमेन की पुष्टि करें.
   3. डोमेन की पुष्टि हो जाने के बाद, ग्राहक या आपके पास, कुछ समय के लिए इस्तेमाल किए जाने वाले उपयोगकर्ता नाम का नाम बदलने का विकल्प होता है. इसके लिए, users.patch या फिर users.update में से किसी एक तरीके का इस्तेमाल किया जा सकता है.

412:limitExceeded

यह गड़बड़ी तब होती है, जब आपके ग्राहक ने सीटों की तय सीमा तक पहुंच लिया हो. इस समस्या को हल करने के लिए, subscriptions.changeSeats तरीके का इस्तेमाल करें. साथ ही, सदस्यता के प्लान के हिसाब से, इनका इस्तेमाल करें:

• FLEXIBLE के लिए, maximumNumberOfSeats पैरामीटर बढ़ाएं.
• ANNUAL के लिए, numberOfSeats पैरामीटर बढ़ाएं.