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

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

  • เราพยายามให้มีเวอร์ชันหลักอย่างน้อย 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 พฤษภาคม 2026 พฤษภาคม 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 กันยายน 2026 สิงหาคม 2027 อัปเกรดจาก v25.1 เป็น v25.2
เวอร์ชันที่จะเปิดตัว
v26 ตุลาคม 2026 พฤศจิกายน 2027  
v26.1* พฤศจิกายน 2569 พฤศจิกายน 2027  

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

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

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

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

Java

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

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

C#

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

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

PHP

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

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

Python

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

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

Ruby

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

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

Perl

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

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

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

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

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