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 hoạt động nữa. Sau đây là một số nguyên tắc khác cần lưu ý:
- Chúng tôi cố gắng duy trì tối đa 5 phiên bản lớn tại bất kỳ thời điểm nào.
- Các phiên bản chính có thời gian hoạt động khoảng 12 tháng, còn các phiên bản phụ có thời gian hoạt động là 10 tháng.
- Bạn sẽ phải thực hiện tối đa hai lần nâng cấp mỗi năm và không cần 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).
Thư viện ứng dụng của chúng tôi hỗ trợ mọi phiên bản hiện có 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ụ được 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. Ngày dự kiến có nghĩa là việc ngừng hoạt động có thể diễn ra bất cứ lúc nào trong tháng đó và ngày có thể thay đổi. Đăng ký theo dõi blog để nhận lời nhắc thông báo về việc ngừng cung cấp phiên bản API.
| Phiên bản API | Ngày phát hành | Ngày ngừng hoạt động | Thay đổi có thể gây lỗi và nâng cấp | Tính năng và thông tin cập nhật | Bảng khác biệt về Proto |
|---|---|---|---|---|---|
| Phiên bản phát hành | |||||
| v23 | Ngày 28 tháng 1 năm 2026 | Tháng 2 năm 2027 | Thay đổi có thể gây lỗi trong phiên bản 23 (hướng dẫn nâng cấp) | Tính năng và nội dung cập nhật của phiên bản 23 | Sự khác biệt về tệp proto giữa phiên bản 22 và phiên bản 23 |
| v23.1 | Ngày 25 tháng 2 năm 2026 | Tháng 2 năm 2027 | Không có (bản phát hành nhỏ) | Tính năng và nội dung cập nhật của phiên bản 23.1 | Sự khác biệt về tệp proto giữa phiên bản 22 và phiên bản 23 |
| v23.2 | Ngày 25 tháng 3 năm 2026 | Tháng 2 năm 2027 | Không có (bản phát hành nhỏ) | Tính năng và nội dung cập nhật trong phiên bản 23.2 | Sự khác biệt về tệp proto giữa phiên bản 22 và phiên bản 23 |
| v23.3 | Ngày 24 tháng 6 năm 2026 | Tháng 2 năm 2027 | Không có (bản phát hành nhỏ) | Tính năng và bản cập nhật của phiên bản 23.3 | Sự khác biệt về tệp proto giữa phiên bản 22 và phiên bản 23 |
| v24 | Ngày 22 tháng 4 năm 2026 | Tháng 5 năm 2027 | thay đổi có thể gây lỗi trong phiên bản 24 (hướng dẫn nâng cấp) | Tính năng và thông tin cập nhật của phiên bản 24 | Sự khác biệt về proto giữa phiên bản 23 và phiên bản 24 |
| v24.1 | Ngày 13 tháng 5 năm 2026 | Tháng 5 năm 2027 | Không có (bản phát hành nhỏ) | Tính năng và nội dung cập nhật của phiên bản 24.1 | Sự khác biệt về proto giữa phiên bản 23 và phiên bản 24 |
| v24.2 | Ngày 24 tháng 6 năm 2026 | Tháng 6/2027 | Không có (bản phát hành nhỏ) | Các tính năng và bản cập nhật của phiên bản 24.2 | Sự khác biệt về proto giữa phiên bản 23 và phiên bản 24 |
| v25 | Ngày 22 tháng 7 năm 2026 | Tháng 8 năm 2027 | Thay đổi có thể gây lỗi trong phiên bản 25 (hướng dẫn nâng cấp) | Các tính năng và bản cập nhật của phiên bản 25 | Sự khác biệt về tệp proto giữa phiên bản 24 và phiên bản 25 |
| v25.1 | Ngày 19 tháng 8 năm 2026 | Tháng 8 năm 2027 | Không có (bản phát hành nhỏ) | Tính năng và nội dung cập nhật của phiên bản 25.1 | Sự khác biệt về tệp proto giữa phiên bản 24 và phiên bản 25 |
| v25.2 | Ngày 23 tháng 9 năm 2026 | Tháng 8 năm 2027 | Không có (bản phát hành nhỏ) | Tính năng và nội dung cập nhật của phiên bản 25.2 | Sự khác biệt về tệp proto giữa phiên bản 24 và phiên bản 25 |
| v26 (Mới nhất) | Ngày 14 tháng 10 năm 2026 | Tháng 11 năm 2027 | Thay đổi có thể gây lỗi trong phiên bản 26 (hướng dẫn nâng cấp) | Các tính năng và bản cập nhật của phiên bản 26 | Sự khác biệt về tệp proto giữa phiên bản 25 và phiên bản 26 |
| Các phiên bản sắp ra mắt | |||||
| v26.1 | Tháng 10/2026 | Tháng 11 năm 2027 | |||
| v26.2 | Tháng 11 năm 2026 | Tháng 11 năm 2027 | |||
| phiên bản 26.3* | Tháng 12 năm 2026 | Tháng 11 năm 2027 | |||
| v27 | Tháng 1 năm 2027 | Tháng 2 năm 2028 | |||
| v27.1 | Tháng 2 năm 2027 | Tháng 2 năm 2028 | |||
| v27.2 | Tháng 2 năm 2027 | Tháng 2 năm 2028 | |||
| v27.3 | Tháng 3 năm 2027 | Tháng 2 năm 2028 | |||
| v27.4 | Tháng 3 năm 2027 | Tháng 2 năm 2028 | |||
| v28 | Tháng 4 năm 2027 | Tháng 5/2028 | |||
| v28.1 | Tháng 4 năm 2027 | Tháng 5/2028 | |||
| v28.2 | Tháng 5 năm 2027 | Tháng 5/2028 | |||
| v28.3 | Tháng 5 năm 2027 | Tháng 5/2028 | |||
| v28.4 | Tháng 6/2027 | Tháng 5/2028 | |||
| v28.5 | Tháng 6/2027 | Tháng 5/2028 | |||
| v29 | Tháng 7/2027 | Tháng 8 năm 2028 | |||
| v29.1 | Tháng 7/2027 | Tháng 8 năm 2028 | |||
| v29.2 | Tháng 8 năm 2027 | Tháng 8 năm 2028 | |||
| v29.3 | Tháng 8 năm 2027 | Tháng 8 năm 2028 | |||
| v29.4 | Tháng 9 năm 2027 | Tháng 8 năm 2028 | |||
| v29.5 | Tháng 9 năm 2027 | Tháng 8 năm 2028 | |||
| v30 | Tháng 10/2027 | Tháng 11 năm 2028 | |||
| v30.1 | Tháng 10/2027 | Tháng 11 năm 2028 | |||
| v30.2 | Tháng 11 năm 2027 | Tháng 11 năm 2028 | |||
| v30.3* | Tháng 12 năm 2027 | Tháng 11 năm 2028 | |||
* Phiên bản 26.3 và 30.3 được chỉ định là bản phát hành không bắt buộc do trùng với mùa lễ.
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ở API & Services (API và dịch vụ) trong Google Cloud Console.
- Nhấp vào Google Ads API trong bảng.
- Trên thẻ con METRICS (CHỈ SỐ), bạn sẽ thấy các yêu cầu gần đây được vẽ 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 Google Ads API, dịch vụ và tên phương thức, chẳng hạn như
google.ads.googleads.v26.services.GoogleAdsService.Mutate. - (Không bắt buộc) Chọn khung thời gian 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ả 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. Yêu cầu gửi đến phiên bản này sẽ không thành công vào hoặc sau ngày ngừng hoạt động. |
| Hệ 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 tham chiếu của phiên bản không dùng nữa sẽ không được làm nổi bật để cho thấy rằng chú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 để hưởng lợi từ các tính năng mới. |
Bạn cần nâng cấp ngay từ các phiên bản ngừng hoạt động để sử dụng Google Ads API.
Bạn nên nâng cấp lên phiên bản mới nhất bằng cách sử dụng 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 cung cấp một phiên bản sau 1 năm kể từ ngày phát hành. |
| API | Các điểm cuối API cho phiên bản không còn được 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 thư viện ứng dụng và REST. 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. |
Điểm cuối API cho 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. Google Ads API sẽ báo lỗi nếu bạn cố gắng truy cập vào các điểm cuối API của phiên bản đã ngừng hoạt động. |
| Thư viện ứng dụng | Để cung cấp các thư viện ứng dụng gọn nhẹ, 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 các thư viện ứng dụng của chúng tôi vào dự án của bạ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 bất kỳ phiên bản thư viện ứng dụng mới nào 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 còn được dùng nữa. | Các phiên bản ngừng hoạt động sẽ 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.
Phiên bản thư viện ứng dụng tối thiểu được liệt kê là đủ cho bản phát hành chính của Google Ads API (chẳng hạn như phiên bản 26). Để xem phiên bản thư viện ứng dụng bắt buộc cho các bản phát hành nhỏ, hãy tham khảo Nhật ký thay đổi được liên kết.
Java
API Google Ads |
Thư viện ứng dụng cho Java |
v26 |
Min: 48.0.0Max: – |
v25 |
Min: 44.0.0Max: – |
v24 |
Min: 43.0.0Max: – |
v23 |
Min: 42.0.0Max: – |
C#
API Google Ads |
Thư viện ứng dụng cho .NET |
v26 |
Min: 27.5.0Max: – |
v25 |
Min: 26.1.0Max: – |
v24 |
Min: 25.3.0Max: – |
v23 |
Min: 25.1.0Max: – |
PHP
API Google Ads |
Thư viện ứng dụng cho PHP |
v26 |
Min: 35.2.0Max: – |
v25 |
Min: 33.6.0Max: – |
v24 |
Min: 33.3.0Max: – |
v23 |
Min: 32.2.0Max: – |
Python
API Google Ads |
Thư viện ứng dụng cho Python |
v26 |
Min: 34.0.0Max: – |
v25 |
Min: 31.2.0Max: – |
v24 |
Min: 30.1.0Max: – |
v23 |
Min: 29.2.0Max: – |
Ruby
API Google Ads |
Thư viện ứng dụng cho Ruby |
v26 |
Min: 46.0.0Max: – |
v25 |
Min: 43.0.0Max: – |
v24 |
Min: 40.0.0Max: – |
v23 |
Min: 38.0.0Max: – |
Perl
API Google Ads |
Thư viện ứng dụng cho Perl |
v26 |
Min: 36.0.0Max: – |
v25 |
Min: 33.0.0Max: – |
v24 |
Min: 32.0.0Max: – |
v23 |
Min: 31.0.0Max: – |
Các thay đổi và tính năng không còn được dùng nữa
Mặc dù trang này tập trung vào vòng đời ở cấp phiên bản API, nhưng việc ngừng sử dụng từng tính năng riêng lẻ (chẳng hạn như ngừng sử dụng Chiến dịch thông minh) và các thay đổi về quy trình làm việc không theo phiên bản (chẳng hạn như các yêu cầu mới về ngân sách chiến dịch Tạo nhu cầu) được theo dõi riêng.
Để kiểm tra vòng đời của tính năng sắp ra mắt và sự thay đổi hành vi trên các phiên bản đang hoạt động, hãy xem hướng dẫn Tính năng ngừng hoạt động và các thay đổi không theo phiên bản.