تصف هذه الصفحة بعض المشاكل الشائعة التي قد تواجهها بما في ذلك 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)
لحلّ هذه المشكلة، يُرجى اتّباع الخطوات التالية:
استدعِ الطريقة
users.get
.إذا تلقّيت استجابة
200
، يعني ذلك أنّ المستخدم متوفّر حاليًا في حساب العميل على Google Workspace. لا يمكنك إضافة هذا المستخدم إلى الحساب.إذا تلقّيت الرد
403 forbidden
، يعني ذلك أنّ النطاق في معلَمة البريد الإلكتروني الأساسي ليس عميل توريد أو أنّه تم استخدام البريد الإلكتروني الأساسي سابقًا لمنتج آخر من Google، ويجب أولاً إثبات ملكية نطاق العميل قبل أن تتم إضافة هذا المستخدم بنجاح.إذا كان بإمكانك إثبات ملكية نطاق العميل، يُرجى تنفيذ ما يلي:
- يمكنك إنشاء مستخدم مشرف مؤقت باستخدام
طريقة
users.insert
ومواصلة توفير المتطلبات اللازمة لإكمال الخطوة الأخيرة لإثبات ملكية النطاق. - عند إثبات ملكية النطاق، أضِف المستخدمين المؤقتين إلى المَعلمة
owners[]
في نص الطلب لطلبwebResource.insert
. يمكنك إجراء هذه المكالمة إلى أن تتلقّى ردًا من "200
". - بعد إثبات ملكية النطاق، أعِد تسمية اسم المستخدم المؤقت باستخدام إما طريقة
users.patch
أوusers.update
.
- يمكنك إنشاء مستخدم مشرف مؤقت باستخدام
طريقة
إذا لم تتمكن من إثبات ملكية نطاق العميل، يمكنك إجراء ما يلي:
- أنشِئ مستخدمًا مشرفًا مؤقتًا باستخدام طريقة
users.insert
. - اطلب من عميلك تسجيل الدخول كمستخدم مؤقت وإثبات ملكية نطاقه من خلال "وحدة تحكُّم المشرف".
- بعد إثبات ملكية النطاق، إما العميل أو يمكنك إعادة تسمية
اسم المستخدم المؤقت. يمكنك استخدام إحدى الطرق
users.patch
أو الطريقةusers.update
.
- أنشِئ مستخدمًا مشرفًا مؤقتًا باستخدام طريقة
412:limitExceeded
يحدث هذا الخطأ عندما يصل عميلك إلى الحدّ الأقصى المسموح به لعدد تراخيص المستخدمين. لحلّ هذه المشكلة، استخدِم طريقة subscriptions.changeSeats
واستخدِم ما يلي وفقًا لخطة الاشتراك:
- بالنسبة إلى
FLEXIBLE
، يجب زيادة المَعلمةmaximumNumberOfSeats
. - بالنسبة إلى
ANNUAL
، يجب زيادة المَعلمةnumberOfSeats
.