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

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

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

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

ตารางเวลา

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

เวอร์ชัน API วันที่เผยแพร่ วันที่เลิกใช้งาน วันที่หยุดให้บริการ คู่มือการอัปเกรด
v18 16 ตุลาคม 2024 กุมภาพันธ์ 2025 24 กันยายน 2025
v17.1 7 สิงหาคม 2024 16 ตุลาคม 2024 4 มิถุนายน 2025 อัปเกรดจาก v17 เป็น v18
v17 5 มิถุนายน 2024 16 ตุลาคม 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) แบบกำหนดเองโดยอัตโนมัติ