การเลิกใช้งานและหยุดให้บริการ

เมื่อมีการเผยแพร่เวอร์ชันใหม่ เวอร์ชันที่เลิกใช้งานจะมีวันที่หยุดให้บริการ ซึ่งหลังจากวันที่ดังกล่าว เวอร์ชันดังกล่าวจะใช้งานไม่ได้อีกต่อไป หลักเกณฑ์อื่นๆ ที่ควรคำนึงถึงมีดังนี้

• คุณจะเผยแพร่เวอร์ชันหลักได้สูงสุด 3 เวอร์ชันพร้อมกัน
• เวอร์ชันหลักมีอายุการใช้งานประมาณ 12 เดือน ส่วนเวอร์ชันย่อยจะมีอายุการใช้งาน 10 เดือน
• คุณจะอัปเกรดได้สูงสุด 2 ครั้งต่อปี และไม่จำเป็นต้องอัปเกรดตามลำดับแบบเคร่งครัด เช่น คุณสามารถอัปเกรดจากเวอร์ชัน (N) ไปเป็นเวอร์ชัน (N+2) ได้โดยตรง
• ช่วงเวลาที่ทับซ้อนกันระหว่างวันที่เผยแพร่ไลบรารีไคลเอ็นต์ทั้งหมดสำหรับเวอร์ชันล่าสุดและเวอร์ชันที่จะหยุดให้บริการคืออย่างน้อย 20 สัปดาห์

ไลบรารีของไคลเอ็นต์รองรับบริการทุกเวอร์ชันที่มีให้บริการ คุณจึงอัปเกรดทีละน้อยได้โดยระบุบริการที่ใช้เวอร์ชันต่างๆ

ตารางเวลา

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

เวอร์ชัน API	วันที่เผยแพร่	วันที่เลิกใช้งาน	วันที่หยุดให้บริการ	คู่มือการอัปเกรด
v18	16 ตุลาคม 2024	กุมภาพันธ์ 2025	24 กันยายน 2025
v17.1	7 สิงหาคม 2024	16 ตุลาคม 2024	4 มิถุนายน 2025	อัปเกรดจาก v17 เป็น v18
v17	5 มิถุนายน 2024	16 ตุลาคม 2024	4 มิถุนายน 2025	อัปเกรดจาก v17 เป็น v18
v16.1	24 เมษายน 2024	5 มิถุนายน 2024	5 กุมภาพันธ์ 2025	อัปเกรดจาก v16 เป็น v17
v16	21 กุมภาพันธ์ 2024	5 มิถุนายน 2024	5 กุมภาพันธ์ 2025	อัปเกรดจาก v16 เป็น v17

ดูเวอร์ชันที่โปรเจ็กต์ใช้อยู่

คุณดูรายการเมธอดและบริการที่โปรเจ็กต์เรียกใช้ล่าสุดได้โดยใช้คอนโซล Google Cloud ดังนี้

1. เปิดAPI และบริการในคอนโซล Google Cloud
2. คลิก Google Ads API ในตาราง
3. ในแท็บย่อยเมตริก คุณควรเห็นคำขอล่าสุดในกราฟแต่ละรายการ คุณดูวิธีการที่ส่งคำขอได้ในตารางวิธีการ ชื่อเมธอดจะประกอบด้วยเวอร์ชัน Google Ads API, บริการ และชื่อเมธอด เช่น google.ads.googleads.v18.services.GoogleAdsService.Mutate
4. (ไม่บังคับ) เลือกกรอบเวลาที่ต้องการดูคำขอ

ความแตกต่างระหว่างการเลิกใช้งานและการหยุดให้บริการ

