Khi 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 thời điểm đó phiên bản đó sẽ không còn được cung cấp. Dưới đây là một số nguyên tắc khác cần lưu ý:
- Mỗi lần chỉ có tối đa 3 phiên bản chính.
- Các phiên bản chính có thời gian hoạt động trong 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ượt nâng cấp mỗi năm và bạn không phải nâng cấp theo thứ tự nghiêm ngặt liên tiếp – 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 mà tất cả các thư viện ứng dụng được phát hành cho phiên bản mới nhất và ngày phiên bản sẽ ngừng hoạt động là ít nhất là 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 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 ngay sau khi có thể.
| 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 thông qua Google Cloud Console:
- Mở API và dịch vụ trong Google Cloud Console.
- Nhấp vào API Google Ads trong bảng.
- 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 các phương thức mà mình đã gửi yêu cầu đến trong bảng Phương thức. Tên phương thức
bao gồm một phiên bản API Google Ads, một dịch vụ và một tên phương thức, chẳng hạn như
google.ads.googleads.v16.services.GoogleAdsService.Mutate. - (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ụ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, mọi 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 còn được sử dụng. 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 dừng hoạt động. |
| Ý 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, nhưng tệp tham chiếu của các phiên bản không dùng nữa sẽ được bỏ đánh dấu để cho biết rằng chúng 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 ngay từ các phiên bản đã ngừng hoạt động để
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 làm theo hướng dẫn nâng cấp. |
| Thời gian | Trung bình, chúng tôi sẽ 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 cụ thể 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 một phiên bản sau 1 năm kể từ khi phát hành. |
| API | Đ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 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 đã 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 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 những phiên bản đã ngừng cung cấp. |
| 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 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 thư viện ứng dụng của chúng tôi vào dự án của bạn. | Thư viện ứng dụng không còn hỗ trợ những 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 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 cung cấp. |
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 hoạt động với phiên bản API nào.
Java
API Google Ads |
Thư viện ứng dụng cho Java |
v16 |
Min: 30.0.0Max: – |
v15 |
Min: 28.0.0Max: – |
v14 |
Min: 26.0.0Max: – |
C#
API Google Ads |
Thư viện ứng dụng cho .NET |
v16 |
Min: 18.1.0Max: – |
v15 |
Min: 17.1.0Max: – |
v14 |
Min: 16.1.0Max: – |
1.199
API Google Ads |
Thư viện ứng dụng cho PHP |
v16 |
Min: 22.1.0Max: – |
v15 |
Min: 21.1.0Max: – |
v14 |
Min: 19.2.0Max: – |
Python
API Google Ads |
Thư viện ứng dụng cho Python |
v16 |
Min: 23.1.0Max: – |
v15 |
Min: 22.1.0Max: – |
Ruby
API Google Ads |
Thư viện ứng dụng cho Ruby |
v16 |
Min: 27.0.0Max: – |
v15 |
Min: 25.0.0Max: – |
v14 |
Min: 23.0.0Max: – |
Perl
API Google Ads |
Thư viện ứng dụng cho Perl |
v16 |
Min: 21.0.0Max: – |
v15 |
Min: 19.0.0Max: – |
v14 |
Min: 17.0.0Max: – |
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 tính năng cụ thể mà theo kế hoạch ngừng sử dụng hiện đang được 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 chiến lược đặt giá thầu COMMISSION
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ẽ gây ra
lỗi BiddingStrategyError.BIDDING_STRATEGY_NOT_SUPPORTED. Những chiến dịch hiện đang 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 chiến lược đặt giá thầu của chiến dịch được cập nhật.
|