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

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

Sau đây là các bước để xác thực bằng thông tin đăng nhập vào 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 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ì phạm vi Data Manager API là một 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 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. Đánh dấu vào hộp bên cạnh Data Manager API trong danh sách phạm vi, rồi nhấp vào Cập nhật.

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

   5. Chuyển đến phần Đối tượng trong Google Cloud Console rồi cập nhật Trạng thái phát hành và Loại người dùng. 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 Máy tính. Bạn có thể bỏ qua bước này nếu đã có ứng dụng OAuth2 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 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 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 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 đăng nhập 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 đăng nhập 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 đăng nhập được thiết lập đúng cách bằng lệnh sau. Nếu thành công, lệnh 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 để Sử dụng tính năng mạo danh tài khoản dịch vụ để xác thực. 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ạ 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 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 đăng nhập 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 đăng nhập 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ó 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 đăng nhập được thiết lập đúng cách bằng lệnh sau. Nếu thành công, lệnh 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à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 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 đă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 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 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 đă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.