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

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

  • จะมีเวอร์ชันหลัก 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

  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 และอื่นๆ อย่างไรก็ตาม จะไม่มีการเพิ่มฟีเจอร์ใหม่ๆ ในเวอร์ชันที่เลิกใช้งานแล้ว

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

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

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

Java

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

C#

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

PHP

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

Python

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

Ruby

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

Perl

ไลบรารีของไคลเอ็นต์สำหรับ 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 หลังจากวันนี้ แคมเปญจะหยุดแสดงจนกว่าจะมีการอัปเดตกลยุทธ์การเสนอราคา