الأخطاء
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
حدث خطأ في الطلبات المقدَّمة إلى واجهة برمجة تطبيقات إدارة عرض السعر والتي لا يمكن إكمالها
. يجب تحليل رسائل الخطأ والتعامل معها بشكل مناسب لتجنب
الأخطاء المستقبلية. الطلبات التي تعرض أخطاء تستهلك حصة المستخدم ومعدلات الأخطاء
التي يجب مراعاتها عند مراجعة طلبات الحصول على حصة إضافية.
تكون استجابة الخطأ بالتنسيق التالي وتتضمن رمز استجابة HTTP،
ورسالة خطأ وحالة رمز RPC من Google:
{
"error": {
"code": integer,
"message": string,
"status": enum (google.rpc.Code)
}
}
في ما يلي قائمة بالأخطاء الشائعة في واجهة برمجة التطبيقات بالإضافة إلى الإجراء الموصى به في حالة
ويتم إرجاعها:
الإجراءات المقترَحة لرمز الخطأ واستدعاء إجراء عن بُعد (RPC) |
400 INVALID_ARGUMENT
|
ثمة مشكلة في طلبك.
راجِع حقل الرسالة في استجابة الخطأ وعدِّل طلبك.
وفقًا لذلك.
إذا كنت تواجه مشاكل في العثور على
مجموعة مقبولة من الفلاتر والأبعاد والمقاييس، يرجى الرجوع إلى
أفضل خيار لإعداد التقارير
الممارسات للحصول على اقتراحات. |
401 UNAUTHENTICATED
|
تعذّر تقديم طلبك بشكل صحيح
تمت مصادقته. يُرجى التحقق من تضمين بيانات اعتماد OAuth صالحة في
طلبك. لمزيد من المعلومات، يُرجى الاطّلاع على
البدء
الدليل. |
404 NOT_FOUND
|
تشير رسالة الأشكال البيانية
Query
أو
Report
الذي تحاول تشغيله أو استرداده لا يمكن العثور عليه. التحقق من
التالي:
|
429 RESOURCE_EXHAUSTED
|
لقد تجاوزت
حصة طلبات واجهة برمجة التطبيقات أو
حصة إعداد التقارير.
اقرأ رسالة الخطأ لتحديد نوع الحصة التي تتجاوزها:
|
500 INTERNAL
|
حدث خطأ داخلي في واجهة برمجة التطبيقات. يمكنك استخدام
دالة أسّية
استراتيجية التعامل مع أخطاء التراجع للانتظار وإعادة محاولة الطلب. إذا كانت
استمرار حدوث الخطأ، contact
والدعم |
504 DEADLINE_EXCEEDED
|
استغرقت واجهة برمجة التطبيقات وقتًا طويلاً جدًا لإكمال
طلبك. يمكنك استخدام
دالة أسّية
استراتيجية التعامل مع أخطاء التراجع للانتظار وإعادة محاولة الطلب. إذا كانت
استمرار حدوث الخطأ، contact
والدعم |
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-08-31 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-31 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eBid Manager API request errors impact user quota and can be avoided by properly handling error messages.\u003c/p\u003e\n"],["\u003cp\u003eError responses provide specific codes, messages, and statuses to help diagnose and resolve issues.\u003c/p\u003e\n"],["\u003cp\u003eCommon errors include invalid arguments, authentication failures, resource exhaustion, and internal server errors.\u003c/p\u003e\n"],["\u003cp\u003eRecommended actions for common errors involve reviewing the request, verifying credentials, and adjusting API usage.\u003c/p\u003e\n"],["\u003cp\u003ePersistent errors after implementing recommended actions necessitate contacting support for further assistance.\u003c/p\u003e\n"]]],[],null,["# Errors\n\nRequests made to the Bid Manager API that can't be completed return an error\nmessage. Error messages should be parsed and appropriately handled to avoid\nfuture errors. Requests returning errors consume user quota, and error rates\nare considered when reviewing requests for additional quota.\n\nAn error response has the following format and includes an HTTP response code,\nan error message, and a [Google RPC code](//cloud.google.com/apis/design/errors#handling_errors) status: \n\n```gdscript\n{\n \"error\": {\n \"code\": integer,\n \"message\": string,\n \"status\": enum (google.rpc.Code)\n }\n}\n```\n\nHere's a list of common API errors along with the recommended action to take if\nthey are returned:\n| **Note:** If the error persists even after taking the recommended action, [contact\n| support](/bid-manager/support/contact) to report the issue.\n\n| Recommended Actions for error code and RPC ||\n|----------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `400` `INVALID_ARGUMENT` | There's an issue with your request. Review the message field in the error response, and modify your request accordingly. If you are experiencing issues with finding an acceptable combination of filters, dimensions, and metrics, refer to our [reporting best practices](/bid-manager/guides/general/best-practices) for recommendations. |\n| `401` `UNAUTHENTICATED` | Your request couldn't be properly authenticated. Verify that you are including valid OAuth credentials in your request. For more information, see the [Get Started guide](/bid-manager/guides/get-started/overview). |\n| `404` `NOT_FOUND` | The [`Query`](/bid-manager/reference/rest/current/queries#Query) or [`Report`](/bid-manager/reference/rest/current/queries.reports#Report) you are attempting to run or retrieve cannot be found. Verify the following: - The resource ID is correct - The resource type is valid for the endpoint - The resource in question was [created by the accessing user](/bid-manager/guides/general/best-practices#build_new_reports_in_the_ui_first) |\n| `429` `RESOURCE_EXHAUSTED` | You have exceeded either your [API request quota](/bid-manager/quotas) or [reporting quota](/bid-manager/guides/general/best-practices#consider_reporting_quotas). Read the error message to determine what type of quota you are exceeding: - API request quota: Examine your API usage using the [Google Cloud Console](//console.developers.google.com/project/_/apiui/apiview/doubleclickbidmanager.googleapis.com/metrics), and modify your workflow to operate within the existing quota limits. If your operations can't be completed within your given daily quota, [request additional quota](/bid-manager/quotas#additional_quota). - Reporting quota: Review [existing reporting quota best practices](/bid-manager/guides/general/best-practices#consider_reporting_quotas) and reach out to [Display \\& Video 360 product support](//support.google.com/displayvideo/contact/nghelp_contact_form) if needed. |\n| `500` `INTERNAL` | The API experienced an internal error. Use the [exponential backoff error handling strategy](/bid-manager/guides/general/best-practices#exponential_backoff) to wait and retry the request. If the error persists, [contact support](/bid-manager/support/contact). |\n| `504` `DEADLINE_EXCEEDED` | The API took too long to complete the request. Use the [exponential backoff error handling strategy](/bid-manager/guides/general/best-practices#exponential_backoff) to wait and retry the request. If the error persists, [contact support](/bid-manager/support/contact). |"]]