الحدود

تعرض هذه الصفحة حصصًا وحدودًا مختلفة خاصة بواجهة برمجة تطبيقات AdSense Management. وتسري هذه القيود بالإضافة على أي حدود خاصة بالمنتجات (مثل عدد القنوات لكل حساب) والتي تنطبق على AdSense بشكل عام.

الحصص على مستوى واجهة برمجة التطبيقات

يتم احتساب جميع الطلبات المُرسَلة إلى AdSense Management API ضمن حصص معدّلات الطلبات العامة، بغض النظر عن نوع الطلب.

يمكنك عرض استخدامك الحالي لأي من هذه الحصص من خلال الانتقال إلى صفحة الحصص في وحدة التحكم في Google API. يمكنك أيضًا إعداد تنبيه بالاستخدام أو مراقبة إضافية، ويمكنك الاطّلاع على المستندات العامة حول حصص Google Cloud لمعرفة مزيد من المعلومات.

سيؤدي تجاوز هذه الحصص إلى رفض الطلب مع عرض رسالة الخطأ HTTP 429 "عدد الطلبات كبير جدًا". ستتضمّن رسالة الخطأ تفاصيل حول الحصة التي تم تجاوزها.

الوصف القيمة Notes
الطلبات في الدقيقة لمستخدم واحد ومشروع 100 timing fixed in amara
الطلبات في الدقيقة لجميع المستخدمين الذين يستخدمون مشروعًا واحدًا 500 timing fixed in amara
الطلبات في اليوم 10,000 تتم إعادة ضبط الحصص اليومية في منتصف الليل تقريبًا بتوقيت المحيط الهادئ.

الحدود القصوى لحجم التقرير

يعتمد الحد الأقصى لحجم التقارير التي تم إنشاؤها بواسطة AdSense Management API على تنسيق الناتج:

  • يمكن أن تتضمّن تقارير JSON (على سبيل المثال، التي يتم إنشاؤها باستخدام accounts.reports.generate) ما لا يزيد عن 100,000 صف. سيتم اقتطاع التقارير التي يزيد حجمها عن هذا الحقل، إلا أنّ الاستجابة تتضمّن حقل totalMatchedRows يتضمّن حجم التقرير الكامل، والذي يمكن استخدامه لتحديد ما إذا كان القطع قد حدث أم لا.
  • تقتصر تقارير ملف CSV (على سبيل المثال، كما يتم إنشاؤها باستخدام accounts.reports.generateCsv) على 1,000,000 صف كحدٍّ أقصى. سيتم اقتطاع التقارير التي يزيد حجمها عن هذه القيمة.

حصة صفوف التقرير

وتطبِّق واجهة برمجة التطبيقات AdSense Management API أيضًا حدودًا على إجمالي حجم بيانات إعداد التقارير التي يمكن استردادها على مدار فترات يومية وأقصر، وذلك لمنع الاستخدام المسيء. سيؤدي تجاوز هذه الحدود إلى رفض الطلب مع ظهور رسالة الخطأ HTTP 429 "عدد كبير جدًا من الطلبات" مع ظهور رسالة مرتبطة مفادها "تم تجاوز حصة صف التقرير".

الحدود القصوى للطلبات الأخرى

تتحكّم معلَمات الطلب المختلفة في مقدار البيانات التي يجب عرضها لأحد الطلبات (مثل page_size للطلبات التي تتيح التقسيم على صفحات أو المعلَمة limit لطلبات إنشاء التقارير). إذا لم يتم تحديد هذه المَعلمات، تكون القيمة التلقائية دائمًا هي القيمة القصوى المسموح بها. سيؤدي تحديد قيمة أعلى إلى رفض الطلب مع عرض رسالة الخطأ "طلب غير صالح HTTP 400".