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

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

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

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

ตารางเวลา

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

เวอร์ชัน APIวันที่เผยแพร่วันที่หยุดให้บริการคู่มือการอัปเกรด
เวอร์ชันที่เผยแพร่
v204 มิถุนายน 2025มิถุนายน 2026 (โดยประมาณ)อัปเกรดจาก v19 เป็น v20
v20.16 สิงหาคม 2025มิถุนายน 2026 (โดยประมาณ)อัปเกรดจาก v19 เป็น v20
v216 สิงหาคม 2025สิงหาคม 2026 (โดยประมาณ)อัปเกรดจาก v20 เป็น v21
v2215 ตุลาคม 2025ตุลาคม 2026 (โดยประมาณ)อัปเกรดจาก v21 เป็น v22
v2328 มกราคม 2026กุมภาพันธ์ 2027อัปเกรดจาก v22 เป็น v23
เวอร์ชันที่จะเปิดตัว
v23.1 25 กุมภาพันธ์ 2026 กุมภาพันธ์ 2027 อัปเกรดจาก v23 เป็น v23.1
v23.2 25 มีนาคม 2026 กุมภาพันธ์ 2027 อัปเกรดจาก v23.1 เป็น v23.2
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 ดังนี้

  1. เปิด API และบริการในคอนโซล Google Cloud
  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 เวอร์ชันใด

Java

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

C#

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

PHP

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

Python

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

Ruby

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

Perl

ไลบรารีของไคลเอ็นต์สำหรับ Perl
v23 Min: 31.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 ดูรายละเอียดเพิ่มเติมเกี่ยวกับการเลิกใช้งานแต่ละรายการได้ใน บล็อกโพสต์ที่ลิงก์

ฟีเจอร์ คำอธิบาย วันที่มีผล หมายเหตุเพิ่มเติม
การเปลี่ยนแปลงการสนับสนุนการจับคู่ข้อมูลลูกค้า

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