Thiết lập quyền truy cập API

Sau đây là cách thiết lập quyền truy cập vào Data Manager API bằng SDK hoặc REST.

Điều kiện tiên quyết

  1. Một dự án trên Google Cloud hoặc một Tài khoản Google mà bạn muốn sở hữu dự án.

    • Nếu bạn chưa có dự án, quy trình thiết lập trong phần tiếp theo sẽ tạo một dự án cho bạn.

    • Nếu bạn đã có một dự án, hãy đảm bảo Tài khoản Google của bạn có một vai trò có thể bật API trên dự án, chẳng hạn như Chủ sở hữu, Người chỉnh sửa hoặc Quản trị viên sử dụng dịch vụ. Để kiểm tra vai trò của bạn, hãy mở trang IAM trong Google Cloud Console, chọn dự án của bạn rồi tìm Tài khoản Google của bạn trong danh sách.

      Để biết thêm thông tin, hãy xem bài viết Xem quyền truy cập hiện tại.

  2. Đã cài đặt Google Cloud CLI.

Bật API

Nếu bạn chưa bật Data Manager API trong dự án trên đám mây của mình trên Google Cloud, hãy bật API này bằng cách nhấp vào Bật Data Manager API hoặc làm theo hướng dẫn để thực hiện bước này theo cách thủ công.

Bật Data Manager API

Nếu bạn không tìm thấy Data Manager API hoặc không thể bật Data Manager API, hãy xác minh rằng Tài khoản Google của bạn đáp ứng các điều kiện tiên quyết.

Thiết lập phương thức xác thực

Bạn có thể sử dụng bất kỳ phương pháp xác thực nào tại Google ngoài khoá API. Bạn nên xem lại cách Chọn phương pháp xác thực phù hợp cho trường hợp sử dụng của bạn để quyết định phương pháp nào phù hợp với trường hợp sử dụng của bạn.

Hai phương pháp xác thực phổ biến là tài khoản người dùng và tài khoản dịch vụ:

  • Tài khoản người dùng: Đại diện cho những người tương tác trực tiếp với các API và dịch vụ của Google.
  • Tài khoản dịch vụ: Đại diện cho ứng dụng, không phải con người, với tư cách là người dùng. Các API này cho phép ứng dụng của bạn quản lý việc xác thực và uỷ quyền. Ví dụ: nếu một ứng dụng cần truy cập vào tài nguyên của Google Cloud.

Quá trình tích hợp của bạn có thể sử dụng Thông tin xác thực mặc định của ứng dụng (ADC) để tự động tìm thông tin xác thực từ môi trường, nhờ đó bạn không cần phải thay đổi mã ứng dụng khách để xác thực.

Chọn Tài khoản người dùng hoặc Tài khoản dịch vụ để thiết lập ADC:

Tài khoản người dùng

