Method: exchanges.generateReport

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

درخواست HTTP

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

این URL از سینتکس Transcoding در 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 .

نوع گزارش

نوع گزارش.

انوم‌ها
REPORT_TYPE_UNSPECIFIED نوع گزارش مشخص نشده است، مقدار ورودی نامعتبر است.
HOURLY نوع گزارش ساعتی
DAILY نوعی گزارش روزانه
WEEKLY نوع گزارش هفتگی
MONTHLY نوع گزارش ماهانه
AWBID_DAILY یک نوع گزارش روزانه AwBid.
AWBID_WEEKLY نوعی گزارش هفتگی AwBid.
AWBID_MONTHLY یک نوع گزارش ماهانه AwBid.
AWBID_OUT_OF_MONTH_IVT نوع گزارش IVT خارج از ماه AwBid.

شناسه ابعاد

گزارش DimensionId enum.

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