Method: exchanges.generateReport

يتم إنشاء معرّف التقرير وعرضه. لا يتم الاحتفاظ بالتقرير. وستؤدي عمليات الاستدعاء التي تتضمّن الطلب نفسه إلى إعادة إنشاء التقرير.

طلب HTTP

POST https://dv360exchangereporting.googleapis.com/v1alpha1/{exchange=exchanges/*}:generateReport

يستخدم عنوان URL بنية تحويل الترميز إلى gRPC.

مَعلمات المسار

المعلمات
exchange

string

الحقل مطلوب. اسم البورصة التي ينتمي إليها التقرير مثال: "exchanges/123" الحقل مطلوب.

نص الطلب

يتضمن نص الطلب بيانات بالبنية التالية:

تمثيل JSON 
{
  "startDate": string,
  "endDate": string,
  "reportType": enum (ReportType),
  "dimensionIds": [
    enum (DimensionId)
  ]
}
الحقول
startDate

string

الحقل مطلوب. تاريخ بدء التقارير بتنسيق ISO_8601‏ YYYY-MM-DD، بما في ذلك هذا التاريخ الحقل مطلوب كإدخال.
endDate

string

الحقل مطلوب. تاريخ انتهاء التقارير بتنسيق ISO_8601‏ YYYY-MM-DD، بما في ذلك هذا التاريخ الحقل مطلوب كإدخال.
reportType

enum (ReportType)

الحقل مطلوب. نوع التقرير، وإذا لم يتم تحديده، سيتم عرض أخطاء
dimensionIds[]

enum (DimensionId)

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

نص الاستجابة

إذا كانت الاستجابة ناجحة، سيحتوي نصها على مثال Report.

نطاقات الأذونات

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/doubleclickbidmanager

لمزيد من المعلومات، يُرجى الاطّلاع على OAuth 2.0 Overview.

ReportType

نوع التقرير

عمليات التعداد
REPORT_TYPE_UNSPECIFIED نوع التقرير غير محدّد، قيمة الإدخال غير صالحة
HOURLY نوع تقرير كل ساعة
DAILY نوع تقرير يومي
WEEKLY نوع تقرير أسبوعي
MONTHLY نوع تقرير شهري
AWBID_DAILY نوع تقرير AwBid اليومي
AWBID_WEEKLY نوع تقرير AwBid الأسبوعي
AWBID_MONTHLY نوع تقرير AwBid الشهري
AWBID_OUT_OF_MONTH_IVT نوع تقرير AwBid خارج الشهر عن الزيارات غير الصالحة

DimensionId

تعداد Report DimensionId

عمليات التعداد
DIMENSION_ID_UNSPECIFIED سمة التقرير غير محدّدة، قيمة الإدخال غير صالحة
PARTNER_ID معرّف الشريك، لا يتوفّر إلا في التقرير اليومي
DEVICE_TYPE نوع الجهاز، لا يتوفّر إلا في التقرير اليومي
CREATIVE_ID معرّف الإعلان، لا يتوفّر إلا في التقرير اليومي يُرجى العِلم أنّ هذه السمة يمكن أن تساهم بشكل كبير في حجم ملف التقارير. وقد تستغرق التقارير التي تتضمّن هذه السمة ساعات لتشغيلها. في المستقبل، سنحدّ من التقييم في هذه الحقول التي تتطلّب تحميلًا كبيرًا.
CREATIVE_TYPE نوع التصميم، لا يتوفّر إلا في التقرير اليومي يُرجى العِلم أنّ هذه السمة يمكن أن تساهم بشكل كبير في حجم ملف التقارير. وقد تستغرق التقارير التي تتضمّن هذه السمة ساعات لتشغيلها. في المستقبل، سنحدّ من التقييم في هذه الحقول التي تتطلّب تحميلًا كبيرًا.
REGION_CODE رمز البلد/المنطقة، لا يتوفّر إلا في التقرير اليومي
DEAL_ID رقم تعريف الصفقة، الذي يتم ربطه بمصدر المخزون، لا يتوفّر إلا في التقرير اليومي
PUBLISHER_ID الرقم التعريفي للناشر، إذا كانت قائمة معرّفات السمات المُدخَلة فارغة، تكون هذه السمة هي السمة التلقائية