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 4 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 hai 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. Ngày dự kiến có nghĩa là việc ngừng cung cấp 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 về thông báo ngừng hoạt động của phiên bản API.

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
v21Ngày 6 tháng 8 năm 2025Nâng cấp từ phiên bản 20 lên phiên bản 21
v20.1Ngày 6 tháng 8 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
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.2Ngày 6 tháng 8 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
v19.1Ngày 16 tháng 4 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
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 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 dùng nữa vẫn hoạt động như thường lệ.

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: –

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
v21 Min: 35.0.0
Max: –
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ề những 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
Môi trường chuyển đổi ảnh hưởng đến hiệu suất của chiến dịch quảng cáo ứng dụng Kể từ ngày 30 tháng 9 năm 2025, chúng tôi sẽ bắt đầu từng bước triển khai một thay đổi đối với các mô hình đặt giá thầu, cho phép các mô hình này sử dụng dữ liệu về môi trường chuyển đổi có trong lượt chuyển đổi được nhập để tối ưu hoá hiệu suất chiến dịch. Ngày 3 tháng 10 năm 2025 Hãy xem bài đăng trên blog của chúng tôi để biết thêm thông tin chi tiết.
Lượt chuyển đổi có thể bao gồm cả giá trị "gclid" và "gbraid". Kể từ ngày 3 tháng 10 năm 2025, lượt chuyển đổi được nhập sẽ không còn trả về lỗi "VALUE_MUST_BE_UNSET" nếu cả trường "gclid" và "gbraid" đều được đặt. Ngày 3 tháng 10 năm 2025 Hãy xem bài đăng trên blog của chúng tôi để biết thêm thông tin chi tiết.