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

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

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

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

ตารางเวลา

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

เวอร์ชัน API	วันที่วางจำหน่าย	วันที่หยุดให้บริการ	คู่มือการอัปเกรด
เวอร์ชันที่เผยแพร่
v19	26 กุมภาพันธ์ 2025	11 กุมภาพันธ์ 2026
v19.1	16 เมษายน 2025	11 กุมภาพันธ์ 2026
v19.2	6 สิงหาคม 2025	11 กุมภาพันธ์ 2026
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	กุมภาพันธ์ 2026	กุมภาพันธ์ 2027
v23.2	25 มีนาคม 2026	กุมภาพันธ์ 2027
v24	เมษายน 2026	พฤษภาคม 2027
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 Console ดังนี้

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

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

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

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

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

Java

Google Ads API	ไลบรารีของไคลเอ็นต์สำหรับ Java
v23	Min: 42.0.0 Max: -
v22	Min: 41.1.0 Max: -
v21	Min: 39.0.0 Max: -
v20	Min: 38.0.0 Max: -

C#

Google Ads API	ไลบรารีของไคลเอ็นต์สำหรับ .NET
v23	Min: 25.0.0 Max: -
v22	Min: 24.1.0 Max: -
v21	Min: 24.0.0 Max: -
v20	Min: 23.0.0 Max: -

PHP

Google Ads API	ไลบรารีของไคลเอ็นต์สำหรับ PHP
v23	Min: 32.1.0 Max: -
v22	Min: 31.0.0 Max: -
v21	Min: 28.0.0 Max: -
v20	Min: 26.1.0 Max: -

Python

Google Ads API	ไลบรารีของไคลเอ็นต์สำหรับ Python
v23	Min: 29.0.0 Max: -
v22	Min: 28.1.0 Max: -
v21	Min: 28.0.0 Max: -
v20	Min: 27.0.0 Max: -

Ruby

Google Ads API	ไลบรารีของไคลเอ็นต์สำหรับ Ruby
v23	Min: 37.0.0 Max: -
v22	Min: 36.0.0 Max: -
v21	Min: 35.0.0 Max: -
v20	Min: 34.0.0 Max: -

Perl

Google Ads API	ไลบรารีของไคลเอ็นต์สำหรับ Perl
v23	Min: 30.0.0 Max: -
v22	Min: 29.0.0 Max: -
v21	Min: 28.0.0 Max: -
v20	Min: 27.0.0 Max: -

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

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

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

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