เมื่อมีการเปิดตัวเวอร์ชันใหม่ เวอร์ชันที่เลิกใช้งานแล้วจะมีการกำหนดวันที่หยุดให้บริการ ซึ่งหลังจากนั้นเวอร์ชันดังกล่าวจะใช้งานไม่ได้อีกต่อไป หลักเกณฑ์อื่นๆ ที่ควรคำนึงถึงมีดังนี้
- เราพยายามให้มีเวอร์ชันหลักอย่างน้อย 5 เวอร์ชันพร้อมให้บริการในเวลาใดก็ตาม
- เวอร์ชันหลักมีอายุการใช้งานประมาณ 12 เดือน ส่วนเวอร์ชันย่อยมีอายุการใช้งาน 10 เดือน
- คุณจะต้องทำการอัปเกรดอย่างมาก 2 ครั้งต่อปี และไม่จำเป็นต้องอัปเกรดตามลำดับอย่างเคร่งครัด เช่น คุณสามารถอัปเกรดจากเวอร์ชัน (N) เป็นเวอร์ชัน (N+2) ได้โดยตรง
ไลบรารีของไคลเอ็นต์รองรับบริการทุกเวอร์ชันที่พร้อมใช้งาน คุณจึงค่อยๆ อัปเกรดได้โดยการระบุบริการที่ใช้เวอร์ชันต่างๆ
ตารางเวลา
ตารางต่อไปนี้แสดงวันที่เลิกใช้งานและวันที่หยุดให้บริการที่เฉพาะเจาะจงสำหรับแต่ละเวอร์ชันที่พร้อมใช้งาน และวันที่ออกที่คาดการณ์ไว้สำหรับเวอร์ชันในอนาคต เราขอแนะนำให้อัปเกรดเป็นเวอร์ชันล่าสุดโดยเร็วที่สุดหลังจากที่เปิดตัว วันที่ที่ยังไม่แน่นอนหมายความว่าการหยุดให้บริการอาจเกิดขึ้นเมื่อใดก็ได้ในเดือนนั้น และวันที่อาจมีการเปลี่ยนแปลง ติดตามบล็อกเพื่อรับการช่วยเตือนประกาศการหยุดให้บริการ API เวอร์ชันต่างๆ
| เวอร์ชัน API | วันที่วางจำหน่าย | วันที่หยุดให้บริการ | คู่มือการอัปเกรด |
|---|---|---|---|
| เวอร์ชันที่เผยแพร่ | |||
| v22 | 15 ตุลาคม 2025 | ตุลาคม 2026 | อัปเกรดจาก v21 เป็น v22 |
| v23 | 28 มกราคม 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 ดังนี้
- เปิด API และบริการในคอนโซล Google Cloud
- คลิก Google Ads API ในตาราง
- ในแท็บย่อยเมตริก คุณจะเห็นคำขอล่าสุดที่พล็อตไว้ในแต่ละกราฟ
คุณดูได้ว่าได้ส่งคำขอไปยังวิธีการใดบ้างในตารางวิธีการ ชื่อเมธอดประกอบด้วยเวอร์ชัน Google Ads API, บริการ
และชื่อเมธอด เช่น
google.ads.googleads.v25.services.GoogleAdsService.Mutate - (ไม่บังคับ) เลือกกรอบเวลาที่ต้องการดูคำขอ
ความแตกต่างระหว่างการเลิกใช้งานกับการหยุดให้บริการ
| คำศัพท์ | การเลิกใช้งาน | พระอาทิตย์ตก |
|---|---|---|
| คำจำกัดความ | เวอร์ชันที่เลิกใช้งานแล้วคือเวอร์ชันที่ไม่ใช่เวอร์ชันล่าสุด เมื่อมีการเปิดตัวเวอร์ชันใหม่ ระบบจะทำเครื่องหมายเวอร์ชันก่อนหน้าทั้งหมดเป็นเลิกใช้งาน | ใช้เวอร์ชันที่หยุดให้บริการไม่ได้อีกต่อไป คำขอที่ส่งไปยังเวอร์ชันนี้ จะล้มเหลวในวันที่หรือหลังจากวันที่หยุดให้บริการ |
| ผลกระทบ | คุณยังคงใช้เวอร์ชันที่เลิกใช้งานแล้วได้จนกว่าจะหยุดให้บริการ
แต่เราจะยกเลิกการไฮไลต์การอ้างอิงของเวอร์ชันที่เลิกใช้งานแล้วเพื่อแสดง
ว่าเวอร์ชันดังกล่าวไม่ใช่เวอร์ชันล่าสุดอีกต่อไป
เราขอแนะนำให้อัปเกรดเป็นเวอร์ชันล่าสุดโดยเร็วที่สุดเพื่อรับประโยชน์จากฟีเจอร์ใหม่ๆ |
คุณต้องอัปเกรดจากเวอร์ชันที่เลิกใช้งานทันทีเพื่อใช้ 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
Google Ads API |
ไลบรารีของไคลเอ็นต์สำหรับ Java |
v25 |
Min: 44.0.0Max: - |
v24 |
Min: 43.0.0Max: - |
v23 |
Min: 42.0.0Max: - |
C#
Google Ads API |
ไลบรารีของไคลเอ็นต์สำหรับ .NET |
v25 |
Min: 26.1.0Max: - |
v24 |
Min: 25.3.0Max: - |
v23 |
Min: 25.1.0Max: - |
PHP
Google Ads API |
ไลบรารีของไคลเอ็นต์สำหรับ PHP |
v25 |
Min: 33.6.0Max: - |
v24 |
Min: 33.3.0Max: - |
v23 |
Min: 32.2.0Max: - |
Python
Google Ads API |
ไลบรารีของไคลเอ็นต์สำหรับ Python |
v25 |
Min: 31.2.0Max: - |
v24 |
Min: 30.1.0Max: - |
v23 |
Min: 29.2.0Max: - |
Ruby
Google Ads API |
ไลบรารีของไคลเอ็นต์สำหรับ Ruby |
v25 |
Min: 43.0.0Max: - |
v24 |
Min: 40.0.0Max: - |
v23 |
Min: 38.0.0Max: - |
Perl
Google Ads API |
ไลบรารีของไคลเอ็นต์สำหรับ Perl |
v25 |
Min: 33.0.0Max: - |
v24 |
Min: 32.0.0Max: - |
v23 |
Min: 31.0.0Max: - |
การเลิกใช้งานและการเปลี่ยนแปลงฟีเจอร์
แม้ว่าหน้านี้จะมุ่งเน้นที่วงจรระดับเวอร์ชัน API แต่การเลิกใช้งานฟีเจอร์แต่ละรายการ (เช่น การเลิกใช้งาน Smart Campaign) และการเปลี่ยนแปลงเวิร์กโฟลว์ที่ไม่มีการกำหนดเวอร์ชัน (เช่น ข้อกำหนดด้านงบประมาณแคมเปญ Demand Gen ใหม่) จะได้รับการติดตามแยกกัน
หากต้องการตรวจสอบวงจรของฟีเจอร์ที่กำลังจะเปิดตัวและการเปลี่ยนแปลงเชิงพฤติกรรมในเวอร์ชันที่ใช้งานอยู่ โปรดดูคู่มือการเลิกใช้งานฟีเจอร์และการเปลี่ยนแปลงที่ไม่มีเวอร์ชัน