عیب یابی مشکلات Reseller 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

این خطا زمانی رخ می دهد که به سهمیه روزانه تماس با این API رسیده باشید. برای حل این مشکل، تاخیر عقب‌نشینی را اجرا کنید. برای اطلاعات بیشتر، محدودیت‌ها و سهمیه‌های استفاده را ببینید.

اگر می‌خواهید اشتراک‌های زیادی را بازیابی کنید، از روش subscriptions.list بدون تعیین پارامترهای customerId یا subscriptionId استفاده کنید. در هر تماس می توانید حداکثر 100 اشتراک را برگردانید. از پارامتر pageToken برای ادامه بازیابی همه اشتراک‌های یک حساب فروشنده استفاده کنید.

403:usageLimits.accessNotConfigured

این خطا زمانی رخ می دهد که API در پروژه Google Cloud فعال نباشد. برای حل این مشکل، به کنسول Google Cloud بروید و API را فعال کنید. برای اطلاعات بیشتر، فعال کردن Google Workspace APIs را ببینید.

404:notFound

هنگام استفاده از روش customers.get ، این خطا به این معنی است که مشتری یا دامنه برای هیچ حساب Google Workspace وجود ندارد و دامنه در دسترس است.

412:conditionNotMet

این خطا به دلیل تعدادی از مسائل مختلف ایجاد می شود.

اگر هنگام استفاده از روش subscriptions.changeRenewalSettings با این خطا مواجه شدید، مطمئن شوید که این روش را فقط در طرح‌های پرداخت تعهد زیر فراخوانی می‌کنید:

  • ANNUAL_MONTHLY_PAY
  • ANNUAL_YEARLY_PAY

اگر هنگام استفاده از روش subscriptions.delete با این خطا مواجه شدید، به این معنی است که هیچ کاربر سرپرستی در حساب Google Workspace وجود ندارد. برای حل این مشکل، یک کاربر مدیر موقت اضافه کنید و دوباره امتحان کنید.

اگر هنگام استفاده از روش subscriptions.insert با این خطا مواجه شدید، به این معنی است که یا نمی توانید SKU انتخاب شده را مجدداً بفروشید یا به مشتری بازارهای نوظهور بفروشید. برای حل این مشکل، شرایط خدمات قابل اجرا را بپذیرید.

429:usageLimits.quotaExceeded

این خطا زمانی رخ می دهد که شما از حد درخواست در ثانیه فراتر رفته باشید. برای حل این مشکل، یک استراتژی امتحان مجدد عقب‌نشینی یا نتایج حافظه پنهان را برای برقراری تماس‌های API کمتر اجرا کنید. برای اطلاعات بیشتر، محدودیت‌ها و سهمیه‌های استفاده را ببینید.

اگر می‌خواهید اشتراک‌های زیادی را بازیابی کنید، از روش subscriptions.list بدون تعیین پارامترهای customerId یا subscriptionId استفاده کنید. در هر تماس می توانید حداکثر 100 اشتراک را برگردانید. از پارامتر pageToken برای ادامه بازیابی همه اشتراک‌های یک حساب فروشنده استفاده کنید.