Google APIs - خطاهای دامنه سراسری

این سند برخی‌از کدها و پیام‌های خطایی را که Google APIs برمی‌گرداند شناسایی می‌کند. به‌طور دقیق، خطاهای فهرست‌شده در اینجا در دامنه سراسری یا پیش‌فرض برای Google APIs است. بسیاری از میاناهای برنامه‌سازی کاربردی نیز دامنه‌های خودشان را تعریف می‌کنند که خطاهای مختص میانای برنامه‌سازی کاربردی را که در دامنه جهانی نیستند شناسایی می‌کنند. برای این خطاها، مقدار ویژگی domain در پاسخ JSON یک مقدار مختص API خواهد بود، مانند youtube.parameter.

این صفحه خطاها را براساس کدهای وضعیت HTTP که در RFC 7231 تعریف شده است فهرست می‌کند.

نمونه پاسخ JSON زیر نشان می‌دهد که چگونه یک خطای سراسری منتقل می‌شود:

{
 "error": {
  "errors": [
   {
    "domain": "global",
    "reason": "invalidParameter",
    "message": "Invalid string value: 'asdf'. Allowed values: [mostpopular]",
    "locationType": "parameter",
    "location": "chart"
   }
  ],
  "code": 400,
  "message": "Invalid string value: 'asdf'. Allowed values: [mostpopular]"
 }
}

خطاها

1. MOVED_PERMANENTLY (301)
2. SEE_OTHER (303)
3. NOT_MODIFIED (304)
4. TEMPORARY_REDIRECT (307)
5. BAD_REQUEST (400)
6. غیرمجاز (۴۰۱)
7. PAYMENT_REQUIRED (402)
8. FORBIDDEN (403)
9. NOT_FOUND (404)
10. METHOD_NOT_ALLOWED (405)
11. CONFLICT (409)
12. GONE (410)
13. PRECONDITION_FAILED (412)
14. REQUEST_ENTITY_TOO_LARGE (413)
15. REQUESTED_RANGE_NOT_SATISFIABLE (416)
16. EXPECTATION_FAILED (417)
17. PRECONDITION_REQUIRED (428)
18. TOO_MANY_REQUESTS (429)
19. INTERNAL_SERVER_ERROR (500)
20. NOT_IMPLEMENTED (501)
21. SERVICE_UNAVAILABLE (503)

MOVED_PERMANENTLY (301)

کد خطا	شرح
movedPermanently	این درخواست و درخواست‌های آتی برای همان عملیات باید به‌جای نشانی وبی که این درخواست به آن ارسال شده است، به نشانی وب مشخص‌شده در سرایند Location این پاسخ ارسال شود.

SEE_OTHER (303)

کد خطا	شرح
seeOther	درخواستتان باموفقیت پردازش شد. برای دریافت پاسخ خود، درخواست GET را به نشانی وب مشخص‌شده در سرایند Location ارسال کنید.
mediaDownloadRedirect	درخواستتان باموفقیت پردازش شد. برای دریافت پاسخ، درخواست GET را به نشانی وب مشخص‌شده در سرصفحه Location ارسال کنید.

NOT_MODIFIED (304)

کد خطا	شرح
notModified	شرط تنظیم‌شده برای سرایند If-None-Match برآورده نشد. این پاسخ نشان می‌دهد که سند درخواست‌شده تغییر نکرده است و پاسخ ذخیره‌شده در حافظه نهان باید بازیابی شود. مقدار سرایند درخواست اچ‌تی‌تی‌پی If-None-Match را بررسی کنید.

TEMPORARY_REDIRECT (307)

کد خطا	شرح
temporaryRedirect	برای پردازش درخواستتان، آن را به نشانی وب مشخص‌شده در سرصفحه Location این پاسخ دوباره ارسال کنید.

BAD_REQUEST (400)‎

