Reports: request

Chèn một yêu cầu báo cáo vào hệ thống báo cáo. Thử ngay.

Yêu cầu

Yêu cầu HTTP

POST https://www.googleapis.com/doubleclicksearch/v2/reports

Ủy quyền

Yêu cầu này cần được cho phép có phạm vi sau:

Phạm vi
https://www.googleapis.com/auth/doubleclicksearch

Để biết thêm thông tin, hãy xem trang xác thực và uỷ quyền.

Nội dung yêu cầu

Trong nội dung yêu cầu, hãy cung cấp dữ liệu theo cấu trúc sau:

{
  "reportScope": {
    "agencyId": long,
    "advertiserId": long,
    "engineAccountId": long,
    "campaignId": long,
    "adGroupId": long,
    "keywordId": long,
    "adId": long
  },
  "reportType": string,
  "columns": [
    {
      "columnName": string,
      "savedColumnName": string,
      "customDimensionName": string,
      "customMetricName": string,
      "headerText": string,
      "startDate": string,
      "endDate": string,
      "groupByColumn": boolean,
      "platformSource": string,
      "productReportPerspective": string
    }
  ],
  "timeRange": {
    "startDate": string,
    "endDate": string,
    "changedMetricsSinceTimestamp": datetime,
    "changedAttributesSinceTimestamp": datetime
  },
  "filters": [
    {
      "column": {
        "columnName": string,
        "savedColumnName": string,
        "customDimensionName": string,
        "customMetricName": string,
        "headerText": string,
        "startDate": string,
        "endDate": string,
        "groupByColumn": boolean,
        "platformSource": string,
        "productReportPerspective": string
      },
      "operator": string,
      "values": [
        (value)
      ]
    }
  ],
  "orderBy": [
    {
      "column": {
        "columnName": string,
        "savedColumnName": string,
        "customDimensionName": string,
        "customMetricName": string,
        "headerText": string,
        "startDate": string,
        "endDate": string,
        "groupByColumn": boolean,
        "platformSource": string,
        "productReportPerspective": string
      },
      "sortOrder": string
    }
  ],
  "includeDeletedEntities": boolean,
  "includeRemovedEntities": boolean,
  "verifySingleTimeZone": boolean,
  "downloadFormat": string,
  "statisticsCurrency": string,
  "startRow": integer,
  "rowCount": integer,
  "maxRowsPerFile": integer
}
Tên tài sản Giá trị Mô tả Ghi chú
reportScope object reportScope là một tập hợp các mã nhận dạng được dùng để xác định một nhóm nhỏ các thực thể sẽ được trả về trong báo cáo. Bạn phải điền toàn bộ các mã nhận dạng từ cấp có phạm vi thấp nhất mà bạn muốn thông qua công ty quảng cáo.
reportScope.agencyId long Mã công ty quảng cáo DS.
reportScope.advertiserId long Mã nhận dạng nhà quảng cáo DS.
reportScope.engineAccountId long Mã tài khoản công cụ DS.
reportScope.campaignId long Mã chiến dịch DS.
reportScope.adGroupId long Mã nhóm quảng cáo DS.
reportScope.keywordId long Mã từ khoá DS.
reportScope.adId long Mã quảng cáo DS.
reportType string Xác định loại hàng được trả về trong báo cáo. Ví dụ: nếu bạn chỉ định reportType: keyword, mỗi hàng trong báo cáo sẽ chứa dữ liệu về một từ khoá. Xem tài liệu tham khảo về Các loại báo cáo để biết những cột có sẵn cho từng loại.
columns[] list Các cột cần đưa vào báo cáo. Số liệu này bao gồm cả các cột trong DoubleClick Search và các cột đã lưu. Đối với các cột trong DoubleClick Search, bạn chỉ cần tham số columnName. Đối với các cột đã lưu, bạn chỉ cần có tham số savedColumnName. Không được đặt cả columnName và savedColumnName trong cùng một khổ.

