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" สําหรับ CZECH
  • "de" สําหรับเยอรมัน
  • "en" สําหรับ ENGLISH
  • "es" สําหรับSPANISH
  • "fr" สําหรับภาษาฝรั่งเศส
  • "it" สําหรับอิตาลี
  • "ja" สําหรับภาษาญี่ปุ่น
  • "ko" สําหรับเกาหลี
  • "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 รหัสคําค้นหา
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

วิธีการ

สร้างคําค้นหา
สร้างการค้นหา
ลบคําค้นหา
ลบการค้นหาที่จัดเก็บไว้ รวมถึงรายงานที่เก็บไว้ซึ่งเกี่ยวข้องกัน
รับข้อความค้นหา
ดึงการค้นหาที่จัดเก็บไว้
รายการ
ดึงการค้นหาที่จัดเก็บไว้
เรียกใช้คําค้นหา
เรียกใช้การค้นหาที่จัดเก็บไว้เพื่อสร้างรายงาน