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

इस पेज पर कुछ सामान्य समस्याओं के बारे में बताया गया है जो रीसेलर के तौर पर, डायरेक्ट्री एपीआई का इस्तेमाल करने पर हो सकती हैं.

400:badRequest

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

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

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

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

403:domainCannotUseApis

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

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

403:forbidden

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

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

403:usageLimits.accessNotConfigured

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

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 पैरामीटर बढ़ाएं.