Giới thiệu API Báo cáo trao đổi DV360 và thiết lập OAuth

API Báo cáo giao dịch DV360 cung cấp cho các đối tác Giao dịch bên thứ ba (3PE) quyền truy cập theo phương thức lập trình vào báo cáo hiệu suất từ Display &Video 360.

API Báo cáo giao dịch DV360 được cung cấp dưới dạng API Google Cloud dựa trên danh sách cho phép sử dụng OAuth. Quy trình danh sách cho phép do nhóm API Báo cáo giao dịch DV360 xử lý.

Cách thực hiện

Sau đây là các bước giới thiệu API Báo cáo giao dịch DV360:

  1. Đăng ký Tài khoản Google trên bảng điều khiển Google Cloud.

    Xin lưu ý rằng tài khoản này dùng để quản lý mã truy cập cho ứng dụng khách chính thức của bạn, vì vậy, đừng dùng tài khoản Gmail cá nhân.

  2. Liên hệ với Google DV360 và cung cấp thông tin tài khoản để thêm tài khoản đó vào danh sách cho phép.

  3. Sau khi nhận được thông báo rằng bạn có trong danh sách cho phép, hãy yêu cầu xem xét xác minh OAuth để cấp cho ứng dụng của bạn quyền truy cập vào phạm vi doubleclickbidmanager.

  4. Đăng nhập vào bảng điều khiển Cloud.

    Chuyển đến phần API và Dịch vụ > Thư viện > Riêng tư. Bạn sẽ thấy API Báo cáo giao dịch DV360 được liệt kê là một trong những API mà bạn có thể sử dụng. Bật API Báo cáo giao dịch DV360.

  5. Chuyển đến phần Thông tin xác thực > Tạo thông tin xác thực > Khoá tài khoản dịch vụ. Làm theo hướng dẫn để tạo tài khoản dịch vụ.

Tài khoản dịch vụ

Tài khoản dịch vụ cho phép mã của bạn gửi trực tiếp thông tin xác thực của ứng dụng đến API. Tài khoản dịch vụ (giống như tài khoản người dùng) được biểu thị bằng một địa chỉ email. Tuy nhiên, không giống như tài khoản người dùng, tài khoản dịch vụ chỉ thuộc về một ứng dụng và chỉ có thể dùng để truy cập vào API mà tài khoản đó được tạo.

Sau đây là các bước tạo thông tin xác thực của tài khoản dịch vụ bằng bảng điều khiển Google Cloud:

  1. Trên trang Trình quản lý API > Thông tin xác thực, hãy chọn Tạo thông tin xác thực → Khoá tài khoản dịch vụ.

  2. Chọn Tài khoản dịch vụ mới trong trình đơn thả xuống Tài khoản dịch vụ.

    Nhập Tên cho tài khoản dịch vụ này. Tên này được dùng làm tên mặc định cho Mã tài khoản dịch vụ, ở bên trái của ký tự @ trong địa chỉ mã tài khoản dịch vụ đã tạo.

    Trong phần Loại khoá, bạn nên để giá trị này là JSON. Nhấp vào Tạo để tạo khoá JSON dưới dạng tệp văn bản .json. Khi được nhắc, hãy tải tệp xuống máy tính của bạn và hộp thoại Tài khoản dịch vụ đã tạo sẽ xuất hiện.

    Sau đây là khoá JSON mẫu:

    {
  "type": "service_account",
  "project_id": "project-id",
  "private_key_id": "some_number",
  "private_key": "-----BEGIN PRIVATE KEY-----\n....
  =\n-----END PRIVATE KEY-----\n",
  "client_email": "<api-name>api@project-id.iam.gserviceaccount.com",
  "client_id": "...",
  "auth_uri": "https://accounts.google.com/o/oauth2/auth",
  "token_uri": "https://accounts.google.com/o/oauth2/token",
  "auth_provider_x509_cert_url": "https://www.googleapis.com/oauth2/v1/certs",
  "client_x509_cert_url": "https://www.googleapis.com/...<api-name>api%40project-id.iam.gserviceaccount.com"
}

  3. Lưu trữ tệp JSON của bạn một cách an toàn vì tệp này chứa khoá riêng tư của bạn và đây là bản sao duy nhất của khoá đó. Bạn cần thông tin xác thực trong tệp này khi mã của bạn gọi API.

  4. Liên hệ với DV360 và cung cấp thông tin tài khoản dịch vụ mà bạn đã tạo, cụ thể là địa chỉ email của tài khoản dịch vụ. Đây là một phần của quy trình danh sách cho phép để truy cập API.

Mã truy cập

Sau khi tài khoản dịch vụ của bạn được uỷ quyền để gọi API, bạn có thể tiếp tục với các ví dụ trong hướng dẫn về API. Để nhận mã truy cập theo cách thủ công, bạn có thể sử dụng một công cụ như oauth2l; hoặc sử dụng một trong các thư viện ứng dụng của chúng tôi để xác thực theo phương thức lập trình.