REST Resource: curators.reports

المورد: التقرير

مورد Report

تمثيل JSON
{
  "name": string,
  "reportId": string,
  "reportDefinition": {
    object (ReportDefinition)
  },
  "displayName": string,
  "updateTime": string,
  "createTime": string,
  "locale": string
}
الحقول
name

string

المعرّف. اسم مورد التقرير يجب أن يكون اسم مورد التقرير على النحو التالي: curators/{accountId}/reports/{reportId}

reportId

string (int64 format)

النتائج فقط. رقم تعريف التقرير

reportDefinition

object (ReportDefinition)

الحقل مطلوب. تعريف التقرير

displayName

string

اختيارية: الاسم المعروض للتقرير

updateTime

string (Timestamp format)

النتائج فقط. لحظة آخر تعديل لهذا التقرير

يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 0 أو 3 أو 6 أو 9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف Z. أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30"

createTime

string (Timestamp format)

النتائج فقط. اللحظة التي تم فيها إنشاء هذا التقرير

يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 0 أو 3 أو 6 أو 9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف Z. أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30"

locale

string

النتائج فقط. اللغة والمنطقة لهذا التقرير يتم ضبط الإعدادات المحلية من الإعدادات المحلية للمستخدم في وقت تقديم الطلب. لا يمكن تعديل اللغة.

ReportDefinition

تعريف كيفية تشغيل التقرير.

تمثيل JSON
{
  "dimensions": [
    enum (Dimension)
  ],
  "metrics": [
    enum (Metric)
  ],
  "filters": [
    {
      object (Filter)
    }
  ],
  "timeZoneSource": enum (TimeZoneSource),
  "timeZone": string,
  "currencyCode": string,
  "dateRange": {
    object (DateRange)
  },
  "sorts": [
    {
      object (Sort)
    }
  ]
}
الحقول
dimensions[]

enum (Dimension)

الحقل مطلوب. قائمة السمات المطلوب إعداد تقارير عنها إذا كان فارغًا، لن يتضمّن التقرير أي سمات، وستكون أي مقاييس إجمالية.

metrics[]

enum (Metric)

الحقل مطلوب. قائمة المقاييس المطلوب إعداد تقارير عنها إذا كان فارغًا، لن يتضمّن التقرير أي مقاييس.

filters[]

object (Filter)

اختيارية: الفلاتر لهذا التقرير

timeZoneSource

enum (TimeZoneSource)

اختيارية: مكان الحصول على المنطقة الزمنية لهذا التقرير يتم استخدام توقيت المحيط الهادئ (PT) تلقائيًا. إذا كان المصدر هو PROVIDED، يجب أيضًا ضبط منطقة زمنية في حقل timeZone في تعريف التقرير.

timeZone

string

اختيارية: إذا كانت قيمة timeZoneSource هي PROVIDED، فهذه هي المنطقة الزمنية التي يجب استخدامها لهذا التقرير. اترك الحقل فارغًا لأي مصدر آخر للمنطقة الزمنية. المنطقة الزمنية بتنسيق IANA على سبيل المثال، "America/New_York".

currencyCode

string

اختيارية: رمز العملة ISO 4217 لهذا التقرير يتم ضبط القيمة تلقائيًا على رمز عملة الحساب في حال عدم تحديد أي قيمة.

dateRange

object (DateRange)

الحقل مطلوب. النطاق الزمني الأساسي لهذا التقرير

sorts[]

object (Sort)

اختيارية: عمليات الترتيب التلقائية التي سيتم تطبيقها على هذا التقرير

السمة

سمات إعداد التقارير