คำศัพท์	การเลิกใช้งาน	พระอาทิตย์ตก
คำจำกัดความ	เวอร์ชันที่เลิกใช้งานคือเวอร์ชันที่ไม่ใช่เวอร์ชันล่าสุด เมื่อมีการเผยแพร่เวอร์ชันใหม่ ระบบจะทําเครื่องหมายเวอร์ชันก่อนหน้าทั้งหมดว่าเลิกใช้งาน	คุณจะใช้เวอร์ชันที่หยุดให้บริการไม่ได้อีกต่อไป คำขอที่ส่งไปยังเวอร์ชันนี้จะดำเนินการไม่สำเร็จในวันที่ประกาศหยุดให้บริการหรือหลังจากนั้น
ผลที่ตามมา	คุณจะยังใช้เวอร์ชันเลิกใช้งานได้จนกว่าจะมีการหยุดให้บริการ แต่ระบบจะยกเลิกการไฮไลต์การอ้างอิงเวอร์ชันเลิกใช้งานเพื่อแสดงให้เห็นว่าเวอร์ชันดังกล่าวไม่ใช่เวอร์ชันล่าสุดแล้ว เราขอแนะนำให้คุณอัปเกรดเป็นเวอร์ชันล่าสุดโดยเร็วที่สุดเพื่อรับประโยชน์จากฟีเจอร์ใหม่ๆ	คุณต้องอัปเกรดจากเวอร์ชันที่หยุดให้บริการทันทีเพื่อใช้ Google Ads API เราขอแนะนําอย่างยิ่งให้คุณอัปเกรดเป็นเวอร์ชันล่าสุดโดยใช้คู่มือการอัปเกรด
การกำหนดเวลา	โดยเฉลี่ยแล้ว เราจะเปิดตัวเวอร์ชันใหม่ทุก 3-4 เดือน ดังนั้นเวอร์ชันหนึ่งๆ จะเลิกใช้งานหลังจากผ่านไปประมาณ 3-4 เดือน	เราตั้งใจที่จะหยุดให้บริการเวอร์ชันหนึ่งๆ หลังจากเปิดตัวไปแล้ว 1 ปี
API	ปลายทาง API สำหรับเวอร์ชันที่เลิกใช้งานจะยังคงทำงานตามปกติ คุณสามารถเข้าถึงปลายทาง API โดยใช้ไลบรารีของไคลเอ็นต์, REST และอื่นๆ ได้ แต่จะไม่มีการเพิ่มฟีเจอร์ใหม่ลงในเวอร์ชันที่เลิกใช้งาน	ปลายทาง API สำหรับเวอร์ชันที่หยุดให้บริการจะหยุดทํางานหลังจากวันที่หยุดให้บริการ Google Ads API จะแสดงข้อผิดพลาดหากคุณพยายามเข้าถึงปลายทาง API ของเวอร์ชันที่เลิกใช้งาน
ไลบรารีของไคลเอ็นต์	เพื่อให้บริการไลบรารีของไคลเอ็นต์ที่กะทัดรัด เราจะหยุดรวม API เวอร์ชันที่เลิกใช้งานไว้ในไลบรารีของไคลเอ็นต์เวอร์ชันใหม่หลังจากวันที่เลิกใช้งาน ซึ่งจะช่วยประหยัดพื้นที่เมื่อรวมไลบรารีของไคลเอ็นต์ในโปรเจ็กต์	ไลบรารีของไคลเอ็นต์ไม่รองรับ API เวอร์ชันที่หยุดให้บริการในไลบรารีของไคลเอ็นต์เวอร์ชันใหม่หลังจากวันที่หยุดให้บริการ
การสนับสนุน	เราให้การสนับสนุนเวอร์ชันที่เลิกใช้งานเป็นประจำ	เราจะไม่รองรับเวอร์ชันที่หยุดให้บริการหลังจากวันที่ประกาศหยุดให้บริการ

เวอร์ชันไลบรารีของไคลเอ็นต์ที่รองรับ

ตารางจะแสดงไลบรารีของไคลเอ็นต์ที่ใช้งานร่วมกับ API เวอร์ชันใดได้บ้าง

การเลิกใช้งานฟีเจอร์

