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

Với việc 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 cung cấp, sau ngày đó, phiên bản đó sẽ không còn nữa. 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 sử dụng khoảng 12 tháng — phiên bản nhỏ: 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à bạn không phải nâng cấp theo thứ tự tuần tự chặt chẽ, 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).
• 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à ngày phiên bản sắp 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ụ đã sử dụng.

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ó, cũng như ngày phát hành dự kiến của 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 ngay sau khi 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	Tháng 7/tháng 8 năm 2024	Tháng 9/Tháng 10 năm 2024	Tháng 5/2025
v17	Tháng 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	Tháng 5/tháng 6 năm 2024	Tháng 1/2025
v16	Ngày 21 tháng 2 năm 2024	Tháng 5/tháng 6 năm 2024	Tháng 1/2025
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
v14.1	Ngày 9 tháng 8 năm 2023	Ngày 18 tháng 10 năm 2023	Ngày 5 tháng 6 năm 2024
v14	Ngày 7 tháng 6 năm 2023	Ngày 18 tháng 10 năm 2023	Ngày 5 tháng 6 năm 2024	Nâng cấp từ phiên bản 14 lên phiên bản 15

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:

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 biểu thị 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ụ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ả 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 cung cấp không dùng được nữa. Các yêu cầu gửi đến phiên bản này sẽ không thực hiện đượ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 dùng nữa cho đến khi chúng ngừng hoạt động. Tuy nhiên, các tệp tham chiếu của những phiên bản không dùng nữa sẽ được loại bỏ đánh dấu để cho thấy rằng những phiên bản đó không phải 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 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 gian	Trung bình, chúng tôi phát hành một phiên bản mới từ 3 đến 4 tháng một lần, vì vậy, phiên bản nhất định 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 phiên bản này sau 1 năm kể từ khi phiên bản này phát hành.
API	Các điểm cuối API cho các 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 thư viện ứng dụng, REST, v.v.; tuy nhiên, các tính năng mới không được thêm vào các phiên bản đã ngừng hoạt động.	Các điểm cuối API cho các phiên bản ngừng cung cấp ngừng hoạt động sau những ngày dừng hoạt động. API Google Ads 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 các phiên bản ngừng cung cấp.
Thư viện ứng dụng	Để cung cấp 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 ngừng sử dụng. Điều này giúp bạn tiết kiệm dung lượng khi tích hợp thư viện ứng dụng của chúng tôi vào 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 cung cấp trong mọi phiên bản thư viện ứng dụng mới sau những ngày dừ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.	Các phiên bản ngừng cung cấp 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 những thư viện ứng dụng hoạt động với phiên bản API nào.

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

Bảng dưới đây liệt kê các trường hợp ngừng sử dụng một số tính năng cụ thể mà chúng tôi hiện đang lên 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	Nội dung 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ợ việc tạo chiến dịch khách sạn bằng COMMISSION chiến lược đặt giá thầu nữa.	Ngày 30 tháng 4 năm 2024	Các yêu cầu tạo chiến dịch khách sạn mới hoặc áp dụng chiến lược đặt giá thầu COMMISSION cho các chiến dịch hiện có sẽ dẫn đến lỗi BiddingStrategyError.BIDDING_STRATEGY_NOT_SUPPORTED. Những chiến dịch hiện có sử dụng chiến lược đặt giá thầu COMMISSION 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, các chiến dịch sẽ ngừng phân phát cho đến khi bạn cập nhật chiến lược đặt giá thầu.