บันทึกประจำรุ่น

หน้านี้มีบันทึกประจำรุ่นสำหรับ Google Bid Manager API

เวอร์ชัน API ล่าสุด: v2

22 กันยายน 2025

ปัญหาที่ทราบ

หยุดให้บริการค่า Enum 3 รายการเนื่องจากมีการใช้งานน้อย ตามที่ได้ประกาศไว้ก่อนหน้านี้ในศูนย์ช่วยเหลือ Display & Video 360Filter

v2

• Filters ต่อไปนี้ได้เลิกใช้งานแล้ว

  ค่า Filter
  FILTER_DFP_ORDER_ID FILTER_YOUTUBE_PROGRAMMATIC_GUARANTEED_INSERTION_ORDER FILTER_YOUTUBE_PROGRAMMATIC_GUARANTEED_PARTNER

1 มีนาคม 2025

ปัญหาที่ทราบ

หยุดให้บริการรายงานความพร้อมของพื้นที่โฆษณา TrueView ของ YouTube และมิติข้อมูลที่เกี่ยวข้อง ตามที่ได้ประกาศไว้ก่อนหน้านี้ในศูนย์ช่วยเหลือของ Display & Video 360

v2

• ตัวกรองต่อไปนี้ได้เลิกใช้งานแล้ว

  ค่าตัวกรอง

  FILTER_DETAILED_DEMOGRAPHICS FILTER_DETAILED_DEMOGRAPHICS_ID FILTER_HOUSEHOLD_INCOME FILTER_LIFE_EVENT FILTER_REMARKETING_LIST FILTER_TRUEVIEW_IAR_AGE FILTER_TRUEVIEW_IAR_CATEGORY FILTER_TRUEVIEW_IAR_CITY FILTER_TRUEVIEW_IAR_COUNTRY FILTER_TRUEVIEW_IAR_COUNTRY_NAME FILTER_TRUEVIEW_IAR_GENDER FILTER_TRUEVIEW_IAR_INTEREST FILTER_TRUEVIEW_IAR_LANGUAGE FILTER_TRUEVIEW_IAR_PARENTAL_STATUS FILTER_TRUEVIEW_IAR_REGION_NAME 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_YOUTUBE_CHANNEL FILTER_YOUTUBE_VIDEO

• เมตริกต่อไปนี้ได้เลิกใช้งานแล้ว

  ค่าเมตริก
  METRIC_POTENTIAL_VIEWS METRIC_TEA_TRUEVIEW_IMPRESSIONS METRIC_TEA_TRUEVIEW_UNIQUE_COOKIES

20 พฤศจิกายน 2024

ฟีเจอร์ใหม่

เปิดตัว FILTER_UNIQUE_REACH_SAMPLE_SIZE_ID ซึ่งจะช่วยให้รวมข้อมูลที่มีความเชื่อมั่นต่ำสำหรับเมตริกที่มีคำนำหน้าต่อไปนี้ได้

• METRIC_UNIQUE_REACH_
• METRIC_VIRTUAL_PEOPLE_DUPLICATE_
• METRIC_VIRTUAL_PEOPLE_EXCLUSIVE_
• METRIC_VIRTUAL_PEOPLE_OVERLAP_

คุณต้องรวมเมตริกที่เกี่ยวข้องอย่างน้อย 1 รายการเมื่อใช้ตัวกรองนี้

เมื่อเปิดตัวแล้ว คำค้นหาที่ไม่มีตัวกรองนี้จะใช้ลักษณะการทำงานเริ่มต้นก่อนหน้าโดยค่าเริ่มต้น ซึ่งจะรวมเฉพาะข้อมูลที่มีความเชื่อมั่นสูง ตั้งแต่วันที่ 4 กุมภาพันธ์ 2025 เป็นต้นไป คำค้นหาที่ไม่มีตัวกรองนี้จะรวมข้อมูลที่มีความน่าเชื่อถือต่ำโดยค่าเริ่มต้น

v2

