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

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

توضّح هذه الصفحة بعض المشاكل الشائعة التي قد تواجهها في ما يتعلّق بواجهة برمجة التطبيقات Reseller 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 وفعِّل واجهة برمجة التطبيقات. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة تفعيل واجهات برمجة التطبيقات في 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`

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