تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

تحديد مشاكل واجهة برمجة تطبيقات المورّد وحلّها

تصف هذه الصفحة بعض المشاكل الشائعة التي قد تواجهها بشأن واجهة برمجة تطبيقات المورّد.

`400:badRequest`

يحدث هذا الخطأ عند تعليق الاشتراك أو إلغاؤه. لمزيد من المعلومات، يُرجى الاطّلاع على تفعيل اشتراك.

`400:invalid`

يمكن أن يحدث هذا الخطأ لعدة أسباب.

إذا كنت تستخدم الطريقة customers.insert، لن تكون إحدى معلَمات عناصر العملاء التالية غير صالحة:

postalAddress.postalCode غير صالح.
postalAddress.countryCode غير مؤهَّل لإعادة بيع Google Workspace.
لا يمكن أن يكون alternateEmail في النطاق نفسه كـ customerDomain.

لحلّ هذه المشكلة، تأكَّد من أنّ المَعلمات المطلوبة متوفّرة وصالحة للعميل.

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

ولا يمكنك خفض عدد تراخيص المستخدمين لأنواع الخطط السنوية. يمكنك تغيير إعدادات التجديد. لكي يحدّد الاشتراك تلقائيًا (في وقت التجديد) عدد تراخيص المستخدمين مساوية لعدد المستخدمين النشطين في الحساب.
إنّ مبلغ المقعد الذي طلبته أقلّ من عدد المستخدمين الحاليين في الحساب. أرسِل رسالة إلى العميل تفيد بأنه يجب عليه إزالة مستخدم قبل أن يتمكن من تقليل عدد تراخيص المستخدمين.
لقد رفعت معلمة المقعد غير الصحيحة. بالنسبة إلى خطة FLEX، يجب زيادة المعلَمة maximumNumberOfSeats وفي خطة ANNUAL، يجب زيادة معلَمة numberOfSeats.
لقد حاولت تغيير المعلمة licensedNumberOfSeats، وهي معلَمة للقراءة فقط.
خلال الفترة التجريبية، يمكن للعملاء الحدّ الأقصى لعدد تراخيص المستخدمين، وهو 10 تراخيص. بدء خدمة مدفوعة من اشتراك يتضمّن فترة تجريبية مجانية لإنهاء الفترة التجريبية على الفور وبدء الفوترة وإزالة الحدّ الأقصى المسموح به لعدد تراخيص المستخدمين، وهو 10 تراخيص

`403:forbidden`

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

`403:usageLimits.dailyLimitExceeded`

يحدث هذا الخطأ عند بلوغ الحدّ الأقصى للحصة اليومية المخصّصة للاتصالات من واجهة برمجة التطبيقات هذه. لحل هذه المشكلة، قم بتنفيذ تأخير التراجع. لمزيد من المعلومات، يمكنك الاطّلاع على الحدود القصوى للاستخدام والحصص.

إذا كنت تحاول استرداد عدة اشتراكات، يمكنك استخدام طريقة subscriptions.list بدون تحديد المعلَمة customerId أو subscriptionId. يمكنك إرجاع 100 اشتراك كحد أقصى لكل مكالمة. يمكنك استخدام المَعلمة pageToken لمواصلة استرداد جميع الاشتراكات ضمن حساب مورّد.

`403:usageLimits.accessNotConfigured`

يحدث هذا الخطأ في حال عدم تفعيل واجهة برمجة التطبيقات في مشروع Google Cloud. لحلّ هذه المشكلة، يُرجى الانتقال إلى Google Cloud Console وتفعيل واجهة برمجة التطبيقات. لمزيد من المعلومات، يُرجى الاطّلاع على تفعيل واجهات برمجة تطبيقات Google Workspace.

`404:notFound`

عند استخدام الإجراء customers.get، يعني هذا الخطأ أنّ العميل أو النطاق غير متوفّرَين لأي حساب على Google Workspace وأنّ النطاق متاح.

`412:conditionNotMet`

يرجع هذا الخطأ إلى عدد من المشاكل المختلفة.

إذا ظهر لك هذا الخطأ عند استخدام طريقة subscriptions.changeRenewalSettings، تأكّد من أنّك تطلب هذه الطريقة فقط في خطط الدفع التالية باشتراك:

ANNUAL_MONTHLY_PAY
ANNUAL_YEARLY_PAY

إذا ظهر لك هذا الخطأ عند استخدام طريقة subscriptions.delete، هذا يعني أنّه ما مِن مستخدم مشرف في حساب Google Workspace. لحلّ هذه المشكلة، عليك إضافة مستخدم مشرف مؤقت وإعادة المحاولة.

إذا ظهر لك هذا الخطأ عند استخدام طريقة subscriptions.insert، يعني ذلك أنّه لا يمكنك إعادة بيع رمز التخزين التعريفي المحدّد أو إلى عميل السوق الناشئة. لحلّ هذه المشكلة، عليك قبول بنود الخدمة السارية.

`429:usageLimits.quotaExceeded`

يحدث هذا الخطأ عند تجاوز الحدّ الأقصى المسموح به لعدد طلبات البحث في الثانية. ولحل هذه المشكلة، عليك تنفيذ استراتيجية خيار "التراجع" لإعادة المحاولة أو تخزين النتائج مؤقتًا لتقليل عدد طلبات البيانات من واجهة برمجة التطبيقات. لمزيد من المعلومات، يمكنك الاطّلاع على الحدود القصوى للاستخدام والحصص.