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

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

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

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

ตารางเวลา

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

เวอร์ชัน APIวันที่เผยแพร่วันที่หยุดให้บริการคู่มือการอัปเกรด
เวอร์ชันที่เผยแพร่
v204 มิถุนายน 202510 มิถุนายน 2026อัปเกรดจาก v19 เป็น v20
v20.16 สิงหาคม 2025มิถุนายน 2026 (โดยประมาณ)อัปเกรดจาก v19 เป็น v20
v216 สิงหาคม 2025สิงหาคม 2026 (โดยประมาณ)อัปเกรดจาก v20 เป็น v21
v2215 ตุลาคม 2025ตุลาคม 2026 (โดยประมาณ)อัปเกรดจาก v21 เป็น v22
v2328 มกราคม 2026กุมภาพันธ์ 2027อัปเกรดจาก v22 เป็น v23
v23.1 25 กุมภาพันธ์ 2026 กุมภาพันธ์ 2027 อัปเกรดจาก v23 เป็น v23.1
v23.2 25 มีนาคม 2026 กุมภาพันธ์ 2027 อัปเกรดจาก v23.1 เป็น v23.2
v24 22 เมษายน 2026 พฤษภาคม 2027 อัปเกรดจาก v23.2 เป็น v24
v24.1 13 พฤษภาคม 2026 พฤษภาคม 2027 อัปเกรดจาก v24 เป็น v24.1
เวอร์ชันที่จะเปิดตัว
v24.2 มิถุนายน 2026 พฤษภาคม 2027  
v25 กรกฎาคม 2026 สิงหาคม 2027  
v25.1 สิงหาคม 2026 สิงหาคม 2027  
v25.2 กันยายน 2026 สิงหาคม 2027  
v26 ตุลาคม 2026 พฤศจิกายน 2027  
v26.1* พฤศจิกายน 2026 พฤศจิกายน 2027  

* v26.1 ได้รับการกำหนดให้เป็นรุ่นที่ไม่บังคับเนื่องจากทับซ้อนกับ ช่วงเทศกาลวันหยุด

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

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

  1. เปิด API และบริการในคอนโซล Google Cloud
  2. คลิก Google Ads API ในตาราง
  3. ในแท็บย่อยเมตริก คุณควรเห็นคำขอล่าสุดที่พล็อตไว้ในแต่ละกราฟ คุณดูวิธีการที่คุณส่งคำขอได้ในตารางวิธีการ ชื่อเมธอด ประกอบด้วยเวอร์ชัน Google Ads API, บริการ และชื่อเมธอด เช่น google.ads.googleads.v24.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
v24 Min: 43.0.0
Max: -
v23 Min: 42.0.0
Max: -
v22 Min: 41.0.0
Max: -
v21 Min: 39.0.0
Max: -
v20 Min: 38.0.0
Max: 42.2.0

C#

ไลบรารีของไคลเอ็นต์สำหรับ .NET
v24 Min: 25.3.0
Max: -
v23 Min: 25.1.0
Max: -
v22 Min: 24.1.0
Max: -
v21 Min: 24.0.0
Max: -
v20 Min: 23.0.0
Max: -

PHP

ไลบรารีของไคลเอ็นต์สำหรับ PHP
v24 Min: 33.3.0
Max: -
v23 Min: 32.2.0
Max: -
v22 Min: 31.0.0
Max: -
v21 Min: 28.0.0
Max: -
v20 Min: 26.1.0
Max: -

Python

ไลบรารีของไคลเอ็นต์สำหรับ Python
v24 Min: 30.1.0
Max: -
v23 Min: 29.2.0
Max: -
v22 Min: 28.1.0
Max: -
v21 Min: 28.0.0
Max: -
v20 Min: 27.0.0
Max: -

Ruby

ไลบรารีของไคลเอ็นต์สำหรับ Ruby
v24 Min: 40.0.0
Max: -
v23 Min: 38.0.0
Max: -
v22 Min: 36.0.0
Max: -
v21 Min: 35.0.0
Max: -
v20 Min: 34.0.0
Max: -

Perl

ไลบรารีของไคลเอ็นต์สำหรับ Perl
v24 Min: 32.0.0
Max: -
v23 Min: 31.0.0
Max: -
v22 Min: 29.0.0
Max: -
v21 Min: 28.0.0
Max: -
v20 Min: 27.0.0
Max: 32.0.0

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

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

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