عمليات التعداد
DIMENSION_UNSPECIFIED القيمة التلقائية هذه القيمة غير مستخدَمة.
ADVERTISER_DOMAIN نطاق المعلِن
COUNTRY الاسم المعروض لبلد معيّن
CURATION_DATA_SEGMENT_ID رقم تعريف شريحة البيانات التي أنشأها منسّق
CURATION_DATA_SEGMENT_RESPONSE_STATUS حالة الاستجابة لطلبات شرائح البيانات في ميزة "التنظيم في الوقت الفعلي" يُرجى الرجوع إلى https://developers.google.com/authorized-buyers/curation/get-started/start لمزيد من التفاصيل.
CURATION_DATA_SEGMENT_RESPONSE_STATUS_NAME الاسم المعروض المترجَم لحالة الردّ على طلبات شرائح البيانات في ميزة "التنظيم في الوقت الفعلي" يُرجى الرجوع إلى https://developers.google.com/authorized-buyers/curation/get-started/start لمزيد من التفاصيل.
CURATOR_FEE_TYPE نوع خدمة التنسيق (مثل الحزمة أو شريحة البيانات)
DATE التاريخ.
DEAL_ID رقم تعريف الصفقة
DEAL_NAME اسم الصفقة
DETECTED_ADVERTISER_NAME الاسم المعروض للمعلن الذي تم رصده
DSP_NAME الاسم المعروض لـ DSP
DSP_SEAT_ID رقم تعريف مقعد DSP
ENVIRONMENT جهاز المستخدم وبيئة الحاوية التي ينشأ منها ظهور الإعلان القيمتان المسموح بهما هما "app" و "web".
ENVIRONMENT_NAME الاسم المعروض المترجَم لجهاز المستخدم وبيئة الحاوية التي ينشأ منها مرّة الظهور. القيمتان المسموح بهما هما "app" و "web".
HOLDING_COMPANY_NAME الاسم المعروض للشركة القابضة
HOUR ساعة
MOBILE_APP_ID رقم تعريف تطبيق الأجهزة الجوّالة
MOBILE_APP_NAME اسم التطبيق المتوافق مع الأجهزة الجوّالة
MOBILE_OS نظام تشغيل الأجهزة الجوّالة
MONTH الشهر:
PACKAGE_FEE_VISIBILITY مستوى ظهور رسوم الحزمة (على سبيل المثال، مفصَح عنها أو غير مفصَح عنها)
PLATFORM المنصة، مثل "كمبيوتر مكتبي" مقابل "جهاز جوّال"
PUBLISHER_DOMAIN نطاق الناشر
PUBLISHER_ID معرّف الناشر
PUBLISHER_NAME اسم الناشر
WEEK الأسبوع.

المقياس

مقاييس إعداد التقارير:

عمليات التعداد
METRIC_UNSPECIFIED القيمة التلقائية هذه القيمة غير مستخدَمة.
ACTIVE_VIEW_MEASURABILITY_RATE نسبة العرض النشط القابلة للقياس
ACTIVE_VIEW_MEASURABLE نسبة العرض النشط القابلة للقياس
ACTIVE_VIEW_VIEWABILITY_RATE نسبة إمكانية العرض النشط
ACTIVE_VIEW_VIEWABLE مرّات الظهور القابلة للعرض في "العرض النشط"
AUCTIONS_WON المزادات التي تم الفوز بها
BIDS عروض الأسعار:
BIDS_IN_AUCTION عروض الأسعار في المزاد
BID_REQUESTS طلبات عروض الأسعار
CLICKS النقرات:
CURATION_PARTNER_FEE رسوم القيّم: سيتم إخفاء هذه القيمة وعرضها على أنّها 0.00 إذا تم ضبط مستوى عرض الحزمة على "غير مفصَح عنها". استخدِم السمة PACKAGE_FEE_VISIBILITY للتحقّق مما إذا تم الإفصاح عن رسوم الحزمة.
DATA_SEGMENT_REQUESTS عدد طلبات شرائح البيانات المُرسَلة في ميزة "التنظيم في الوقت الفعلي"
IMPRESSIONS مرّات الظهور
SPEND الإنفاق بعملة التقارير المحدّدة في الطلب القيمة التلقائية هي الدولار الأمريكي.

تصفية

فلتر على حقل واحد أو أكثر

تمثيل JSON
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "fieldFilter": {
    object (FieldFilter)
  },
  "notFilter": {
    object (Filter)
  },
  "andFilter": {
    object (FilterList)
  },
  "orFilter": {
    object (FilterList)
  }
  // End of mutually exclusive fields.
}
الحقول
يحدّد النوع كيفية دمج الفلاتر الأساسية. في ما يلي قائمة بالحقول التي يستبعد بعضها بعضًا. سيتم ضبط حقل واحد على الأكثر في الرد:
fieldFilter

object (FieldFilter)

فلتر في حقل واحد

notFilter

object (Filter)

فلتر يتم إلغاء نتيجته

andFilter

object (FilterList)

قائمة بالفلاتر التي يتم دمج نتائجها باستخدام عامل التشغيل AND.

orFilter

object (FilterList)

قائمة بالفلاتر التي يتم دمج نتائجها باستخدام عامل التشغيل OR.

نهاية الحقول التي يستبعد كلّ منها الآخر

FieldFilter

فلتر في حقل معيّن

تمثيل JSON
{
  "field": {
    object (Field)
  },
  "operation": enum (Operation),
  "values": [
    {
      object (ReportValue)
    }
  ]
}
الحقول
field

