Method: exchanges.generateReport

Tạo và trả về mã báo cáo. Báo cáo không được duy trì. Các lệnh gọi có cùng yêu cầu sẽ tạo lại báo cáo.

Yêu cầu HTTP

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

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số đường dẫn

Tham số
exchange

string

Bắt buộc. Tên của sàn giao dịch mà báo cáo thuộc về. Ví dụ: "exchanges/123" Bắt buộc.

Nội dung yêu cầu

Nội dung yêu cầu chứa dữ liệu với cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "startDate": string,
  "endDate": string,
  "reportType": enum (ReportType),
  "dimensionIds": [
    enum (DimensionId)
  ]
}
Trường
startDate

string

Bắt buộc. Ngày bắt đầu của báo cáo ở định dạng ISO_8601 YYYY-MM-DD, bao gồm cả ngày này. Bắt buộc phải nhập.
endDate

string

Bắt buộc. Ngày kết thúc của báo cáo theo định dạng ISO_8601 YYYY-MM-DD, bao gồm cả ngày này. Bắt buộc phải nhập.
reportType

enum (ReportType)

Bắt buộc. Nếu bạn không chỉ định loại báo cáo, thì hệ thống sẽ trả về lỗi.
dimensionIds[]

enum (DimensionId)

Không bắt buộc. Danh sách các phương diện mà báo cáo sẽ được tạo dựa trên đó. Nếu giá trị rỗng, thì chỉ bao gồm mã nhà xuất bản. Nếu không được hỗ trợ trong một loại báo cáo cụ thể, các phương diện này sẽ bị bỏ qua.

Nội dung phản hồi

Nếu thành công, nội dung phản hồi sẽ chứa một thực thể của Report.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

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

Để biết thêm thông tin, hãy xem OAuth 2.0 Overview.

ReportType

Loại báo cáo.

Enum
REPORT_TYPE_UNSPECIFIED Chưa chỉ định loại báo cáo, giá trị nhập không hợp lệ.
HOURLY Loại báo cáo theo giờ.
DAILY Loại báo cáo hằng ngày.
WEEKLY Loại báo cáo hằng tuần.
MONTHLY Loại báo cáo hằng tháng.
AWBID_DAILY Loại báo cáo AwBid hằng ngày.
AWBID_WEEKLY Loại báo cáo hằng tuần AwBid.
AWBID_MONTHLY Loại báo cáo hằng tháng AwBid.
AWBID_OUT_OF_MONTH_IVT Loại báo cáo AwBid về lưu lượng truy cập không hợp lệ ngoài tháng.

DimensionId

Liệt kê DimensionId trong báo cáo.

Enum
DIMENSION_ID_UNSPECIFIED Phương diện Báo cáo không được chỉ định, giá trị đầu vào không hợp lệ.
PARTNER_ID Mã đối tác, chỉ được hỗ trợ trong Báo cáo hằng ngày.
DEVICE_TYPE Loại thiết bị, chỉ được hỗ trợ trong Báo cáo hằng ngày.
CREATIVE_ID Mã mẫu quảng cáo, chỉ được hỗ trợ trong Báo cáo hằng ngày. Xin lưu ý rằng phương diện này có thể đóng góp đáng kể vào kích thước tệp của báo cáo. Và những báo cáo có phương diện này có thể mất nhiều giờ để chạy. Trong tương lai, chúng tôi sẽ giới hạn điểm xếp hạng cho những trường tải nặng này.
CREATIVE_TYPE Loại mẫu quảng cáo, chỉ được hỗ trợ trong Báo cáo hằng ngày. Xin lưu ý rằng phương diện này có thể đóng góp đáng kể vào kích thước tệp của báo cáo. Và những báo cáo có phương diện này có thể mất nhiều giờ để chạy. Trong tương lai, chúng tôi sẽ giới hạn mức độ tải trên những trường tải nặng này.
REGION_CODE Mã quốc gia/khu vực, chỉ được hỗ trợ trong Báo cáo hằng ngày.
DEAL_ID Mã giao dịch, liên kết với nguồn khoảng không quảng cáo, chỉ được hỗ trợ trong Báo cáo hằng ngày.
PUBLISHER_ID Mã nhà xuất bản, nếu danh sách mã phương diện đầu vào có giá trị rỗng, thì đây là phương diện mặc định.