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

`403:forbidden`

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

`403:usageLimits.dailyLimitExceeded`

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

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

`403:usageLimits.accessNotConfigured`

يحدث هذا الخطأ عندما لا يتم تفعيل واجهة برمجة التطبيقات في مشروع Google Cloud. الحل هذه المشكلة، انتقِل إلى وحدة تحكّم Google Cloud وفعِّل واجهة برمجة التطبيقات. لمزيد من المعلومات، المعلومات، راجع تفعيل واجهات برمجة التطبيقات في 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`

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