Method: exchanges.generateReport

Tạo và trả về mã báo cáo. Báo cáo không còn tồn tại. 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 nền tảng trao đổi quảng cáo sở hữu báo cáo. 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 có 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 theo định dạng ISO_8601 YYYY-MM-DD, tính cả hai định dạng này. Bắt buộc làm dữ liệu đầu vào.
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, tính cả hai định dạng này. Bắt buộc làm dữ liệu đầu vào.
reportType

enum (ReportType)

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

enum (DimensionId)

Không bắt buộc. Danh sách phương diện mà báo cáo sẽ được tạo. Nếu giá trị rỗng, chỉ cung cấp mã nhà xuất bản. Nếu một loại báo cáo cụ thể không hỗ trợ phương diện này thì chúng 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 phiên bản 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 bài viết Tổng quan về OAuth 2.0.

ReportType

Loại báo cáo.

Enum
REPORT_TYPE_UNSPECIFIED Loại báo cáo chưa được chỉ định, giá trị nhập không hợp lệ
HOURLY Loại báo cáo hằng 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.

DimensionId

Báo cáo enum Kích thước.

Enum
DIMENSION_ID_UNSPECIFIED Phương diện báo cáo chưa được chỉ định, giá trị nhập 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. Ngoài ra, các báo cáo bao gồm phương diện này có thể mất hàng giờ để chạy. Trong tương lai, chúng tôi sẽ hạn chế xếp hạng trên các 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. Ngoài ra, các báo cáo bao gồm phương diện này có thể mất hàng giờ để chạy. Trong tương lai, chúng tôi sẽ hạn chế xếp hạng trên các 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 đến 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 là rỗng, thì đây là phương diện mặc định.