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

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

403:forbidden

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

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

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.insertcall. يُرجى إجراء هذه المكالمة إلى أن تتلقّى ردًا من 200.
    3. بعد إثبات ملكية النطاق، أعِد تسمية اسم المستخدم المؤقت باستخدام إما الطريقة users.patch أو الطريقة users.update.
  3. إذا لم تتمكّن من إثبات ملكية نطاق العميل، اتّبِع الخطوات التالية:

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

412:limitExceeded

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

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