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 đó, phiên bản đó sẽ không còn sử dụng được nữa. Dưới đâ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 có sẵn tại bất kỳ thời điểm nào.
  • Các phiên bản chính có thời gian tồn tại khoảng 12 tháng—phụ phiên bản: 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 đúng thứ tự tuần 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ờ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 các 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. Ngày dự kiến có nghĩa là việc ngừng hoạt động có thể xảy 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 hoạt độngHướng dẫn nâng cấp
Phiên bản đã phát hành
v20Ngày 4 tháng 6 năm 2025Tháng 6 năm 2026 (dự kiến)Nâng cấp từ v19 lên v20
v20.1Ngày 6 tháng 8 năm 2025Tháng 6 năm 2026 (dự kiến)Nâng cấp từ v19 lên v20
v21Ngày 6 tháng 8 năm 2025Tháng 8 năm 2026 (dự kiến)Nâng cấp từ v20 lên v21
v22Ngày 15 tháng 10 năm 2025Tháng 10 năm 2026 (dự kiến)Nâng cấp từ v21 lên v22
v23Ngày 28 tháng 1 năm 2026Tháng 2 năm 2027Nâng cấp từ v22 lên v23
Phiên bản sắp ra mắt
v23.1 Ngày 25 tháng 2 năm 2026 Tháng 2 năm 2027 Nâng cấp từ v23 lên v23.1
v23.2 Ngày 25 tháng 3 năm 2026 Tháng 2 năm 2027 Nâng cấp từ v23.1 lên v23.2
v24 Tháng 4 năm 2026 Tháng 5 năm 2027  
v24.1 Tháng 5 năm 2026 Tháng 5 năm 2027  
v24.2 Tháng 6 năm 2026 Tháng 5 năm 2027  
v25 Tháng 7 năm 2026 Tháng 8 năm 2027  
v25.1 Tháng 8 năm 2026 Tháng 8 năm 2027  
v25.2 Tháng 9 năm 2026 Tháng 8 năm 2027  
v26 Tháng 10 năm 2026 Tháng 11 năm 2027  
v26.1* Tháng 11 năm 2026 Tháng 11 năm 2027  

* v26.1 được chỉ định là phiên 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 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 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 đến 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.v23.services.GoogleAdsService.Mutate.
  4. (Không bắt buộc) Chọn khoảng thời gian mà bạn muốn xem cho các yêu cầu.

Sự khác biệt giữa việc ngừng sử dụng và ngừng hoạt động

Thuật ngữNgừng sử dụngNgừng hoạt động
Đị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 phát hành phiên bản mới, tất cả các phiên bản trước đó sẽ được đánh dấu là không dùng nữa. Phiên bản ngừng hoạt động không còn sử dụng được. Các 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àm ý Bạn vẫn có thể sử dụng các phiên bản bị ngừng hoạt động cho đến khi các phiên bản đó ngừng cung cấp, nhưng các tham chiếu của phiên bản bị ngừng hoạt động sẽ bị làm mờ để cho biết 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 từ các phiên bản ngừng hoạt động ngay lập tức để 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 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 cứ 3 đến 4 tháng một lần, vì vậy, phiên bản đã cho sẽ bị ngừng sử dụ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 sau 1 năm kể từ ngày phát hành.
API Điểm cuối API cho các phiên bản ngừng hoạt động 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, 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 bị ngừng sử dụng.

 Điểm cuối API cho các phiên bản ngừng hoạt động 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 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 bị ngừng sử dụng 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 trong dự án của mình. 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 cung cấp dịch vụ hỗ trợ thường xuyên cho 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 date.

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

Thư viện ứng dụng cho Java
v23 Min: 42.1.0
Max: -
v22 Min: 41.1.0
Max: -
v21 Min: 39.0.0
Max: -
v20 Min: 38.0.0
Max: -

C#

Thư viện ứng dụng cho .NET
v23 Min: 25.1.0
Max: -
v22 Min: 24.1.0
Max: -
v21 Min: 24.0.0
Max: -
v20 Min: 23.0.0
Max: -

PHP

