Queries

如需本資源的方法清單，請見本頁結尾。

資源表示法

代表查詢。

{
  "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
}
資源名稱 值 說明 Notes
kind string 識別這是哪種資源類型。值：固定字串 "doubleclickbidmanager#query"。
metadata nested object 查詢中繼資料。
metadata.dataRange string 報表資料範圍。

可接受的值如下：
  • 「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 產生的報表格式。

可接受的值如下：
  • 「CSV」
  • 「EXCEL_CSV」
  • 「XLSX」
metadata.googleCloudStoragePathForLatestReport string Google Cloud Storage 中儲存最新報表的位置路徑。
metadata.googleDrivePathForLatestReport string Google 雲端硬碟中最新報表路徑。
metadata.latestReportRunTimeMs long 最新報表開始執行的時間。
metadata.locale string

產生的報表語言代碼。可接受的值如下：

  • 「cs」為 CZECH
  • 「de」代表 GERMAN
  • 將「en」用於英文
  • 「es」代表 SPANISH
  • 「fr」：FRENCH
  • 「it」義大利 ITALIAN
  • 「ja」代表 JAPANESE
  • 「ko」代表 KOREAN
  • 為 POLISH 支付「pl」
  • 「pt-BR」：BRAZILIAN_PORTUGUESE
  • 適用於「ru」的 RUSSIAN
  • 「tr」代表「TURKISH」
  • 「uk」適用於 UKRAINIAN
  • 「zh-CN」代表 CHINA_CHINESE
  • 「zh-TW」代表 TAIWAN_CHINESE

不在上述清單中的語言代碼字串會產生英文報告。
metadata.reportCount integer 針對查詢產生的報表數量。
metadata.running boolean 指出是否正在執行最新報表。
metadata.sendNotification boolean 是否要在報表準備就緒時傳送電子郵件通知。預設為 False。
metadata.shareEmailAddress[] list 報表製作完成後，電子郵件通知的電子郵件地址清單。與「sendNotification」分開。
metadata.title string 查詢標題。用於為這項查詢產生的報表命名。
params nested object 查詢參數。
params.filters[] list 符合報表中的流量資料篩選器。
params.filters[].type string 篩選器類型。

可接受的值如下：
  • 「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 篩選器值。
params.groupBys[] list 資料會依照這個欄位中列出的篩選條件進行分組。
params.includeInviteData boolean 已淘汰，現已不使用這個欄位。
params.metrics[] list 指標，以納入報表為欄。
params.type string 報表類型。

類型限制：
  • TYPE_ORDER_ID 支援過去 60 天內的日期範圍。
  • 「TYPE_AUDIENCE_COMPOSITION」、「TYPE_INVENTORY_AVAILABILITY」和「TYPE_TRUEVIEW_IAR」支援的日期範圍最多為 30 天。


可接受的值如下：
  • 「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 查詢 ID。
reportDataEndTimeMs long 報表資料的結束時間。請注意，如果 metadata.dataRange 是 CUSTOM_DATES，則為 reportDataEndTimeMs。
reportDataStartTimeMs long 報表資料中顯示的開始時間。請注意，如果 metadata.dataRange 是 CUSTOM_DATES，則為 reportDataStartTimeMs。
schedule nested object 執行查詢的頻率和時機相關資訊。
schedule.endTimeMs long 定期執行查詢的時間。
schedule.frequency string 執行查詢的頻率。

可接受的值如下：
  • 「DAILY」
  • 「MONTHLY」
  • 「ONE_TIME」
  • 「QUARTERLY」
  • 「SEMI_MONTHLY」
  • 「WEEKLY」
schedule.nextRunMinuteOfDay integer 已淘汰，此欄位無效。
schedule.nextRunTimezoneCode string 報表產生時間的標準時區代碼。預設值為 America/New_York。
timezoneCode string 報表資料時間的標準時區代碼。預設值為 America/New_York。

方法

建立查詢
建立查詢。
刪除查詢
刪除已儲存的查詢和相關聯的已儲存報表。
取得查詢
擷取已儲存的查詢。
清單查詢
擷取已儲存的查詢。
執行查詢
執行已儲存的查詢以產生報表。