• เราได้เพิ่มตัวกรองต่อไปนี้

  ประเภทตัวกรอง	ค่าที่ใช้ได้
  FILTER_UNIQUE_REACH_SAMPLE_SIZE_ID	0: รวมข้อมูลที่มีความน่าเชื่อถือต่ำ (ค่าเริ่มต้นหลังวันที่ 4 กุมภาพันธ์ 2025) 1: รวมเฉพาะข้อมูลที่มีความน่าเชื่อถือสูง (ค่าเริ่มต้นก่อน4 กุมภาพันธ์ 2025)

1 ตุลาคม 2024

ฟีเจอร์ใหม่

ไม่มี

ปัญหาที่ทราบ

v2

การเลิกใช้งานมิติข้อมูลการรายงานการสร้างโมเดลพื้นที่โฆษณาที่ไม่ระบุชื่อ (AIM)

มิติข้อมูล FILTER_ANONYMOUS_INVENTORY_MODELING จะเลิกใช้งาน

การสร้างหรือเรียกใช้แหล่งข้อมูล Query โดยใช้ค่าที่เลิกใช้งานแล้วใน params.groupBy จะแสดงข้อผิดพลาด 400

เมตริก DST/ROC (ค่าธรรมเนียมในการดำเนินงานตามกฎระเบียบ) และค่าใช้จ่ายสื่อทั้งหมดใช้ร่วมกับรายงาน YOUTUBE ไม่ได้

ค่าเมตริกต่อไปนี้ใช้ในรายงาน YOUTUBE ไม่ได้อีกต่อไป

• METRIC_TOTAL_MEDIACOST_ADVERTISER
• METRIC_TOTAL_MEDIACOST_ECPAPC_ADVERTISER
• METRIC_TOTAL_MEDIACOST_ECPAPC_PARTNER
• METRIC_TOTAL_MEDIACOST_ECPAPC_USD
• METRIC_TOTAL_MEDIACOST_ECPAPV_ADVERTISER
• METRIC_TOTAL_MEDIACOST_ECPAPV_PARTNER
• METRIC_TOTAL_MEDIACOST_ECPAPV_USD
• METRIC_TOTAL_MEDIACOST_ECPA_ADVERTISER
• METRIC_TOTAL_MEDIACOST_ECPA_PARTNER
• METRIC_TOTAL_MEDIACOST_ECPA_USD
• METRIC_TOTAL_MEDIACOST_ECPCV_ADVERTISER
• METRIC_TOTAL_MEDIACOST_ECPCV_PARTNER
• METRIC_TOTAL_MEDIACOST_ECPCV_USD
• METRIC_TOTAL_MEDIACOST_ECPC_ADVERTISER
• METRIC_TOTAL_MEDIACOST_ECPC_PARTNER
• METRIC_TOTAL_MEDIACOST_ECPC_USD
• METRIC_TOTAL_MEDIACOST_ECPM_ADVERTISER
• METRIC_TOTAL_MEDIACOST_ECPM_PARTNER
• METRIC_TOTAL_MEDIACOST_ECPM_USD
• METRIC_TOTAL_MEDIACOST_PARTNER
• METRIC_TOTAL_MEDIACOST_USD
• METRIC_TOTAL_MEDIACOST_VIEWABLE_ECPM_ADVERTISER
• METRIC_TOTAL_MEDIACOST_VIEWABLE_ECPM_PARTNER
• METRIC_TOTAL_MEDIACOST_VIEWABLE_ECPM_USD
• METRIC_FEE32_ADVERTISER
• METRIC_FEE32_PARTNER
• METRIC_FEE32_USD

การสร้างหรือเรียกใช้ทรัพยากร Query ที่มีparams.typeของ YOUTUBE และค่าเมตริกที่เกี่ยวข้องในparams.metrics จะแสดงข้อผิดพลาด 400

1 พฤษภาคม 2024

ฟีเจอร์ใหม่

ไม่มี

ปัญหาที่ทราบ

v2

การหยุดให้บริการรายงานเส้นทางแบบเต็มและรายงานการระบุแหล่งที่มาของเส้นทาง

