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

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

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

22 กันยายน 2025

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

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

v2

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

    ค่า Filter

    FILTER_DFP_ORDER_ID

    FILTER_INSERTION_ORDER

    FILTER_YOUTUBE_PROGRAMMATIC_GUARANTEED_PARTNER

1 มีนาคม 2025

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

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

v2

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

    ค่าแจกแจงค่า
    ReportType INVENTORY_AVAILABILITY

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

    ค่าตัวกรอง

    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 เวอร์ชัน 2

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

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

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

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

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

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

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

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

v2

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

ไม่มี

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

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