Số cột tối đa cho mỗi yêu cầu là 300.
columns[].columnName string Tên của một cột DoubleClick Search cần đưa vào báo cáo.
columns[].savedColumnName string Tên của cột đã lưu để đưa vào báo cáo. Báo cáo phải thuộc phạm vi của nhà quảng cáo trở xuống và cột đã lưu này phải được tạo trong giao diện người dùng DoubleClick Search.
columns[].headerText string Văn bản dùng để xác định cột này trong kết quả báo cáo; mặc định là columnName hoặc savedColumnName khi không được chỉ định. Tính năng này có thể được sử dụng để ngăn chặn xung đột giữa các cột DoubleClick Search và các cột đã lưu có cùng tên.
columns[].startDate string Ngày bao gồm ở định dạng YYYY-MM-DD. Khi được cung cấp, giá trị này sẽ chỉ ghi đè phạm vi thời gian tổng thể của báo cáo cho cột này. Bạn phải cung cấp thông tin này cùng với endDate.
columns[].endDate string Ngày không phân biệt đối xử ở định dạng YYYY-MM-DD. Khi được cung cấp, giá trị này sẽ chỉ ghi đè phạm vi thời gian tổng thể của báo cáo cho cột này. Bạn phải cung cấp thông tin này cùng với startDate.
columns[].groupByColumn boolean Chỉ báo cáo đồng bộ. Đặt thành true để nhóm theo cột này. Giá trị mặc định là false.
timeRange object Nếu một báo cáo yêu cầu các chỉ số, thì đối số này sẽ được dùng để giới hạn các chỉ số trong một phạm vi thời gian cụ thể.
timeRange.startDate string Ngày bao gồm ở định dạng YYYY-MM-DD.
timeRange.endDate string Ngày bao gồm ở định dạng YYYY-MM-DD.
timeRange.changedMetricsSinceTimestamp datetime Dấu thời gian UTC bao gồm ở định dạng RFC, ví dụ: 2013-07-16T10:16:23.555Z. Xem thêm tài liệu tham khảo về cách hoạt động của báo cáo chỉ số đã thay đổi.
timeRange.changedAttributesSinceTimestamp datetime Dấu thời gian UTC bao gồm ở định dạng RFC, ví dụ: 2013-07-16T10:16:23.555Z. Xem thêm tài liệu tham khảo về cách hoạt động của báo cáo thuộc tính đã thay đổi.
filters[] list Danh sách bộ lọc sẽ được áp dụng cho báo cáo.

Số lượng bộ lọc tối đa cho mỗi yêu cầu là 300.
filters[].column nested object Cột để áp dụng bộ lọc. Đây có thể là một cột trong DoubleClick Search hoặc một cột đã lưu.
filters[].column.columnName string Tên của một cột DoubleClick Search cần đưa vào báo cáo.
filters[].column.savedColumnName string Tên của cột đã lưu để đưa vào báo cáo. Báo cáo phải thuộc phạm vi của nhà quảng cáo trở xuống và cột đã lưu này phải được tạo trong giao diện người dùng DoubleClick Search.
filters[].operator string Toán tử sẽ sử dụng trong bộ lọc. Hãy xem tài liệu tham khảo về bộ lọc để biết danh sách các toán tử có thể sử dụng.
filters[].values[] list Danh sách các giá trị để lọc giá trị cột.

Số lượng giá trị bộ lọc tối đa cho mỗi yêu cầu là 300.
orderBy[] list Chỉ báo cáo đồng bộ. Danh sách các cột và hướng dẫn xác định cách sắp xếp sẽ được thực hiện trên các hàng báo cáo.

