Chuyển từ API Trình quản lý giá thầu phiên bản 1.1 sang phiên bản 2

Vào tháng 3 năm 2022, chúng tôi đã phát hành phiên bản 2 của API Trình quản lý giá thầu. Do phát hành phiên bản mới này, chúng tôi dự định sẽ sớm thông báo ngày ngừng cung cấp phiên bản 1.1. T4 bạn nên bắt đầu quá trình di chuyển từ phiên bản 1.1 sang phiên bản 2 càng sớm càng tốt.

Di chuyển ứng dụng

Việc di chuyển từ phiên bản 1.1 sang phiên bản 2 yêu cầu bạn phải cập nhật URL điểm cuối để gọi phiên bản 2, và cập nhật ứng dụng của bạn cho phù hợp với các thay đổi có thể gây lỗi.

Cập nhật lệnh gọi API từ phiên bản 1.1 lên phiên bản 2

Để sử dụng phiên bản 2 thay vì phiên bản 1.1, bạn cần cập nhật các yêu cầu của mình để sử dụng phiên bản mới 2 điểm cuối.

Xác định các phương thức tương đương

Để cập nhật các lệnh gọi API của bạn từ việc sử dụng phiên bản 1.1 sang phiên bản 2, trước tiên bạn phải xác định các phương thức tương đương v1.1 trong v2.

Tên sau đây của tất cả dịch vụ và phương thức có thay đổi đôi chút giữa v1.1 và v2:

Cập nhật lên điểm cuối mới

Sau khi xác định được các phương thức tương đương, bạn cần cập nhật yêu cầu của mình. Để ví dụ: để gọi phương thức queries.getquery bằng phiên bản 1.1, bạn sẽ sử dụng URL sau:

https://www.googleapis.com/doubleclickbidmanager/v1.1/query/queryId

Để gọi phương thức tương đương trong phiên bản 2 (được gọi là queries.get), hãy cập nhật phương thức URL đến:

GET https://doubleclickbidmanager.googleapis.com/v2/queries/queryId

Nếu bạn đang sử dụng thư viện ứng dụng để gửi yêu cầu tới API, hãy sử dụng phiên bản gần đây của thư viện ứng dụng và cập nhật cấu hình của bạn để sử dụng phiên bản 2.

Thực hiện các thay đổi bắt buộc

Chúng tôi sẽ giới thiệu một số thay đổi có thể gây lỗi trong phiên bản 2. Xem lại những nội dung sau và thực hiện những thay đổi cần thiết phù hợp với cách bạn đang sử dụng API Trình quản lý giá thầu.

Cập nhật cuộc gọi thành dịch vụ queries

Cập nhật cuộc gọi thành dịch vụ reports

Cập nhật logic xử lý lỗi

Thông báo lỗi trên API đã được cập nhật trong phiên bản 2. Đây là các thông báo lỗi mới cụ thể hơn và trong một số trường hợp, cung cấp thông tin về các giá trị trong Yêu cầu API gây ra lỗi được trả về. Nếu lỗi hiện tại của bạn logic xử lý dựa trên văn bản thông báo lỗi cụ thể, khái quát hoá lỗi của bạn trước khi chuyển sang phiên bản 2.