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

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

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

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

ตารางเวลา

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

เวอร์ชัน API วันที่เผยแพร่ วันที่เลิกใช้งาน วันที่พระอาทิตย์ตก คู่มือการอัปเกรด
v18 ก.ย./ต.ค. 2024 ม.ค./ก.พ. 2025 กันยายน 2025
v17.1 7 สิงหาคม 2024 ก.ย./ต.ค. 2024 พฤษภาคม 2025
v17 5 มิถุนายน 2024 ก.ย./ต.ค. 2024 พฤษภาคม 2025
v16.1 24 เมษายน 2024 5 มิถุนายน 2024 มกราคม 2025 อัปเกรดจาก v16 เป็น v17
v16 21 กุมภาพันธ์ 2024 5 มิถุนายน 2024 มกราคม 2025 อัปเกรดจาก v16 เป็น v17
v15 18 ตุลาคม 2023 21 กุมภาพันธ์ 2024 25 กันยายน 2024 อัปเกรดจาก v15 เป็น v16

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

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

  1. เปิด API และ บริการใน Google Cloud Console
  2. คลิก Google Ads API ในตาราง
  3. ในแท็บย่อยเมตริก คุณควรเห็นคำขอล่าสุดแสดงอยู่ในเส้นทางนั้น แต่ละกราฟ คุณสามารถดูวิธีที่คุณส่งคำขอไปให้ได้ใน เมธอด ชื่อเมธอด ประกอบด้วยเวอร์ชัน Google Ads API, บริการ และชื่อเมธอด เช่น google.ads.googleads.v17.services.GoogleAdsService.Mutate
  4. (ไม่บังคับ) เลือกกรอบเวลาที่ต้องการดูสำหรับคำขอของคุณ

ความแตกต่างระหว่างการเลิกใช้งานและการเลิกใช้งาน

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

เราขอแนะนำให้คุณอัปเกรดเป็นเวอร์ชันล่าสุดโดยเร็วที่สุดเพื่อ ได้ประโยชน์จากฟีเจอร์ใหม่ๆ

คุณต้องอัปเกรดจากเวอร์ชันที่หยุดให้บริการทันทีใน เพื่อใช้ Google Ads API

เราขอแนะนำอย่างยิ่งให้คุณอัปเกรดเป็นเวอร์ชันล่าสุด เวอร์ชัน โดยใช้คู่มือการอัปเกรด

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

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

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

เวอร์ชันไลบรารีของไคลเอ็นต์ที่รองรับ

ตารางนี้แสดงไลบรารีของไคลเอ็นต์ที่ใช้ได้กับ API เวอร์ชันต่างๆ

Java

ไลบรารีของไคลเอ็นต์สำหรับ Java
v17 Min: 32.0.0
Max: -
v16 Min: 30.0.0
Max: -
v15 Min: 28.0.0
Max: 32.0.0

C#

ไลบรารีของไคลเอ็นต์สำหรับ .NET
v17 Min: 20.1.0
Max: -
v16 Min: 18.1.0
Max: -
v15 Min: 17.1.0
Max: 20.1.0

PHP

ไลบรารีไคลเอ็นต์สำหรับ PHP
v17 Min: 23.1.0
Max: -
v16 Min: 22.1.0
Max: -
v15 Min: 21.1.0
Max: 23.1.0

Python

ไลบรารีของไคลเอ็นต์สำหรับ Python
v17 Min: 24.1.0
Max: -
v16 Min: 23.1.0
Max: -
v15 Min: 22.1.0
Max: -

Ruby

ไลบรารีไคลเอ็นต์สำหรับ Ruby
v17 Min: 29.0.0
Max: -
v16 Min: 27.0.0
Max: -
v15 Min: 25.0.0
Max: -

Perl

ไลบรารีของไคลเอ็นต์สำหรับ Perl
v17 Min: 23.0.0
Max: -
v16 Min: 21.0.0
Max: -
v15 Min: 19.0.0
Max: -

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

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

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

ฟีเจอร์ คำอธิบาย วันที่มีผล หมายเหตุเพิ่มเติม
กลยุทธ์การเสนอราคาค่าคอมมิชชัน Google Ads API ไม่รองรับการสร้างแคมเปญโรงแรมด้วย COMMISSION อีกต่อไป กลยุทธ์การเสนอราคา 30 เมษายน 2024 คำขอสร้างแคมเปญโรงแรมใหม่หรือใช้ COMMISSION กับแคมเปญที่มีอยู่จะทำให้ วันที่ BiddingStrategyError.BIDDING_STRATEGY_NOT_SUPPORTED แคมเปญที่มีอยู่ซึ่งมีการเสนอราคา COMMISSION กลยุทธ์จะยังคงทำงานต่อไปจนถึงวันที่ 31 ตุลาคม 2024 หลังจากวันนี้ แคมเปญจะหยุดแสดงจนกว่าจะมีการอัปเดตกลยุทธ์การเสนอราคา