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

Khi ra mắt một phiên bản mới, một phiên bản phiên bản được chỉ định ngày ngừng cung cấp, sau đó phiên bản đó sẽ không còn được sẵn có. Dưới đây là một số nguyên tắc khác cần lưu ý:

  • Có tối đa 3 phiên bản chính cùng một lúc.
  • Các phiên bản chính có thời gian tồn tại khoảng 12 tháng — các phiên bản nhỏ: 10 tháng.
  • Bạn sẽ phải thực hiện tối đa hai nâng cấp mỗi năm và bạn không có để 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 sang phiên bản (N+2).
  • Sự 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 phải mất í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 có sẵn của dịch vụ, do đó bạn có thể nâng cấp dần bằng cách chỉ định các phiên bản được sử dụng khác nhau luôn miễn phí.

Lịch trình

Bảng dưới đây liệt kê ngày ngừng sử dụng và ngày ngừng cung cấp cụ thể cho từng phiên bản hiện có và ngày phát hành dự kiến cho các phiên bản sau này. T4 khuyến khích bạn nâng cấp lên phiên bản mới nhất ngay khi có thể sau khi bản 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
v18 Tháng 9/Tháng 10 năm 2024 Tháng 1/tháng 2 năm 2025 Tháng 9/2025
v17.1 Ngày 7 tháng 8 năm 2024 Tháng 9/Tháng 10 năm 2024 Tháng 5/2025
v17 Ngày 5 tháng 6 năm 2024 Tháng 9/Tháng 10 năm 2024 Tháng 5/2025
v16.1 Ngày 24 tháng 4 năm 2024 Ngày 5 tháng 6 năm 2024 Tháng 1/2025 Nâng cấp từ phiên bản 16 lên phiên bản 17
v16 Ngày 21 tháng 2 năm 2024 Ngày 5 tháng 6 năm 2024 Tháng 1/2025 Nâng cấp từ phiên bản 16 lên phiên bản 17
v15 Ngày 18 tháng 10 năm 2023 Ngày 21 tháng 2 năm 2024 Ngày 25 tháng 9 năm 2024 Nâng cấp từ phiên bản 15 lên phiên bản 16

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 & các 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 biểu thị dựa 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 API Google Ads, dịch vụ và tên phương thức, chẳng hạn như google.ads.googleads.v17.services.GoogleAdsService.Mutate.
  4. (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ụngHoàng hôn
Định nghĩa Phiên bản không dùng nữa là một 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 không dùng nữa. Phiên bản đã ngừng cung cấp không dùng được nữa. Yêu cầu được gửi đến địa chỉ email này phiên bản của bạn sẽ không hoạt động được vào hoặc sau ngày ngừng cung cấp.
Ý nghĩa Bạn vẫn có thể sử dụng các phiên bản không được dùng nữa cho đến khi các phiên bản đó ngừng hoạt động, nhưng phần tham chiếu của phiên bản không được dùng nữa sẽ được bỏ đánh dấu để hiển thị chúng không phải là phiên bản mới nhất nữa.

Chúng tôi khuyến khích bạ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 cung cấp ngay lập tức trong để sử dụng API Google Ads.

Bạn nên nâng cấp lên phiên bản mới nhất phiên bản, 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 mỗi 3 đến 4 tháng, do đó, sẽ không được sử dụng sau khoảng 3 đến 4 tháng. Chúng tôi dự định ngừng cung cấp phiên bản này sau 1 năm kể từ khi phiên bản này phát hành.
API Điểm cuối API cho những phiên bản không dùng nữa vẫn hoạt động như thông 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. bật; tuy nhiên, các tính năng mới 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 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ặp lỗi nếu bạn cố truy cập vào Điểm cuối API của các phiên bản ngừng cung cấp.
Thư viện ứng dụng Để cung cấp thư viện máy khách nhỏ gọn, chúng tôi sẽ ngừng bao gồm cả các phiên bản API không dùng nữa trong 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 không gian khi kết hợp trong các 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 cung cấp trong mọi phiên bản thư viện ứng dụng mới sau ngày ngừng cung cấp.
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. Các phiên bản ngừng cung cấp không còn được hỗ trợ sau khi mặt trời lặn ngày.

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 hoạt động với phiên bản API nào.

Java

Thư viện ứng dụng dành cho Java
v17
32.0.0 Min: Max:
v16
30.0.0 Min: Max:
v15 Min: 28.0.0
Max: 32.0.0

C#

Thư viện ứng dụng cho .NET
v17
20.1.0 Min: Max:
v16
18.1.0 Min: Max:
v15 Min: 17.1.0
Max: 20.1.0

PHP

Thư viện ứng dụng cho PHP
v17
23.1.0 Min: Max:
v16
22.1.0 Min: Max:
v15 Min: 21.1.0
Max: 23.1.0

Python

Thư viện ứng dụng cho Python
v17
24.1.0 Min: Max:
v16
23.1.0 Min: Max:
v15
22.1.0 Min: Max:

Ruby

Thư viện ứng dụng cho Ruby
v17
29.0.0 Min: Max:
v16
27.0.0 Min: Max:
v15
25.0.0 Min: Max:

Perl

Thư viện ứng dụng cho Perl
v17
23.0.0 Min: Max:
v16
21.0.0 Min: Max:
v15
19.0.0 Min: Max:

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

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 các tính năng sắp tới.

Bảng dưới đây liệt kê các tính năng cụ thể không được dùng nữa hiện có đã lập kế hoạch 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
Chiến lược đặt giá thầu có phí hoa hồng API Google Ads không còn hỗ trợ tạo chiến dịch khách sạn bằng COMMISSION nữa chiến lược đặt giá thầu . Ngày 30 tháng 4 năm 2024 Yêu cầu tạo chiến dịch khách sạn mới hoặc áp dụng COMMISSION cho các chiến dịch hiện có sẽ dẫn đến BiddingStrategyError.BIDDING_STRATEGY_NOT_SUPPORTED . Các chiến dịch hiện có được đặt giá thầu COMMISSION Chiến lược này sẽ tiếp tục chạy cho đến hết ngày 31 tháng 10 năm 2024. Sau ngày này chiến dịch sẽ ngừng phân phát cho đến khi chiến lược đặt giá thầu của chúng được cập nhật.