Trang này được dịch bởi Cloud Translation API.

Queries

Để biết danh sách các phương thức cho tài nguyên này, hãy xem ở cuối trang.

Biểu diễn tài nguyên

Biểu thị một truy vấn.

{
  "kind": "doubleclickbidmanager#query",
  "queryId": long,
  "metadata": {
    "title": string,
    "dataRange": string,
    "format": string,
    "running": boolean,
    "reportCount": integer,
    "googleCloudStoragePathForLatestReport": string,
    "latestReportRunTimeMs": long,
    "googleDrivePathForLatestReport": string,
    "sendNotification": boolean,
    "shareEmailAddress": [
      string
    ],
    "locale": string
  },
  "params": {
    "type": string,
    "groupBys": [
      string
    ],
    "filters": [
      {
        "type": string,
        "value": string
      }
    ],
    "metrics": [
      string
    ],
    "includeInviteData": boolean
  },
  "schedule": {
    "frequency": string,
    "endTimeMs": long,
    "nextRunMinuteOfDay": integer,
    "nextRunTimezoneCode": string
  },
  "reportDataStartTimeMs": long,
  "reportDataEndTimeMs": long,
  "timezoneCode": string
}

Tên tài sản	Giá trị	Mô tả
`kind`	`string`	Xác định loại tài nguyên này. Giá trị: chuỗi cố định `"doubleclickbidmanager#query"`.
`metadata`	`nested object`	Siêu dữ liệu truy vấn.
`metadata.dataRange`	`string`	Phạm vi của dữ liệu báo cáo. Các giá trị được chấp nhận là: "`ALL_TIME`" "`CURRENT_DAY`" "`CUSTOM_DATES`" "`LAST_14_DAYS`" "`LAST_30_DAYS`" "`LAST_365_DAYS`" "`LAST_7_DAYS`" "`LAST_90_DAYS`" "`MONTH_TO_DATE`" "`PREVIOUS_DAY`" "`PREVIOUS_HALF_MONTH`" "`PREVIOUS_MONTH`" "`PREVIOUS_QUARTER`" "`PREVIOUS_WEEK`" "`PREVIOUS_YEAR`" "`QUARTER_TO_DATE`" "`TYPE_NOT_SUPPORTED`" "`WEEK_TO_DATE`" "`YEAR_TO_DATE`"
`metadata.format`	`string`	Định dạng của báo cáo được tạo. Các giá trị được chấp nhận là: "`CSV`" "`EXCEL_CSV`" "`XLSX`"
`metadata.googleCloudStoragePathForLatestReport`	`string`	Đường dẫn đến vị trí trong Google Cloud Storage nơi lưu trữ báo cáo mới nhất.
`metadata.googleDrivePathForLatestReport`	`string`	Đường dẫn trong Google Drive để tải báo cáo mới nhất.
`metadata.latestReportRunTimeMs`	`long`	Thời điểm báo cáo mới nhất bắt đầu chạy.
`metadata.locale`	`string`	Ngôn ngữ của các báo cáo đã tạo. Các giá trị được chấp nhận là: "`cs`" cho CZECH "`de`" dành cho ĐỨC "`en`" bằng TIẾNG VIỆT "`es`" cho tiếng Tây Ban Nha "`fr`" dành cho PHÁP "`it`" cho Ý "`ja`" cho TIẾNG NHẬT "`ko`" cho KOREAN "`pl`" cho POLish "`pt-BR`" cho BRAZLIAN_PORT8ESE "`ru`" cho NGA "`tr`" cho tiếng TURKish "`uk`" cho UKRAINIAN "`zh-CN`" cho CHINA_CHINESE "`zh-TW`" cho TAIWAN_CHINESE Chuỗi ngôn ngữ không có trong danh sách ở trên sẽ tạo báo cáo bằng tiếng Anh.
`metadata.reportCount`	`integer`	Số báo cáo đã được tạo cho truy vấn.
`metadata.running`	`boolean`	Liệu báo cáo mới nhất có đang chạy hay không.
`metadata.sendNotification`	`boolean`	Liệu có gửi thông báo qua email khi báo cáo đã sẵn sàng hay không. Giá trị mặc định là false.
`metadata.shareEmailAddress[]`	`list`	Danh sách các địa chỉ email nhận được thông báo qua email khi báo cáo hoàn tất. Tách biệt với `sendNotification`.
`metadata.title`	`string`	Tiêu đề truy vấn. Tham số này được dùng để đặt tên cho các báo cáo được tạo từ truy vấn này.
`params`	`nested object`	Tham số truy vấn.
`params.filters[]`	`list`	Bộ lọc dùng để khớp với dữ liệu lưu lượng truy cập trong báo cáo của bạn.
`params.filters[].type`	`string`	Loại bộ lọc. Các giá trị được chấp nhận là: "`FILTER_ACTIVE_VIEW_EXPECTED_VIEWABILITY`" "`FILTER_ACTIVITY_ID`" "`FILTER_ADVERTISER`" "`FILTER_ADVERTISER_CURRENCY`" "`FILTER_ADVERTISER_TIMEZONE`" "`FILTER_AD_POSITION`" "`FILTER_AGE`" "`FILTER_AUTHORIZED_SELLER_STATE_ID`" "`FILTER_BRANDSAFE_CHANNEL_ID`" "`FILTER_BROWSER`" "`FILTER_BUDGET_SEGMENT_DESCRIPTION`" "`FILTER_CAMPAIGN_DAILY_FREQUENCY`" "`FILTER_CARRIER`" "`FILTER_CHANNEL_ID`" "`FILTER_CITY`" "`FILTER_COMPANION_CREATIVE_ID`" "`FILTER_CONVERSION_DELAY`" "`FILTER_COUNTRY`" "`FILTER_CREATIVE_ATTRIBUTE`" "`FILTER_CREATIVE_HEIGHT`" "`FILTER_CREATIVE_ID`" "`FILTER_CREATIVE_SIZE`" "`FILTER_CREATIVE_TYPE`" "`FILTER_CREATIVE_WIDTH`" "`FILTER_DATA_PROVIDER`" "`FILTER_DATE`" "`FILTER_DAY_OF_WEEK`" "`FILTER_DEVICE_MAKE`" "`FILTER_DEVICE_MODEL`" "`FILTER_DEVICE_TYPE`" "`FILTER_DFP_ORDER_ID`" "`FILTER_DMA`" "`FILTER_DV360_ACTIVITY_ID`" "`FILTER_EXCHANGE_ID`" "`FILTER_FLOODLIGHT_ACTIVITY_ID`" "`FILTER_FLOODLIGHT_PIXEL_ID`" "`FILTER_GENDER`" "`FILTER_INSERTION_ORDER`" "`FILTER_INVENTORY_COMMITMENT_TYPE`" "`FILTER_INVENTORY_DELIVERY_METHOD`" "`FILTER_INVENTORY_FORMAT`" "`FILTER_INVENTORY_RATE_TYPE`" "`FILTER_INVENTORY_SOURCE`" "`FILTER_INVENTORY_SOURCE_TYPE`" "`FILTER_KEYWORD`" "`FILTER_LINE_ITEM`" "`FILTER_LINE_ITEM_DAILY_FREQUENCY`" "`FILTER_LINE_ITEM_LIFETIME_FREQUENCY`" "`FILTER_LINE_ITEM_TYPE`" "`FILTER_MEDIA_PLAN`" "`FILTER_MOBILE_DEVICE_MAKE`" "`FILTER_MOBILE_DEVICE_MAKE_MODEL`" "`FILTER_MOBILE_DEVICE_TYPE`" "`FILTER_MOBILE_GEO`" "`FILTER_MONTH`" "`FILTER_MRAID_SUPPORT`" "`FILTER_NIELSEN_AGE`" "`FILTER_NIELSEN_COUNTRY_CODE`" "`FILTER_NIELSEN_DEVICE_ID`" "`FILTER_NIELSEN_GENDER`" "`FILTER_NOT_SUPPORTED`" "`FILTER_ORDER_ID`" "`FILTER_OS`" "`FILTER_PAGE_CATEGORY`" "`FILTER_PAGE_LAYOUT`" "`FILTER_PARTNER`" "`FILTER_PARTNER_CURRENCY`" "`FILTER_PUBLIC_INVENTORY`" "`FILTER_QUARTER`" "`FILTER_REGION`" "`FILTER_REGULAR_CHANNEL_ID`" "`FILTER_SITE_ID`" "`FILTER_SITE_LANGUAGE`" "`FILTER_SKIPPABLE_SUPPORT`" "`FILTER_TARGETED_USER_LIST`" "`FILTER_TIME_OF_DAY`" "`FILTER_TRUEVIEW_AD_GROUP_AD_ID`" "`FILTER_TRUEVIEW_AD_GROUP_ID`" "`FILTER_TRUEVIEW_AGE`" "`FILTER_TRUEVIEW_CATEGORY`" "`FILTER_TRUEVIEW_CITY`" "`FILTER_TRUEVIEW_CONVERSION_TYPE`" "`FILTER_TRUEVIEW_COUNTRY`" "`FILTER_TRUEVIEW_CUSTOM_AFFINITY`" "`FILTER_TRUEVIEW_DMA`" "`FILTER_TRUEVIEW_GENDER`" "`FILTER_TRUEVIEW_IAR_AGE`" "`FILTER_TRUEVIEW_IAR_CATEGORY`" "`FILTER_TRUEVIEW_IAR_CITY`" "`FILTER_TRUEVIEW_IAR_COUNTRY`" "`FILTER_TRUEVIEW_IAR_GENDER`" "`FILTER_TRUEVIEW_IAR_INTEREST`" "`FILTER_TRUEVIEW_IAR_LANGUAGE`" "`FILTER_TRUEVIEW_IAR_PARENTAL_STATUS`" "`FILTER_TRUEVIEW_IAR_REGION`" "`FILTER_TRUEVIEW_IAR_REMARKETING_LIST`" "`FILTER_TRUEVIEW_IAR_TIME_OF_DAY`" "`FILTER_TRUEVIEW_IAR_YOUTUBE_CHANNEL`" "`FILTER_TRUEVIEW_IAR_YOUTUBE_VIDEO`" "`FILTER_TRUEVIEW_IAR_ZIPCODE`" "`FILTER_TRUEVIEW_INTEREST`" "`FILTER_TRUEVIEW_KEYWORD`" "`FILTER_TRUEVIEW_PARENTAL_STATUS`" "`FILTER_TRUEVIEW_PLACEMENT`" "`FILTER_TRUEVIEW_REGION`" "`FILTER_TRUEVIEW_REMARKETING_LIST`" "`FILTER_TRUEVIEW_URL`" "`FILTER_TRUEVIEW_ZIPCODE`" "`FILTER_UNKNOWN`" "`FILTER_USER_LIST`" "`FILTER_USER_LIST_FIRST_PARTY`" "`FILTER_USER_LIST_THIRD_PARTY`" "`FILTER_VIDEO_AD_POSITION_IN_STREAM`" "`FILTER_VIDEO_COMPANION_SIZE`" "`FILTER_VIDEO_COMPANION_TYPE`" "`FILTER_VIDEO_CREATIVE_DURATION`" "`FILTER_VIDEO_CREATIVE_DURATION_SKIPPABLE`" "`FILTER_VIDEO_DURATION_SECONDS`" "`FILTER_VIDEO_FORMAT_SUPPORT`" "`FILTER_VIDEO_INVENTORY_TYPE`" "`FILTER_VIDEO_PLAYER_SIZE`" "`FILTER_VIDEO_RATING_TIER`" "`FILTER_VIDEO_SKIPPABLE_SUPPORT`" "`FILTER_VIDEO_VPAID_SUPPORT`" "`FILTER_WEEK`" "`FILTER_YEAR`" "`FILTER_YOUTUBE_VERTICAL`" "`FILTER_ZIP_CODE`"
`params.filters[].value`	`string`	Giá trị bộ lọc.
`params.groupBys[]`	`list`	Dữ liệu được nhóm theo những bộ lọc được liệt kê trong trường này.
`params.includeInviteData`	`boolean`	Không dùng nữa. Trường này không còn được sử dụng nữa.
`params.metrics[]`	`list`	Chỉ số cần đưa vào dưới dạng cột trong báo cáo.
`params.type`	`string`	Loại báo cáo. Giới hạn theo loại cụ thể: `TYPE_ORDER_ID` hỗ trợ phạm vi ngày tối đa là 60 ngày trong quá khứ. `TYPE_AUDIENCE_COMPOSITION`, `TYPE_INVENTORY_AVAILABILITY`, `TYPE_TRUEVIEW_IAR` phạm vi ngày hỗ trợ tối đa là 30 ngày qua. Các giá trị được chấp nhận là: "`TYPE_ACTIVE_GRP`" "`TYPE_AUDIENCE_COMPOSITION`" "`TYPE_AUDIENCE_PERFORMANCE`" "`TYPE_CLIENT_SAFE`" "`TYPE_COMSCORE_VCE`" "`TYPE_CROSS_FEE`" "`TYPE_CROSS_PARTNER`" "`TYPE_CROSS_PARTNER_THIRD_PARTY_DATA_PROVIDER`" "`TYPE_ESTIMATED_CONVERSION`" "`TYPE_FEE`" "`TYPE_GENERAL`" "`TYPE_INVENTORY_AVAILABILITY`" "`TYPE_KEYWORD`" "`TYPE_LINEAR_TV_SEARCH_LIFT`" "`TYPE_NIELSEN_AUDIENCE_PROFILE`" "`TYPE_NIELSEN_DAILY_REACH_BUILD`" "`TYPE_NIELSEN_ONLINE_GLOBAL_MARKET`" "`TYPE_NIELSEN_SITE`" "`TYPE_NOT_SUPPORTED`" "`TYPE_ORDER_ID`" "`TYPE_PAGE_CATEGORY`" "`TYPE_PETRA_NIELSEN_AUDIENCE_PROFILE`" "`TYPE_PETRA_NIELSEN_DAILY_REACH_BUILD`" "`TYPE_PETRA_NIELSEN_ONLINE_GLOBAL_MARKET`" "`TYPE_PIXEL_LOAD`" "`TYPE_REACH_AND_FREQUENCY`" "`TYPE_REACH_AUDIENCE`" "`TYPE_THIRD_PARTY_DATA_PROVIDER`" "`TYPE_TRUEVIEW`" "`TYPE_TRUEVIEW_IAR`" "`TYPE_VERIFICATION`" "`TYPE_YOUTUBE_VERTICAL`"
`queryId`	`long`	Mã truy vấn.
`reportDataEndTimeMs`	`long`	Thời gian kết thúc của dữ liệu xuất hiện trong báo cáo. Lưu ý rằng bạn phải nhập `reportDataEndTimeMs` nếu `metadata.dataRange` là `CUSTOM_DATES` và sẽ bị bỏ qua nếu không được tính.
`reportDataStartTimeMs`	`long`	Thời gian bắt đầu cho dữ liệu xuất hiện trong báo cáo. Lưu ý rằng bạn phải nhập `reportDataStartTimeMs` nếu `metadata.dataRange` là `CUSTOM_DATES` và sẽ bị bỏ qua nếu không được tính.
`schedule`	`nested object`	Thông tin về tần suất và thời điểm chạy truy vấn.
`schedule.endTimeMs`	`long`	Ngày giờ để chạy truy vấn định kỳ cho đến.
`schedule.frequency`	`string`	Tần suất chạy truy vấn. Các giá trị được chấp nhận là: "`DAILY`" "`MONTHLY`" "`ONE_TIME`" "`QUARTERLY`" "`SEMI_MONTHLY`" "`WEEKLY`"
`schedule.nextRunMinuteOfDay`	`integer`	Không dùng nữa. Trường này không có tác dụng.
`schedule.nextRunTimezoneCode`	`string`	Mã múi giờ chuẩn cho thời gian tạo báo cáo. Giá trị mặc định là `America/New_York`.
`timezoneCode`	`string`	Mã múi giờ chuẩn cho thời gian dữ liệu báo cáo. Giá trị mặc định là `America/New_York`.

Phương thức

createquery: Tạo một truy vấn.
deletequery: Xoá truy vấn đã lưu trữ cũng như các báo cáo được lưu trữ có liên quan.
getquery: Truy xuất truy vấn đã lưu trữ.
listqueries: Truy xuất các truy vấn đã lưu trữ.
chạy truy vấn: Chạy truy vấn đã lưu trữ để tạo báo cáo.

Queries Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.

Biểu diễn tài nguyên

Phương thức

Queries