تنطبق الحدود والحصص التالية على Data API.
كيفية تطبيق الحصص
تتطلّب جميع الطلبات إلى الإصدار 1 من Google Analytics Data API مشروعًا على Google Cloud، وتخضع للحصص الموضّحة في هذه الصفحة. يتم استهلاك الحصص بغض النظر عن الطريقة المستخدَمة لتحديد المشروع الذي يتم إجراء المكالمة منه، بما في ذلك:
- الطلبات التي تمت المصادقة عليها باستخدام بيانات اعتماد OAuth 2.0
- الطلبات التي تتم المصادقة عليها باستخدام مفتاح واجهة برمجة تطبيقات فقط
تُستخدَم مفاتيح واجهة برمجة التطبيقات لربط طلب بمشروع معيّن على Google Cloud لأغراض الحصة والفوترة. سيتم احتساب جميع طلبات البيانات من واجهة برمجة التطبيقات التي يتم إجراؤها باستخدام بيانات الاعتماد أو مفتاح واجهة برمجة التطبيقات من مشروعك ضمن الحصص السارية على مشروعك وموقع "إحصاءات Google".
فئات الحصص
تتضمّن Data API أربع فئات لحصة الطلبات: الأساسية، والوقت الفعلي، ومسار الإحالة الناجحة، وChat.
تفرض طلبات البيانات من واجهة برمجة التطبيقات إلى طرق Core رسومًا على حصص Core. تفرض طلبات البيانات من واجهة برمجة التطبيقات إلى طرق Realtime رسومًا على حصص Realtime. تفرض طلبات واجهة برمجة التطبيقات إلى طرق Funnel رسومًا على حصص Funnel. تفرض طلبات البيانات من واجهة برمجة التطبيقات إلى طرق Chat رسومًا على حصص Chat. يستهلك كل طلب نوعًا واحدًا فقط من الحصة.
| فئة الحصة | طُرق واجهة برمجة التطبيقات |
|---|---|
| التعريف | runReport وrunPivotReport وbatchRunReports وbatchRunPivotReports وrunAccessReport وgetMetadata وcheckCompatibility وcreateAudienceExports |
| الوقت الفعلي | runRealtimeReport |
| مسار الإحالة الناجحة | runFunnelReport |
| محادثة | properties.chat |
حصص مواقع "إحصاءات Google"
تستهلك جميع الطلبات حصص الموقع.
| اسم الحصة | الحدّ الأقصى للموقع العادي | الحدّ الأقصى لعدد مواقع "إحصاءات 360" |
|---|---|---|
| الرموز المميزة الأساسية لكل موقع في اليوم | 200000 | 2,000,000 |
| الرموز المميزة الأساسية لكل موقع في الساعة | 40,000 | 400,000 |
| الرموز المميزة الأساسية لكل مشروع ولكل موقع في الساعة | 14,000 | 140,000 |
| الطلبات المتزامنة الأساسية لكل موقع | 10 | 50 |
| أخطاء الخادم الأساسية لكل مشروع ولكل موقع ولكل ساعة | 10 | 50 |
| الرموز المميّزة في الوقت الفعلي لكل موقع في اليوم | 200000 | 2,000,000 |
| الرموز المميّزة في الوقت الفعلي لكل موقع في الساعة | 40,000 | 400,000 |
| الرموز المميّزة في الوقت الفعلي لكل مشروع ولكل موقع ولكل ساعة | 14,000 | 140,000 |
| الطلبات المتزامنة في الوقت الفعلي لكل موقع | 10 | 50 |
| أخطاء الخادم في الوقت الفعلي لكل مشروع ولكل موقع ولكل ساعة | 10 | 50 |
| الرموز المميّزة للمسار التحويلي لكل موقع في اليوم | 200000 | 2,000,000 |
| رموز مسار الإحالة الناجحة المميزة لكل موقع في الساعة | 40,000 | 400,000 |
| رموز مميّزة للمسار الإحالي لكل مشروع ولكل موقع في الساعة | 14,000 | 140,000 |
| طلبات مسار الإحالة الناجحة المتزامنة لكل موقع | 10 | 50 |
| أخطاء خادم المسار الإحالي لكل مشروع ولكل موقع ولكل ساعة | 10 | 50 |
| رموز المحادثة المميزة لكل موقع في اليوم | 3,750,000 | 3,750,000 |
| رموز المحادثة المميزة لكل موقع في الساعة | 500,000 | 500,000 |
- يتم قياس الطلبات المتزامنة من خلال عدد الطلبات التي يتم تنفيذها في الوقت نفسه. لتقليل عدد الطلبات المتزامنة، انتظِر إلى أن تكتمل الطلبات السابقة قبل إرسال طلبات إضافية.
- أخطاء الخادم هي الرمزان 500 و503. لا يتم تحصيل رسوم من حصص أخطاء الخادم إلا عندما يؤدي الطلب إلى حدوث خطأ في الخادم. عند استنفاد حصص Server Errors لزوج من المشاريع والمواقع، يتم حظر جميع الطلبات إلى الموقع من المشروع. للاطّلاع على قائمة كاملة بردود الأخطاء، يُرجى الرجوع إلى ردود الأخطاء.
- يستهلك كل طلب حصة من الرموز المميزة لكل موقع في الساعة ومن الرموز المميزة لكل مشروع لكل موقع في الساعة. وهذا يعني أنّه يجب أن يتم الوصول إلى موقع واحد من خلال أكثر من 3 مشاريع قبل أن يتم استنفاد حصة "الرموز المميزة لكل موقع في الساعة" قبل حصة "الرموز المميزة لكل مشروع ولكل موقع في الساعة".
يُسمح للمواقع بإرسال 120 طلبًا محتملاً يتم تحديد حدّه الأدنى كل ساعة. من المحتمل أن يتم وضع حدّ أدنى لعدد مرات الظهور للأبعاد userAgeBracket وuserGender وbrandingInterest وaudienceId وaudienceName. يتم تطبيق الحدود لمنع أي شخص يشاهد التقرير من استنتاج الخصائص الديموغرافية أو الاهتمامات للمستخدمين الفرديين.
حصة الرموز المميّزة للموقع
يتم استهلاك الرموز المميّزة مع كل طلب يتم إرساله إلى الإصدار 1 من Google Analytics Data API.
يعتمد عدد الرموز المميزة التي يتم تحصيل رسومها على مدى تعقيد الطلب. مع أنّ معظم الطلبات ستفرض رسومًا بقيمة 10 رموز مميّزة أو أقل، ستستهلك الطلبات الأكثر تعقيدًا (مثل طلبات البحث في chat"مستشار إحصاءات Google") المزيد من الرموز.
العوامل التي تؤثر في استهلاك الرموز المميزة
يتم تحديد التكلفة الدقيقة للرمز المميز لكل طلب في وقت التنفيذ، ما يجعل عملية الحساب المسبق الدقيق أمرًا صعبًا. تتأثر التكلفة بمجموعة من العوامل المتعلقة بالطلب نفسه والبيانات الأساسية في الموقع على "إحصاءات Google". يمكن أن تؤدي هذه العوامل إلى ارتفاع التكاليف:
- عدد الصفوف: طلب عدد أكبر من الصفوف
- عدد السمات والمقاييس: يتضمّن عددًا أكبر من السمات والمقاييس.
- تعقيد الفلتر: استخدام تعبيرات فلتر معقّدة
- مدة النطاق الزمني: البحث في فترات زمنية أطول
- عدد القيم الفريدة للسمة في البيانات: يمكن أن تؤدي السمات التي تتضمّن عددًا كبيرًا من القيم الفريدة (مثل
pagePathوالسمات المخصّصة) إلى زيادة تكلفة الرموز المميزة بشكل كبير. - عدد أحداث الموقع: قد تستهلك طلبات البحث في المواقع التي تتضمّن عددًا أكبر من الأحداث رموزًا مميّزة أكثر من طلب البحث نفسه في موقع يتضمّن بيانات أقل.
مراقبة استخدام الرموز المميزة
إنّ الطريقة الأكثر فعالية لتحديد تكلفة الرموز المميزة لطلبات البيانات المحدّدة من واجهة برمجة التطبيقات
هي تضمين المَعلمة "returnPropertyQuota": true في نص الطلب.
سيتضمّن ردّ واجهة برمجة التطبيقات بعد ذلك الكائن PropertyQuota الذي يوضّح بالتفصيل الرموز المميّزة المستخدَمة في هذا الطلب المحدّد وأرصدة الحصة المتبقية.
استخدام الرموز المميزة في المحادثة وتتبُّعها
بالنسبة إلى طلبات chat من "مستشار إحصاءات Google"، تمثّل الرموز المميّزة تكاليف العمليات الحسابية التي يجريها النموذج، والاستدلال، واسترداد البيانات الأساسية. يتأثر استهلاك الرموز المميزة في Chat بما يلي:
- نطاق طلب البحث والتحليل: يشير إلى مدى تعقيد التحليل المطلوب ونطاقه.
- رموز الإدخال والإخراج في النموذج: حجم البيانات السياقية التي تتم معالجتها وسرد الاستجابة الذي يتم إنشاؤه
- رموز التفكير: خطوات الاستدلال التي يتطلّبها النموذج لتجميع النتائج
- وقت استجابة التنفيذ: وقت المعالجة المطلوب لاستكشاف البيانات المتعددة الخطوات.
لمراقبة استخدام الرموز المميزة في المحادثة، اضبط "returnPropertyQuota": true في ChatRequest. سيتضمّن الردّ عنصر PropertyChatQuota الذي يحتوي على الحقلَين tokensPerDay وtokensPerHour اللذين يتضمّنان الرصيد المستخدَم والمتبقّي.