Thư viện ứng dụng cho PHP
v23 Min: 32.2.0
Max: -
v22 Min: 31.0.0
Max: -
v21 Min: 28.0.0
Max: -
v20 Min: 26.1.0
Max: -

Python

Thư viện ứng dụng cho Python
v23 Min: 29.2.0
Max: -
v22 Min: 28.1.0
Max: -
v21 Min: 28.0.0
Max: -
v20 Min: 27.0.0
Max: -

Ruby

Thư viện ứng dụng cho Ruby
v23 Min: 38.0.0
Max: -
v22 Min: 36.0.0
Max: -
v21 Min: 35.0.0
Max: -
v20 Min: 34.0.0
Max: -

Perl

Thư viện ứng dụng cho Perl
v23 Min: 31.0.0
Max: -
v22 Min: 29.0.0
Max: -
v21 Min: 28.0.0
Max: -
v20 Min: 27.0.0
Max: -

Ngừng sử dụng tính năng

Hãy thường xuyên theo dõi blog dành cho nhà phát triển Google Ads để là người đầu tiên biết về việc ngừng sử dụng tính năng sắp tới.

Bảng sau đây liệt kê các tính năng cụ thể dự kiến sẽ ngừng sử dụng cho API Google Ads. Bạn có thể xem thêm thông tin chi tiết về từng trường hợp ngừng sử dụ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
Thay đổi đối với việc hỗ trợ tính năng So khớp khách hàng

Kể từ ngày 1 tháng 4 năm 2026, các mã thông báo dành cho nhà phát triển không có yêu cầu gần đây về tính năng So khớp khách hàng phải sử dụng Data Manager API cho quy trình So khớp khách hàng.

  • Nếu mã thông báo dành cho nhà phát triển của bạn đã gửi yêu cầu OfflineUserDataJobService hoặc UserDataService cho đối tượng So khớp khách hàng trong khoảng thời gian từ ngày 1 tháng 10 năm 2025 đến ngày 31 tháng 3 năm 2026, thì bạn có thể tiếp tục sử dụng mã thông báo dành cho nhà phát triển của mình với Google Ads API cho quy trình So khớp khách hàng. Tuy nhiên, bạn nên nâng cấp quy trình So khớp khách hàng lên Data Manager API để cải thiện trải nghiệm của nhà phát triển và sử dụng các tính năng bổ sung.
  • Nếu không, kể từ ngày 1 tháng 4 năm 2026, mọi OfflineUserDataJobService hoặc UserDataService yêu cầu cho đối tượng So khớp khách hàng sẽ không thành công và gặp lỗi CUSTOMER_NOT_ALLOWLISTED_FOR_THIS_FEATURE. Thay vì API Google Ads, hãy sử dụng Data Manager API cho quy trình So khớp khách hàng.
Ngày 1 tháng 4 năm 2026 Xem bài đăng trên blog của chúng tôi để biết thêm chi tiết.
Thay đổi đối với việc hỗ trợ thuộc tính của phiên và địa chỉ IP Kể từ ngày 2 tháng 2 năm 2026, Google Ads API sẽ không còn chấp nhận những người dùng mới sử dụng thuộc tính của phiên hoặc dữ liệu địa chỉ IP khi nhập lượt chuyển đổi nữa. Người dùng hiện tại nên di chuyển sang Data Manager API. Ngày 2 tháng 2 năm 2026 Xem bài đăng trên blog của chúng tôi để biết thêm chi tiết.
Ngừng sử dụng quảng cáo chỉ tạo cuộc gọi điện thoại Kể từ tháng 1 năm 2026, bạn không thể tạo quảng cáo chỉ tạo cuộc gọi điện thoại mới. Quảng cáo chỉ tạo cuộc gọi điện thoại hiện có sẽ ngừng phân phát vào tháng 2 năm 2027 và tính năng hỗ trợ API sẽ bị xoá. Thay vào đó, nhà quảng cáo nên sử dụng Quảng cáo tìm kiếm thích ứng có thành phần cuộc gọi Tháng 1 năm 2026 Xem bài đăng trên blog của chúng tôi để biết thêm chi tiết.