Ngừng sử dụng và ngừng cung cấp

Khi phát hành một phiên bản mới, phiên bản bị ngừng sử dụng sẽ được chỉ định ngày ngừng hoạt động, sau ngày đó, 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 3 phiên bản chính tại một thời điểm bất kỳ.
  • Các phiên bản chính có vòng đời khoảng 12 tháng – phiên bản phụ: 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 cần nâng cấp theo thứ tự tuần tự nghiêm ngặt. Ví dụ: bạn có thể nâng cấp từ phiên bản (N) trực tiếp 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ẽ ngừng hoạt động là ít nhất 20 tuần.

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ụ đã 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 APINgày phát hànhNgày ngưng sử dụngNgày ngừng hoạt độngHướng dẫn nâng cấp
v20Ngày 4 tháng 6 năm 2025Tháng 6 năm 2026 (dự kiến)Nâng cấp từ phiên bản 19 lên phiên bản 20
v19.1Ngày 16 tháng 4 năm 2025 Tháng 2 năm 2026 (dự kiến)
v19Ngày 26 tháng 2 năm 2025 Tháng 2 năm 2026 (dự kiến)Nâng cấp từ phiên bản 18 lên phiên bản 19
v18Ngày 16 tháng 10 năm 2024Tháng 6 năm 2025Ngày 20 tháng 8 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 Google Cloud Console:

  1. Mở API và dịch vụ trong Google Cloud Console.
  2. Nhấp vào API Google Ads trong bảng.
  3. Trên thẻ phụ CHỈ SỐ, bạn sẽ thấy các yêu cầu gần đây của mình được vẽ trên từng 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.v21.services.GoogleAdsService.Mutate.
  4. (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ụngHoà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 một 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ể dùng phiên bản ngừng hoạt động nữa. Các yêu cầu được 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àm ý 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ài liệu tham khảo của các phiên bản không dùng nữa sẽ bị giả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 để 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 sử dụng hướng dẫn nâng cấp.
Thời điểm 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ẽ không được dùng nữa sau khoảng 3 đến 4 tháng. Chúng tôi dự định ngừng hỗ trợ một phiên bản sau 1 năm kể từ khi phát hành.
API Các điểm cuối API cho 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 các 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 cho 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ẽ gửi thông 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 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 không dùng nữa. Đ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 mình. Các 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. Sau ngày ngừng hoạt động, các phiên bản ngừng hoạt động sẽ không còn được hỗ trợ nữa.

Các phiên bản thư viện ứng dụng được hỗ trợ

Bảng này cho biết những thư viện ứng dụng nào hoạt động với những phiên bản API nào.

Java

Thư viện ứng dụng cho Java
v21 Min: 39.0.0
Max: –
v20 Min: 38.0.0
Max: –
v19 Min: 36.0.0
Max: –
v18 Min: 34.0.0
Max: 39.0.0

C#

Thư viện ứng dụng cho .NET
v21 Min: 24.0.0
Max: –
v20 Min: 23.0.0
Max: –
v19 Min: 22.1.0
Max: –
v18 Min: 21.1.0
Max: 23.0.0

PHP

Thư viện ứng dụng cho PHP
v21 Min: 31.0.0
Max: –
v20 Min: 28.0.0
Max: –
v19 Min: 26.1.0
Max: –
v18 Min: 25.0.0
Max: 30.0.0

Python

Thư viện ứng dụng cho Python
v21 Min: 28.0.0
Max: –
v20 Min: 27.0.0
Max: –
v19 Min: 25.2.0
Max: –

Ruby

Thư viện ứng dụng cho Ruby
v20 Min: 34.0.0
Max: –
v19 Min: 32.0.0
Max: –
v18 Min: 31.0.0
Max: –

Perl

Thư viện ứng dụng cho Perl
v21 Min: 28.0.0
Max: –
v20 Min: 27.0.0
Max: –
v19 Min: 26.0.0
Max: –
v18 Min: 25.0.1
Max: 28.0.0

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ê những tính năng cụ thể dự kiến sẽ ngừng sử dụng trong Google Ads API. Bạn có thể xem thêm thông tin chi tiết về từng lần ngừng cung cấp 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
Thông báo lỗi mới cho mã thông báo nhà phát triển không hợp lệ Kể từ ngày 28 tháng 4 năm 2025, mã thông báo không hợp lệ của nhà phát triển sẽ trả về DEVELOPER_TOKEN_INVALID cho phiên bản 19.1 trở lên và DEVELOPER_TOKEN_NOT_APPROVED cho các phiên bản trước phiên bản 19.1. Mã thông báo không hợp lệ của nhà phát triển được trả về trước đó OAUTH_TOKEN_HEADER_INVALID, mã này vẫn sẽ được dùng cho tiêu đề OAuth không hợp lệ. Ngày 28 tháng 4 năm 2025 Thay đổi này sẽ không ảnh hưởng đến những người đã có các lệnh gọi API đang hoạt động.