- المورد: Report
- ReportDefinition
- السمة
- المقياس
- الفلتر
- FieldFilter
- الحقل
- العملية
- ReportValue
- IntList
- StringList
- DoubleList
- FilterList
- TimeZoneSource
- DateRange
- FixedDateRange
- التاريخ
- RelativeDateRange
- الترتيب
- الطُرق
المورد: التقرير
مورد Report
| تمثيل JSON |
|---|
{
"name": string,
"reportId": string,
"reportDefinition": {
object ( |
| الحقول | |
|---|---|
name |
المعرّف. اسم مورد التقرير يجب أن يكون اسم مورد التقرير على النحو التالي: |
reportId |
النتائج فقط. رقم تعريف التقرير |
reportDefinition |
الحقل مطلوب. تعريف التقرير |
displayName |
اختيارية: الاسم المعروض للتقرير |
updateTime |
النتائج فقط. لحظة آخر تعديل لهذا التقرير يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 0 أو 3 أو 6 أو 9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف Z. أمثلة: |
createTime |
النتائج فقط. اللحظة التي تم فيها إنشاء هذا التقرير يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 0 أو 3 أو 6 أو 9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف Z. أمثلة: |
locale |
النتائج فقط. اللغة والمنطقة لهذا التقرير يتم ضبط الإعدادات المحلية من الإعدادات المحلية للمستخدم في وقت تقديم الطلب. لا يمكن تعديل اللغة. |
ReportDefinition
تعريف كيفية تشغيل التقرير.
| تمثيل JSON |
|---|
{ "dimensions": [ enum ( |
| الحقول | |
|---|---|
dimensions[] |
الحقل مطلوب. قائمة السمات المطلوب إعداد تقارير عنها إذا كان فارغًا، لن يتضمّن التقرير أي سمات، وستكون أي مقاييس إجمالية. |
metrics[] |
الحقل مطلوب. قائمة المقاييس المطلوب إعداد تقارير عنها إذا كان فارغًا، لن يتضمّن التقرير أي مقاييس. |
filters[] |
اختيارية: الفلاتر لهذا التقرير |
timeZoneSource |
اختيارية: مكان الحصول على المنطقة الزمنية لهذا التقرير يتم استخدام توقيت المحيط الهادئ (PT) تلقائيًا. إذا كان المصدر هو PROVIDED، يجب أيضًا ضبط منطقة زمنية في حقل timeZone في تعريف التقرير. |
timeZone |
اختيارية: إذا كانت قيمة timeZoneSource هي PROVIDED، فهذه هي المنطقة الزمنية التي يجب استخدامها لهذا التقرير. اترك الحقل فارغًا لأي مصدر آخر للمنطقة الزمنية. المنطقة الزمنية بتنسيق IANA على سبيل المثال، "America/New_York". |
currencyCode |
اختيارية: رمز العملة ISO 4217 لهذا التقرير يتم ضبط القيمة تلقائيًا على رمز عملة الحساب في حال عدم تحديد أي قيمة. |
dateRange |
الحقل مطلوب. النطاق الزمني الأساسي لهذا التقرير |
sorts[] |
اختيارية: عمليات الترتيب التلقائية التي سيتم تطبيقها على هذا التقرير |
السمة
سمات إعداد التقارير
| عمليات التعداد | |
|---|---|
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 |
فلتر يتم إلغاء نتيجته |
andFilter |
قائمة بالفلاتر التي يتم دمج نتائجها باستخدام عامل التشغيل AND. |
orFilter |
قائمة بالفلاتر التي يتم دمج نتائجها باستخدام عامل التشغيل OR. |
| نهاية الحقول التي يستبعد كلّ منها الآخر | |
FieldFilter
فلتر في حقل معيّن
| تمثيل JSON |
|---|
{ "field": { object ( |
| الحقول | |
|---|---|
field |
الحقل مطلوب. الحقل المطلوب الفلترة حسبه |
operation |
الحقل مطلوب. عملية هذا الفلتر |
values[] |
الحقل مطلوب. القيم التي تريد الفلترة إليها |
الحقل
سمة أو مقياس في تقرير
| تمثيل 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 |
المقياس الذي يمثّله هذا الحقل |
| نهاية الحقول التي يستبعد كلّ منها الآخر | |
العملية
عمليات الفلترة المتوافقة
| عمليات التعداد | |
|---|---|
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 ( |
| الحقول | |
|---|---|
| قيمة الحقل، وتعتمد على تنسيق بيانات الحقل. في ما يلي قائمة بالحقول التي يستبعد بعضها بعضًا. سيتم ضبط حقل واحد على الأكثر في الرد: | |
intValue |
للقيم الصحيحة |
doubleValue |
للقيم المزدوجة |
stringValue |
لقيم السلاسل |
boolValue |
للقيم المنطقية. |
intListValue |
للقوائم التي تتضمّن قيمًا صحيحة |
stringListValue |
لقوائم القيم النصية. |
doubleListValue |
لقوائم القيم المزدوجة |
bytesValue |
لقيم وحدات البايت سلسلة بترميز base64 |
| نهاية الحقول التي يستبعد كلّ منها الآخر | |
IntList
قائمة بقيم الأعداد الصحيحة
| تمثيل JSON |
|---|
{ "values": [ string ] } |
| الحقول | |
|---|---|
values[] |
القيم |
StringList
قائمة بقيم السلاسل
| تمثيل JSON |
|---|
{ "values": [ string ] } |
| الحقول | |
|---|---|
values[] |
القيم |
DoubleList
قائمة بالقيم المزدوجة
| تمثيل JSON |
|---|
{ "values": [ number ] } |
| الحقول | |
|---|---|
values[] |
القيم |
FilterList
قائمة بالفلاتر
| تمثيل JSON |
|---|
{
"filters": [
{
object ( |
| الحقول | |
|---|---|
filters[] |
الحقل مطلوب. قائمة بالفلاتر |
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 ( |
| الحقول | |
|---|---|
| إما نطاق زمني ثابت أو نسبي. في ما يلي قائمة بالحقول التي يستبعد بعضها بعضًا. سيتم ضبط حقل واحد على الأكثر في الرد: | |
fixed |
نطاق زمني ثابت |
relative |
نطاق زمني نسبي |
| نهاية الحقول التي يستبعد كلّ منها الآخر | |
FixedDateRange
نطاق زمني بين تاريخَين ثابتَين (بما في ذلك تاريخ الانتهاء)
| تمثيل JSON |
|---|
{ "startDate": { object ( |
| الحقول | |
|---|---|
startDate |
الحقل مطلوب. تاريخ بدء هذا النطاق الزمني |
endDate |
الحقل مطلوب. تاريخ الانتهاء (شامل) لهذا النطاق الزمني |
التاريخ
تمثّل تاريخًا تقويميًا كاملاً أو جزئيًا، مثل تاريخ ميلاد. يتم تحديد الوقت من اليوم والمنطقة الزمنية في مكان آخر أو لا يكونان مهمَّين. التاريخ نسبي بالنسبة إلى التقويم الميلادي. ويمكن أن يمثّل ذلك أحد الخيارات التالية:
- تاريخ كامل، مع قيم غير صفرية للسنة والشهر واليوم.
- شهر ويوم، مع سنة صفرية (على سبيل المثال، ذكرى سنوية).
- سنة بمفردها، مع شهر صفر ويوم صفر.
- سنة وشهر، مع يوم صفر (على سبيل المثال، تاريخ انتهاء صلاحية بطاقة الائتمان).
الأنواع ذات الصلة:
google.type.TimeOfDaygoogle.type.DateTimegoogle.protobuf.Timestamp
| تمثيل JSON |
|---|
{ "year": integer, "month": integer, "day": integer } |
| الحقول | |
|---|---|
year |
تمثّل السنة في التاريخ. يجب أن تتراوح القيمة بين 1 و9999، أو أن تكون 0 لتحديد تاريخ بدون سنة. |
month |
شهر من السنة يجب أن تكون القيمة من 1 إلى 12، أو 0 لتحديد سنة بدون شهر ويوم. |
day |
يوم من الشهر يجب أن تتراوح القيمة بين 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 |
اختيارية: نظام الترتيب إذا كانت القيمة "صحيح"، سيكون الترتيب تنازليًا. |
الطُرق |
|
|---|---|
|
لإنشاء عنصر Report. |
|
تحذف هذه الطريقة عنصر Report. |
|
يسترد عنصر Report. |
|
تعرض هذه القائمة Report عنصر. |
|
تعديل عنصر Report |
|
لبدء تنفيذ تقرير حالي بشكل غير متزامن |