Truy cập thuộc tính nhận dạng người dùng

Người dùng sẽ sử dụng Trình kết nối cộng đồng của bạn để tạo nguồn dữ liệu của riêng họ. Đối với các nguồn dữ liệu này, trình kết nối của bạn có thể truy cập danh tính của người dùng hiệu quả. Tuỳ thuộc vào Thông tin xác thực nguồn dữ liệu, người dùng hiệu quả có thể là người tạo nguồn dữ liệu (thông tin xác thực của chủ sở hữu) hoặc người xem báo cáo (Thông tin xác thực của người xem).

Lợi ích

  • Bạn có thể thay mặt người dùng truy cập vào các dịch vụ và API của Google.
  • Bạn có thể triển khai chế độ kiểm soát quyền truy cập tuỳ chỉnh để đảm bảo chỉ hiển thị dữ liệu có liên quan.
  • Bạn có thể tuỳ chỉnh trải nghiệm người dùng cho phù hợp với người dùng hiệu quả.

Các bước triển khai

Truy cập vào mã thông báo OAuth của người dùng

Trình kết nối của bạn có thể thay mặt người dùng truy cập vào các dịch vụ và API của Google bằng cách truyền mã thông báo OAuth của người dùng. Để truy cập vào mã thông báo OAuth của người dùng hiệu quả trong trình kết nối, hãy sử dụng ScriptApp.getOAuthToken(). Xem tài liệu tham khảo về get OAuthToken. Mã thông báo này sẽ bao gồm Phạm vi uỷ quyền có trong quá trình uỷ quyền trình kết nối.

Đối với hầu hết trình kết nối, Apps Script sẽ tự động phát hiện những phạm vi cần thiết bằng cách phân tích cú pháp và xử lý tập lệnh. Bạn có thể xem phạm vi mà trình kết nối sử dụng bất cứ lúc nào. Bạn cũng có thể đặt phạm vi một cách rõ ràng trong tệp kê khai bằng cách sử dụng chuỗi URL. Nếu bạn muốn thay mặt người dùng truy cập vào một dịch vụ hoặc API của Google, hãy thêm phạm vi liên quan đó vào tệp kê khai.

Truy cập vào địa chỉ email của người dùng

Trong mã của mình, bạn có thể xác định người dùng hiện tại đang hoạt động bằng Session.getEffectiveUser().getEmail(). Hãy xem Tài liệu tham khảo về getAvailableUser. Việc thêm mã này sẽ tự động thêm phạm vi uỷ quyền https://www.googleapis.com/auth/userinfo.email vào trình kết nối của bạn.

Ví dụ: Gọi API Google bằng mã thông báo OAuth của người dùng

  • Trình kết nối Google Fit tìm nạp dữ liệu từ API Google Fit cho người dùng hiệu quả. Trong khi gọi API, API này sẽ truyền mã thông báo OAuth của người dùng hiệu quả. Hãy xem mã nguồn để biết thông tin chi tiết về cách triển khai.
  • Trình kết nối Firestore sử dụng Cloud Resource Manager (Trình quản lý tài nguyên đám mây) để nhận danh sách dự án cho người dùng hiệu quả. Trình kết nối này cũng truyền mã thông báo OAuth của người dùng hiệu quả. Hãy xem mã nguồn để biết thông tin chi tiết về cách triển khai.

Ví dụ: isAdminUser() dựa trên địa chỉ email