الحدود القصوى للاستخدام
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يفرض هذا الإصدار من Google Search Console API حدود الاستخدام التالية:
إحصاءات البحث
تنقسم حصة "إحصاءات البحث" إلى نوعَين: حدود التحميل وحدود الطلبات في الثانية. تكون رسالة الخطأ "تم تجاوز الحصّة" هي نفسها لجميع الأحداث التي تم تجاوزها.
حصة التحميل
يمثّل الحقل تحميل الموارد الداخلية التي يستهلكها طلب بحث. لن يتجاوز معظم المستخدمين حدود التحميل، ولكن في حال إجراء ذلك، ستظهر لك رسالة خطأ تم تجاوز الحصة المحدّدة. يفرض مورد إحصاءات البحث حدود التحميل التالية:
- حصة التحميل قصيرة المدى: يتم قياس الحصة قصيرة المدى في مقاطع مدّتها 10 دقائق. لحلّ هذه المشكلة:
- إذا تجاوزت حصتك، انتظِر لمدة 15 دقيقة ثم أعِد المحاولة. إذا كنت لا تزال تتجاوز الحصة، يعني ذلك أنّك تتجاوز الحصة طويلة الأجل.
- وإذا كنت تتجاوز الحصة قصيرة الأجل فقط، انشر طلبات البحث على مدار اليوم.
- حصة التحميل طويلة المدى: يتم قياس الحصة طويلة المدى في أجزاء مدّتها يوم واحد. إذا تجاوزت الحصة المحدّدة عند تنفيذ طلب بحث واحد فقط خلال فترة 10 دقائق، يعني ذلك أنّك تجاوزت الحصة طويلة الأجل. لحلّ هذه المشكلة:
- تكون طلبات البحث باهظة الثمن عند التجميع و/أو الفلترة حسب الصفحة أو سلسلة طلب البحث. إنّ طلبات البحث المجمّعة/التي تتم فلترتها حسب الصفحة وسلسلة طلب البحث هي الأكثر تكلفة. لتقليل الحمل على طلبات البحث هذه، عليك إزالة مجموعة و/أو فلترة الصفحة و/أو طلب البحث.
- يزداد تحميل طلب البحث مع زيادة النطاق الزمني الذي تم البحث عنه. لذا فإن الاستعلامات التي لها نطاق ستة أشهر تكون أكثر تكلفة بكثير من استعلام بنطاق يوم واحد.
- تجنَّب إعادة الاستعلام عن البيانات نفسها (على سبيل المثال، إجراء طلبات بحث عن جميع بيانات الشهر الماضي مرارًا وتكرارًا).
حصة الطلبات في الثانية
يفرض مورد إحصاءات البحث حدود QPM (طلبات البحث في الدقيقة) وQPD (طلبات البحث في اليوم) التالية:
- الحصة لكل موقع إلكتروني (الطلبات التي تستعلم عن الموقع الإلكتروني نفسه):
- الحصة لكل مستخدم (المكالمات التي يجريها المستخدم نفسه):
- الحصة لكل مشروع (المكالمات التي يتم إجراؤها باستخدام مفتاح Play Console نفسه):
- 30,000,000 QPD
- 40,000 QPM
مثال
- باستطاعة المستخدم "أ" جمع ما يصل إلى 1200 وحدة QPM إلى مواقعها الإلكترونية الثلاثة.
- يمكن للمستخدمين "أ" و"ب" الحصول على ما يصل إلى 1200 وحدة QPM مجمَّعة في موقعهم الإلكتروني الواحد.
فحص عنوان URL
حصة فحص الفهرس
- الحصة لكل موقع إلكتروني (الطلبات التي تستعلم عن الموقع الإلكتروني نفسه):
- الحصة لكل مشروع (المكالمات التي يتم إجراؤها باستخدام مفتاح Play Console نفسه):
- 10,000,000 QPD
- 15,000 QPM
جميع الموارد الأخرى
- الحد الأقصى المسموح به لكل مستخدم (المكالمات التي يجريها المستخدم نفسه):
- 20 طلب في الثانية
- 200 قيمة في الدقيقة
- الحد الأقصى لكل مشروع (المكالمات التي يتم إجراؤها باستخدام مفتاح Play Console نفسه):
لعرض حدود الاستخدام لمشروعك أو تغييرها، أو لطلب زيادة حصتك، عليك اتّباع الخطوات التالية:
- إذا لم يكن لديك حساب فوترة
لمشروعك، أنشئ واحدًا.
- انتقِل إلى صفحة واجهات برمجة التطبيقات التي تم تفعيلها في مكتبة واجهة برمجة التطبيقات في وحدة التحكم في واجهة برمجة التطبيقات، واختَر واجهة برمجة تطبيقات من القائمة.
- لعرض الإعدادات المتعلّقة بالحصة وتغييرها، اختَر الحصص. لعرض إحصاءات الاستخدام، انقر على الاستخدام.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2024-07-23 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2024-07-23 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThe Google Search Console API has usage limits for Search Analytics, URL inspection, and all other resources to ensure fair access.\u003c/p\u003e\n"],["\u003cp\u003eSearch Analytics usage is limited by short-term (10 minutes) and long-term (1 day) load quota, as well as QPS (queries per second), QPM (queries per minute) and QPD (queries per day) quota for per-site, per-user, and per-project usage.\u003c/p\u003e\n"],["\u003cp\u003eURL inspection is restricted by per-site and per-project quota based on QPM and QPD and has an index inspection quota.\u003c/p\u003e\n"],["\u003cp\u003eAll other resources have per-user and per-project limitations on QPS, QPM, and QPD.\u003c/p\u003e\n"],["\u003cp\u003eUsers can monitor their current API usage in the quota tab of their Google API Console project.\u003c/p\u003e\n"]]],["The Google Search Console API has usage limits for Search Analytics and URL inspection. Search Analytics has load and QPS limits; exceeding load quotas requires waiting 15 minutes or reducing query complexity (grouping/filtering, date range, re-querying). QPS limits are 1,200 QPM per site/user, and 30,000,000 QPD and 40,000 QPM per project. URL inspection has 2,000 QPD and 600 QPM per site, with project limits at 10,000,000 QPD and 15,000 QPM. All other resources have a per-user limit of 20 QPS and 200 QPM, and per-project of 100,000,000 QPD.\n"],null,["# Usage Limits\n\nThis version of the Google Search Console API enforces the following usage limits:\n\n*** ** * ** ***\n\nSearch Analytics\n----------------\n\nSearch Analytics quota falls in two types: load limits and QPS limits. The \"[quota exceeded](/webmaster-tools/v1/errors#error_quotaExceeded)\" error is the same for all quota exceeded events.\n\n### Load quota\n\n*Load* represents the internal resources consumed by a query. Most users will not exceed load limits, but if you do, you will receive a \"[quota exceeded](/webmaster-tools/v1/errors#error_quotaExceeded)\" error message. The [Search Analytics](/webmaster-tools/v1/searchanalytics) resource enforces the following load limits:\n\n- **Short-term load quota:** Short-term quota is measured in 10 minute chunks. **To fix:**\n - If you exceed your quota, wait 15 minutes and try again. If you still exceed quota, you are exceeding long-term quota.\n - If you are exceeding short-term quota only, spread out your queries throughout the day.\n- **Long-term load quota:** Long-term quota is measured in 1 day chunks. If you exceed quota when running only a single query inside a 10 minute period, you are exceeding your long-term quota. **To fix:**\n - Queries are expensive when you group and/or filter by either page or query string. Queries grouped/filtered by page AND query string are the most expensive. To reduce your load for these queries, remove the grouping and/or filtering for the page and/or query string.\n - Query load increases with the date range queried. So queries with a six month range are much more expensive than a query with a one day range.\n - Avoid requerying the same data (for example, querying all data for last month over and over).\n\n### QPS quota\n\nThe [Search Analytics](/webmaster-tools/v1/searchanalytics) resource enforces the following QPS (queries per second) QPM (queries per minute) and QPD (queries per day) limits:\n\n- **Per-site quota** (calls querying the same site):\n - 1,200 QPM\n- **Per-user quota** (calls made by the same user):\n - 1,200 QPM\n- **Per-project quota** (calls made using the same Developer Console key):\n - 30,000,000 QPD\n - 40,000 QPM\n\n*Example*\n\n- User A can make up to 1,200 QPM combined to her 3 websites.\n- Users A and B can make up to 1,200 QPM combined to their one website.\n\nURL inspection\n--------------\n\n- **index inspection quota**\n- **Per-site quota** (calls querying the same site):\n - 2000 QPD\n - 600 QPM\n- **Per-project quota** (calls made using the same Developer Console key):\n - 10,000,000 QPD\n - 15,000 QPM\n\nAll other resources\n-------------------\n\n- **Per-user limit** (calls made by the same user):\n - 20 QPS\n - 200 QPM\n- **Per-project limit** (calls made using the same Developer Console key):\n - 100,000,000 QPD\n\n*** ** * ** ***\n\nYou can see your current usage in the quota tab for your project in the [Google APIs Console](https://console.developers.google.com/project)."]]
