Tổng quan

Chọn đường dẫn tích hợp

Chọn đường dẫn phù hợp nhất với nhu cầu của bạn:

Đường dẫn Phù hợp nhất cho Tìm hiểu thêm
Giao thức thương mại toàn cầu (UCP) Người bán và nhà bán lẻ. Tài liệu về UCP
Liên kết tài khoản tiêu chuẩn Nhà thông minh, TV và YouTube. Tài liệu

Tính năng liên kết tài khoản cho phép người dùng Tài khoản Google kết nối với các dịch vụ của bạn một cách nhanh chóng, liền mạch và an toàn. Bạn có thể chọn triển khai tính năng Liên kết tài khoản Google để chia sẻ dữ liệu của người dùng từ nền tảng của bạn với các ứng dụng và dịch vụ của Google.

Giao thức OAuth 2.0 an toàn cho phép bạn liên kết an toàn Tài khoản Google của người dùng với tài khoản của họ trên nền tảng của bạn, nhờ đó cấp cho các ứng dụng và thiết bị của Google quyền truy cập vào các dịch vụ của bạn.

Người dùng có thể liên kết hoặc huỷ liên kết tài khoản và tuỳ ý tạo tài khoản mới trên nền tảng của bạn bằng tính năng Liên kết tài khoản Google.

Trường hợp sử dụng

Sau đây là một số lý do để triển khai tính năng Liên kết tài khoản Google:

  • Chia sẻ dữ liệu của người dùng từ nền tảng của bạn với các ứng dụng và dịch vụ của Google.

  • Tích hợp với Google Mua sắm và các nền tảng AI (Tìm kiếm, Gemini) bằng Giao thức thương mại toàn cầu (UCP).

  • Phát nội dung video và phim bằng Google TV.

  • Quản lý và điều khiển các thiết bị thông minh trong nhà được kết nối bằng ứng dụng Google Home và Trợ lý Google, "Ok Google, bật đèn".

  • Tạo trải nghiệm và chức năng tuỳ chỉnh cho người dùng trên Trợ lý Google bằng Hành động đàm thoại, "Ok Google, đặt cho tôi món thường dùng ở Starbucks".

  • Cho phép người dùng kiếm phần thưởng bằng cách xem các sự kiện phát trực tiếp đủ điều kiện trên YouTube sau khi liên kết Tài khoản Google của họ với một tài khoản đối tác trao thưởng.

  • Điền sẵn thông tin vào tài khoản mới trong quá trình đăng ký bằng dữ liệu được chia sẻ có sự đồng ý từ hồ sơ Tài khoản Google.

Tính năng và yêu cầu

Ma trận sau đây xác định mức hỗ trợ và các đề xuất cho từng quy trình liên kết.

Quy trình liên kết Tính năng tiêu chuẩn Tính năng UCP
Chuyển đổi ứng dụng Đề xuất Đề xuất
Liên kết đơn giản Đề xuất Đề xuất
Liên kết OAuth Bắt buộc (Dự phòng) Bắt buộc (Dự phòng)
OAuth 2.1 Đề xuất Đề xuất

Phát triển dựa trên tác nhân (MCP và UCP)

Các mô hình ngôn ngữ lớn (LLM) và tác nhân AI yêu cầu xác thực mạnh mẽ để truy cập vào dữ liệu người dùng. Tính năng Liên kết tài khoản Google hỗ trợ các mô hình mới nổi sau đây:

Quy trình liên kết tài khoản

Có 3 quy trình Liên kết tài khoản Google, tất cả đều dựa trên OAuth và yêu cầu bạn quản lý hoặc kiểm soát các điểm cuối trao đổi mã thông báo và cấp quyền tuân thủ OAuth 2.0.

Trong quá trình liên kết, bạn sẽ cấp mã truy cập cho Google đối với từng Tài khoản Google sau khi nhận được sự đồng ý của chủ tài khoản để liên kết tài khoản và chia sẻ dữ liệu.

Liên kết OAuth

Đây là quy trình liên kết OAuth sẽ chuyển người dùng đến trang web của bạn để liên kết. Người dùng sẽ được chuyển hướng đến trang web của bạn để đăng nhập vào tài khoản của họ. Sau khi đăng nhập, người dùng đồng ý chia sẻ dữ liệu của họ trên dịch vụ của bạn với Google. Tại thời điểm đó, Tài khoản Google của người dùng và dịch vụ của bạn sẽ được liên kết.

Tính năng liên kết OAuth hỗ trợ mã uỷ quyền và các quy trình OAuth ngầm ẩn. Dịch vụ của bạn phải lưu trữ một điểm cuối cấp quyền tuân thủ OAuth 2.0 cho quy trình ngầm ẩn và phải hiển thị cả điểm cuối trao đổi mã thông báo và cấp quyền khi sử dụng quy trình mã uỷ quyền.

Hình 1. Liên kết tài khoản trên điện thoại của người dùng bằng tính năng liên kết OAuth

Liên kết chuyển đổi ứng dụng dựa trên OAuth ("Chuyển đổi ứng dụng")

Một quy trình OAuth sẽ chuyển người dùng đến ứng dụng của bạn để liên kết.

Tính năng Liên kết chuyển đổi ứng dụng dựa trên OAuth hướng dẫn người dùng khi họ chuyển đổi giữa các ứng dụng di động đã xác minh trên Android hoặc iOS và nền tảng của Google để xem các thay đổi được đề xuất về quyền truy cập dữ liệu và cấp sự đồng ý để liên kết tài khoản của họ trên nền tảng của bạn với Tài khoản Google của họ. Để bật tính năng Chuyển đổi ứng dụng, dịch vụ của bạn phải hỗ trợ tính năng liên kết OAuth hoặc tính năng Liên kết đăng nhập bằng Google dựa trên OAuth bằng quy trình mã uỷ quyền.

