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

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

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

  1. เปิด API และบริการใน Google Cloud Console
  2. คลิก Google Ads API ในตาราง
  3. ในแท็บย่อยเมตริก คุณจะเห็นคำขอล่าสุดแสดงอยู่ในกราฟแต่ละกราฟ คุณดูวิธีที่คุณส่งคำขอไปให้ได้ในตารางวิธีการ ชื่อเมธอดประกอบไปด้วยเวอร์ชัน Google Ads API, บริการ และชื่อเมธอด เช่น google.ads.googleads.v16.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:

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