object (Field)

الحقل مطلوب. الحقل المطلوب الفلترة حسبه

operation

enum (Operation)

الحقل مطلوب. عملية هذا الفلتر

values[]

object (ReportValue)

الحقل مطلوب. القيم التي تريد الفلترة إليها

الحقل

سمة أو مقياس في تقرير

تمثيل JSON
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "dimension": enum (Dimension),
  "metric": enum (Metric)
  // End of mutually exclusive fields.
}
الحقول
إما سمة أو مقياس. في ما يلي قائمة بالحقول التي يستبعد بعضها بعضًا. سيتم ضبط حقل واحد على الأكثر في الرد:
dimension

enum (Dimension)

البُعد الذي يمثّله هذا الحقل

metric

enum (Metric)

المقياس الذي يمثّله هذا الحقل

نهاية الحقول التي يستبعد كلّ منها الآخر

العملية

عمليات الفلترة المتوافقة

عمليات التعداد
IN

بالنسبة إلى المعاملات العددية، يتم التحقّق مما إذا كان المعامل ضمن مجموعة قيم الفلتر المقدَّمة.

بالنسبة إلى معاملات القائمة، تتحقّق هذه الدالة مما إذا كان أي عنصر في المعامل ضمن مجموعة قيم الفلتر المقدَّمة.

القيمة التلقائية

NOT_IN

بالنسبة إلى المعاملات العددية، يتم التحقّق من أنّ المعامل ليس ضمن مجموعة قيم الفلاتر المقدَّمة.

بالنسبة إلى معاملات القائمة، يتم التحقّق من أنّ أيًا من العناصر في المعامل ليس ضمن مجموعة قيم الفلتر المقدَّمة.

CONTAINS

بالنسبة إلى معاملات السلاسل العددية، تتحقّق هذه الدالة مما إذا كان المعامل يحتوي على أيّ من السلاسل الفرعية للفلتر المقدَّم.

بالنسبة إلى معاملات قائمة السلاسل، تتحقّق هذه الدالة مما إذا كانت أي سلسلة في المعامل تحتوي على أي من السلاسل الفرعية للفلتر المقدَّم.

NOT_CONTAINS

بالنسبة إلى معاملات السلسلة العددية، يتم التحقّق من أنّ المعامل لا يحتوي على أي من السلاسل الفرعية للفلتر المقدَّمة.

بالنسبة إلى معاملات قائمة السلاسل، يتم التحقّق من أنّ أيًا من السلاسل في المعامل لا يحتوي على أي من السلاسل الفرعية للفلتر المقدَّم.

LESS_THAN المعامل أقل من قيمة الفلتر المقدَّمة.
LESS_THAN_EQUALS المعامل أقل من قيمة الفلتر المقدَّمة أو يساويها.
GREATER_THAN المعامل أكبر من قيمة الفلتر المقدَّمة.
GREATER_THAN_EQUALS المعامل أكبر من قيمة الفلتر المقدَّمة أو يساويها.
BETWEEN يقع المعامِل بين قيم الفلتر المقدَّمة.
MATCHES يتطابق المعامل مع تعبير عادي أو مجموعة من التعبيرات العادية (يجب أن يتطابق أحدها).
NOT_MATCHES يتطابق المعامِل سلبيًا مع تعبير عادي أو مجموعة من التعبيرات العادية (يجب ألا يتطابق أي منها).

ReportValue

تمثّل قيمة واحدة في تقرير.

تمثيل JSON
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "intValue": string,
  "doubleValue": number,
  "stringValue": string,
  "boolValue": boolean,
  "intListValue": {
    object (IntList)
  },
  "stringListValue": {
    object (StringList)
  },
  "doubleListValue": {
    object (DoubleList)
  },
  "bytesValue": string
  // End of mutually exclusive fields.
}
الحقول
قيمة الحقل، وتعتمد على تنسيق بيانات الحقل. في ما يلي قائمة بالحقول التي يستبعد بعضها بعضًا. سيتم ضبط حقل واحد على الأكثر في الرد:
intValue

string (int64 format)

للقيم الصحيحة

doubleValue

number

للقيم المزدوجة

stringValue

string

لقيم السلاسل

boolValue

boolean

للقيم المنطقية.

intListValue

object (IntList)

للقوائم التي تتضمّن قيمًا صحيحة

stringListValue

object (StringList)

لقوائم القيم النصية.

doubleListValue

object (DoubleList)

لقوائم القيم المزدوجة

bytesValue

string (bytes format)

لقيم وحدات البايت

سلسلة بترميز base64

