- طلب 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[] |
يصف أعمدة السمات. يتطابق عدد DimensionHeaders وترتيب DimensionHeaders مع السمات الموجودة في الصفوف. |
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 |
إذا كانت القيمة "صحيح"، يشير ذلك إلى أنّه تم إدراج بعض مجموعات مجموعات السمات في "(غير ذلك)". الصف. ويمكن أن يحدث ذلك في التقارير التي تتضمّن عددًا كبيرًا من القيم. تتم تعبئة مَعلمة البيانات الوصفية 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 . |