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