Tổng quan

Bạn có thể tạo và quản lý phân khúc dựa trên dữ liệu bằng cách sử dụng Authorized Buyers Marketplace API. API này hiển thị một tài nguyên curators.dataSegments. Đây là một REST API có thư viện ứng dụng được tạo mà bạn có thể dùng để tích hợp.

Thiết lập chế độ xác thực

API của Google sử dụng giao thức OAuth 2.0 để xác thực và uỷ quyền. Sau đây là cách thiết lập Tài khoản dịch vụ để truy cập vào Marketplace API.

  1. Nếu chưa thực hiện, hãy tạo một Dự án Google Cloud lưu trữ thông tin xác thực mà bạn dùng để truy cập vào API.
  2. Chuyển đến trang API đã bật của Google Cloud Console. Chọn dự án mà bạn đã tạo trước đó.

  3. Bạn sẽ thấy danh sách các API và dịch vụ đã bật. Bạn phải bật Marketplace API để truy cập vào API này. Nếu Marketplace API chưa được bật, hãy nhấp vào +Bật API và dịch vụ rồi làm theo các hướng dẫn sau:

    1. Bạn sẽ được chuyển đến một trang có hộp tìm kiếm. Tìm kiếm Authorized Buyers Marketplace API.
    2. Chọn Authorized Buyers Marketplace API trong trang kết quả.
    3. Nhấp vào Bật.
  4. Trên trình đơn điều hướng, hãy chọn Thông tin đăng nhập.
  5. Nhấp vào +Tạo thông tin xác thực, rồi chọn Tài khoản dịch vụ trong trình đơn thả xuống xuất hiện.
  6. Nhập Tên cho tài khoản dịch vụ. Mã nhận dạng tài khoản dịch vụ được tạo tự động khi bạn tạo tài khoản – hãy lưu ý giá trị này vì bạn sẽ cần đến nó ở bước 14. Nhập nội dung mô tả (không bắt buộc). Nhấp vào Tạo và tiếp tục.
  7. Bạn có thể định cấu hình quyền cho tài khoản dịch vụ rồi nhấp vào Tiếp tục.
  8. Bạn có thể định cấu hình người dùng hoặc nhóm có thể thực hiện các hành động với tư cách là tài khoản dịch vụ rồi nhấp vào Xong.
  9. Tài khoản dịch vụ mới của bạn sẽ xuất hiện trong mục Tài khoản dịch vụ. Tìm rồi nhấp vào mã tài khoản dịch vụ mà bạn vừa tạo.
  10. Nhấp vào thẻ Khoá.
  11. Trong trình đơn thả xuống Thêm khoá, hãy chọn Tạo khoá mới.
  12. Chọn JSON làm Loại khoá rồi nhấp vào Tạo.
  13. Tải khoá xuống thư mục làm việc của bạn. Để biết thêm thông tin về cách lưu trữ khoá một cách an toàn, hãy xem phần Quản lý khoá tài khoản dịch vụ. Ứng dụng của bạn sẽ dùng khoá này để thực hiện các lệnh gọi API.
  14. Chia sẻ mã tài khoản dịch vụ với Người quản lý tài khoản kỹ thuật để liên kết tài khoản dịch vụ với tài khoản của bạn.

Phạm vi API

Khi thực hiện quy trình OAuth 2.0 để nhận mã truy cập dùng cho lệnh gọi API, bạn phải chỉ định những API có thể truy cập bằng mã thông báo đó. Đối với Authorized Buyers Marketplace API, phạm vi đó là https://www.googleapis.com/auth/authorized-buyers-marketplace.

Cách xác định phân khúc dữ liệu trong API so với tính năng Tuyển chọn theo thời gian thực

Trong Marketplace API, các phân khúc dữ liệu được xác định bằng một tên tài nguyên dành riêng cho API, chẳng hạn như:

"curators/[YOUR_ACCOUNT_ID]/dataSegments/[DATA_SEGMENT_ID]".

Khi xác định các phân khúc dữ liệu phù hợp cho cơ hội quảng cáo trong tính năng Tuyển chọn theo thời gian thực, hãy chỉ định giá trị cho mã nhận dạng tài nguyên DATA_SEGMENT_ID thay vì toàn bộ tài nguyên name mà API sử dụng.

Các bước tiếp theo