ฟีเจอร์ คำอธิบาย วันที่มีผล หมายเหตุเพิ่มเติม
การเปลี่ยนแปลงนโยบายการเก็บรักษาข้อมูล ระยะเวลาเก็บรักษาข้อมูลการรายงานแบบละเอียด (รายวัน รายชั่วโมง รายสัปดาห์) จะลดลงเหลือ 37 เดือน ส่วนข้อมูลระดับสูง (รายเดือน รายไตรมาส รายปี) จะยังคงพร้อมใช้งานเป็นเวลา 11 ปี 1 มิถุนายน 2026 ดูรายละเอียดเพิ่มเติมได้ที่บล็อกโพสต์ของเรา
การเปลี่ยนแปลงการรองรับ Conversion ออฟไลน์

ตั้งแต่วันที่ 15 มิถุนายน 2026 เป็นต้นไป โทเค็นนักพัฒนาซอฟต์แวร์ที่ไม่มีคำขอ Conversion ออฟไลน์ล่าสุดจะต้องใช้ Data Manager API สำหรับเวิร์กโฟลว์ Conversion ออฟไลน์

15 มิถุนายน 2026 ดูรายละเอียดเพิ่มเติมได้ที่บล็อกโพสต์ ของเรา
การเปลี่ยนแปลงการสนับสนุนการจับคู่ข้อมูลลูกค้า

ตั้งแต่วันที่ 1 เมษายน 2026 เป็นต้นไป โทเค็นนักพัฒนาซอฟต์แวร์ที่ไม่มีคำขอการจับคู่ข้อมูลลูกค้าล่าสุดจะต้องใช้ Data Manager API สำหรับเวิร์กโฟลว์การจับคู่ข้อมูลลูกค้า

  • หากโทเค็นของนักพัฒนาของคุณส่งคำขอ OfflineUserDataJobService หรือ UserDataService สําหรับกลุ่มเป้าหมายตามการจับคู่ข้อมูลลูกค้าในระหว่างวันที่ 1 ตุลาคม 2025 ถึง 31 มีนาคม 2026 คุณจะใช้โทเค็นของนักพัฒนาของคุณกับ Google Ads API สําหรับเวิร์กโฟลว์การจับคู่ข้อมูลลูกค้าต่อไปได้ อย่างไรก็ตาม เราขอแนะนำให้คุณ อัปเกรด เวิร์กโฟลว์การจับคู่ข้อมูลลูกค้าเป็น Data Manager API เพื่อ ประสบการณ์การใช้งานที่ดีขึ้นสำหรับนักพัฒนาซอฟต์แวร์และสิทธิ์เข้าถึงฟีเจอร์เพิ่มเติม
  • มิฉะนั้น ตั้งแต่วันที่ 1 เมษายน 2026 เป็นต้นไป คำขอ OfflineUserDataJobService หรือ UserDataService สำหรับกลุ่มเป้าหมายการจับคู่ข้อมูลลูกค้าจะดำเนินการไม่สำเร็จและคุณจะได้รับข้อผิดพลาด CUSTOMER_NOT_ALLOWLISTED_FOR_THIS_FEATURE ใช้ Data Manager API สำหรับเวิร์กโฟลว์การจับคู่ข้อมูลลูกค้าแทน Google Ads API
1 เมษายน 2026 ดูรายละเอียดเพิ่มเติมได้ที่บล็อกโพสต์ ของเรา
การเปลี่ยนแปลงการรองรับแอตทริบิวต์ที่อยู่ IP และเซสชัน Google Ads API จะไม่รับผู้ใช้ใหม่ที่ใช้แอตทริบิวต์เซสชันหรือข้อมูลที่อยู่ IP เป็นส่วนหนึ่งของการนําเข้า Conversion อีกต่อไป ผู้ใช้ปัจจุบันควร ย้ายข้อมูลไปยัง Data Manager API 2 กุมภาพันธ์ 2026 ดูรายละเอียดเพิ่มเติมได้ที่บล็อกโพสต์
การเลิกใช้งานโฆษณาแบบโทรออกเท่านั้น สร้างโฆษณาแบบโทรออกเท่านั้นใหม่ไม่ได้ โฆษณาแบบโทรเท่านั้นที่มีอยู่จะหยุด แสดงในเดือนกุมภาพันธ์ 2027 และจะนำการสนับสนุน API ออก ผู้ลงโฆษณา ควรใช้โฆษณา Search ที่ปรับเปลี่ยนตามบริบทซึ่งมีชิ้นงานการโทรแทน มกราคม 2026 ดูรายละเอียดเพิ่มเติมได้ที่บล็อกโพสต์