เมื่อมีการเผยแพร่เวอร์ชันใหม่ เวอร์ชันที่เลิกใช้งานจะมีวันที่หยุดให้บริการ ซึ่งหลังจากวันที่ดังกล่าว เวอร์ชันดังกล่าวจะใช้งานไม่ได้อีกต่อไป หลักเกณฑ์อื่นๆ ที่ควรคำนึงถึงมีดังนี้
- คุณจะเผยแพร่เวอร์ชันหลักได้สูงสุด 3 เวอร์ชันพร้อมกัน
- เวอร์ชันหลักมีอายุการใช้งานประมาณ 12 เดือน ส่วนเวอร์ชันย่อยจะมีอายุการใช้งาน 10 เดือน
- คุณจะอัปเกรดได้สูงสุด 2 ครั้งต่อปี และไม่จำเป็นต้องอัปเกรดตามลำดับที่เข้มงวด เช่น คุณสามารถอัปเกรดจากเวอร์ชัน (N) ไปเป็นเวอร์ชัน (N+2) ได้โดยตรง
- ช่วงเวลาที่ทับซ้อนกันระหว่างวันที่เผยแพร่ไลบรารีไคลเอ็นต์ทั้งหมดสำหรับเวอร์ชันล่าสุดและเวอร์ชันที่จะหยุดให้บริการคืออย่างน้อย 20 สัปดาห์
ไลบรารีของไคลเอ็นต์รองรับบริการทุกเวอร์ชันที่มีให้บริการ คุณจึงอัปเกรดทีละน้อยได้โดยระบุบริการที่ใช้เวอร์ชันต่างๆ
ตารางเวลา
ตารางต่อไปนี้แสดงวันที่เลิกใช้งานและหยุดให้บริการที่เฉพาะเจาะจงสำหรับเวอร์ชันที่มีให้บริการแต่ละเวอร์ชัน รวมถึงวันที่เปิดตัวที่คาดการณ์ไว้สำหรับเวอร์ชันในอนาคต เราขอแนะนำให้คุณอัปเกรดเป็นเวอร์ชันล่าสุดโดยเร็วที่สุดหลังจากการเปิดตัว
| เวอร์ชัน API | วันที่เผยแพร่ | วันที่เลิกใช้งาน | วันที่หยุดให้บริการ | คู่มือการอัปเกรด |
|---|---|---|---|---|
| v19 | 26 กุมภาพันธ์ 2025 | อัปเกรดจาก v18 เป็น v19 | ||
| v18 | 16 ตุลาคม 2024 | มิถุนายน 2025 | กันยายน 2025 | อัปเกรดจาก v17 เป็น v18 |
| 17.1 | 7 สิงหาคม 2024 | 16 ตุลาคม 2024 | 4 มิถุนายน 2025 | |
| v17 | 5 มิถุนายน 2024 | 16 ตุลาคม 2024 | 4 มิถุนายน 2025 |
ดูเวอร์ชันที่โปรเจ็กต์ใช้อยู่
คุณดูรายการเมธอดและบริการที่โปรเจ็กต์เรียกใช้ล่าสุดได้โดยใช้คอนโซล Google Cloud ดังนี้
- เปิดAPI และบริการในคอนโซล Google Cloud
- คลิก Google Ads API ในตาราง
- ในแท็บย่อยเมตริก คุณควรเห็นคำขอล่าสุดในกราฟแต่ละรายการ คุณดูวิธีการที่ส่งคำขอได้ในตารางวิธีการ ชื่อเมธอดจะประกอบด้วยเวอร์ชัน Google Ads API, บริการ และชื่อเมธอด เช่น
google.ads.googleads.v19.services.GoogleAdsService.Mutate - (ไม่บังคับ) เลือกกรอบเวลาที่ต้องการดูคำขอ
ความแตกต่างระหว่างการเลิกใช้งานและการหยุดให้บริการ
| คำศัพท์ | การเลิกใช้งาน | พระอาทิตย์ตก |
|---|---|---|
| คำจำกัดความ | เวอร์ชันที่เลิกใช้งานคือเวอร์ชันที่ไม่ใช่เวอร์ชันล่าสุด เมื่อมีการเผยแพร่เวอร์ชันใหม่ ระบบจะทําเครื่องหมายเวอร์ชันก่อนหน้าทั้งหมดว่าเลิกใช้งาน | คุณจะใช้เวอร์ชันที่หยุดให้บริการไม่ได้อีกต่อไป คำขอที่ส่งไปยังเวอร์ชันนี้จะดำเนินการไม่สำเร็จในวันที่ประกาศหยุดให้บริการหรือหลังจากนั้น |
| ผลที่ตามมา | คุณจะยังใช้เวอร์ชันเลิกใช้งานได้จนกว่าจะมีการหยุดให้บริการ แต่ระบบจะยกเลิกการไฮไลต์การอ้างอิงเวอร์ชันเลิกใช้งานเพื่อแสดงให้เห็นว่าเวอร์ชันดังกล่าวไม่ใช่เวอร์ชันล่าสุดแล้ว
เราขอแนะนำให้คุณอัปเกรดเป็นเวอร์ชันล่าสุดโดยเร็วที่สุดเพื่อรับประโยชน์จากฟีเจอร์ใหม่ๆ |
คุณต้องอัปเกรดจากเวอร์ชันที่หยุดให้บริการทันทีเพื่อใช้ Google Ads API
เราขอแนะนําอย่างยิ่งให้คุณอัปเกรดเป็นเวอร์ชันล่าสุดโดยใช้คู่มือการอัปเกรด |
| การกำหนดเวลา | โดยเฉลี่ยแล้ว เราจะเปิดตัวเวอร์ชันใหม่ทุก 3-4 เดือน ดังนั้นเวอร์ชันหนึ่งๆ จะเลิกใช้งานหลังจากผ่านไปประมาณ 3-4 เดือน | เราตั้งใจที่จะหยุดให้บริการเวอร์ชันหนึ่งๆ หลังจากเปิดตัวไปแล้ว 1 ปี |
| API | ปลายทาง API สำหรับเวอร์ชันที่เลิกใช้งานจะยังคงทำงานตามปกติ
คุณสามารถเข้าถึงปลายทาง API โดยใช้ไลบรารีของไคลเอ็นต์, REST และอื่นๆ ได้ แต่จะไม่มีการเพิ่มฟีเจอร์ใหม่ลงในเวอร์ชันที่เลิกใช้งาน |
ปลายทาง API สำหรับเวอร์ชันที่หยุดให้บริการจะหยุดทํางานหลังจากวันที่หยุดให้บริการ Google Ads API จะแสดงข้อผิดพลาดหากคุณพยายามเข้าถึงปลายทาง API ของเวอร์ชันที่เลิกใช้งาน |
| ไลบรารีของไคลเอ็นต์ | เพื่อให้บริการไลบรารีของไคลเอ็นต์ที่กะทัดรัด เราจะหยุดรวม API เวอร์ชันที่เลิกใช้งานไว้ในไลบรารีของไคลเอ็นต์เวอร์ชันใหม่หลังจากวันที่เลิกใช้งาน ซึ่งจะช่วยประหยัดพื้นที่เมื่อรวมไลบรารีของไคลเอ็นต์ไว้ในโปรเจ็กต์ | ไลบรารีของไคลเอ็นต์ไม่รองรับ API เวอร์ชันที่หยุดให้บริการในไลบรารีของไคลเอ็นต์เวอร์ชันใหม่หลังจากวันที่หยุดให้บริการ |
| การสนับสนุน | เราให้การสนับสนุนเวอร์ชันที่เลิกใช้งานเป็นประจำ | เราจะไม่รองรับเวอร์ชันที่หยุดให้บริการหลังจากวันที่ประกาศหยุดให้บริการ |
เวอร์ชันไลบรารีของไคลเอ็นต์ที่รองรับ
ตารางจะแสดงไลบรารีของไคลเอ็นต์ที่ใช้งานร่วมกับ API เวอร์ชันใดได้บ้าง
Google Ads API |
ไลบรารีของไคลเอ็นต์สําหรับ Java |
v19 |
Min: 36.0.0Max: - |
v18 |
Min: 34.0.0Max: - |
v17 |
Min: 32.0.0Max: - |
Google Ads API |
ไลบรารีของไคลเอ็นต์สำหรับ .NET |
v19 |
Min: 22.1.0Max: - |
v18 |
Min: 21.1.0Max: - |
v17 |
Min: 20.1.0Max: - |
v16 |
Min: 18.1.0Max: 21.1.0 |
Google Ads API |
ไลบรารีของไคลเอ็นต์สำหรับ PHP |
v19 |
Min: 26.1.0Max: - |
v18 |
Min: 25.0.0Max: - |
v17 |
Min: 23.1.0Max: - |
Google Ads API |
ไลบรารีของไคลเอ็นต์สําหรับ Python |
v19 |
Min: 25.2.0Max: - |
v18 |
Min: 25.1.0Max: - |
v17 |
Min: 24.1.0Max: - |
v16 |
Min: 23.1.0Max: - |
Google Ads API |
ไลบรารีของไคลเอ็นต์สําหรับ Ruby |
v18 |
Min: 31.0.0Max: - |
v17 |
Min: 29.0.0Max: - |
v16 |
Min: 27.0.0Max: - |
Google Ads API |
ไลบรารีของไคลเอ็นต์สําหรับ Perl |
v19 |
Min: 26.0.0Max: - |
v18 |
Min: 25.0.1Max: - |
v17 |
Min: 23.0.0Max: - |
การเลิกใช้งานฟีเจอร์
ตรวจสอบบล็อกนักพัฒนาซอฟต์แวร์ Google Ads เป็นประจําเพื่อเป็นคนแรกที่ทราบเกี่ยวกับการเลิกใช้งานฟีเจอร์ที่กําลังจะมีขึ้น
ตารางต่อไปนี้แสดงการเลิกใช้งานฟีเจอร์ที่เฉพาะเจาะจงซึ่งวางแผนไว้สําหรับ Google Ads API ดูรายละเอียดเพิ่มเติมเกี่ยวกับการเลิกใช้งานแต่ละรายการได้ในบล็อกโพสต์ที่ลิงก์
| ฟีเจอร์ | คำอธิบาย | วันที่มีผล | หมายเหตุเพิ่มเติม |
|---|---|---|---|
| การอัปเดตรายงานข้อมูลเชิงลึกเกี่ยวกับข้อความค้นหาของ Google Ads API และสคริปต์ Google Ads ตั้งแต่วันที่ 3 มีนาคม 2025 | ตั้งแต่วันที่ 3 มีนาคม 2025 เป็นต้นไป รายงานข้อมูลเชิงลึกเกี่ยวกับข้อความค้นหาของ Google Ads API และสคริปต์ Google Ads จะแสดงผลหมวดหมู่ย่อยทั้งหมดของ Search เป็นว่าง UI ของ Google Ads ได้นําฟิลด์นี้ออกแล้ว และ API กำลังเปิดตัวการเปลี่ยนแปลงนี้เพื่อให้สอดคล้องกันทั่วทั้ง Google Ads | 3 มีนาคม 2025 | ตั้งแต่วันที่ 3 มีนาคม 2025 เป็นต้นไป ค่าทั้งหมดสำหรับ
segments.search_subcategoryจะว่างเปล่า หากคุณค้นหา segments.search_subcategory ในรายงาน
campaign_search_term_insight หรือ
customer_search_term_insight ให้ตรวจสอบว่าโค้ดของคุณจัดการค่าว่างใน segments.search_subcategory ได้
สตริงว่างเป็นรายการที่รับทั้งหมดอยู่แล้ว ดังนั้นโค้ดของคุณควรจัดการเรื่องนี้อยู่แล้ว เราขอแนะนำให้นำsegments.search_subcategoryออกจากข้อความค้นหา
|
| การเปลี่ยนแปลงที่กําลังจะเกิดขึ้นกับขนาดหน้าใน Google Ads API | เมื่อ v16 หยุดให้บริการแล้ว คุณจะตั้งค่าช่อง page_size ไม่ได้อีกต่อไปเมื่อส่งคำขอ GoogleAdsService.Search |
กุมภาพันธ์ 2025 | เมื่อ v16 หยุดให้บริการ คำขอทั้งหมดของ GoogleAdsService.Search จะถือว่ามีขนาดหน้าคงที่คือ 10,000 แถว |
| การอัปเดตวันหมดอายุของการเป็นสมาชิกการจับคู่ข้อมูลลูกค้า | ตั้งแต่วันที่ 7 เมษายน 2025 เป็นต้นไป ช่อง UserList.membership_life_span จะไม่อนุญาตให้ใช้ค่าที่มากกว่า 540 อีกต่อไป |
7 เมษายน 2025 | ตั้งแต่วันที่ 7-15 เมษายน 2025 เราจะทยอยเปิดตัวการเปลี่ยนแปลงในช่องUserList.membership_life_span คําขอตั้งค่าช่องเป็นค่ามากกว่า 540 จะแสดงข้อผิดพลาด RangeError.TOO_HIGH ระบบจะย้ายข้อมูลรายการผู้ใช้ที่มีอยู่ซึ่งมีค่าในช่องมากกว่า 540 วันโดยอัตโนมัติเพื่อให้มีระยะเวลาการเป็นสมาชิกสูงสุด 540 วัน ดูข้อมูลเพิ่มเติมได้ในการอัปเดตการหมดอายุของการเป็นสมาชิกการจับคู่ข้อมูลลูกค้า
|