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

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.