این صفحه برخی از مشکلات رایجی را که ممکن است در رابطه با 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
برای ادامه بازیابی همه اشتراکهای یک حساب فروشنده استفاده کنید.