اعتبارًا من 8 سبتمبر 2025، يجب أن يحدّد كل عنصر جديد في الحملة ما إذا كان سيعرض إعلانات سياسية في الاتحاد الأوروبي أم لا. ستتعذّر عمليات تحميل واجهة برمجة التطبيقات "مساحة العرض والفيديو 360" وملفات SDF التي لا تقدّم بيانات الإفصاح. يمكنك الاطّلاع على صفحة الإيقاف النهائي لمزيد من التفاصيل حول كيفية تعديل عملية الدمج لإجراء هذا البيان.
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تحمي حدود الاستخدام بنية Google الأساسية من العمليات المبرمَجة التي تستخدم
واجهة برمجة التطبيقات في "مساحة العرض والفيديو 360 " بطريقة غير ملائمة. تضمن هذه الإجراءات عدم تأثُّر المنتدى بأكمله سلبًا بأحد مطوّري البرامج.
حدود حصص طلبات البيانات من واجهة برمجة التطبيقات
تستخدِم Display & Video 360 API نوعَين من الحدود:
إجمالي حدود الحصة، التي يتم احتساب جميع الطلبات ذات الصلة بها.
حدود الحصة للكتابة، والتي يتم احتساب جميع الطلبات ذات الصلة التي تم إجراؤها لكتابة الطرق
ضدها يتم تعريف طرق الكتابة على أنّها طرق تعدّل الموارد، مثل create أو
patch أو delete أو bulkEdit. يُرجى العِلم أنّ بعض methods تستهلك حصة كتابة أكبر من غيرها.
طلبات الكتابة في الدقيقة لكلّ معلِن لكلّ مشروع:150
الطرق التي تعتمد على الكتابة بشكل كبير
تُستخدم طرق واجهة برمجة التطبيقات التالية بشكل مكثّف في عمليات الكتابة، ما يعني أنّها تستخدِم
كمية كبيرة من موارد المنتجات، وبالتالي تستهلك
حصة أكبر من طلبات الكتابة مقارنةً بطلبات الكتابة الأخرى.
يتم احتساب الطلبات المقدَّمة إلى الطرق التي تتطلّب الكثير من عمليات الكتابة على أنّها 5 طلبات بحث لعمليات الكتابة
عند احتساب استهلاك حصة طلبات الكتابة. على سبيل المثال، إذا تم إرسال 100 طلب كتابة عادي و21 طلبًا مكثّفًا للكتابة (لا يحدّد أيّ منها المعلِن) في غضون دقيقة، سيتم احتساب ذلك على أنّه 205 طلبات كتابة (100 + (21 * 5) =
205) وسيتجاوز الحدّ الأقصى الحالي لحصة الطلبات العامة التي تبلغ 200 طلب كتابة في الدقيقة.
في حال تعذّر إكمال طلبك بسبب تجاوز الحدّ الأقصى لطلبات واجهة برمجة التطبيقات، تعرض واجهة برمجة التطبيقات رمز حالة HTTP وسبب الخطأ.
بالإضافة إلى ذلك، يحتوي نص الاستجابة على وصف مفصّل لسبب
حدوث الخطأ.
تعرض القائمة التالية الأخطاء المحتملة والإجراءات المقترَحة عند عدم نجاح الطلبات بسبب تجاوز حدود طلبات البيانات من واجهة برمجة التطبيقات.
الرمز
متوسط عائد النقرة
الرسالة
الإجراء المقترَح
429
RESOURCE_EXHAUSTED
تم
استنفاد
المورد
(مثلاً، التحقّق من
الحصة).
راجِع معدّل الاستخدام
من Google API Console و
عدِّل سير العمل لتتم بدرجةٍ أفضل
مزامنة الطلبات المقدَّمة ضمن حساب معلِنين مختلفين أو بشكلٍ عام، يمكنك تقليل معدّل إرسال الطلبات.
لا يمكن طلب زيادة حدود حصة واجهة برمجة التطبيقات Display & Video 360 API.
تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eDisplay & Video 360 API usage is subject to quota limits to protect Google's infrastructure and ensure fair usage.\u003c/p\u003e\n"],["\u003cp\u003eTwo main quota types exist: total requests and write requests (methods modifying resources), with limits applied per project and per advertiser per project.\u003c/p\u003e\n"],["\u003cp\u003eCertain write-intensive methods consume more write quota than others.\u003c/p\u003e\n"],["\u003cp\u003eExceeding quota limits can lead to request throttling, indicated by a 429 error code, requiring adjustments to request frequency.\u003c/p\u003e\n"],["\u003cp\u003eQuota limit increases for the Display & Video 360 API are not available.\u003c/p\u003e\n"]]],[],null,["# Usage Limits\n\nUsage limits protect Google's infrastructure from automated processes that use\nthe Display \\& Video 360 API in an inappropriate way. They ensure that one developer's\nactions can't negatively impact the larger community.\n\nAPI request quota limits\n------------------------\n\nThe Display \\& Video 360 API uses two types of limits:\n\n- **Total quota limits**, which all relevant requests count against.\n- **Write quota limits** , which all relevant requests made to write methods count against. Write methods are defined as methods---such as `create`, `patch`, `delete`, or `bulkEdit`---that modify resources. Note that [some\n methods](#write_intensive) consume more write quota than others.\n\nIf your project exceeds any of these limits, [throttling could\noccur](#exceeding_limits).\n\n### Project-wide quota limit\n\nThe following default quota limits are shared by all Display \\& Video 360 API resources\nand methods:\n\n- **Total requests per minute per project:** `1500`\n- **Write requests per minute per project:** `700`\n\n### Advertiser-specific request quota limits\n\nMethods that specify an advertiser ID in the request URL count against\nadditional \"per advertiser per project\" quota limits.\n\nAll requests with an advertiser ID specified in their URL path---such as\nthose to the [`advertisers.lineItems`](/display-video/api/reference/rest/current/advertisers.lineItems),\n[`advertisers.creatives`](/display-video/api/reference/rest/current/advertisers.creatives), or\n[`advertisers.channels`](/display-video/api/reference/rest/current/advertisers.channels) services---will count against\nthe following quota limits:\n\n- **Total requests per minute per advertiser per project:** `300`\n- **Write requests per minute per advertiser per project:** `150`\n\nWrite-intensive methods\n-----------------------\n\nThe following API methods are write-intensive, meaning that they use a\nsignificant amount of product resources and, as a result, consume more\nwrite request quota than other write requests.\n\nRequests made to write-intensive methods are counted as 5 write queries\nwhen computing write request quota consumption. For example, 100 standard write\nrequests and 21 write-intensive requests (none of which specify an advertiser)\nmade within a minute would be counted as 205 write queries (`100 + (21 * 5) =\n205`) and would exceed the existing general request quota limit of 200 write\nqueries per minute.\n\nThe following methods are considered write-intensive:\n\n- [`customBiddingAlgorithms.scripts.create`](/display-video/api/reference/rest/current/customBiddingAlgorithms.scripts/create)\n- [`customBiddingAlgorithms.uploadScript`](/display-video/api/reference/rest/current/customBiddingAlgorithms/uploadScript)\n- [`firstPartyAndPartnerAudiences.create`](/display-video/api/reference/rest/current/firstPartyAndPartnerAudiences/create)\n- [`firstPartyAndPartnerAudiences.editCustomerMatchMembers`](/display-video/api/reference/rest/current/firstPartyAndPartnerAudiences/editCustomerMatchMembers)\n- [`media.upload`](/display-video/api/reference/rest/current/media/upload)\n\nExceeding quota limits\n----------------------\n\nIn the unlikely event that your request fails due to exceeding an API request\nlimit, the API returns an HTTP status code and reason for the error.\nAdditionally, the body of the response contains a detailed description of what\ncaused the error.\n\nThe following list shows the possible errors and recommended actions for\nrequest failures caused by exceeding API request limits.\n\n| Code | RPC | Message | Recommended Action |\n|-------|----------------------|--------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `429` | `RESOURCE_EXHAUSTED` | Resource has been exhausted (e.g., check quota). | [Examine your usage](//console.developers.google.com/project/_/apiui/apiview/displayvideo.googleapis.com/metrics) from the Google API Console and modify your workflow to better parallelize requests made under different advertisers or more generally slow down the rate at which you are sending requests. |\n\nIncreases cannot be requested for Display \\& Video 360 API quota limits."]]
