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
}
ชื่อพร็อพเพอร์ตี้ ค่า คำอธิบาย หมายเหตุ
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" สำหรับเช็กเกีย
  • "de" สำหรับเยอรมัน
  • "en" สำหรับภาษาอังกฤษ
  • "es" สำหรับสเปน
  • "fr" สำหรับฝรั่งเศส
  • "it" สำหรับอิตาลี
  • "ja" สำหรับภาษาญี่ปุ่น
  • "ko" สำหรับเกาหลี
  • "pl" สำหรับภาษาโปแลนด์
  • "pt-BR" สำหรับ BRAZILIAN_PORTUGUESE
  • "ru" สำหรับรัสเซีย
  • "tr" สำหรับตุรกี
  • "uk" สำหรับสหราชอาณาจักร
  • "zh-CN" สำหรับ CHINA_CHINESE
  • "zh-TW" สำหรับ TAIWAN_CHINESE

สตริงภาษาที่ไม่ได้อยู่ในรายการด้านบนจะสร้างรายงานเป็นภาษาอังกฤษ

metadata.reportCount integer จำนวนรายงานที่สร้างขึ้นสำหรับ Query
metadata.running boolean รายงานล่าสุดกำลังทำงานอยู่หรือไม่
metadata.sendNotification boolean จะส่งการแจ้งเตือนทางอีเมลเมื่อรายงานพร้อมแล้วหรือไม่ ค่าเริ่มต้นคือ false
metadata.shareEmailAddress[] list รายการที่อยู่อีเมลที่จะส่งการแจ้งเตือนทางอีเมลเมื่อรายงานเสร็จสิ้น แยกต่างหากจาก sendNotification
metadata.title string ชื่อการค้นหา ซึ่งใช้เพื่อตั้งชื่อรายงานที่สร้างจาก Query นี้
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 รหัสการค้นหา
reportDataEndTimeMs long เวลาสิ้นสุดสำหรับข้อมูลที่แสดงในรายงาน โปรดทราบว่าต้องระบุ reportDataEndTimeMs หาก metadata.dataRange คือ CUSTOM_DATES และจะไม่มีการละเว้น
reportDataStartTimeMs long เวลาเริ่มต้นสำหรับข้อมูลที่แสดงในรายงาน โปรดทราบว่าต้องระบุ reportDataStartTimeMs หาก metadata.dataRange คือ CUSTOM_DATES และจะไม่มีการละเว้น
schedule nested object ข้อมูลเกี่ยวกับความถี่และเวลาที่จะเรียกใช้การค้นหา
schedule.endTimeMs long วันที่และเวลาที่จะเรียกใช้การค้นหาเป็นระยะจนถึง
schedule.frequency string ความถี่ในการทำการค้นหา

ค่าที่ยอมรับได้ มีดังนี้
  • "DAILY"
  • "MONTHLY"
  • "ONE_TIME"
  • "QUARTERLY"
  • "SEMI_MONTHLY"
  • "WEEKLY"
schedule.nextRunMinuteOfDay integer เลิกใช้งานแล้ว ฟิลด์นี้ไม่มีผล
schedule.nextRunTimezoneCode string รหัสเขตเวลา Canonical สำหรับเวลาในการสร้างรายงาน ค่าเริ่มต้นคือ America/New_York
timezoneCode string รหัสเขตเวลา Canonical สำหรับเวลาของข้อมูลรายงาน ค่าเริ่มต้นคือ America/New_York

เมธอด

createquery
สร้างการค้นหา
deletequery
ลบการค้นหาที่จัดเก็บไว้และรายงานที่จัดเก็บไว้ที่เชื่อมโยง
getquery
เรียกข้อมูลการค้นหาที่จัดเก็บไว้
listqueries
เรียกข้อมูลการค้นหาที่จัดเก็บไว้
การค้นหา
เรียกใช้การค้นหาที่จัดเก็บไว้เพื่อสร้างรายงาน