نهاية الحقول التي يستبعد كلّ منها الآخر

IntList

قائمة بقيم الأعداد الصحيحة

تمثيل JSON
{
  "values": [
    string
  ]
}
الحقول
values[]

string (int64 format)

القيم

StringList

قائمة بقيم السلاسل

تمثيل JSON
{
  "values": [
    string
  ]
}
الحقول
values[]

string

القيم

DoubleList

قائمة بالقيم المزدوجة

تمثيل JSON
{
  "values": [
    number
  ]
}
الحقول
values[]

number

القيم

FilterList

قائمة بالفلاتر

تمثيل JSON
{
  "filters": [
    {
      object (Filter)
    }
  ]
}
الحقول
filters[]

object (Filter)

الحقل مطلوب. قائمة بالفلاتر

TimeZoneSource

المصدر الذي يحدّد المنطقة الزمنية للتقرير

عمليات التعداد
TIME_ZONE_SOURCE_UNSPECIFIED القيمة التلقائية غير محدّدة.
AD_EXCHANGE استخدِم توقيت المحيط الهادئ(PT).
UTC استخدِم المنطقة الزمنية للتوقيت العالمي المنسّق (UTC).
PROVIDED استخدِم المنطقة الزمنية المقدَّمة في حقل ReportDefinition.time_zone. قد يستغرق تشغيل التقارير وقتًا أطول لأنّه يتم احتساب التواريخ ديناميكيًا في وقت الطلب.
CURATOR استخدِم المنطقة الزمنية من إعدادات حساب المنسّق.

DateRange

نطاق زمني لتقرير

تمثيل JSON
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "fixed": {
    object (FixedDateRange)
  },
  "relative": enum (RelativeDateRange)
  // End of mutually exclusive fields.
}
الحقول
إما نطاق زمني ثابت أو نسبي. في ما يلي قائمة بالحقول التي يستبعد بعضها بعضًا. سيتم ضبط حقل واحد على الأكثر في الرد:
fixed

object (FixedDateRange)

نطاق زمني ثابت

relative

enum (RelativeDateRange)

نطاق زمني نسبي

نهاية الحقول التي يستبعد كلّ منها الآخر

FixedDateRange

نطاق زمني بين تاريخَين ثابتَين (بما في ذلك تاريخ الانتهاء)

تمثيل JSON
{
  "startDate": {
    object (Date)
  },
  "endDate": {
    object (Date)
  }
}
الحقول
startDate

object (Date)

الحقل مطلوب. تاريخ بدء هذا النطاق الزمني

endDate

object (Date)

الحقل مطلوب. تاريخ الانتهاء (شامل) لهذا النطاق الزمني

التاريخ

تمثّل تاريخًا تقويميًا كاملاً أو جزئيًا، مثل تاريخ ميلاد. يتم تحديد الوقت من اليوم والمنطقة الزمنية في مكان آخر أو لا يكونان مهمَّين. التاريخ نسبي بالنسبة إلى التقويم الميلادي. ويمكن أن يمثّل ذلك أحد الخيارات التالية:

  • تاريخ كامل، مع قيم غير صفرية للسنة والشهر واليوم.
  • شهر ويوم، مع سنة صفرية (على سبيل المثال، ذكرى سنوية).
  • سنة بمفردها، مع شهر صفر ويوم صفر.
  • سنة وشهر، مع يوم صفر (على سبيل المثال، تاريخ انتهاء صلاحية بطاقة الائتمان).

الأنواع ذات الصلة:

تمثيل JSON
{
  "year": integer,
  "month": integer,
  "day": integer
}
الحقول
year

integer

تمثّل السنة في التاريخ. يجب أن تتراوح القيمة بين 1 و9999، أو أن تكون 0 لتحديد تاريخ بدون سنة.

month

integer

شهر من السنة يجب أن تكون القيمة من 1 إلى 12، أو 0 لتحديد سنة بدون شهر ويوم.

day

integer

يوم من الشهر يجب أن تتراوح القيمة بين 1 و31 وأن تكون صالحة للسنة والشهر، أو أن تكون 0 لتحديد سنة بمفردها أو سنة وشهر لا يكون اليوم فيهما مهمًا.

RelativeDateRange

خيارات النطاقات الزمنية النسبية