เราจะหยุดให้บริการรายงานเส้นทางแบบสมบูรณ์และรายงานการระบุแหล่งที่มาของเส้นทาง การเรียกข้อมูลหรือสร้างทรัพยากรQueryและReportประเภทเหล่านี้ จะทำให้เกิดข้อผิดพลาด

ค่าต่อไปนี้ ReportType จะ หยุดให้บริการ

• FULL_PATH
• PATH_ATTRIBUTION

ฟิลด์ pathQueryOptions ของออบเจ็กต์ Options ก็จะ หยุดให้บริการด้วย

28 กุมภาพันธ์ 2024

ฟีเจอร์ใหม่

ไม่มี

ปัญหาที่ทราบ

v2

การหยุดให้บริการค่าเมตริก Conversion จากหลายอุปกรณ์

เลิกใช้งานเมตริก Conversion จากหลายอุปกรณ์ ค่าเมตริกของ Bid Manager API ต่อไปนี้จะรวมอยู่ด้วย

• METRIC_CM360_POST_CLICK_REVENUE_CROSS_ENVIRONMENT
• METRIC_CM360_POST_VIEW_REVENUE_CROSS_ENVIRONMENT
• METRIC_POST_CLICK_CONVERSIONS_CROSS_ENVIRONMENT
• METRIC_POST_VIEW_CONVERSIONS_CROSS_ENVIRONMENT
• METRIC_TOTAL_CONVERSIONS_CROSS_ENVIRONMENT

6 กรกฎาคม 2022

ฟีเจอร์ใหม่

เปิดตัว Bid Manager API v2

ทำการเปลี่ยนแปลงโครงสร้างของ API ซึ่งรวมถึงการอัปเดต ปลายทางของบริการ และการเปลี่ยนชื่อบริการและเมธอด

อัปเดตทรัพยากรคำค้นหาและรายงานอย่างมีนัยสำคัญโดย นำฟิลด์ที่ไม่จำเป็นออก จัดระเบียบฟิลด์ที่มีอยู่ใหม่ และเปลี่ยนประเภทฟิลด์ ซึ่งรวมถึงการเปลี่ยนประเภทฟิลด์เพื่อใช้ออบเจ็กต์ที่มีชื่อแทนคำจำกัดความ "ออบเจ็กต์ที่ซ้อนกัน" ทั่วไป

ต้องเรียกใช้การค้นหาเฉพาะกิจโดยใช้วิธีqueries.run แทนที่จะให้ระบบเรียกใช้โดยอัตโนมัติหลังจากสร้าง

แทนที่พารามิเตอร์การค้นหา queries.run asynchronous ด้วย synchronous

การดึงข้อมูลรายงานที่ง่ายขึ้นผ่านการเปลี่ยนแปลงต่อไปนี้

• การเพิ่มวิธีการ queries.reports.get
• การเพิ่มพารามิเตอร์การค้นหา orderBy ลงใน queries.reports.list
• การอัปเดตร่างกายการตอบกลับของ queries.run จากออบเจ็กต์ว่างเป็น อินสแตนซ์ของทรัพยากร Report ที่สร้างขึ้น

อัปเดตข้อความแสดงข้อผิดพลาดที่ API แสดงให้มีความเฉพาะเจาะจงมากขึ้นและมี วิธีแก้ปัญหาที่แนะนำเพิ่มเติม

ทำตามวิธีการที่ระบุไว้ในคู่มือการย้ายข้อมูล v2 เพื่อย้ายข้อมูลจาก v1.1 ไปยัง v2

v2

• มีการเปลี่ยนแปลงปลายทางบริการดังนี้

  ปลายทางบริการ v1	ปลายทางบริการ v2
  https://www.googleapis.com/doubleclickbidmanager	https://doubleclickbidmanager.googleapis.com

• เราได้เปลี่ยนชื่อบริการดังนี้

  บริการ v1	บริการ v2
  คำค้นหา	คำค้นหา
  รายงาน	queries.reports

