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

Quy trình tham gia Display & Video 360 Seller API

Có một số bước chính để bắt đầu sử dụng Display & Video 360 Seller API. DV360 Seller API là một Google Cloud API dựa trên danh sách cho phép và sử dụng OAuth 2.0 để xác thực và uỷ quyền.

Quy trình đưa vào danh sách cho phép do nhóm Display & Video 360 Seller API xử lý.

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ã truy cập cho ứng dụng khách phát hành công khai của bạn. Không sử dụng tài khoản Gmail cá nhân.
    • Tài khoản không thể 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 nhóm DV360 của Google và cung cấp thông tin tài khoản của bạn để thêm tài khoản đó vào danh sách cho phép.
  3. Chờ xác nhận rằng tài khoản của bạn đã được bật.
  4. Không bắt buộc và không chặn: Gửi yêu cầu xem xét quy trình xác minh OAuth cho ứng dụng của bạn để truy cập vào phạm vi https://www.googleapis.com/auth/doubleclickbidmanager.
  5. Trong Google Cloud Console, hãy chuyển đến API và dịch vụ > Thư viện > Riêng tư. Bạn sẽ thấy DV360 Seller API có sẵn cho dự án của mình.
  6. Bật DV360 Seller API.
  7. Chuyển đến phần API và Dịch vụ > 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 thiết lập trong tài liệu về Tài khoản dịch vụ OAuth 2.0.

    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ư tài khoản được dùng cho DV360 Reporting API.

    Việc 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 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. Ví dụ: chúng ta sẽ xem 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 của Google Cloud Platform.

    Sử dụng Google Cloud Console

    Trên trang API Manager→Credentials (Trình quản lý API→Thông tin đăng nhập) của Google Cloud Console, hãy chọn "Create credentials→Service account key" (Tạo thông tin đăng nhập→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ã nhận dạng tài khoản dịch vụ" (ở bên trái dấu "@" trong địa chỉ mã nhận dạng tài khoản dịch vụ được tạo), nhưng bạn có thể thay đổi tên mã nhận dạng tài khoản dịch vụ này nếu muốn. Bạn có thể đặt tên tuỳ ý, điều quan trọng là bạn phải nhớ được những tên này. Trong phần "Loại khoá", bạn nên để giá trị này là "JSON". Nhấp vào "Tạo", sau đó GCP Console 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"
}

    Hãy 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ã khi muốn gửi thông tin xác thực đến API Google Cloud Platform.

  8. Liên hệ với nhóm Display & Video 360 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 tài khoản dịch vụ). Đây là bước thứ hai trong danh sách cho phép để 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ề DV360 Seller API. Để tự lấy mã thông báo uỷ quyền, hãy xem hướng dẫn trong kho lưu trữ công cụ oauth2l (bằng khoá tài khoản dịch vụ JSON mà bạn đã tải xuống). Bạn 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 trong Tài liệu xác thực của Google Cloud.

Quan trọng: Phạm vi OAuth phải là https://www.googleapis.com/auth/doubleclickbidmanager

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