Thiết lập tính năng xác thực

Giới thiệu về API người bán DV360

Có một số bước chính để triển khai API cho DV360 Seller API. API người bán DV360 được hiển thị dưới dạng API Google Cloud dựa trên danh sách cho phép và sử dụng OAuth để xác thực.

Quy trình thêm vào danh sách cho phép sẽ được xử lý bằng cách liên hệ với nhóm DV360 Seller API.

Các bước tham gia:

  1. Đăng ký Tài khoản Google bằng cách truy cập vào https://console.cloud.google.com/
    • Tài khoản này sẽ được dùng để quản lý mã thông báo truy cập cho ứng dụng chính thức của bạn. Đừng sử dụng tài khoản Gmail cá nhân của bạn.
    • Tài khoản này không được là một Nhóm Google.
    • Nếu bạn đang sử dụng một dự án Google Cloud hiện có: Tài khoản đó phải là quản trị viên của dự án.
  2. Hãy liên hệ với Google DV360 bằng thông tin tài khoản mà bạn đã đăng ký để thêm tài khoản đó vào danh sách cho phép.
  3. Chờ tài khoản của bạn được thêm vào danh sách cho phép.
  4. Không bắt buộc và không chặn: Gửi yêu cầu xem xét xác minh OAuth cho ứng dụng của bạn để truy cập vào phạm vi(doubleclickbidmanager).
  5. Truy cập vào https://console.cloud.google.com/. Chuyển đến API và dịch vụ -> Thư viện -> Riêng tư. Bạn sẽ thấy API người bán DV360 được liệt kê là một trong những API mà bạn có thể sử dụng.
  6. Bật DV360 Seller API
  7. Chuyển đế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ại đây: https://developers.google.com/identity/protocols/OAuth2ServiceAccount

    Thiết lập tài khoản dịch vụ:

    Lưu ý: Hãy cho chúng tôi biết nếu bạn muốn sử dụng lại một tài khoản dịch vụ hiện có, chẳng hạn như cho DV360 Reporting API.

    Quá trình xác thực và uỷ quyền API Google Cloud (thường được nhóm lại với nhau thành "auth") thường được thực hiện bằng 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 ứng dụng trực tiếp đến Cloud 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 đị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ể được dùng để truy cập vào API mà tài khoản đó được tạo. Ví dụ: chúng tôi sẽ hướng dẫn cách tạo thông tin xác thực tài khoản dịch vụ bằng Bảng điều khiển Google Cloud Platform.

    Sử dụng Google Cloud Console

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

    alt_text

    Tiếp theo, hãy 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ụ".

    alt_text

    Nhập "Tên" cho tài khoản dịch vụ này. Tên này sẽ được dùng làm tên mặc định cho "Mã tài khoản dịch vụ" (ở bên trái dấu "@" trong địa chỉ mã tài khoản dịch vụ đã tạo), nhưng bạn có thể thay đổi tên mã tài khoản dịch vụ này nếu muốn. Bạn có thể đặt tên tuỳ ý; quan trọng là bạn nhớ được tên đó. Trong phần "Loại khoá", bạn nên để giá trị này là "JSON". Nhấp vào "Tạo", sau đó Bảng điều khiển GCP sẽ tạo một khoá JSON (dưới dạng tệp văn bản .json), nhắc bạn tải tệp xuống máy tính và hiển thị hộp thoại Tài khoản dịch vụ đã tạo.

    alt_text

    Khoá JSON được tạo sẽ tương tự như khoá JSON mẫu sau: 

    {
  "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"
}

    Lưu trữ tệp JSON này một cách an toàn vì tệp này chứa khoá riêng tư của bạn (và tệp này là bản sao duy nhất của khoá đó). Bạn sẽ cần tham chiếu đến tệp khoá tài khoản dịch vụ này trong mã của mình khi muốn gửi thông tin xác thực đến API Google Cloud Platform.

  8. Liên hệ với DV360 bằng thông tin về tài khoản dịch vụ mà bạn đã tạo. Cụ thể, chúng tôi sẽ cần email của tài khoản dịch vụ này. Đây là một quy trình danh sách cho phép khác cho hoạt động Uỷ quyền.
  9. Sau khi tài khoản dịch vụ của bạn được uỷ quyền gọi API, bạn có thể tham khảo tài liệu về API tại https://developers.google.com/display-video/seller. Để nhận mã xác thực theo cách thủ công, hãy xem hướng dẫn tại đây: https://github.com/google/oauth2l. (Bạn cần phải tải phiên bản JSON của khoá tài khoản dịch vụ xuống). Ngoài ra, bạn cũng có thể xem hướng dẫn chi tiết về cách lấy mã thông báo Oauth theo phương thức lập trình tại đây: https://cloud.google.com/docs/authentication/production.

Lưu ý quan trọng: Phạm vi OAuth cần phải là "doubleclickbidmanager"

Trước
Tổng quan
Tiếp
Thư viện ứng dụng