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

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

  • เรามุ่งมั่นที่จะให้เวอร์ชันหลักพร้อมใช้งานสูงสุด 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 สิงหาคม 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.v25.services.GoogleAdsService.Mutate
  4. (ไม่บังคับ) เลือกกรอบเวลาที่ต้องการดูคำขอ

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

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

เราขอแนะนำให้คุณอัปเกรดเป็นเวอร์ชันล่าสุดโดยเร็วที่สุดเพื่อ รับประโยชน์จากฟีเจอร์ใหม่ๆ

 คุณต้องอัปเกรดจากเวอร์ชันที่หยุดให้บริการ ทันที เพื่อใช้ Google Ads API

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

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

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

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

ตารางนี้แสดงไลบรารีของไคลเอ็นต์ที่ทำงานร่วมกับ Google Ads 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: -

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: -

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

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

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