Tính năng Chuyển đổi ứng dụng được hỗ trợ cho cả AndroidiOS.

Cách hoạt động:

Ứng dụng Google kiểm tra xem ứng dụng của bạn có được cài đặt trên thiết bị của người dùng hay không:

  • Nếu tìm thấy ứng dụng, người dùng sẽ được "chuyển đổi" sang ứng dụng của bạn. Ứng dụng của bạn thu thập sự đồng ý của người dùng để liên kết tài khoản với Google, sau đó "chuyển đổi trở lại" sang nền tảng của Google.
  • Nếu không tìm thấy ứng dụng hoặc xảy ra lỗi trong quá trình liên kết chuyển đổi ứng dụng, người dùng sẽ được chuyển hướng đến quy trình liên kết Đơn giản hoặc OAuth.

Hình 2. Liên kết tài khoản trên điện thoại của người dùng bằng tính năng Chuyển đổi ứng dụng

Liên kết đơn giản dựa trên OAuth ("Đơn giản")

Tính năng liên kết Đơn giản khi đăng nhập bằng Google dựa trên OAuth sẽ thêm tính năng Đăng nhập bằng Google vào tính năng liên kết OAuth, cho phép người dùng hoàn tất quy trình liên kết mà không cần rời khỏi nền tảng của Google, nhờ đó giảm thiểu các trở ngại và tỷ lệ bỏ qua. Tính năng Liên kết đơn giản dựa trên OAuth mang lại trải nghiệm tốt nhất cho người dùng với tính năng đăng nhập, tạo tài khoản và liên kết tài khoản liền mạch bằng cách kết hợp tính năng Đăng nhập bằng Google với tính năng liên kết OAuth. Dịch vụ của bạn phải hỗ trợ các điểm cuối trao đổi mã thông báo và cấp quyền tuân thủ OAuth 2.0. Ngoài ra, điểm cuối trao đổi mã thông báo của bạn phải hỗ trợ Mã thông báo web JSON (JWT) các câu khẳng định và triển khai các ý định checkget bắt buộc, đồng thời có thể triển khai ý định create.

Cách hoạt động:

Google khẳng định tài khoản người dùng và chuyển thông tin này cho bạn:

  • Nếu người dùng có tài khoản trong cơ sở dữ liệu của bạn, thì người dùng sẽ liên kết thành công Tài khoản Google của họ với tài khoản của họ trên dịch vụ của bạn.
  • Nếu người dùng không có tài khoản trong cơ sở dữ liệu của bạn và dịch vụ của bạn hỗ trợ việc tạo tài khoản, thì người dùng có thể tạo tài khoản mới của bên thứ ba bằng thông tin được khẳng định mà Google cung cấp (email, tên và ảnh hồ sơ) hoặc chọn đăng nhập và liên kết bằng một email khác bằng tính năng liên kết OAuth.

Hình 3. Liên kết tài khoản trên điện thoại của người dùng bằng tính năng Liên kết đơn giản

Bạn nên sử dụng quy trình nào?

Bạn nên triển khai tất cả các quy trình để đảm bảo người dùng có được trải nghiệm liên kết tốt nhất. Các quy trình Chuyển đổi ứng dụng và Đơn giản giúp giảm thiểu trở ngại trong quá trình liên kết vì người dùng có thể hoàn tất quy trình liên kết chỉ trong vài bước. Quy trình liên kết OAuth có mức độ nỗ lực thấp nhất và là nơi phù hợp để bắt đầu, sau đó bạn có thể thêm các quy trình liên kết khác.

Làm việc với mã thông báo

Tính năng Liên kết tài khoản Google dựa trên các cơ chế mã thông báo OAuth 2.0 tiêu chuẩn. Bạn sẽ cấp mã truy cập và mã làm mới cho Google sau khi người dùng đồng ý liên kết tài khoản của họ.

  • Mã truy cập: Mã thông báo có thời gian tồn tại ngắn được Google sử dụng để truy cập vào các API của bạn.
  • Mã làm mới: Mã thông báo có thời gian tồn tại dài được Google sử dụng để lấy mã truy cập mới khi mã truy cập hết hạn.

Để biết các hợp đồng giao thức chi tiết và yêu cầu về tham số, hãy xem bài viết Điểm cuối trao đổi mã thông báo.

Liên kết liên tục

Liên kết liên tục là yêu cầu cốt lõi để tích hợp ổn định. Tính năng này đảm bảo rằng tài khoản người dùng vẫn được liên kết ngay cả khi mạng bị lỗi tạm thời hoặc thông tin xác thực được làm mới định kỳ.

Để triển khai tính năng liên kết liên tục, hãy sử dụng phương pháp "cửa sổ trượt": kéo dài thời gian hết hạn của Mã làm mới hiện có thay vì xoay vòng mã đó (tham khảo Phần 6 của RFC 6749). Điều này giúp ngăn chặn các tình trạng xung đột và việc huỷ liên kết không mong muốn có thể xảy ra nếu một Mã làm mới mới được cấp nhưng Google không nhận hoặc lưu trữ thành công.

Đăng ký với Google

Chúng tôi cần thông tin chi tiết về quá trình thiết lập OAuth 2.0 và chia sẻ thông tin xác thực để bật tính năng liên kết tài khoản. Hãy xem bài viết đăng ký để biết thông tin chi tiết.