- طلب HTTP
- مَعلمات المسار
- نص الطلب
- نص الاستجابة
- نطاقات التفويض
- ResponseMetaData
- SchemaRestrictionResponse
- ActiveMetricRestriction
- RestrictedMetricType
- جرِّبه الآن
استرداد محتوى مهمة التقرير بعد طلب reportTasks.create
، يمكنك استرداد محتوى التقرير بعد أن يصبح "نشطًا". ستعرض هذه الطريقة خطأ إذا لم تكن حالة مهمة التقرير ACTIVE
. وستعرض استجابة طلب البحث قيم الصفوف والأعمدة الجدولية للتقرير.
طلب HTTP
POST https://analyticsdata.googleapis.com/v1alpha/{name=properties/*/reportTasks/*}:query
يستخدم عنوان URL بنية تحويل الترميز gRPC.
معلمات المسار
المَعلمات | |
---|---|
name |
مطلوبة. اسم مصدر التقرير تنسيق الملف: |
نص الطلب
يحتوي نص الطلب على بيانات بالبنية التالية:
تمثيل JSON |
---|
{ "offset": string, "limit": string } |
الحقول | |
---|---|
offset |
اختياريّ. عدد الصفوف لصف البداية في التقرير. يتم احتساب الصف الأول على أنه الصف 0. عند إجراء التقسيم على صفحات، لا يحدد الطلب الأول الإزاحة، أو ما يعادله، يعمل على ضبط الإزاحة على 0، يعرض الطلب الأول أول لمزيد من المعلومات عن مَعلمة التقسيم على صفحات هذه، اطّلِع على تقسيم النتائج على عدّة صفحات. |
limit |
اختياريّ. عدد الصفوف المطلوب عرضها من التقرير. وفي حال عدم تحديد قيمة، يتم عرض 10,000 صف. تعرض واجهة برمجة التطبيقات 250,000 صف كحد أقصى لكل طلب، بغض النظر عن العدد الذي تطلبه. يجب أن تكون قيمة الحقل " ويمكن أن تعرِض واجهة برمجة التطبيقات أيضًا صفوفًا أقل من قيمة لمزيد من المعلومات عن مَعلمة التقسيم على صفحات هذه، اطّلِع على تقسيم النتائج على عدّة صفحات. |
نص الاستجابة
محتوى التقرير المقابل لمهمة تقرير
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل JSON |
---|
{ "dimensionHeaders": [ { object ( |
الحقول | |
---|---|
dimensionHeaders[] |
لوصف أعمدة الأبعاد. يتطابق عدد أبعاد الأبعاد وترتيب أبعادها مع السمات الموجودة في الصفوف. |
metricHeaders[] |
لوصف أعمدة المقاييس. يتطابق عدد MetricHeaders وترتيبها MetricHeaders في المقاييس الموجودة في الصفوف. |
rows[] |
صفوف مجموعات قيم السمات وقيم المقاييس في التقرير |
totals[] |
القيم الإجمالية للمقاييس عند طلبها. |
maximums[] |
الحد الأقصى لقيم المقاييس، عند الطلب. |
minimums[] |
تمثّل هذه السمة الحد الأدنى لقيم المقاييس، عند الطلب. |
rowCount |
إجمالي عدد الصفوف في نتيجة طلب البحث. |
metadata |
البيانات الوصفية للتقرير. |
نطاقات التفويض
يتطلب استخدام أحد نطاقات OAuth التالية:
https://www.googleapis.com/auth/analytics.readonly
https://www.googleapis.com/auth/analytics
ResponseMetaData
البيانات الوصفية للردّ التي تتضمّن معلومات إضافية عن محتوى التقرير
تمثيل JSON |
---|
{
"dataLossFromOtherRow": boolean,
"schemaRestrictionResponse": {
object ( |
الحقول | |
---|---|
dataLossFromOtherRow |
إذا كانت القيمة صحيحة، يشير ذلك إلى أنّه يتمّ تضمين بعض مجموعات مجموعات السمات في الصف "(other)". وقد يحدث ذلك في التقارير التي تتضمّن عددًا كبيرًا من القيم. تتم تعبئة بيانات مَعلمة البيانات الوصفية dataLossFromOtherRow استنادًا إلى جدول البيانات المجمَّعة المستخدَمة في التقرير. ستتمّ تعبئة المَعلمة بدقة بغضّ النظر عن الفلاتر والقيود الواردة في التقرير. على سبيل المثال، يمكن حذف الصف (other) من التقرير لأنّ الطلب يحتوي على فلتر في sessionSource = google. ستتم تعبئة هذه المَعلمة في حال عدم ظهور بيانات من صف آخر ضمن البيانات المجمّعة التي تم إدخالها لإنشاء هذا التقرير. لمزيد من المعلومات، يُرجى الاطّلاع على المقالة لمحة عن صف (other) وتحليل عينات البيانات. |
schemaRestrictionResponse |
يصِف هذا القسم قيود المخطط التي تم فرضها بشكل نشط أثناء إنشاء هذا التقرير. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة إدارة أذونات الوصول والقيود المفروضة على البيانات. |
currencyCode |
رمز العملة المستخدَمة في هذا التقرير. مخصّصة للاستخدام في تنسيق مقاييس العملات، مثل رموز العملات هي ترميزات سلاسل لأنواع العملات وفقًا لمعيار ISO 4217 (https://en.wikipedia.org/wiki/ISO_4217)، على سبيل المثال USD وEUR وJPY. لمعرفة المزيد من المعلومات، يُرجى الاطّلاع على https://support.google.com/analytics/answer/9796179. |
timeZone |
تشير هذه السمة إلى المنطقة الزمنية الحالية للموقع. مخصَّصة لتفسير السمات المستندة إلى الوقت، مثل |
emptyReason |
إذا تم تحديد سبب فارغ، يكون التقرير فارغًا لهذا السبب. |
subjectToThresholding |
إذا كانت |
SchemaRestrictionResponse
تم فرض قيود المخطط بشكل نشط أثناء إنشاء هذا التقرير. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة إدارة أذونات الوصول والقيود المفروضة على البيانات.
تمثيل JSON |
---|
{
"activeMetricRestrictions": [
{
object ( |
الحقول | |
---|---|
activeMetricRestrictions[] |
تم فرض جميع القيود بشكلٍ نشط أثناء إنشاء التقرير. على سبيل المثال، يكون نوع التقييد |
ActiveMetricRestriction
أحد المقاييس محظور بشكل نشط في إنشاء التقرير.
تمثيل JSON |
---|
{
"restrictedMetricTypes": [
enum ( |
الحقول | |
---|---|
restrictedMetricTypes[] |
سبب تقييد هذا المقياس. |
metricName |
اسم المقياس المحظور. |
RestrictedMetricType
فئات البيانات التي قد يُحظر عليك الاطّلاع عليها في مواقع معيّنة على "إحصاءات Google 4"
عمليات التعداد | |
---|---|
RESTRICTED_METRIC_TYPE_UNSPECIFIED |
نوع غير محدَّد. |
COST_DATA |
مقاييس التكلفة مثل adCost |
REVENUE_DATA |
مقاييس الأرباح مثل purchaseRevenue |