• ระบบได้เปลี่ยนชื่อเมธอดดังนี้

  เมธอด v1	เมธอด v2
  Queries.createquery	queries.create
  Queries.deletequery	queries.delete
  Queries.getquery	queries.get
  Queries.listqueries	queries.list
  Queries.runquery	queries.run
  Reports.listreports	queries.reports.list

• เราได้เพิ่มวิธีการต่อไปนี้

  บริการ	วิธีการ
  queries.reports	รับ

• เมธอดต่อไปนี้มีเนื้อหาการตอบกลับใหม่

  วิธีการ	ออบเจ็กต์เนื้อหาการตอบกลับใหม่
  queries.run	โปรดรายงาน

• ระบบได้นำฟิลด์ต่อไปนี้ออกแล้ว

  ทรัพยากร	ช่อง
  queries.list เนื้อหาการตอบกลับ	ชนิด
  queries.reports.list เนื้อหาการตอบกลับ	ชนิด
  การค้นหา	ชนิด reportDataEndTimeMs reportDataStartTimeMs timezoneCode
  RunQueryRequest	reportDataEndTimeMs reportDataStartTimeMs timezoneCode

• ระบบได้เปลี่ยนประเภทออบเจ็กต์ของช่องต่อไปนี้เป็นประเภทต่อไปนี้

  ทรัพยากร	ช่อง	ประเภทออบเจ็กต์
  การค้นหา	ข้อมูลเมตา params กำหนดเวลา	QueryMetadata พารามิเตอร์ QuerySchedule
  โปรดรายงาน	คีย์ ข้อมูลเมตา params	ReportKey ReportMetadata พารามิเตอร์
  RunQueryRequest	dataRange	DataRange

• เราได้เพิ่มพารามิเตอร์การค้นหาวิธีการต่อไปนี้

  วิธีการ	พารามิเตอร์การค้นหา
  queries.list	orderBy
  queries.reports.list	orderBy
  queries.run	พร้อมกัน

• ระบบได้นำพารามิเตอร์การค้นหาของเมธอดต่อไปนี้ออกแล้ว

  วิธีการ	พารามิเตอร์การค้นหา
  queries.create	ไม่พร้อมกัน
  queries.run	ไม่พร้อมกัน

• มีการเพิ่มค่าตัวกรองต่อไปนี้

  ค่าตัวกรอง
  FILTER_INVENTORY_MEDIA_COST_TYPE
  FILTER_TARGETING_EXPANSION

• ระบบได้นำค่าตัวกรองต่อไปนี้ออกแล้ว

  ค่าตัวกรอง
  FILTER_TRUEVIEW_IAR_REGION

• มีการเพิ่มค่าเมตริกต่อไปนี้

  ค่าเมตริก
  METRIC_STORE_VISIT_VIEW_THROUGH_CONVERSIONS
  METRIC_UNIQUE_REACH_AVERAGE_VIEWABLE_IMPRESSION_FREQUENCY
  METRIC_UNIQUE_REACH_IMPRESSION_REACH_ADDED_WITH_CROSS_STACK_FCAP
  METRIC_UNIQUE_REACH_IMPRESSION_REACH_ADDED_WITH_PG_FMGMT
  METRIC_UNIQUE_REACH_INCREMENTAL_CLICK_REACH
  METRIC_UNIQUE_REACH_INCREMENTAL_IMPRESSION_REACH
  METRIC_UNIQUE_REACH_INCREMENTAL_TOTAL_REACH
  METRIC_UNIQUE_REACH_INCREMENTAL_VIEWABLE_IMPRESSION_REACH
  METRIC_UNIQUE_REACH_VIEWABLE_IMPRESSION_REACH

ปัญหาที่ทราบ

ไม่มี

รุ่นก่อนหน้า

หากต้องการอ่านเกี่ยวกับการเปิดตัว Bid Manager API ก่อนหน้านี้สำหรับเวอร์ชันที่หยุดให้บริการ โปรดดูบันทึกประจำรุ่นที่เก็บถาวร