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

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

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

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

ตารางเวลา

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

เวอร์ชัน APIวันที่เผยแพร่วันที่ประกาศหยุดให้บริการคู่มือการอัปเกรด
เวอร์ชันที่เผยแพร่
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 22 เมษายน 2026 พฤษภาคม 2027 อัปเกรดจาก v23.2 เป็น v24
v24.1 13 พฤษภาคม 2026 พฤษภาคม 2027 อัปเกรดจาก v24 เป็น v24.1
v24.2 24 มิถุนายน 2026 มิถุนายน 2027 อัปเกรดจาก v24.1 เป็น v24.2
เวอร์ชันที่จะเผยแพร่
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.v24.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 เวอร์ชันหลัก (เช่น v24) หากต้องการดูไลบรารีของไคลเอ็นต์เวอร์ชันที่จำเป็นสำหรับการเผยแพร่เวอร์ชันย่อย โปรดดูบันทึกการเปลี่ยนแปลงที่ลิงก์ไว้

Java

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

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

C#

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

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

PHP

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

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

Python

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

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

Ruby

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

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

Perl

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

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

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

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

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