เมื่อเปิดตัวเวอร์ชันใหม่ เวอร์ชันที่เลิกใช้งานแล้วจะได้รับวันที่หยุดให้บริการ ซึ่งหลังจากนั้นเวอร์ชันดังกล่าวจะใช้งานไม่ได้อีกต่อไป ต่อไปนี้คือหลักเกณฑ์อื่นๆ ที่ควรทราบ
- จะมีเวอร์ชันหลัก 3 เวอร์ชันให้เลือกได้สูงสุด 1 เวอร์ชันต่อครั้ง
- เวอร์ชันหลักมีอายุการใช้งานประมาณ 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.v16.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: |
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 หลังจากวันดังกล่าว แคมเปญจะหยุดแสดงจนกว่าจะมีการอัปเดตกลยุทธ์การเสนอราคา
|