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

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

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

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

ตารางเวลา

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

เวอร์ชัน APIวันที่วางจำหน่ายวันที่เลิกใช้งานวันที่หยุดให้บริการคู่มือการอัปเกรด
v216 สิงหาคม 2025อัปเกรดจาก v20 เป็น v21
v20.16 สิงหาคม 2025มิถุนายน 2026 (โดยประมาณ)อัปเกรดจาก v19 เป็น v20
v204 มิถุนายน 2025มิถุนายน 2026 (โดยประมาณ)อัปเกรดจาก v19 เป็น v20
v19.26 สิงหาคม 2025 กุมภาพันธ์ 2026 (โดยประมาณ)อัปเกรดจาก v18 เป็น v19
v19.116 เมษายน 2025 กุมภาพันธ์ 2026 (โดยประมาณ)อัปเกรดจาก v18 เป็น v19
v1926 กุมภาพันธ์ 2025 กุมภาพันธ์ 2026 (โดยประมาณ)อัปเกรดจาก v18 เป็น v19
v1816 ตุลาคม 2024มิถุนายน 202520 สิงหาคม 2025

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

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

  1. เปิด API และบริการใน Google Cloud Console
  2. คลิก Google Ads API ในตาราง
  3. ในแท็บย่อยเมตริก คุณควรเห็นคำขอล่าสุดที่พล็อตไว้ในแต่ละกราฟ คุณดูวิธีการที่คุณส่งคำขอได้ในตารางวิธีการ ชื่อเมธอด ประกอบด้วยเวอร์ชัน Google Ads API, บริการ และชื่อเมธอด เช่น google.ads.googleads.v21.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
v21 Min: 39.0.0
Max: -
v20 Min: 38.0.0
Max: -
v19 Min: 36.0.0
Max: -

C#

ไลบรารีของไคลเอ็นต์สำหรับ .NET
v21 Min: 24.0.0
Max: -
v20 Min: 23.0.0
Max: -
v19 Min: 22.1.0
Max: -
v18 Min: 21.1.0
Max: 23.0.0

PHP

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

Python

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

Ruby

ไลบรารีของไคลเอ็นต์สำหรับ Ruby
v21 Min: 35.0.0
Max: -
v20 Min: 34.0.0
Max: -
v19 Min: 32.0.0
Max: -
v18 Min: 31.0.0
Max: -

Perl

ไลบรารีของไคลเอ็นต์สำหรับ Perl
v21 Min: 28.0.0
Max: -
v20 Min: 27.0.0
Max: -
v19 Min: 26.0.0
Max: -
v18 Min: 25.0.1
Max: 28.0.0

การเลิกใช้งานฟีเจอร์

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

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

ฟีเจอร์ คำอธิบาย วันที่มีผล หมายเหตุเพิ่มเติม
สภาพแวดล้อม Conversion ที่ส่งผลต่อประสิทธิภาพ App Campaign ตั้งแต่วันที่ 30 กันยายน 2025 เป็นต้นไป เราจะเริ่มทยอยเปิดตัวการเปลี่ยนแปลงรูปแบบการเสนอราคา ซึ่งจะช่วยให้ใช้ข้อมูลสภาพแวดล้อมของ Conversion ที่รวมอยู่ใน Conversion ที่นำเข้าเพื่อเพิ่มประสิทธิภาพแคมเปญได้ 3 ตุลาคม 2025 ดูรายละเอียดเพิ่มเติมได้ที่บล็อกโพสต์ของเรา
Conversion อาจมีทั้งค่า `gclid` และ `gbraid` ตั้งแต่วันที่ 3 ตุลาคม 2025 เป็นต้นไป Conversion ที่นำเข้าจะไม่แสดงข้อผิดพลาด `VALUE_MUST_BE_UNSET` อีกต่อไป หากตั้งค่าทั้งฟิลด์ `gclid` และ `gbraid` 3 ตุลาคม 2025 ดูรายละเอียดเพิ่มเติมได้ที่บล็อกโพสต์ของเรา