ตรวจสอบบล็อกนักพัฒนาซอฟต์แวร์ Google Ads เป็นประจําเพื่อเป็นคนแรกที่ทราบเกี่ยวกับการเลิกใช้งานฟีเจอร์ที่กําลังจะมีขึ้น

ตารางต่อไปนี้แสดงการเลิกใช้งานฟีเจอร์ที่เฉพาะเจาะจงซึ่งวางแผนไว้สําหรับ Google Ads API ดูรายละเอียดเพิ่มเติมเกี่ยวกับการเลิกใช้งานแต่ละรายการได้ในบล็อกโพสต์ที่ลิงก์

ฟีเจอร์	คำอธิบาย	วันที่มีผล	หมายเหตุเพิ่มเติม
การอัปเดตรายงานข้อมูลเชิงลึกเกี่ยวกับข้อความค้นหาของ Google Ads API และสคริปต์ Google Ads ตั้งแต่วันที่ 3 มีนาคม 2025	ตั้งแต่วันที่ 3 มีนาคม 2025 เป็นต้นไป รายงานข้อมูลเชิงลึกเกี่ยวกับข้อความค้นหาของ Google Ads API และสคริปต์ Google Ads จะแสดงผลหมวดหมู่ย่อยทั้งหมดของ Search เป็นว่าง UI ของ Google Ads ได้นําฟิลด์นี้ออกแล้ว และ API กำลังเปิดตัวการเปลี่ยนแปลงนี้เพื่อให้สอดคล้องกันทั่วทั้ง Google Ads	3 มีนาคม 2025	ตั้งแต่วันที่ 3 มีนาคม 2025 เป็นต้นไป ค่าทั้งหมดสำหรับ segments.search_subcategoryจะว่างเปล่า หากคุณค้นหา segments.search_subcategory ในรายงาน campaign_search_term_insight หรือ customer_search_term_insight ให้ตรวจสอบว่าโค้ดของคุณจัดการค่าว่างใน segments.search_subcategory ได้ สตริงว่างเป็นรายการที่รับทั้งหมดอยู่แล้ว ดังนั้นโค้ดของคุณควรจัดการเรื่องนี้อยู่แล้ว เราขอแนะนําให้นํา segments.search_subcategory ออกจากคําค้นหา
การเปลี่ยนแปลงที่กําลังจะเกิดขึ้นกับขนาดหน้าใน Google Ads API	เมื่อ v16 หยุดให้บริการแล้ว คุณจะตั้งค่าช่อง page_size ไม่ได้อีกต่อไปเมื่อส่งคำขอ GoogleAdsService.Search	กุมภาพันธ์ 2025	เมื่อ v16 หยุดให้บริการแล้ว คำขอทั้งหมดของ GoogleAdsService.Search จะถือว่ามีขนาดหน้าคงที่คือ 10,000 แถว
การอัปเดตวันหมดอายุของการเป็นสมาชิกการจับคู่ข้อมูลลูกค้า	ตั้งแต่วันที่ 7 เมษายน 2025 เป็นต้นไป ช่อง UserList.membership_life_span จะไม่อนุญาตให้ใช้ค่าที่มากกว่า 540 อีกต่อไป	7 เมษายน 2025	ตั้งแต่วันที่ 7-15 เมษายน 2025 เราจะทยอยเปิดตัวการเปลี่ยนแปลงในช่องUserList.membership_life_span คําขอตั้งค่าช่องเป็นค่ามากกว่า 540 จะแสดงข้อผิดพลาด RangeError.TOO_HIGH ระบบจะย้ายข้อมูลรายการผู้ใช้ที่มีอยู่ซึ่งมีค่าในช่องมากกว่า 540 วันโดยอัตโนมัติเพื่อให้มีระยะเวลาการเป็นสมาชิกสูงสุด 540 วัน ดูข้อมูลเพิ่มเติมได้ในการอัปเดตการหมดอายุของการเป็นสมาชิกการจับคู่ข้อมูลลูกค้า