این صفحه برخی از مشکلات رایجی را که ممکن است در رابطه با رابط برنامهنویسی کاربردی فروشندگان با آنها مواجه شوید، شرح میدهد.
400:badRequest
این خطا زمانی رخ میدهد که اشتراک به حالت تعلیق درآمده یا لغو شده باشد. برای اطلاعات بیشتر، به فعال کردن اشتراک مراجعه کنید.
400:invalid
این خطا میتواند به دلایل مختلفی رخ دهد.
اگر از متد customers.insert استفاده میکنید، یکی از پارامترهای شیء customer زیر نامعتبر است:
-
postalAddress.postalCodeنامعتبر. -
postalAddress.countryCodeبرای فروش مجدد Google Workspace واجد شرایط نیست. -
alternateEmailنمیتواند در همان دامنهcustomerDomainباشد.
برای حل این مشکل، بررسی کنید که پارامترهای مورد نیاز برای مشتری وجود داشته و معتبر باشند.
اگر از متد subscriptions.changeSeats استفاده میکنید، ممکن است یکی از مشکلات زیر باعث بروز این خطا شده باشد:
- شما نمیتوانید تعداد صندلیها را برای انواع طرحهای سالانه کاهش دهید. تغییر تنظیمات تمدید را در نظر بگیرید. برای اینکه اشتراک به طور خودکار (در زمان تمدید) تعداد صندلیها را برابر با تعداد کاربران فعال حساب تنظیم کند.
- تعداد صندلیهای درخواستی شما کمتر از تعداد کاربران فعلی حساب کاربری است. به مشتری پیام دهید که قبل از کاهش تعداد صندلیهایش، باید یک کاربر را حذف کند.
- شما پارامتر صندلی نادرست را افزایش دادید. برای طرح
FLEX، پارامترmaximumNumberOfSeatsو برای طرحANNUAL، پارامترnumberOfSeatsرا افزایش دهید. - شما سعی کردید پارامتر
licensedNumberOfSeatsرا که یک پارامتر فقط خواندنی است، تغییر دهید. - در طول دوره آزمایشی، مشتریان حداکثر ۱۰ صندلی دارند. برای پایان دادن فوری به دوره آزمایشی، شروع پرداخت صورتحساب و حذف حداکثر ۱۰ صندلی، میتوانید از یک اشتراک آزمایشی رایگان، یک سرویس پولی را شروع کنید .
403:forbidden
این خطا زمانی رخ میدهد که شما مالک مشتری نیستید یا مشتری شما دسترسی نماینده فروش به کنسول مدیریت خود را غیرفعال کرده است.
403:usageLimits.dailyLimitExceeded
این خطا زمانی رخ میدهد که به سهمیه روزانه برای تماسهای این API رسیده باشید. برای حل این مشکل، یک تأخیر برگشتی پیادهسازی کنید. برای اطلاعات بیشتر، به محدودیتهای استفاده و سهمیهها مراجعه کنید.
اگر میخواهید اشتراکهای زیادی را بازیابی کنید، استفاده از متد subscriptions.list را بدون مشخص کردن پارامترهای customerId یا subscriptionId در نظر بگیرید. میتوانید حداکثر ۱۰۰ اشتراک را در هر فراخوانی برگردانید. از پارامتر pageToken برای ادامه بازیابی همه اشتراکها تحت یک حساب نمایندگی فروش استفاده کنید.
403:usageLimits.accessNotConfigured
این خطا زمانی رخ میدهد که API در پروژه Google Cloud فعال نشده باشد. برای حل این مشکل، به کنسول Google Cloud بروید و API را فعال کنید. برای اطلاعات بیشتر، به بخش فعال کردن APIهای Google Workspace مراجعه کنید.
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
این خطا زمانی رخ میدهد که از محدودیت تعداد پرسوجوها در ثانیه عبور کردهاید. برای حل این مشکل، یک استراتژی تلاش مجدد backoff پیادهسازی کنید یا نتایج را ذخیره کنید تا فراخوانیهای API کمتری انجام شود. برای اطلاعات بیشتر، به محدودیتهای استفاده و سهمیهبندی مراجعه کنید.
اگر میخواهید اشتراکهای زیادی را بازیابی کنید، استفاده از متد subscriptions.list را بدون مشخص کردن پارامترهای customerId یا subscriptionId در نظر بگیرید. میتوانید حداکثر ۱۰۰ اشتراک را در هر فراخوانی برگردانید. از پارامتر pageToken برای ادامه بازیابی همه اشتراکها تحت یک حساب نمایندگی فروش استفاده کنید.