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

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