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

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

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

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

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

403:usageLimits.accessNotConfigured

يحدث هذا الخطأ في حال عدم تفعيل واجهة برمجة التطبيقات في مشروع Google Cloud. لحلّ هذه المشكلة، يُرجى الانتقال إلى Google Cloud Console وتفعيل واجهة برمجة التطبيقات. لمزيد من المعلومات، يُرجى الاطّلاع على تفعيل واجهات برمجة تطبيقات 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.