کد خطا	شرح
badRequest	درخواست API نامعتبر است یا قالب آن درست نیست. درنتیجه، سرور میانای برنامه‌سازی کاربردی نتوانست درخواست را درک کند.
badBinaryDomainRequest	درخواست دامنه دودویی نامعتبر است.
badContent	نوع محتوای داده‌های درخواست یا نوع محتوای بخشی از درخواست چندبخشی پشتیبانی نمی‌شود.
badLockedDomainRequest	درخواست دامنه قفل‌شده نامعتبر است.
corsRequestWithXOrigin	درخواست CORS حاوی سرصفحه XD3 X-Origin است که نشان‌دهنده درخواست CORS بد است.
endpointConstraintMismatch	درخواست ناموفق بود زیرا با API مشخص‌شده مطابقت نداشت. مقدار مسیر نشانی وب را بررسی کنید تا مطمئن شوید درست است.
invalid	درخواست ناموفق بود زیرا حاوی مقدار نامعتبری بود. این مقدار می‌تواند مقدار پارامتر، مقدار سرایند، یا مقدار ویژگی باشد.
invalidAltValue	مقدار پارامتر alt قالب خروجی ناشناخته‌ای را مشخص می‌کند.
invalidHeader	درخواست ناموفق بود زیرا سرایند نامعتبری داشت.
invalidParameter	درخواست ناموفق بود زیرا حاوی پارامتر یا مقدار پارامتر نامعتبر بود. اسناد API را مرور کنید تا مشخص شود کدام پارامترها برای درخواست شما معتبر هستند.
invalidQuery	درخواست نامعتبر است. برای تعیین اینکه چه پارامترهایی برای درخواست پشتیبانی می‌شوند و برای دیدن اینکه آیا درخواست حاوی ترکیبی نامعتبر از پارامترها یا مقدار پارامتر نامعتبر است، مستندات API را بررسی کنید. مقدار پارامتر درخواست q را بررسی کنید.
keyExpired	کلید میانای برنامه‌سازی کاربردی ارائه‌شده در درخواست منقضی شده است، یعنی سرور میانای برنامه‌سازی کاربردی نمی‌تواند محدودیت سهمیه را برای برنامه‌ای که درخواست را ارسال می‌کند بررسی کند. برای کسب اطلاعات بیشتر یا دریافت کلید جدید، Google Developers Console را بررسی کنید.
keyInvalid	کلید میانای برنامه‌سازی کاربردی ارائه‌شده در درخواست نامعتبر است، یعنی سرور میانای برنامه‌سازی کاربردی نمی‌تواند حد سهمیه را برای برنامه‌ای که درخواست را ارسال می‌کند بررسی کند. از کنسول توسعه‌دهندگان Google برای پیدا کردن کلید API خود یا دریافت آن استفاده کنید.
lockedDomainCreationFailure	کد OAuth در رشته پُرسمان دریافت شده است، که این «میانای برنامه‌سازی کاربردی» برای قالب‌های پاسخ غیر از JSON یا XML آن را ممنوع کرده است. درصورت امکان، کد OAuth را در سرصفحه «مجوز» ارسال کنید.
notDownload	فقط درخواست‌های بارگیری رسانه را می‌توان به /download/* مسیر نشانی وب ارسال کرد. درخواست را به همان مسیر، اما بدون پیشوند /download، دوباره ارسال کنید.
notUpload	درخواست انجام نشد زیرا درخواست بارگذاری نیست، و فقط درخواست‌های بارگذاری را می‌توان به نشانی‌های وب /upload/* ارسال کرد. درخواست را دوباره به همان مسیر ارسال کنید، اما بدون پیشوند /upload.
parseError	سرور میانای برنامه‌سازی کاربردی نمی‌تواند بدنه درخواست را تجزیه کند.
required	درخواست API فاقد اطلاعات ضروری است. اطلاعات موردنیاز می‌تواند پارامتر یا ویژگی منبع باشد.
tooManyParts	درخواست چندبخشی ناموفق بود چون بخش‌های بسیار زیادی دارد
unknownApi	میانای برنامه‌سازی کاربردی که درخواست آن را فراخوانی می‌کند شناسایی نشد.
unsupportedMediaProtocol	کارخواه از پروتکل رسانه‌ای پشتیبانی‌نشده‌ای استفاده می‌کند.
unsupportedOutputFormat	مقدار پارامتر alt قالب خروجی‌ای را مشخص می‌کند که برای این سرویس پشتیبانی نمی‌شود. مقدار پارامتر درخواست alt را بررسی کنید.
wrongUrlForUpload	درخواست از نوع درخواست بارگذاری است، اما ناموفق بود زیرا به URI مناسب ارسال نشده است. درخواست‌های بارگذاری باید به شناسه منابع یکنواختی ارسال شوند که پیشوند /upload/* را دارند. درخواست را دوباره به همان مسیر ارسال کنید، اما با پیشوند /upload.

غیرمجاز (۴۰۱)

کد خطا	شرح
unauthorized	کاربر برای انجام این درخواست مجاز نیست.
authError	اطلاعات اعتباری مجوز ارائه‌شده برای درخواست نامعتبر است. مقدار سرایند درخواست اچ‌تی‌تی‌پی Authorization را بررسی کنید.
expired	جلسه منقضی شد. مقدار سرایند درخواست HTTP Authorization را بررسی کنید.
lockedDomainExpired	درخواست ناموفق بود زیرا دامنه قفل‌شده که قبلاً معتبر بود منقضی شده است.
required	کاربر باید به سیستم وارد شده باشد تا بتواند این درخواست میانای برنامه‌سازی کاربردی را انجام دهد. مقدار سرایند درخواست HTTP Authorization را بررسی کنید.

پرداخت لازم است (۴۰۲)

کد خطا	شرح
dailyLimitExceeded402	به حد بودجه روزانه تعیین‌شده توسط توسعه‌دهنده رسیده‌اید.
quotaExceeded402	عملیات درخواست‌شده به منابع بیشتری نسبت به آنچه سهمیه اجازه می‌دهد نیاز دارد. برای تکمیل عملیات، پرداخت لازم است.
user402	عملیات درخواستی نیازمند نوعی پرداخت ازسوی کاربر اصالت‌سنجی‌شده است.

ممنوع (۴۰۳)

کد خطا	شرح
forbidden	عملیات درخواستی ممنوع است و نمی‌تواند تکمیل شود.
accessNotConfigured	پروژه‌تان برای دسترسی به این «میانای برنامه‌سازی کاربردی» پیکربندی نشده است. لطفاً از Google Developers Console برای فعال کردن API برای پروژه‌تان استفاده کنید.
accessNotConfigured	این پروژه به‌دلیل سوءاستفاده مسدود شده است. به http://support.google.com/code/go/developer_compliance مراجعه کنید.
accessNotConfigured	پروژه برای حذف علامت‌گذاری شده است.
accountDeleted	حساب کاربری منسوب به اطلاعات کاربری مجوز درخواست حذف شده است. مقدار سرایند درخواست اچ‌تی‌تی‌پی Authorization را بررسی کنید.
accountDisabled	حساب کاربری مرتبط با اطلاعات اعتباری مجوز درخواست غیرفعال شده است. مقدار سرایند درخواست HTTP Authorization را بررسی کنید.
accountUnverified	نشانی ایمیل کاربری که درخواست را ارسال می‌کند درستی‌سنجی نشده است. مقدار سرایند درخواست HTTP Authorization را بررسی کنید.
concurrentLimitExceeded	درخواست ناموفق بود زیرا به حد مجاز استفاده هم‌زمان رسیده‌اید.
dailyLimitExceeded	به حد سهمیه روزانه برای این API رسیده‌اید.
dailyLimitExceeded	به حد سهمیه روزانه رسیده‌اید و پروژه به‌دلیل سوءاستفاده مسدود شده است. برای کمک به حل مشکل، فرم پشتیبانی رعایت استانداردهای Google API را ببینید.
dailyLimitExceededUnreg	درخواست ناموفق بود زیرا به حد روزانه استفاده از API غیرتأییدشده رسیده‌اید. ادامه استفاده از API مستلزم ثبت‌نام ازطریق کنسول Google Developers است.
downloadServiceForbidden	میانای برنامه‌سازی کاربردی از سرویس بارگیری پشتیبانی نمی‌کند.
insufficientAudience	درخواست برای این مخاطب تکمیل نشد.
insufficientAuthorizedParty	درخواست برای این برنامه تکمیل نمی‌شود.
insufficientPermissions	کاربر اصالت‌سنجی‌شده اجازه‌های کافی برای اجرای این درخواست را ندارد.
limitExceeded	درخواست به‌دلیل محدودیت‌های دسترسی یا نرخ تکمیل نشد.
lockedDomainForbidden	این میانای برنامه‌سازی کاربردی از دامنه‌های قفل‌شده پشتیبانی نمی‌کند.
quotaExceeded	عملیات درخواستی به منابع بیشتری نسبت‌به سهمیه مجاز نیاز دارد.
rateLimitExceeded	درخواست‌های زیادی در بازه زمانی مشخصی ارسال شده است.
rateLimitExceededUnreg	از حد مجاز نرخ فراتر رفته‌اید و باید برنامه‌تان را ثبت کنید تا بتوانید به فراخوانی API ادامه دهید. لطفاً بااستفاده از Google Developers Console ثبت‌نام کنید.
responseTooLarge	منبع درخواستی برای برگرداندن بیش‌ازحد بزرگ است.
servingLimitExceeded	به حد نرخ کلی مشخص‌شده برای API رسیده‌اید.
sslRequired	برای انجام این عملیات، SSL لازم است.
unknownAuth	سرور API طرح مجوز استفاده‌شده برای درخواست را تشخیص نمی‌دهد. مقدار سرایند درخواست اچ‌تی‌تی‌پی Authorization را بررسی کنید.
userRateLimitExceeded	درخواست ناموفق بود زیرا به حد نرخ هر کاربر رسیده‌اید.
userRateLimitExceededUnreg	درخواست ناموفق بود زیرا به حد نرخ هر کاربر رسیده است و توسعه‌دهنده کارخواه در درخواست شناسایی نشده است. لطفاً از Google Developer Console (https://console.developers.google.com) برای ایجاد پروژه برای برنامه‌تان استفاده کنید.
variableTermExpiredDailyExceeded	درخواست ناموفق بود زیرا سهمیه دوره متغیر منقضی شده است و به حد روزانه رسیده‌اید.
variableTermLimitExceeded	درخواست ناموفق بود زیرا به حد سهمیه دوره متغیر رسیده است.

NOT_FOUND (404)

کد خطا	شرح
notFound	عملیات درخواستی ناموفق بود زیرا منبع مرتبط با درخواست پیدا نشد.
notFound	منبع مرتبط با درخواست پیدا نشد. اگر در دو هفته گذشته از این API استفاده نکرده‌اید، لطفاً برنامه App Engine را دوباره مستقر کنید و دوباره آن را فراخوانی کنید.
unsupportedProtocol	پروتکل استفاده‌شده در درخواست پشتیبانی نمی‌شود.

METHOD_NOT_ALLOWED (405)

کد خطا	شرح
httpMethodNotAllowed	روش HTTP مرتبط با درخواست پشتیبانی نمی‌شود.

تداخل (۴۰۹)

کد خطا	شرح
conflict	درخواست API نمی‌تواند تکمیل شود زیرا عملیات درخواستی با عنصر موجود تداخل دارد. برای مثال، درخواستی که سعی می‌کند یک مورد تکراری ایجاد کند، باعث ایجاد تعارض می‌شود، اگرچه موارد تکراری معمولاً با خطاهای خاص‌تری شناسایی می‌شوند.
duplicate	عملیات درخواست‌شده ناموفق بود زیرا سعی کرد منبعی را ایجاد کند که ازقبل وجود دارد.

GONE (410)

کد خطا	شرح
deleted	درخواست ناموفق بود زیرا منبع منسوب به درخواست حذف شده است

PRECONDITION_FAILED (412)

کد خطا	شرح
conditionNotMet	شرط تنظیم‌شده در سرایند درخواست HTTP If-Match یا If-None-Match درخواست برآورده نشد. برای جزئیات بیشتر، بخش ETag مشخصات HTTP را ببینید. مقدار سرایند درخواست HTTP If-Match را بررسی کنید.

REQUEST_ENTITY_TOO_LARGE (413)

کد خطا	شرح
backendRequestTooLarge	درخواست خیلی بزرگ است.
batchSizeTooLarge	درخواست دسته‌ای حاوی عناصر بسیار زیادی است.
uploadTooLarge	درخواست ناموفق بود زیرا داده‌های ارسال‌شده در درخواست بسیار بزرگ است.

REQUESTED_RANGE_NOT_SATISFIABLE (416)

کد خطا	شرح
requestedRangeNotSatisfiable	درخواست محدوده مشخصی را تعیین کرده است که نمی‌تواند برآورده شود.

EXPECTATION_FAILED (417)

کد خطا	شرح
expectationFailed	سرور نمی‌تواند انتظار مشتری را برآورده کند.

PRECONDITION_REQUIRED (428)

کد خطا	شرح
preconditionRequired	این درخواست به پیش‌شرطی نیاز دارد که ارائه نشده است. برای اینکه این درخواست موفقیت‌آمیز باشد، باید سرصفحه If-Match یا If-None-Match را با درخواست ارائه دهید.

TOO_MANY_REQUESTS (429)

کد خطا	شرح
rateLimitExceeded	درخواست‌های زیادی در بازه زمانی مشخصی ارسال شده است.

INTERNAL_SERVER_ERROR (500)

کد خطا	شرح
internalError	درخواست به‌دلیل خطای داخلی انجام نشد.

NOT_IMPLEMENTED (501)

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

SERVICE_UNAVAILABLE (503)

کد خطا	شرح
backendError	خطای زیرینه روی داد.
backendNotConnected	درخواست به‌دلیل خطای اتصال ناموفق بود.
notReady	سرور میانای برنامه‌سازی کاربردی برای پذیرش درخواست‌ها آماده نیست.