Dưới đây là các bước để xác thực bằng thông tin đăng nhập tài khoản người dùng:

  1. Định cấu hình chế độ cài đặt Nền tảng xác thực của Google cho dự án của bạn.

    1. Mở Trang xây dựng thương hiệu trong Google Cloud Console.

    2. Chọn dự án của bạn.

    3. Điền vào biểu mẫu rồi nhấp vào Tạo.

  2. Vì Data Manager API sử dụng phạm vi nhạy cảm, nên bạn cần thực hiện các bước sau:

    1. Chuyển đến phần cài đặt Truy cập dữ liệu cho dự án của bạn.

    2. Nhấp vào Thêm hoặc xoá phạm vi.

    3. Trong danh sách phạm vi, hãy tìm Data Manager API và đánh dấu vào hộp cho từng phạm vi mà ứng dụng của bạn yêu cầu:

      • .../auth/datamanager: Chọn phạm vi này cho các thao tác API tiêu chuẩn, chẳng hạn như quản lý dữ liệu khách hàng, đối tượng và sự kiện. Đây là phạm vi chính được sử dụng trong suốt hướng dẫn này.

      • .../auth/datamanager.partnerlink: Chỉ chọn phạm vi này nếu bạn là đối tác dữ liệu đang tạo hoặc xoá đường liên kết của đối tác trong tài khoản nhà quảng cáo.

    4. Nhấp vào Cập nhật.

    5. Nhấp vào Lưu.

    6. Chuyển đến phần Audience (Đối tượng) trong Google Cloud Console rồi định cấu hình các chế độ cài đặt cho quá trình phát triển ban đầu:

      • Đặt Trạng thái xuất bản thành Thử nghiệm.
      • Đặt Loại người dùng thành Nội bộ (nếu dự án của bạn thuộc một tổ chức Google Workspace) hoặc Bên ngoài (nếu không).
      • Nếu bạn sử dụng Bên ngoài, hãy thêm Tài khoản Google mà bạn dùng để tạo thông tin xác thực làm Người dùng thử nghiệm.

      Tìm hiểu thêm về các chế độ cài đặt này trong phần Quản lý đối tượng của ứng dụng.

  3. Nhấp vào Tạo ứng dụng OAuth2 để tạo một ứng dụng OAuth2 trong dự án hoặc làm theo hướng dẫn để tạo ứng dụng OAuth2 cho Máy tính. Bạn có thể bỏ qua bước này nếu đã có ứng dụng OAuth2 cho Máy tính mà bạn muốn dùng cho Data Manager API.

    Nếu bạn nhấp vào Tạo ứng dụng OAuth2, hãy chọn Ứng dụng dành cho máy tính khi được nhắc Định cấu hình ứng dụng OAuth để có thể sử dụng ứng dụng đó trong các bước còn lại.

    Tạo ứng dụng OAuth2

    Trong bước cuối cùng, hãy nhấp vào DOWNLOAD CLIENT CONFIGURATION (TẢI CẤU HÌNH ỨNG DỤNG KHÁCH XUỐNG) và lưu ý vị trí tải xuống mà bạn chọn.

  4. Tạo tệp ADC cục bộ bằng cách chạy lệnh sau. Lệnh này sẽ khởi chạy một quy trình web, trong đó bạn được nhắc đăng nhập vào Tài khoản Google mà bạn đang sử dụng với API.

    Thay thế PATH_TO_CLIENT_JSON bằng tên của tệp JSON mà bạn đã tải xuống.

    gcloud auth application-default login \
  --scopes="https://www.googleapis.com/auth/datamanager,https://www.googleapis.com/auth/cloud-platform" \
  --client-id-file="PATH_TO_CLIENT_JSON"

    Nếu bạn muốn sử dụng cùng một thông tin xác thực cho Data Manager API và Google Ads API, hãy thêm phạm vi Google Ads API vào danh sách --scopes:

    gcloud auth application-default login \
  --scopes="https://www.googleapis.com/auth/datamanager,https://www.googleapis.com/auth/adwords,https://www.googleapis.com/auth/cloud-platform" \
  --client-id-file="PATH_TO_CLIENT_JSON"

    Nếu bạn muốn sử dụng cùng một thông tin xác thực cho API Trình quản lý dữ liệu và API Display & Video 360, hãy thêm phạm vi API Display & Video 360 vào danh sách --scopes:

    gcloud auth application-default login \
  --scopes="https://www.googleapis.com/auth/datamanager,https://www.googleapis.com/auth/display-video,https://www.googleapis.com/auth/cloud-platform" \
  --client-id-file="PATH_TO_CLIENT_JSON"

  5. Xác nhận thông tin đăng nhập được thiết lập chính xác bằng lệnh sau. Nếu thành công, lệnh này sẽ in mã truy cập vào bảng điều khiển.

    gcloud auth application-default print-access-token

Tài khoản dịch vụ

Dưới đây là các bước để tạo tài khoản dịch vụ và sử dụng tính năng mạo danh tài khoản dịch vụ để xác thực trong môi trường phát triển cục bộ. Các bước này sử dụng tính năng mạo danh thay vì khoá tài khoản dịch vụ vì khoá tài khoản dịch vụ có thể trở thành rủi ro bảo mật nếu không được quản lý cẩn thận.

  1. Nhấp vào nút Tạo tài khoản dịch vụ sau đây hoặc làm theo hướng dẫn để chọn hoặc tạo tài khoản dịch vụ.

    Tạo tài khoản dịch vụ

  2. Cấp cho tài khoản dịch vụ vai trò IAM Người dùng sử dụng dịch vụ (roles/serviceusage.serviceUsageConsumer), bao gồm cả quyền serviceusage.services.use cho phép tài khoản dịch vụ gửi yêu cầu API cho dự án.

    gcloud projects add-iam-policy-binding PROJECT_ID \
  --member="serviceAccount:SERVICE_ACCOUNT_EMAIL" \
  --role="roles/serviceusage.serviceUsageConsumer"

  3. Cấp cho Tài khoản Google của bạn vai trò IAM Người tạo mã thông báo tài khoản dịch vụ (roles/iam.serviceAccountTokenCreator) trên tài khoản dịch vụ.

    gcloud iam service-accounts add-iam-policy-binding SERVICE_ACCOUNT_EMAIL \
  --member="user:USER_EMAIL" \
  --role="roles/iam.serviceAccountTokenCreator"

  4. Định cấu hình ADC bằng cách chạy lệnh sau:

    gcloud auth application-default login \
  --impersonate-service-account=SERVICE_ACCOUNT_EMAIL \
  --scopes="https://www.googleapis.com/auth/datamanager,https://www.googleapis.com/auth/cloud-platform"

    Nếu bạn muốn sử dụng cùng một thông tin xác thực cho Data Manager API và Google Ads API, hãy thêm phạm vi Google Ads API vào danh sách --scopes:

    gcloud auth application-default login \
  --impersonate-service-account=SERVICE_ACCOUNT_EMAIL \
  --scopes="https://www.googleapis.com/auth/datamanager,https://www.googleapis.com/auth/adwords,https://www.googleapis.com/auth/cloud-platform"

    Nếu bạn muốn sử dụng cùng một thông tin xác thực cho API Trình quản lý dữ liệu và API Display & Video 360, hãy thêm phạm vi API Display & Video 360 vào danh sách --scopes:

    gcloud auth application-default login \
  --impersonate-service-account=SERVICE_ACCOUNT_EMAIL \
  --scopes="https://www.googleapis.com/auth/datamanager,https://www.googleapis.com/auth/display-video,https://www.googleapis.com/auth/cloud-platform"

    Khi được nhắc đăng nhập, hãy đăng nhập bằng Tài khoản Google có vai trò Người tạo mã thông báo tài khoản dịch vụ.

  5. Xác nhận thông tin đăng nhập được thiết lập chính xác bằng lệnh sau. Nếu thành công, lệnh này sẽ in mã truy cập vào bảng điều khiển.

    gcloud auth application-default print-access-token --scopes="https://www.googleapis.com/auth/datamanager"