عمليات التعداد
RELATIVE_DATE_RANGE_UNSPECIFIED القيمة التلقائية هذه القيمة غير مستخدَمة.
TODAY تاريخ إنشاء التقرير
YESTERDAY التاريخ الذي يسبق تاريخ تنفيذ التقرير بيوم واحد.
THIS_WEEK_TO_DATE من بداية الأسبوع في التقويم وحتى يوم تنفيذ التقرير.
THIS_WEEK_TO_YESTERDAY من بداية الأسبوع التقويمي الذي يتم فيه إنشاء التقرير، وحتى اليوم السابق لإنشاء التقرير.
THIS_MONTH_TO_DATE من بداية الشهر التقويمي الذي يتم فيه تشغيل التقرير، وحتى يوم تشغيل التقرير (بما في ذلك هذا اليوم).
THIS_MONTH_TO_YESTERDAY من بداية الشهر التقويمي الذي يتم فيه إنشاء التقرير، وحتى اليوم السابق لإنشاء التقرير.
THIS_QUARTER_TO_DATE من بداية الربع السنوي الذي يتم فيه إنشاء التقرير، وحتى يوم إنشاء التقرير (بما في ذلك هذا اليوم)
THIS_QUARTER_TO_YESTERDAY من بداية الربع السنوي الذي يتم فيه عرض التقرير، وحتى اليوم السابق لعرض التقرير.
THIS_YEAR_TO_DATE من بداية السنة التقويمية التي يتم فيها إنشاء التقرير، وحتى اليوم الذي يتم فيه إنشاء التقرير.
THIS_YEAR_TO_YESTERDAY من بداية السنة التقويمية التي يتم فيها تنفيذ التقرير، وحتى اليوم السابق لتنفيذ التقرير.
LAST_WEEK الأسبوع التقويمي السابق بالكامل، من الاثنين إلى الأحد (شاملاً)، الذي يسبق الأسبوع التقويمي الذي يتم تشغيل التقرير فيه.
LAST_WEEK_STARTING_SUNDAY الأسبوع التقويمي السابق بالكامل، من الأحد إلى السبت (شاملاً)، الذي يسبق الأسبوع التقويمي الذي يتم فيه تشغيل التقرير.
LAST_MONTH الشهر التقويمي السابق بالكامل الذي يسبق الشهر التقويمي الذي يتم فيه تشغيل التقرير.
LAST_QUARTER الربع السنوي التقويمي السابق بالكامل الذي يسبق الربع السنوي التقويمي الذي يتم تشغيل التقرير فيه.
LAST_YEAR السنة التقويمية السابقة بالكامل التي تسبق السنة التقويمية التي يتم فيها تشغيل التقرير.
LAST_7_DAYS الأيام السبعة السابقة لليوم الذي يتم فيه إنشاء التقرير
LAST_30_DAYS الأيام الـ 30 السابقة لليوم الذي يتم فيه إنشاء التقرير
LAST_60_DAYS ‫60 يومًا قبل يوم إنشاء التقرير
LAST_90_DAYS الأيام الـ 90 السابقة لليوم الذي يتم فيه إنشاء التقرير
LAST_93_DAYS ‫93 يومًا قبل يوم إنشاء التقرير
LAST_180_DAYS ‫180 يومًا قبل يوم إنشاء التقرير
LAST_360_DAYS ‫360 يومًا قبل يوم إنشاء التقرير
LAST_365_DAYS ‫365 يومًا قبل اليوم الذي يتم فيه إنشاء التقرير
LAST_3_MONTHS الأشهر التقويمية الثلاثة السابقة بالكامل للشهر التقويمي الذي يتم فيه تشغيل التقرير.
LAST_6_MONTHS الأشهر التقويمية الستة السابقة بالكامل للشهر التقويمي الذي يتم فيه تشغيل التقرير.
LAST_12_MONTHS الأشهر الـ 12 التقويمية السابقة بالكامل التي تسبق الشهر التقويمي الذي يتم فيه إنشاء التقرير
ALL_AVAILABLE من 3 سنوات قبل إنشاء التقرير إلى اليوم السابق لإنشاء التقرير، بما في ذلك هذين اليومين.

ترتيب

تمثّل هذه السمة ترتيبًا في تقرير.

تمثيل JSON
{
  "field": {
    object (Field)
  },
  "descending": boolean
}
الحقول
field

object (Field)

الحقل مطلوب. حقل (سمة أو مقياس) للترتيب حسبه

descending

boolean

اختيارية: نظام الترتيب إذا كانت القيمة "صحيح"، سيكون الترتيب تنازليًا.

الطُرق

create

لإنشاء عنصر Report.

delete

تحذف هذه الطريقة عنصر Report.

get

يسترد عنصر Report.

list

تعرض هذه القائمة Report عنصر.

patch

تعديل عنصر Report

run

لبدء تنفيذ تقرير حالي بشكل غير متزامن