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

DV360 Exchange Reporting API được đưa vào danh sách cho phép dựa trên Google Cloud API sử dụng OAuth. Quy trình danh sách cho phép do DV360 Exchange xử lý Nhóm API Báo cáo.

Cách thực hiện

Dưới đây là các bước bắt đầu sử dụng API Báo cáo trao đổi DV360:

  1. Đăng ký Tài khoản Google trên Google Cloud Google Play Console.

    Xin lưu ý rằng tài khoản này được dùng để quản lý mã truy cập cho phiên bản chính thức, nên đừng sử dụng tài khoản Gmail cá nhân.

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

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

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

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

  5. Chuyển đến phần Credentials > (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 một dịch vụ tài khoản.

Tài khoản dịch vụ

Tài khoản dịch vụ cho phép mã của bạn gửi thông tin xác thực của ứng dụng trực tiếp đến API. Tài khoản dịch vụ, chẳng hạn như tài khoản người dùng, được đại diện bằng địa chỉ email của bạn. 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ề ứng dụng và chỉ có thể dùng để truy cập API mà ứng dụng được tạo.

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

  1. Từ Trình quản lý API > Thông tin đăng nhập, chọn Tạo thông tin đăng nhập→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 tên cho Mã tài khoản dịch vụ của bạn, ở bên trái @ trong địa chỉ mã tài khoản dịch vụ đã tạo.

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

    Dưới đâ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 một cách an toàn vì tệp này chứa khoá riêng tư của bạn và là bản sao duy nhất của khoá đó. Cần có thông tin đăng nhập trong tệp này khi mã của bạn thực hiện lệnh gọi đến API.

  4. Hãy liên hệ với DV360 và cung cấp thông tin về 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 phép thực hiện lệnh gọi đến API, bạn có thể hãy 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 công cụ như oauth2l; hoặc, sử dụng một từ khách hàng của chúng tôi thư viện sang xác thực theo phương thức lập trình.