Để tìm hiểu thêm về quy trình xác thực và thông tin xác thực cho ứng dụng, hãy xem phần Phương pháp xác thực tại Google và Cách hoạt động của Thông tin xác thực mặc định của ứng dụng.

Thiết lập quyền truy cập vào tài khoản

Tài khoản người dùng

Chọn thẻ tương ứng với trường hợp sử dụng của bạn.

  • Chọn Nhà quảng cáo nếu bạn đang sử dụng thông tin đăng nhập cho một Tài khoản Google là người dùng trong tài khoản nhà quảng cáo mà bạn muốn quản lý.
  • Chọn Đối tác dữ liệu nếu bạn đang sử dụng thông tin đăng nhập cho một Tài khoản Google là người dùng trong tài khoản đối tác dữ liệu và bạn muốn quản lý các tài khoản nhà quảng cáo có đường liên kết đối tác đến tài khoản đối tác dữ liệu. Tài khoản đối tác dữ liệu chỉ được cấp sau khi trải qua quy trình phê duyệt. Để bắt đầu, hãy điền thông tin vào biểu mẫu bày tỏ sự quan tâm.

Nhà quảng cáo

Cấp cho email liên kết với người dùng quyền truy cập vào Destination.

Làm theo hướng dẫn để thêm email của người dùng vào tài khoản Google Ads hoặc tài khoản người quản lý Google Ads cấp cao hơn.

Display & Video 360

Làm theo hướng dẫn để thêm email của người dùng vào tài khoản.

Google Analytics

Làm theo hướng dẫn để thêm email của người dùng vào tài khoản.

Đối tác dữ liệu

Cấp cho email liên kết với người dùng quyền truy cập vào tài khoản đối tác dữ liệu của bạn. Thông thường, các đối tác dữ liệu sử dụng tài khoản dịch vụ để truy cập API. Tuy nhiên, nếu sử dụng tài khoản người dùng cho mục đích thử nghiệm hoặc các mục đích khác, bạn phải cấp cho tài khoản người dùng quyền truy cập vào tài khoản đối tác dữ liệu.

Thêm email của người dùng vào tài khoản đối tác dữ liệu thông qua giao diện người dùng Google Ads bằng cách làm theo các hướng dẫn này.

Tài khoản dịch vụ

Chọn thẻ tương ứng với trường hợp sử dụng của bạn.

  • Chọn Nhà quảng cáo nếu bạn đang sử dụng thông tin đăng nhập cho một Tài khoản Google là người dùng trong tài khoản nhà quảng cáo mà bạn muốn quản lý.
  • Chọn Đối tác dữ liệu nếu bạn đang sử dụng thông tin đăng nhập cho một Tài khoản Google là người dùng trong tài khoản đối tác dữ liệu và bạn muốn quản lý các tài khoản nhà quảng cáo có đường liên kết đối tác đến tài khoản đối tác dữ liệu. Tài khoản đối tác dữ liệu chỉ được cấp sau khi trải qua quy trình phê duyệt. Để bắt đầu, hãy điền thông tin vào biểu mẫu bày tỏ sự quan tâm.

Nhà quảng cáo

Cấp cho email liên kết với tài khoản dịch vụ của bạn quyền truy cập vào Destination.

Hoàn tất quy trình Thiết lập quyền truy cập vào tài khoản để thêm tài khoản dịch vụ vào tài khoản Google Ads hoặc tài khoản người quản lý Google Ads chính.

Display & Video 360

Làm theo hướng dẫn để tạo người dùng Display & Video 360 được liên kết với tài khoản dịch vụ.

Google Analytics

Làm theo hướng dẫn để thêm email của tài khoản dịch vụ vào tài khoản.

Đối tác dữ liệu

Cấp cho email liên kết với tài khoản dịch vụ của bạn quyền truy cập vào tài khoản đối tác dữ liệu.

Quyền truy cập vào tài khoản của đối tác dữ liệu được quản lý thông qua giao diện người dùng Google Ads. Để thêm tài khoản dịch vụ và đặt cấp truy cập, hãy làm theo các bước trong phần Thiết lập quyền truy cập vào tài khoản.

Các bước tiếp theo

Tiếp
Cài đặt thư viện ứng dụng