Khi phát hành một phiên bản mới, phiên bản không dùng nữa sẽ được chỉ định ngày ngừng hoạt động, sau đó, phiên bản đó sẽ không còn được cung cấp nữa. Dưới đây là một số nguyên tắc khác mà bạn cần lưu ý:
- Tại một thời điểm, tối đa có 3 phiên bản chính.
- Phiên bản chính có vòng đời khoảng 12 tháng – phiên bản nhỏ: 10 tháng.
- Bạn sẽ phải thực hiện tối đa 2 lần nâng cấp mỗi năm và không nhất thiết phải nâng cấp theo thứ tự tuần tự nghiêm ngặt. Ví dụ: bạn có thể nâng cấp trực tiếp từ phiên bản (N) lên phiên bản (N+2).
- Khoảng thời gian trùng lặp giữa ngày phát hành tất cả thư viện ứng dụng cho phiên bản mới nhất và phiên bản sắp ngừng hoạt động phải ít nhất là 20 tuần.
Thư viện ứng dụng của chúng tôi hỗ trợ mọi phiên bản có sẵn của một dịch vụ, vì vậy, bạn có thể nâng cấp dần bằng cách chỉ định các phiên bản khác nhau của dịch vụ đã sử dụng.
Lịch trình
Bảng sau đây liệt kê ngày ngừng sử dụng và ngày ngừng hoạt động cụ thể cho từng phiên bản hiện có, cũng như ngày phát hành dự kiến cho các phiên bản trong tương lai. Bạn nên nâng cấp lên phiên bản mới nhất càng sớm càng tốt sau khi phiên bản đó được phát hành.
| Phiên bản API | Ngày phát hành | Ngày ngừng sử dụng | Ngày ngừng hoạt động | Hướng dẫn nâng cấp |
|---|---|---|---|---|
| v19 | Ngày 26 tháng 2 năm 2025 | Nâng cấp từ phiên bản 18 lên phiên bản 19 | ||
| v18 | Ngày 16 tháng 10 năm 2024 | Tháng 6 năm 2025 | Tháng 9 năm 2025 | Nâng cấp từ phiên bản 17 lên phiên bản 18 |
| 17.1 | Ngày 7 tháng 8 năm 2024 | Ngày 16 tháng 10 năm 2024 | Ngày 4 tháng 6 năm 2025 | |
| v17 | Ngày 5 tháng 6 năm 2024 | Ngày 16 tháng 10 năm 2024 | Ngày 4 tháng 6 năm 2025 |
Xem các phiên bản mà dự án của bạn đang sử dụng
Bạn có thể xem danh sách các phương thức và dịch vụ mà dự án của bạn đã gọi gần đây bằng cách sử dụng Google Cloud Console:
- Mở phần API và dịch vụ trong Google Cloud Console.
- Nhấp vào API Google Ads trong bảng.
- Trên thẻ phụ CHỈ SỐ, bạn sẽ thấy các yêu cầu gần đây được lập biểu đồ trên mỗi biểu đồ. Bạn có thể xem những phương thức mà bạn đã gửi yêu cầu trong bảng Phương thức. Tên phương thức bao gồm phiên bản API Google Ads, một dịch vụ và tên phương thức, chẳng hạn như
google.ads.googleads.v19.services.GoogleAdsService.Mutate. - (Không bắt buộc) Chọn khung thời gian mà bạn muốn xem cho các yêu cầu của mình.
Sự khác biệt giữa việc ngừng sử dụng và ngừng cung cấp
| Thuật ngữ | Ngừng sử dụng | Hoàng hôn |
|---|---|---|
| Định nghĩa | Phiên bản không dùng nữa là phiên bản không phải là phiên bản mới nhất. Sau khi phiên bản mới được phát hành, tất cả các phiên bản trước đó sẽ được đánh dấu là không dùng nữa. | Bạn không thể sử dụng phiên bản ngừng hoạt động nữa. Các yêu cầu gửi đến phiên bản này sẽ không thành công kể từ ngày ngừng hoạt động. |
| Hậu quả | Bạn vẫn có thể sử dụng các phiên bản không dùng nữa cho đến khi chúng ngừng hoạt động, nhưng các tệp tham chiếu của các phiên bản không dùng nữa sẽ không được làm nổi bật để cho biết rằng đó không còn là phiên bản mới nhất nữa.
Bạn nên nâng cấp lên phiên bản mới nhất càng sớm càng tốt để tận dụng các tính năng mới. |
Bạn cần nâng cấp từ các phiên bản ngừng hoạt động ngay lập tức để sử dụng API Google Ads.
Bạn nên nâng cấp lên phiên bản mới nhất bằng cách tham khảo hướng dẫn nâng cấp. |
| Thời gian | Trung bình, chúng tôi phát hành một phiên bản mới sau mỗi 3 đến 4 tháng, vì vậy, phiên bản đã cho sẽ ngừng hoạt động sau khoảng 3 đến 4 tháng. | Chúng tôi dự định ngừng hoạt động một phiên bản 1 năm sau khi phát hành. |
| API | Các điểm cuối API cho các phiên bản không dùng nữa vẫn hoạt động như bình thường.
Bạn có thể truy cập vào các điểm cuối API của chúng tôi bằng cách sử dụng thư viện ứng dụng, REST, v.v.; tuy nhiên, các tính năng mới sẽ không được thêm vào các phiên bản không dùng nữa. |
Các điểm cuối API của các phiên bản ngừng hoạt động sẽ ngừng hoạt động sau ngày ngừng hoạt động. API Google Ads sẽ gửi lỗi nếu bạn cố gắng truy cập vào các điểm cuối API của các phiên bản ngừng hoạt động. |
| Thư viện ứng dụng | Để cung cấp thư viện ứng dụng nhỏ gọn, chúng tôi sẽ ngừng đưa các phiên bản API không dùng nữa vào phiên bản thư viện ứng dụng mới sau ngày ngừng sử dụng. Điều này giúp bạn tiết kiệm dung lượng khi kết hợp thư viện ứng dụng của chúng tôi vào dự án. | Thư viện ứng dụng không còn hỗ trợ các phiên bản API ngừng hoạt động trong mọi phiên bản thư viện ứng dụng mới sau ngày ngừng hoạt động. |
| Hỗ trợ | Chúng tôi thường xuyên hỗ trợ các phiên bản không dùng nữa. | Phiên bản ngừng hoạt động không còn được hỗ trợ sau ngày ngừng hoạt động. |
Các phiên bản thư viện ứng dụng được hỗ trợ
Bảng này cho biết thư viện ứng dụng nào hoạt động với phiên bản API nào.
Java
API Google Ads |
Thư viện ứng dụng cho Java |
v19 |
Min: 36.0.0Max: - |
v18 |
Min: 34.0.0Max: - |
v17 |
Min: 32.0.0Max: - |
C#
API Google Ads |
Thư viện ứng dụng cho .NET |
v19 |
Min: 22.1.0Max: - |
v18 |
Min: 21.1.0Max: - |
v17 |
Min: 20.1.0Max: - |
v16 |
Min: 18.1.0Max: 21.1.0 |
PHP
API Google Ads |
Thư viện ứng dụng cho PHP |
v18 |
Min: 25.0.0Max: - |
v17 |
Min: 23.1.0Max: - |
v16 |
Min: 22.1.0Max: - |
Python
API Google Ads |
Thư viện ứng dụng cho Python |
v19 |
Min: 25.2.0Max: - |
v18 |
Min: 25.1.0Max: - |
v17 |
Min: 24.1.0Max: - |
v16 |
Min: 23.1.0Max: - |
Ruby
API Google Ads |
Thư viện ứng dụng cho Ruby |
v18 |
Min: 31.0.0Max: - |
v17 |
Min: 29.0.0Max: - |
v16 |
Min: 27.0.0Max: - |
Perl
API Google Ads |
Thư viện ứng dụng cho Perl |
v19 |
Min: 26.0.0Max: - |
v18 |
Min: 25.0.1Max: - |
v17 |
Min: 23.0.0Max: - |
Ngừng sử dụng tính năng
Thường xuyên theo dõi blog nhà phát triển Google Ads để là người đầu tiên biết về các tính năng sắp ngừng hoạt động.
Bảng sau đây liệt kê các tính năng cụ thể dự kiến sẽ ngừng hoạt động đối với API Google Ads. Bạn có thể xem thêm thông tin chi tiết về từng tính năng ngừng hoạt động trong các bài đăng trên blog được liên kết.
| Tính năng | Mô tả | Ngày có hiệu lực | Ghi chú khác |
|---|---|---|---|
| Nội dung cập nhật về báo cáo thông tin chi tiết về cụm từ tìm kiếm trong API Google Ads và tập lệnh Google Ads kể từ ngày 3 tháng 3 năm 2025 | Kể từ ngày 3 tháng 3 năm 2025, API Google Ads và tập lệnh Google Ads sẽ trả về tất cả các danh mục phụ của cụm từ tìm kiếm ở trạng thái trống. Giao diện người dùng Google Ads đã xoá trường này và API cũng đang triển khai thay đổi này để nhất quán trên Google Ads. | Ngày 3 tháng 3 năm 2025 | Kể từ ngày 3 tháng 3 năm 2025, dự kiến tất cả giá trị cho
segments.search_subcategory sẽ trống. Nếu bạn truy vấn segments.search_subcategory trong báo cáo
campaign_search_term_insight hoặc
customer_search_term_insight, hãy kiểm tra để đảm bảo mã của bạn có thể xử lý giá trị trống trong segments.search_subcategory.
Chuỗi trống đã là một chuỗi tổng hợp, vì vậy, mã của bạn phải đã xử lý việc này. Bạn nên xoá segments.search_subcategory khỏi truy vấn của mình.
|
| Những thay đổi sắp tới đối với kích thước trang trong API Google Ads | Khi phiên bản 16 ngừng hoạt động, bạn sẽ không thể đặt trường page_size khi tạo yêu cầu GoogleAdsService.Search. |
Tháng 2 năm 2025 | Khi phiên bản 16 ngừng hoạt động, tất cả các yêu cầu GoogleAdsService.Search sẽ giả định kích thước trang cố định là 10.000 hàng. |
| Thông tin cập nhật về thời điểm hết hạn gói thành viên So khớp khách hàng | Kể từ ngày 7 tháng 4 năm 2025, trường UserList.membership_life_span sẽ không còn cho phép các giá trị lớn hơn 540. |
Ngày 7 tháng 4 năm 2025 | Từ ngày 7 tháng 4 năm 2025 đến ngày 15 tháng 4 năm 2025, chúng tôi sẽ từng bước triển khai thay đổi đối với trường UserList.membership_life_span. Các yêu cầu đặt trường lớn hơn 540 sẽ trả về lỗi RangeError.TOO_HIGH. Mọi danh sách người dùng hiện có có giá trị trường lớn hơn 540 sẽ được tự động di chuyển để có thời hạn thành viên tối đa là 540 ngày. Hãy xem phần Cập nhật về việc hết hạn gói thành viên So khớp khách hàng để biết thêm thông tin.
|