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

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

400:badRequest

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

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

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

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

403:domainCannotUseApis

यह गड़बड़ी तब होती है, जब आपके ग्राहक ने Admin SDK API के लिए, रीसेलर के ऐक्सेस को बंद कर दिया हो. इस समस्या को हल करने के लिए, अपने ग्राहक से एडमिन 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 API चालू करना लेख पढ़ें.

409:duplicate

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

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

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

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

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

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

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

   1. users.insert तरीके का इस्तेमाल करके, कुछ समय के लिए एडमिन उपयोगकर्ता बनाएं. इसके बाद, डोमेन की पुष्टि करने के आखिरी चरण पर जाएं.
   2. डोमेन की पुष्टि करते समय, अनुरोध के मुख्य हिस्से के owners[] पैरामीटर में कुछ समय के लिए उपयोगकर्ताओं को जोड़ें. इसके लिए, webResource.insert कॉल का इस्तेमाल करें. जब तक आपको 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 पैरामीटर की वैल्यू बढ़ाएं.