تحديد مشاكل Directory API وحلّها

توضّح هذه الصفحة بعض المشاكل الشائعة التي قد تواجهها بصفتك موزعًا معتمدًا عند استخدام Directory API.

400:badRequest

يحدث هذا الخطأ عند تمرير قيمة مَعلمة غير صحيحة إلى الطريقة.

في حال استخدام طريقة users.get، تأكَّد من أنّ القيمة التي تم تمريرها إلى المَعلمة userKey هي إما عنوان البريد الإلكتروني الأساسي للمستخدم أو عنوان البريد الإلكتروني البديل أو رقم تعريف المستخدم الفريد.

في حال استخدام طريقة users.list، تحقَّق من المَعلمات التالية:

• المَعلمة customer: استخدِم فقط customerId الذي أنشأته Google. لا تستخدِم نطاق العميل الفعلي. ننصحك باستخدام هذه المَعلمة لأنّه إذا كان لدى العميل نطاقات ثانوية، سيؤدي استخدام المَعلمة domain فقط إلى عرض المستخدمين الذين لديهم عناوين بريد إلكتروني على هذا النطاق تحديدًا.
• المَعلمة domain: استخدِم نطاق العميل الفعلي فقط. لا تستخدِم
  customerId الذي أنشأته Google.

403:domainCannotUseApis

يحدث هذا الخطأ عندما يوقف العميل إمكانية وصول المورّد إلى واجهة برمجة التطبيقات في حزمة SDK للمشرف. لحلّ هذه المشكلة، اطلب من العميل إعادة تفعيل إذن الوصول إلى واجهة برمجة التطبيقات في حزمة SDK للمشرف. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة التحكّم في الوصول إلى واجهة برمجة التطبيقات.

إذا كنت تحاول الحصول على عدد المستخدمين المرخَّص لهم حاليًا وظهر لك هذا الخطأ، استخدِم الحقل licensedNumberOfSeats من مورد الاشتراك بدلاً من استدعاء الطريقة users.list.

403:forbidden

يحدث هذا الخطأ عندما لا تكون مالك حساب العميل أو عندما يكون العميل قد أوقف إذن وصول المورّد إلى "وحدة تحكّم المشرف".

لحلّ هذه المشكلة، يمكنك إما استدعاء طريقة customers.get قبل إجراء مكالمات للتحقّق من ملكية المورّد للعميل، أو يمكنك أن تطلب من العميل إعادة تفعيل إذن وصول المورّد إلى "وحدة تحكّم المشرف". لمزيد من المعلومات، يُرجى الاطّلاع على مقالة الوصول إلى "وحدة تحكّم المشرف" التابعة للعميل.

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. عند إثبات ملكية النطاق، أضِف المستخدمين المؤقتين إلى المَعلمة owners[] في نص الطلب الخاص باستدعاء webResource.insert. أجرِ هذه المكالمة إلى أن تتلقّى ردًا 200.
   3. بعد إثبات ملكية النطاق، أعِد تسمية اسم المستخدم المؤقت باستخدام إحدى الطريقتين التاليتين: users.patch أو users.update.

3. إذا لم تتمكّن من إثبات ملكية العميل للنطاق، اتّبِع الخطوات التالية:

   1. أنشئ حساب مستخدم مشرف مؤقتًا باستخدام الطريقة users.insert.
   2. اطلب من العميل تسجيل الدخول كمستخدم مؤقت وإثبات ملكية نطاقه من خلال "وحدة تحكّم المشرف".
   3. بعد إثبات ملكية النطاق، يمكن للعميل أو لك إعادة تسمية اسم المستخدم المؤقت. يمكنك استخدام الطريقتَين users.patch أو users.update.

412:limitExceeded

يحدث هذا الخطأ عندما يصل العميل إلى الحدّ الأقصى لعدد تراخيص المستخدمين. لحلّ هذه المشكلة، استخدِم طريقة subscriptions.changeSeats، واستنادًا إلى خطة الاشتراك، اتّبِع ما يلي:

• بالنسبة إلى FLEXIBLE، عليك زيادة المَعلمة maximumNumberOfSeats.
• بالنسبة إلى ANNUAL، عليك زيادة المَعلمة numberOfSeats.