Số lượng đơn đặt hàng tối đa cho mỗi yêu cầu là 300.
orderBy[].column nested object Cột để sắp xếp. Đây có thể là cột do DoubleClick Search xác định hoặc cột đã lưu.
orderBy[].column.columnName string Tên của một cột DoubleClick Search cần đưa vào báo cáo.
orderBy[].column.savedColumnName string Tên của cột đã lưu để đưa vào báo cáo. Báo cáo phải thuộc phạm vi của nhà quảng cáo trở xuống và cột đã lưu này phải được tạo trong giao diện người dùng DoubleClick Search.
orderBy[].sortOrder string Hướng sắp xếp, là ascending hoặc descending.
includeDeletedEntities boolean Xác định xem có nên đưa thực thể đã xoá vào báo cáo hay không. Giá trị mặc định là false. Không được dùng nữa, vui lòng sử dụng includeRemovedEntities.
verifySingleTimeZone boolean Nếu giá trị là true, báo cáo sẽ chỉ được tạo nếu tất cả dữ liệu số liệu thống kê yêu cầu đều bắt nguồn từ một múi giờ duy nhất. Giá trị mặc định là false.
downloadFormat string Định dạng mà báo cáo sẽ được trả về. Hiện tại, csv hoặc tsv được hỗ trợ.
statisticsCurrency string Chỉ định đơn vị tiền tệ mà hệ thống sẽ trả về số tiền. Các giá trị có thể là: usd, agency (hợp lệ nếu báo cáo thuộc về công ty quảng cáo trở xuống), advertiser (hợp lệ nếu báo cáo là * nhà quảng cáo trở xuống) hoặc account (hợp lệ nếu báo cáo là ở phạm vi tài khoản công cụ trở xuống).
startRow integer Chỉ báo cáo đồng bộ. Chỉ mục từ 0 của hàng đầu tiên cần trả về. Giá trị có thể chấp nhận là từ 0 đến 50000. Mặc định là 0.
rowCount integer Chỉ báo cáo đồng bộ. Số hàng tối đa cần trả về; hàng bổ sung sẽ bị loại bỏ. Giá trị có thể chấp nhận là từ 0 đến 10000. Mặc định là 10000.
maxRowsPerFile integer Chỉ báo cáo không đồng bộ. Số hàng tối đa cho mỗi tệp báo cáo. Một báo cáo lớn sẽ được chia thành nhiều tệp dựa trên trường này. Giá trị có thể chấp nhận là từ 1000000 đến 100000000.
includeRemovedEntities boolean Xác định xem có nên đưa thực thể đã xoá vào báo cáo hay không. Giá trị mặc định là false.
columns[].customDimensionName string Phân đoạn báo cáo theo phương diện tuỳ chỉnh. Báo cáo phải dành cho một nhà quảng cáo trở xuống và thứ nguyên tùy chỉnh phải được thiết lập trong DoubleClick Search. Tên phương diện tuỳ chỉnh (xuất hiện trong DoubleClick Search) có phân biệt chữ hoa chữ thường.

Nếu mục tiêu này được sử dụng trong báo cáo lượt chuyển đổi, thì hệ thống sẽ trả về giá trị của phương diện tuỳ chỉnh đã chỉ định cho lượt chuyển đổi nhất định (nếu có). Cột này không phân đoạn báo cáo lượt chuyển đổi.
columns[].platformSource string Nền tảng được dùng để cung cấp dữ liệu cho phương diện tuỳ chỉnh. Giá trị có thể chấp nhận là "lũ lụt".
filters[].column.customDimensionName string Phân đoạn báo cáo theo phương diện tuỳ chỉnh. Báo cáo phải dành cho một nhà quảng cáo trở xuống và thứ nguyên tùy chỉnh phải được thiết lập trong DoubleClick Search. Tên phương diện tuỳ chỉnh (xuất hiện trong DoubleClick Search) có phân biệt chữ hoa chữ thường.

Nếu mục tiêu này được sử dụng trong báo cáo lượt chuyển đổi, thì hệ thống sẽ trả về giá trị của phương diện tuỳ chỉnh đã chỉ định cho lượt chuyển đổi nhất định (nếu có). Cột này không phân đoạn báo cáo lượt chuyển đổi.
filters[].column.headerText string Văn bản dùng để xác định cột này trong kết quả báo cáo; mặc định là columnName hoặc savedColumnName khi không được chỉ định. Tính năng này có thể được sử dụng để ngăn chặn xung đột giữa các cột DoubleClick Search và các cột đã lưu có cùng tên.
filters[].column.startDate string Ngày bao gồm ở định dạng YYYY-MM-DD. Khi được cung cấp, giá trị này sẽ chỉ ghi đè phạm vi thời gian tổng thể của báo cáo cho cột này. Bạn phải cung cấp thông tin này cùng với endDate.
filters[].column.endDate string Ngày không phân biệt đối xử ở định dạng YYYY-MM-DD. Khi được cung cấp, giá trị này sẽ chỉ ghi đè phạm vi thời gian tổng thể của báo cáo cho cột này. Bạn phải cung cấp thông tin này cùng với startDate.
filters[].column.groupByColumn boolean Chỉ báo cáo đồng bộ. Đặt thành true để nhóm theo cột này. Giá trị mặc định là false.
filters[].column.platformSource string Nền tảng được dùng để cung cấp dữ liệu cho phương diện tuỳ chỉnh. Giá trị có thể chấp nhận là "lũ lụt".
orderBy[].column.customDimensionName string Phân đoạn báo cáo theo phương diện tuỳ chỉnh. Báo cáo phải dành cho một nhà quảng cáo trở xuống và thứ nguyên tùy chỉnh phải được thiết lập trong DoubleClick Search. Tên phương diện tuỳ chỉnh (xuất hiện trong DoubleClick Search) có phân biệt chữ hoa chữ thường.

