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

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

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

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

ตารางเวลา

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

เวอร์ชัน API	วันที่เผยแพร่	วันที่หยุดให้บริการ	คู่มือการอัปเกรด
เวอร์ชันที่เผยแพร่
v20	4 มิถุนายน 2025	มิถุนายน 2026 (โดยประมาณ)	อัปเกรดจาก v19 เป็น v20
v20.1	6 สิงหาคม 2025	มิถุนายน 2026 (โดยประมาณ)	อัปเกรดจาก v19 เป็น v20
v21	6 สิงหาคม 2025	สิงหาคม 2026 (โดยประมาณ)	อัปเกรดจาก v20 เป็น v21
v22	15 ตุลาคม 2025	ตุลาคม 2026 (โดยประมาณ)	อัปเกรดจาก v21 เป็น v22
v23	28 มกราคม 2026	กุมภาพันธ์ 2027	อัปเกรดจาก v22 เป็น v23
v23.1	25 กุมภาพันธ์ 2026	กุมภาพันธ์ 2027	อัปเกรดจาก v23 เป็น v23.1
v23.2	25 มีนาคม 2026	กุมภาพันธ์ 2027	อัปเกรดจาก v23.1 เป็น v23.2
v24	22 เมษายน 2026	พฤษภาคม 2027	อัปเกรดจาก v23.2 เป็น v24
เวอร์ชันที่จะเปิดตัว
v24.1	พฤษภาคม 2026	พฤษภาคม 2027
v24.2	มิถุนายน 2026	พฤษภาคม 2027
v25	กรกฎาคม 2026	สิงหาคม 2027
v25.1	สิงหาคม 2026	สิงหาคม 2027
v25.2	กันยายน 2026	สิงหาคม 2027
v26	ตุลาคม 2026	พฤศจิกายน 2027
v26.1*	พฤศจิกายน 2026	พฤศจิกายน 2027

* v26.1 ได้รับการกำหนดให้เป็นรุ่นที่ไม่บังคับเนื่องจากทับซ้อนกับ ช่วงเทศกาลวันหยุด

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

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

1. เปิด API และบริการในคอนโซล Google Cloud
2. คลิก Google Ads API ในตาราง
3. ในแท็บย่อยเมตริก คุณควรเห็นคำขอล่าสุดที่พล็อตไว้ในแต่ละกราฟ คุณดูวิธีการที่คุณส่งคำขอได้ในตารางวิธีการ ชื่อเมธอด ประกอบด้วยเวอร์ชัน Google Ads API, บริการ และชื่อเมธอด เช่น google.ads.googleads.v24.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 ดูรายละเอียดเพิ่มเติมเกี่ยวกับการเลิกใช้งานแต่ละรายการได้ใน บล็อกโพสต์ที่ลิงก์

ฟีเจอร์	คำอธิบาย	วันที่มีผล	หมายเหตุเพิ่มเติม
การเปลี่ยนแปลงการสนับสนุนการจับคู่ข้อมูลลูกค้า	ตั้งแต่วันที่ 1 เมษายน 2026 เป็นต้นไป โทเค็นนักพัฒนาซอฟต์แวร์ที่ไม่มีคำขอการจับคู่ข้อมูลลูกค้าล่าสุด จะต้องใช้ Data Manager API สำหรับเวิร์กโฟลว์การจับคู่ข้อมูลลูกค้า หากโทเค็นของนักพัฒนาของคุณส่งคำขอ OfflineUserDataJobService หรือ UserDataService สําหรับกลุ่มเป้าหมายตามการจับคู่ข้อมูลลูกค้าในระหว่างวันที่ 1 ตุลาคม 2025 ถึง 31 มีนาคม 2026 คุณจะใช้โทเค็นของนักพัฒนาของคุณกับ Google Ads API สําหรับเวิร์กโฟลว์การจับคู่ข้อมูลลูกค้าต่อไปได้ อย่างไรก็ตาม เราขอแนะนำให้คุณ อัปเกรด เวิร์กโฟลว์การจับคู่ข้อมูลลูกค้าเป็น Data Manager API เพื่อ ประสบการณ์ในการใช้งานที่ดีขึ้นสำหรับนักพัฒนาซอฟต์แวร์และสิทธิ์เข้าถึงฟีเจอร์เพิ่มเติม มิฉะนั้น ตั้งแต่วันที่ 1 เมษายน 2026 เป็นต้นไป คำขอ OfflineUserDataJobService หรือ UserDataService สำหรับกลุ่มเป้าหมายการจับคู่ข้อมูลลูกค้าจะดำเนินการไม่สำเร็จและคุณจะได้รับข้อผิดพลาด CUSTOMER_NOT_ALLOWLISTED_FOR_THIS_FEATURE ใช้ Data Manager API สำหรับเวิร์กโฟลว์การจับคู่ข้อมูลลูกค้าแทน Google Ads API	1 เมษายน 2026	ดูรายละเอียดเพิ่มเติมได้ที่บล็อกโพสต์ ของเรา
การเปลี่ยนแปลงการรองรับแอตทริบิวต์ที่อยู่ IP และเซสชัน	Google Ads API จะไม่รับผู้ใช้ใหม่ที่ใช้แอตทริบิวต์เซสชันหรือข้อมูลที่อยู่ IP เป็นส่วนหนึ่งของการนําเข้า Conversion อีกต่อไป ผู้ใช้เดิมควร ย้ายข้อมูลไปยัง Data Manager API	2 กุมภาพันธ์ 2026	ดูรายละเอียดเพิ่มเติมได้ที่บล็อกโพสต์
การเลิกใช้งานโฆษณาแบบโทรเท่านั้น	สร้างโฆษณาแบบโทรออกเท่านั้นใหม่ไม่ได้ โฆษณาแบบโทรเท่านั้นที่มีอยู่จะหยุด แสดงในเดือนกุมภาพันธ์ 2027 และจะนำการสนับสนุน API ออก ผู้ลงโฆษณา ควรใช้โฆษณา Search ที่ปรับเปลี่ยนตามบริบทซึ่งมีชิ้นงานการโทรแทน	มกราคม 2026	ดูรายละเอียดเพิ่มเติมได้ที่บล็อกโพสต์