หลังจากเปิดตัวเวอร์ชันใหม่ เวอร์ชันที่เลิกใช้งานแล้วจะได้รับวันที่เลิกใช้งาน หลังจากนั้นเวอร์ชันดังกล่าวจะจะใช้งานไม่ได้อีกต่อไป หลักเกณฑ์อื่นๆ ที่ควรคำนึงถึงมีดังนี้
- จะมีเวอร์ชันหลัก 3 เวอร์ชันสูงสุดในคราวเดียว
- เวอร์ชันหลักจะมีอายุการใช้งานประมาณ 12 เดือน ส่วนเวอร์ชันย่อย: 10 เดือน
- คุณจะต้องดำเนินการไม่เกิน2 รายการต่อปี และคุณไม่จำเป็นต้องอัปเกรดตามลำดับเคร่งครัด เช่น อัปเกรดจากเวอร์ชัน (N) เป็นเวอร์ชัน (N+2) โดยตรง
- ความคาบเกี่ยวกันระหว่างวันที่เผยแพร่ไลบรารีของไคลเอ็นต์ทั้งหมดสำหรับเวอร์ชันล่าสุดและเวอร์ชันที่จะหยุดให้บริการเป็นเวลาอย่างน้อย 20 สัปดาห์
ไลบรารีของไคลเอ็นต์ของเรารองรับบริการเวอร์ชันที่พร้อมใช้งาน ดังนั้นคุณจึงค่อยๆ อัปเกรดได้โดยระบุเวอร์ชันต่างๆ ของบริการที่ใช้
ตารางเวลา
ตารางด้านล่างแสดงวันที่เลิกใช้งานและวันที่เลิกใช้งานที่เฉพาะเจาะจงสำหรับแต่ละเวอร์ชันที่พร้อมใช้งาน รวมถึงวันที่วางจำหน่ายที่คาดการณ์สำหรับเวอร์ชันในอนาคต เราขอแนะนำให้คุณอัปเกรดเป็นเวอร์ชันล่าสุดโดยเร็วที่สุดหลังจากเปิดตัว
เวอร์ชัน API | วันที่เผยแพร่ | วันที่เลิกใช้งาน | วันที่พระอาทิตย์ตก | คู่มือการอัปเกรด |
---|---|---|---|---|
v18 | ก.ย./ต.ค. 2024 | ม.ค./ก.พ. 2025 | กันยายน 2025 | |
v17.1 | ก.ค./ส.ค. 2024 | ก.ย./ต.ค. 2024 | พฤษภาคม 2025 | |
v17 | พ.ค./มิ.ย. 2024 | ก.ย./ต.ค. 2024 | พฤษภาคม 2025 | |
v16.1 | 24 เมษายน 2024 | พ.ค./มิ.ย. 2024 | มกราคม 2025 | |
v16 | 21 กุมภาพันธ์ 2024 | พ.ค./มิ.ย. 2024 | มกราคม 2025 | |
v15 | 18 ตุลาคม 2023 | 21 กุมภาพันธ์ 2024 | 25 กันยายน 2024 | อัปเกรดจาก v15 เป็น v16 |
v14.1 | 9 สิงหาคม 2023 | 18 ตุลาคม 2023 | 5 มิถุนายน 2024 | |
v14 | 7 มิถุนายน 2023 | 18 ตุลาคม 2023 | 5 มิถุนายน 2024 | อัปเกรดจาก v14 เป็น v15 |
ดูเวอร์ชันของโปรเจ็กต์ที่โปรเจ็กต์ใช้อยู่
คุณดูรายการเมธอดและบริการที่โปรเจ็กต์เพิ่งเรียกใช้ได้โดยใช้ Google Cloud Console
- เปิด API และบริการใน Google Cloud Console
- คลิก Google Ads API ในตาราง
- ในแท็บย่อยเมตริก คุณควรจะเห็นคำขอล่าสุดแสดงอยู่ในกราฟแต่ละรายการ คุณสามารถดูวิธีการที่คุณส่งคำขอไปในตารางเมธอด ชื่อเมธอดประกอบด้วยเวอร์ชันของ Google Ads API, บริการ และชื่อเมธอด เช่น
google.ads.googleads.v17.services.GoogleAdsService.Mutate
- (ไม่บังคับ) เลือกกรอบเวลาที่ต้องการดูสำหรับคำขอของคุณ
ความแตกต่างระหว่างการเลิกใช้งานและการเลิกใช้งาน
คำศัพท์ | การเลิกใช้งาน | พระอาทิตย์ตก |
---|---|---|
คำจำกัดความ | เวอร์ชันที่เลิกใช้งานแล้วคือเวอร์ชันที่ไม่ใช่เวอร์ชันล่าสุด เมื่อเปิดตัวเวอร์ชันใหม่แล้ว ระบบจะทำเครื่องหมายเวอร์ชันก่อนหน้าทั้งหมดเป็นเลิกใช้งานแล้ว | และเวอร์ชันหยุดให้บริการจะใช้งานไม่ได้ คำขอที่ส่งไปยังเวอร์ชันนี้จะล้มเหลวในหรือหลังจากวันที่หยุดให้บริการ |
ผลกระทบ | คุณจะยังใช้เวอร์ชันที่เลิกใช้งานแล้วได้จนกว่าจะหยุดให้บริการ แต่ระบบจะเลิกไฮไลต์การอ้างอิงของเวอร์ชันที่เลิกใช้งานแล้วเพื่อแสดงให้เห็นว่าเวอร์ชันดังกล่าวไม่ใช่เวอร์ชันล่าสุดอีกต่อไป
เราขอแนะนําให้อัปเกรดเป็นเวอร์ชันล่าสุดโดยเร็วที่สุดเพื่อใช้ประโยชน์จากฟีเจอร์ใหม่ๆ |
คุณต้องอัปเกรดจากเวอร์ชันที่หยุดให้บริการทันทีเพื่อใช้ Google Ads API
เราขอแนะนำอย่างยิ่งให้คุณอัปเกรดเป็นเวอร์ชันล่าสุดโดยใช้คู่มือการอัปเกรด |
ช่วงเวลา | โดยเฉลี่ยแล้วเราจะเผยแพร่เวอร์ชันใหม่ทุก 3-4 เดือน ดังนั้นระบบจะเลิกใช้งานเวอร์ชันที่ระบุหลังจากผ่านไปประมาณ 3-4 เดือน | เราตั้งเป้าจะหยุดให้บริการเวอร์ชัน 1 ปีหลังจากการเปิดตัว |
API | ปลายทาง API สำหรับเวอร์ชันที่เลิกใช้งานแล้วยังคงทำงานตามปกติ
คุณเข้าถึงปลายทาง API ได้โดยใช้ไลบรารีของไคลเอ็นต์, REST และอื่นๆ อย่างไรก็ตาม จะไม่มีการเพิ่มฟีเจอร์ใหม่ๆ ในเวอร์ชันที่เลิกใช้งานแล้ว |
ปลายทาง API สำหรับเวอร์ชันที่หยุดให้บริการจะหยุดทำงานหลังจากวันที่หยุดให้บริการ Google Ads API จะแสดงข้อผิดพลาดหากคุณพยายามเข้าถึงปลายทาง API ของเวอร์ชันที่หยุดให้บริการ |
ไลบรารีของไคลเอ็นต์ | เพื่อวัตถุประสงค์ในการให้บริการไลบรารีของไคลเอ็นต์ขนาดกะทัดรัด เราจะหยุดรวม API เวอร์ชันที่เลิกใช้งานแล้วในไลบรารีไคลเอ็นต์เวอร์ชันใหม่หลังจากวันที่เลิกใช้งาน ซึ่งจะช่วยให้คุณประหยัดพื้นที่เมื่อรวมไลบรารีของไคลเอ็นต์ของเราไว้ในโปรเจ็กต์ของคุณ | ไลบรารีของไคลเอ็นต์ไม่รองรับเวอร์ชัน API ที่หยุดให้บริการในไลบรารีของไคลเอ็นต์ใหม่หลังจากวันที่หยุดให้บริการอีกต่อไป |
การสนับสนุน | เราจะให้การสนับสนุนตามปกติสำหรับเวอร์ชันที่เลิกใช้งานแล้ว | เราไม่รองรับเวอร์ชันที่หยุดให้บริการหลังจากวันที่หยุดให้บริการ |
เวอร์ชันไลบรารีของไคลเอ็นต์ที่รองรับ
ตารางนี้แสดงไลบรารีของไคลเอ็นต์ที่ใช้ได้กับ API เวอร์ชันต่างๆ
Java
Google Ads API |
ไลบรารีของไคลเอ็นต์สำหรับ Java |
v16 |
Min: 30.0.0 Max: - |
v15 |
Min: 28.0.0 Max: - |
v14 |
Min: 26.0.0 Max: 30.0.0
|
C#
Google Ads API |
ไลบรารีของไคลเอ็นต์สำหรับ .NET |
v16 |
Min: 18.1.0 Max: - |
v15 |
Min: 17.1.0 Max: - |
v14 |
Min: 16.1.0 Max: 19.0.1 |
PHP
Google Ads API |
ไลบรารีไคลเอ็นต์สำหรับ PHP |
v16 |
Min: 22.1.0 Max: - |
v15 |
Min: 21.1.0 Max: - |
Python
Google Ads API |
ไลบรารีของไคลเอ็นต์สำหรับ Python |
v16 |
Min: 23.1.0 Max: - |
v15 |
Min: 22.1.0 Max: - |
Ruby
Google Ads API |
ไลบรารีไคลเอ็นต์สำหรับ Ruby |
v16 |
Min: 27.0.0 Max: - |
v15 |
Min: 25.0.0 Max: - |
v14 |
Min: 23.0.0 Max: 27.0.0
|
Perl
Google Ads API |
ไลบรารีของไคลเอ็นต์สำหรับ Perl |
v16 |
Min: 21.0.0 Max: - |
v15 |
Min: 19.0.0 Max: - |
v14 |
Min: 17.0.0 Max: 21.0.0 |
การเลิกใช้งานฟีเจอร์
ติดตามบล็อกนักพัฒนาซอฟต์แวร์ Google Ads เป็นประจำเพื่อรับข่าวสารเกี่ยวกับการเลิกใช้งานฟีเจอร์ที่กำลังจะเกิดขึ้นเป็นคนแรก
ตารางด้านล่างแสดงการเลิกใช้งานฟีเจอร์ที่เฉพาะเจาะจงซึ่งวางแผนไว้สำหรับ Google Ads API ในปัจจุบัน ดูรายละเอียดเพิ่มเติมเกี่ยวกับการเลิกใช้งานแต่ละรายการได้ในบล็อกโพสต์ที่ลิงก์
ฟีเจอร์ | คำอธิบาย | วันที่มีผล | หมายเหตุเพิ่มเติม |
---|---|---|---|
กลยุทธ์การเสนอราคาค่าคอมมิชชัน |
Google Ads API
ไม่รองรับการสร้างแคมเปญโรงแรมที่มีกลยุทธ์การเสนอราคา COMMISSION
อีกต่อไป
|
30 เมษายน 2024 |
คำขอสร้างแคมเปญโรงแรมใหม่หรือใช้กลยุทธ์การเสนอราคา COMMISSION กับแคมเปญที่มีอยู่จะทำให้เกิดข้อผิดพลาด BiddingStrategyError.BIDDING_STRATEGY_NOT_SUPPORTED แคมเปญที่มีอยู่ซึ่งใช้กลยุทธ์การเสนอราคา COMMISSION จะยังคงทํางานต่อไปจนถึงวันที่ 31 ตุลาคม 2024 หลังจากวันนี้
แคมเปญจะหยุดแสดงจนกว่าจะมีการอัปเดตกลยุทธ์การเสนอราคา
|