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

توضّح هذه الصفحة بعض المشاكل الشائعة التي قد تواجهها في ما يتعلّق بواجهة برمجة التطبيقات 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

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

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