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.

Chọn loại quy trình thiết lập mà bạn muốn làm theo:

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

Trước khi có thể sử dụng Data API, hãy đảm bảo bạn có những điều sau:

Một dự án trên Google Cloud.
Một Tài khoản Google có quyền serviceusage.services.enable trên dự án Google Cloud của bạn hoặc có một vai trò bao gồm quyền đó. Ví dụ: roles/owner và roles/serviceusage.serviceUsageAdmin đều bao gồm quyền serviceusage.services.enable. Để kiểm tra quyền của bạn, hãy xem phần Xem quyền truy cập hiện tại.
Google Cloud CLI đã cài đặt.

Bật API

Nếu chưa bật, hãy bật Data Manager API 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.

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 thức 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 thức 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 các 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 từ 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 Mạo danh tài khoản dịch vụ để thiết lập ADC:

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

Đị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.

Quan trọng: Mọi ứng dụng Google Cloud dùng để lấy thông tin xác thực của người dùng cho phạm vi Data Manager API đều phải trải qua quy trình xác minh OAuth của Google để tránh màn hình giao diện người dùng chưa được xác minh cho người dùng. Bạn không bắt buộc phải xác minh OAuth của Google đối với tài khoản dịch vụ.
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.
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 xuất bản 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.
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.

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 --scopeslist:

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 --scopes danh sách:

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"

Xác nhận rằng thông tin xác thực đượ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ì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 thức 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

Cấp quyền truy cập vào Destination cho email được liên kết với tài khoản người dùng của bạn.

Nếu đang sử dụng tài khoản Google Ads, hãy 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ẹ.
Nếu đang sử dụng tài khoản Display & Video 360, hãy làm theo hướng dẫn để thêm email của người dùng vào tài khoản.
Nếu đang sử dụng một tài sản Google Analytics, hãy làm theo hướng dẫn để thêm email của người dùng vào tài khoản.

Các bước tiếp theo

Cài đặt thư viện ứng dụng và chạy các mẫu mã để thử yêu cầu Data Manager API đầu tiên.

Tiếp

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