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.

ReportType

نوع التقرير

عمليات التعداد
REPORT_TYPE_UNSPECIFIED نوع التقرير غير محدد، قيمة إدخال غير صالحة
HOURLY نوع التقرير كل ساعة
DAILY نوع التقرير يوميًا
WEEKLY نوع التقرير أسبوعيًا.
MONTHLY نوع التقرير شهريًا:

DimensionId

تعداد رقم تعريف البُعد.

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