Method: exchanges.generateReport

شناسه گزارش را تولید و برمی گرداند. این گزارش ادامه ندارد. فراخوان هایی با درخواست یکسان، گزارش را بازسازی می کند.

درخواست HTTP

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

URL از دستور GRPC Transcoding استفاده می کند.

پارامترهای مسیر

پارامترها
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 مراجعه کنید.

نوع گزارش

نوع گزارش

Enums
REPORT_TYPE_UNSPECIFIED نوع گزارش نامشخص، مقدار ورودی نامعتبر است
HOURLY نوع گزارش ساعتی
DAILY نوع گزارش روزانه
WEEKLY نوع گزارش هفتگی
MONTHLY نوع گزارش ماهانه

DimensionId

DimensionId enum را گزارش کنید.

Enums
DIMENSION_ID_UNSPECIFIED گزارش ابعاد نامشخص، مقدار ورودی نامعتبر است.
PARTNER_ID شناسه شریک، فقط در گزارش روزانه پشتیبانی می‌شود.
DEVICE_TYPE نوع دستگاه، فقط در گزارش روزانه پشتیبانی می شود.
CREATIVE_ID شناسه خلاق، فقط در گزارش روزانه پشتیبانی می‌شود. لطفا توجه داشته باشید که این بعد می تواند به میزان قابل توجهی در اندازه فایل گزارش ها کمک کند. و گزارش‌ها شامل اجرای این بعد می‌شود که ممکن است ساعت‌ها طول بکشد. در آینده امتیاز را در این زمینه های بارگیری سنگین محدود خواهیم کرد.
CREATIVE_TYPE نوع خلاق، فقط در گزارش روزانه پشتیبانی می شود. لطفا توجه داشته باشید که این بعد می تواند به میزان قابل توجهی در اندازه فایل گزارش ها کمک کند. و گزارش‌ها شامل اجرای این بعد می‌شود که ممکن است ساعت‌ها طول بکشد. در آینده امتیاز را در این زمینه های بارگیری سنگین محدود خواهیم کرد.
REGION_CODE کد کشور/منطقه، فقط در گزارش روزانه پشتیبانی می شود.
DEAL_ID شناسه معامله، نگاشت به منبع موجودی، فقط در گزارش روزانه پشتیبانی می‌شود.
PUBLISHER_ID شناسه ناشر، اگر فهرست شناسه بعد ورودی تهی باشد، این بعد پیش‌فرض است.