Nếu mục tiêu này được sử dụng trong báo cáo lượt chuyển đổi, thì hệ thống sẽ trả về giá trị của phương diện tuỳ chỉnh đã chỉ định cho lượt chuyển đổi nhất định (nếu có). Cột này không phân đoạn báo cáo lượt chuyển đổi.
orderBy[].column.headerText string Văn bản dùng để xác định cột này trong kết quả báo cáo; mặc định là columnName hoặc savedColumnName khi không được chỉ định. Tính năng này có thể được sử dụng để ngăn chặn xung đột giữa các cột DoubleClick Search và các cột đã lưu có cùng tên.
orderBy[].column.startDate string Ngày bao gồm ở định dạng YYYY-MM-DD. Khi được cung cấp, giá trị này sẽ chỉ ghi đè phạm vi thời gian tổng thể của báo cáo cho cột này. Bạn phải cung cấp thông tin này cùng với endDate.
orderBy[].column.endDate string Ngày không phân biệt đối xử ở định dạng YYYY-MM-DD. Khi được cung cấp, giá trị này sẽ chỉ ghi đè phạm vi thời gian tổng thể của báo cáo cho cột này. Bạn phải cung cấp thông tin này cùng với startDate.
orderBy[].column.groupByColumn boolean Chỉ báo cáo đồng bộ. Đặt thành true để nhóm theo cột này. Giá trị mặc định là false.
orderBy[].column.platformSource string Nền tảng được dùng để cung cấp dữ liệu cho phương diện tuỳ chỉnh. Giá trị có thể chấp nhận là "lũ lụt".
columns[].customMetricName string Tên của một chỉ số tuỳ chỉnh mà bạn muốn đưa vào báo cáo. Báo cáo phải dành cho một nhà quảng cáo trở xuống và chỉ số tùy chỉnh phải được thiết lập trong DoubleClick Search. Tên chỉ số tùy chỉnh (xuất hiện trong DoubleClick Search) có phân biệt chữ hoa chữ thường.
filters[].column.customMetricName string Tên của một chỉ số tuỳ chỉnh mà bạn muốn đưa vào báo cáo. Báo cáo phải dành cho một nhà quảng cáo trở xuống và chỉ số tùy chỉnh phải được thiết lập trong DoubleClick Search. Tên chỉ số tùy chỉnh (xuất hiện trong DoubleClick Search) có phân biệt chữ hoa chữ thường.
orderBy[].column.customMetricName string Tên của một chỉ số tuỳ chỉnh mà bạn muốn đưa vào báo cáo. Báo cáo phải dành cho một nhà quảng cáo trở xuống và chỉ số tùy chỉnh phải được thiết lập trong DoubleClick Search. Tên chỉ số tùy chỉnh (xuất hiện trong DoubleClick Search) có phân biệt chữ hoa chữ thường.
columns[].productReportPerspective string Trả về chỉ số chỉ cho một loại hoạt động sản phẩm cụ thể. Các giá trị được chấp nhận là:
  • "sold": chỉ trả về chỉ số của những sản phẩm đã bán
  • "advertised": chỉ trả về các chỉ số cho các sản phẩm đã được quảng cáo trong chiến dịch Mua sắm và có thể đã được bán hoặc chưa bán
filters[].column.productReportPerspective string Trả về chỉ số chỉ cho một loại hoạt động sản phẩm cụ thể. Các giá trị được chấp nhận là:
  • "sold": chỉ trả về chỉ số của những sản phẩm đã bán
  • "advertised": chỉ trả về các chỉ số cho các sản phẩm đã được quảng cáo trong chiến dịch Mua sắm và có thể đã được bán hoặc chưa bán
orderBy[].column.productReportPerspective string Trả về chỉ số chỉ cho một loại hoạt động sản phẩm cụ thể. Các giá trị được chấp nhận là:
  • "sold": chỉ trả về chỉ số của những sản phẩm đã bán
  • "advertised": chỉ trả về các chỉ số cho các sản phẩm đã được quảng cáo trong chiến dịch Mua sắm và có thể đã được bán hoặc chưa bán

Phản hồi

Nếu thành công, phương thức này sẽ trả về một tài nguyên Báo cáo trong nội dung phản hồi.

Hãy dùng thử!

Hãy sử dụng APIs Explorer (Trình khám phá API) bên dưới để gọi phương thức này trên dữ liệu trực tiếp và xem phản hồi. Ngoài ra, hãy thử độc lập Trình khám phá.