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

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

• คุณจะเผยแพร่เวอร์ชันหลักได้สูงสุด 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. ในแท็บย่อยMETRICS คุณควรเห็นคำขอล่าสุดในกราฟแต่ละรายการ คุณดูวิธีการที่ส่งคำขอได้ในตารางวิธีการ ชื่อเมธอดจะประกอบด้วยเวอร์ชัน 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	เมื่อ v16 หยุดให้บริการแล้ว คุณจะตั้งค่าช่อง page_size ไม่ได้อีกต่อไปเมื่อส่งคำขอ GoogleAdsService.Search	กุมภาพันธ์ 2025	เมื่อ v16 หยุดให้บริการ คำขอทั้งหมดของ GoogleAdsService.Search จะถือว่ามีขนาดหน้าคงที่คือ 10,000 แถว
กลยุทธ์การเสนอราคา CPC ที่ปรับปรุงแล้ว	Google Ads API ไม่รองรับการตั้งค่า ECPC เป็นกลยุทธ์การเสนอราคาสําหรับแคมเปญ Search และ Display อีกต่อไป	ตุลาคม 2024	คำขอตั้งค่าช่อง enhanced_cpc_enabled เป็น TRUE ในกลยุทธ์การเสนอราคาจะทำให้เกิดข้อผิดพลาด BiddingStrategyError.BIDDING_STRATEGY_NOT_SUPPORTED แคมเปญที่มีอยู่ซึ่งมีกลยุทธ์การเสนอราคา eCPC จะทํางานต่อไปได้จนถึงวันที่ 15 มีนาคม 2025 หลังจากวันที่ดังกล่าว ระบบจะย้ายข้อมูลแคมเปญเหล่านั้นเป็นต้นทุนต่อคลิก (CPC) แบบกำหนดเองโดยอัตโนมัติ