تحديد مشاكل 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.