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 không 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 rằng 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 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 chi tiết, hãy xem phần Xem quyền truy cập hiện tại.

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

Bật API

Nếu bạn chưa làm việc này, hãy bật Data Manager API trong dự án trên Google Cloud 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 Bật Data Manager API không thành công, 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 quy trình 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 thức xác thực phù hợp cho trường hợp sử dụng của mìnhđể quyết định phương pháp phù hợp cho 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 các ứng dụng, không phải người dùng. Các tài khoản này cho phép ứng dụng của bạn quản lý quy trình 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 trên 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 trong môi trường, nhờ đó bạn không phải thay đổi mã ứng dụng để 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

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

  1. Định cấu hình các 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 Thương hiệu trong 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 các phạm vi nhạy cảm, nên bạn phải thực hiện các bước sau:

    1. Chuyển đến phần Chế độ cài đặt quyền truy cập vào 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 rồi đá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 tạo hoặc xoá các đường liên kết đố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 Đối tượng trong bảng điều khiển Google Cloud 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 các 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 bài viết Quản lý đối tượng của ứng dụng.

  3. Nhấp vào Tạo ứng dụng OAuth2 để tạo ứng dụng OAuth2 trong dự án hoặc làm theo hướng dẫn để tạo ứng dụng OAuth2 Dành cho máy tính. Bạn có thể bỏ qua bước này nếu đã có ứng dụng OAuth2 Dành cho máy tính mà bạn muốn sử 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 để bạn có thể sử dụng ứng dụng này trong các bước còn lại.

    Tạo ứng dụng OAuth2

    Ở bước cuối cùng, hãy nhấp vào TẢI CẤU HÌNH ỨNG DỤNG XUỐNG rồi 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 Data Manager API và Display & Video 360 API, hãy thêm phạm vi Display & Video 360 API 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 rằng thông tin xác thực đượ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ột 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ụ

Sau đây là các bước để tạo tài khoản dịch vụ và sử dụng tài khoản dịch vụ tính năng mạo danh để 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 mối đe doạ về 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 tiêu dùng sử dụng dịch vụ (roles/serviceusage.serviceUsageConsumer), bao gồm serviceusage.services.use quyền 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 Data Manager API và Display & Video 360 API, hãy thêm phạm vi Display & Video 360 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/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ủa bạn có vai trò Người tạo mã thông báo tài khoản dịch vụ.

  5. Xác nhận rằng thông tin xác thực đượ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ột 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 của bạn, hãy xem bài viết 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 xác thực cho một Tài khoản Google là người dùng trong các 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 xác thực 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 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 the 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 mẹ.

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, đối tác dữ liệu sử dụng tài khoản dịch vụ để truy cập vào API. Tuy nhiên, nếu bạn 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, thì 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 xác thực cho một Tài khoản Google là người dùng trong các 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 xác thực 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 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 mẹ.

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 của bạn.

Quyền truy cập vào tài khoản đố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à thiết lập cấp truy cập cho tài khoản đó, 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