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

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

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

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

ตารางเวลา

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

เวอร์ชัน APIวันที่วางจำหน่ายวันที่หยุดให้บริการคู่มือการอัปเกรด
เวอร์ชันที่เผยแพร่
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 22 เมษายน 2026 พฤษภาคม 2027 อัปเกรดจาก v23.2 เป็น v24
v24.1 13 พฤษภาคม 2569 พฤษภาคม 2027 อัปเกรดจาก v24 เป็น v24.1
v24.2 24 มิถุนายน 2026 มิถุนายน 2027 อัปเกรดจาก v24.1 เป็น v24.2
v25 22 กรกฎาคม 2026 สิงหาคม 2027 อัปเกรดจาก v24.2 เป็น v25
v25.1 19 สิงหาคม 2026 สิงหาคม 2027 อัปเกรดจาก v25 เป็น v25.1
v25.2 23 กันยายน 2569 สิงหาคม 2027 อัปเกรดจาก v25.1 เป็น v25.2
เวอร์ชันที่กำลังจะเปิดตัว
v26 ตุลาคม 2026 พฤศจิกายน 2027  
v26.1 ตุลาคม 2026 พฤศจิกายน 2027  
v26.2 พฤศจิกายน 2569 พฤศจิกายน 2027  
v26.3* ธันวาคม 2026 พฤศจิกายน 2027  
v27 มกราคม 2027 กุมภาพันธ์ 2028  
v27.1 กุมภาพันธ์ 2027 กุมภาพันธ์ 2028  
v27.2 กุมภาพันธ์ 2027 กุมภาพันธ์ 2028  
v27.3 มีนาคม 2027 กุมภาพันธ์ 2028  
v27.4 มีนาคม 2027 กุมภาพันธ์ 2028  
v28 เมษายน 2027 พฤษภาคม 2028  
v28.1 เมษายน 2027 พฤษภาคม 2028  
v28.2 พฤษภาคม 2027 พฤษภาคม 2028  
v28.3 พฤษภาคม 2027 พฤษภาคม 2028  
v28.4 มิถุนายน 2027 พฤษภาคม 2028  
v28.5 มิถุนายน 2027 พฤษภาคม 2028  
v29 กรกฎาคม 2027 สิงหาคม 2028  
v29.1 กรกฎาคม 2027 สิงหาคม 2028  
v29.2 สิงหาคม 2027 สิงหาคม 2028  
v29.3 สิงหาคม 2027 สิงหาคม 2028  
v29.4 กันยายน 2027 สิงหาคม 2028  
v29.5 กันยายน 2027 สิงหาคม 2028  
v30 ตุลาคม 2027 พฤศจิกายน 2028  
v30.1 ตุลาคม 2027 พฤศจิกายน 2028  
v30.2 พฤศจิกายน 2027 พฤศจิกายน 2028  
v30.3* ธันวาคม 2027 พฤศจิกายน 2028  

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

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

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

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

Java

Changelog

ไลบรารีของไคลเอ็นต์สำหรับ Java
v26 Min: 48.0.0
Max: -
v25 Min: 44.0.0
Max: -
v24 Min: 43.0.0
Max: -
v23 Min: 42.0.0
Max: -

C#

Changelog

ไลบรารีของไคลเอ็นต์สำหรับ .NET
v26 Min: 27.5.0
Max: -
v25 Min: 26.1.0
Max: -
v24 Min: 25.3.0
Max: -
v23 Min: 25.1.0
Max: -

PHP

บันทึกการเปลี่ยนแปลง

ไลบรารีของไคลเอ็นต์สำหรับ PHP
v26 Min: 35.2.0
Max: -
v25 Min: 33.6.0
Max: -
v24 Min: 33.3.0
Max: -
v23 Min: 32.2.0
Max: -

Python

Changelog

ไลบรารีของไคลเอ็นต์สำหรับ Python
v26 Min: 34.0.0
Max: -
v25 Min: 31.2.0
Max: -
v24 Min: 30.1.0
Max: -
v23 Min: 29.2.0
Max: -

Ruby

บันทึกการเปลี่ยนแปลง

ไลบรารีของไคลเอ็นต์สำหรับ Ruby
v26 Min: 46.0.0
Max: -
v25 Min: 43.0.0
Max: -
v24 Min: 40.0.0
Max: -
v23 Min: 38.0.0
Max: -

Perl

บันทึกการเปลี่ยนแปลง

ไลบรารีของไคลเอ็นต์สำหรับ Perl
v26 Min: 36.0.0
Max: -
v25 Min: 33.0.0
Max: -
v24 Min: 32.0.0
Max: -
v23 Min: 31.0.0
Max: -

การเลิกใช้งานและการเปลี่ยนแปลงฟีเจอร์

แม้ว่าหน้านี้จะมุ่งเน้นที่วงจรระดับเวอร์ชัน API แต่การเลิกใช้งานฟีเจอร์แต่ละรายการ (เช่น การเลิกใช้งาน Smart Campaign) และการเปลี่ยนแปลงเวิร์กโฟลว์ที่ไม่มีเวอร์ชัน (เช่น ข้อกำหนดด้านงบประมาณแคมเปญ Demand Gen ใหม่) จะได้รับการติดตามแยกต่างหาก

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