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

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

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

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

ตารางเวลา

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

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

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

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

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

C#

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

PHP

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

Python

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

Ruby

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

Perl

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

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

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

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

ฟีเจอร์ คำอธิบาย วันที่มีผล หมายเหตุเพิ่มเติม
การเปลี่ยนแปลงขนาดหน้าเว็บใน Google Ads API ที่กำลังจะเกิดขึ้น เมื่อ v16 หยุดให้บริการ คุณจะไม่สามารถตั้งค่าช่อง page_size เมื่อส่งคำขอ GoogleAdsService.Search ได้อีกต่อไป มกราคม 2025 เมื่อ v16 หยุดให้บริการ คำขอทั้งหมดของ GoogleAdsService.Search จะถือว่ามีขนาดหน้าคงที่คือ 10,000 แถว
กลยุทธ์การเสนอราคา CPC ที่ปรับปรุงแล้ว Google Ads API ไม่รองรับการตั้งค่า ECPC เป็นกลยุทธ์การเสนอราคาสําหรับแคมเปญ Search และ Display แล้ว ตุลาคม 2024 คำขอตั้งค่าช่อง enhanced_cpc_enabled ในกลยุทธ์การเสนอราคาเป็น TRUE จะทำให้เกิดข้อผิดพลาด BiddingStrategyError.BIDDING_STRATEGY_NOT_SUPPORTED แคมเปญที่มีอยู่ซึ่งมีกลยุทธ์การเสนอราคา eCPC จะทํางานต่อไปได้จนถึงวันที่ 15 มีนาคม 2025 หลังจากวันนี้ ระบบจะย้ายข้อมูลไปยังต้นทุนต่อคลิก (CPC) ที่กำหนดเองโดยอัตโนมัติ