개요

통합 경로 선택

필요에 가장 적합한 경로를 선택하세요.

경로 권장 용도 자세히 알아보기
범용 상거래 프로토콜 (UCP) 판매자 및 소매업체 UCP 문서
표준 계정 연결 스마트 홈, TV, YouTube 문서

계정 연결을 사용하면 Google 계정 소유자가 빠르고 원활하며 안전하게 서비스에 연결할 수 있습니다. Google 계정 연결을 구현하여 플랫폼의 사용자 데이터를 Google 앱 및 서비스와 공유할 수 있습니다.

보안 OAuth 2.0 프로토콜을 사용하면 사용자의 Google 계정을 플랫폼의 계정과 안전하게 연결하여 Google 애플리케이션 및 기기에 서비스에 대한 액세스 권한을 부여할 수 있습니다.

사용자는 Google 계정 연결을 사용하여 계정을 연결하거나 연결 해제할 수 있으며, 선택적으로 플랫폼에서 새 계정을 만들 수 있습니다.

사용 사례

Google 계정 연결을 구현하는 몇 가지 이유는 다음과 같습니다.

기능 및 요구사항

다음 표에서는 각 연결 흐름에 대한 지원 및 권장사항을 정의합니다.

연결 흐름 표준 기능 UCP 기능
앱 플립 권장 권장
간소화된 연결 권장 권장
OAuth 연결 필수 (대체) 필수 (대체)
OAuth 2.1 권장 권장

에이전트형 개발 (MCP 및 UCP)

대규모 언어 모델 (LLM) 및 AI 에이전트가 사용자 데이터에 액세스하려면 강력한 인증이 필요합니다. Google 계정 연결은 다음과 같은 새로운 패러다임을 지원합니다.

계정 연결 흐름

OAuth 기반이며 OAuth 2.0 호환 승인 및 토큰 교환 엔드포인트를 관리하거나 제어해야 하는 3가지 Google 계정 연결 흐름이 있습니다.

연결 프로세스 중에 계정 소유자의 계정 연결 및 데이터 공유 동의를 얻은 후 개별 Google 계정에 대한 액세스 토큰을 Google에 발급합니다.

OAuth 연결

사용자를 연결을 위해 웹사이트 로 보내는 OAuth 연결 흐름입니다. 사용자는 웹사이트로 리디렉션되어 계정에 로그인합니다. 로그인한 후 사용자는 서비스의 데이터를 Google과 공유하는 데 동의합니다. 이때 사용자의 Google 계정과 서비스가 연결됩니다.

OAuth 연결은 승인 코드 및 암시적 OAuth 흐름을 지원합니다. 서비스는 암시적 흐름을 위한 OAuth 2.0 호환 승인 엔드포인트를 호스팅해야 하며, 승인 코드 흐름을 사용하는 경우 승인 및 토큰 교환 엔드포인트를 모두 노출해야 합니다.

그림 1. OAuth 연결을 사용하여 사용자 휴대전화에서 계정 연결

OAuth 기반 앱 플립 연결('앱 플립')

연결을 위해 사용자를 앱 으로 보내는 OAuth 흐름입니다.

OAuth 기반 앱 플립 연결은 사용자가 인증된 Android 또는 iOS 모바일 앱과 Google 플랫폼 간에 이동하면서 제안된 데이터 액세스 변경사항을 검토하고 플랫폼의 계정을 Google 계정과 연결하는 데 동의하도록 안내합니다. 앱 플립을 사용 설정하려면 서비스에서 OAuth 연결 또는 OAuth 기반 Google 계정으로 로그인 연결 을(를) 승인 코드 흐름을 사용하여 지원해야 합니다.

앱 플립은 Android와 iOS 모두에서 지원됩니다.

작동 방식:

Google 앱은 앱이 사용자 기기에 설치되어 있는지 확인합니다.

  • 앱이 발견되면 사용자는 앱으로 '플립'됩니다. 앱은 Google과 계정을 연결하는 데 동의를 얻은 다음 Google 표시 경로로 '플립 백'합니다.
  • 앱을 찾을 수 없거나 앱 플립 연결 프로세스 중에 오류가 발생하면 사용자는 간소화된 연결 또는 OAuth 연결 흐름으로 리디렉션됩니다.

그림 2. 앱 플립을 사용하여 사용자 휴대전화에서 계정 연결

OAuth 기반 간소화된 연결('간소화됨')

OAuth 기반 Google 계정으로 로그인 간소화된 연결 은 OAuth 연결 위에 Google 계정으로 로그인을 추가하여 사용자가 Google 표시 경로를 벗어나지 않고 연결 프로세스를 완료할 수 있도록 하여 마찰과 이탈을 줄입니다. OAuth 기반 간소화된 연결은 Google 계정으로 로그인을 OAuth 연결과 결합하여 원활한 로그인, 계정 생성, 계정 연결로 최고의 사용자 환경을 제공합니다. 서비스는 OAuth 2.0 호환 승인 및 토큰 교환 엔드포인트를 지원해야 합니다. 또한 토큰 교환 엔드포인트는 JSON 웹 토큰 (JWT) 어설션을 지원하고 필수 check 및 get 인텐트와 선택적으로 create 인텐트를 구현해야 합니다.

작동 방식:

Google은 사용자 계정을 어설션하고 이 정보를 전달합니다.

  • 데이터베이스에 사용자의 계정이 있는 경우 사용자는 Google 계정을 서비스의 계정과 성공적으로 연결합니다.
  • 데이터베이스에 사용자의 계정이 없고 서비스에서 계정 생성을 지원하는 경우 사용자는 Google에서 제공하는 어설션된 정보 (이메일, 이름, 프로필 사진)로 새 서드 파티 계정을 만들거나 OAuth 연결을 사용하여 다른 이메일로 로그인하고 연결할 수 있습니다.

그림 3. 간소화된 연결을 사용하여 사용자 휴대전화에서 계정 연결

어떤 흐름을 사용해야 하나요?

사용자에게 최고의 연결 환경을 제공하려면 모든 흐름을 구현하는 것이 좋습니다. 간소화된 연결 및 앱 플립 흐름은 사용자가 몇 단계만으로 연결 프로세스를 완료할 수 있으므로 연결 마찰을 줄입니다. OAuth 연결 흐름은 가장 적은 노력이 필요하며 시작하기에 좋은 방법입니다. 그런 다음 다른 연결 흐름을 추가할 수 있습니다.

토큰 작업

Google 계정 연결은 표준 OAuth 2.0 토큰 메커니즘을 사용합니다. 사용자가 계정 연결에 동의한 후 액세스 토큰과 갱신 토큰을 Google에 발급합니다.

  • 액세스 토큰: Google에서 API에 액세스하는 데 사용하는 단기 토큰입니다.
  • 갱신 토큰: Google에서 만료될 때 새 액세스 토큰을 가져오는 데 사용하는 장기 토큰입니다.

자세한 프로토콜 계약 및 매개변수 요구사항은 토큰 교환 엔드포인트를 참고하세요.

영구 연결

영구 연결은 안정적인 통합을 위한 핵심 요구사항입니다. 일시적인 네트워크 오류 또는 주기적인 사용자 인증 정보 갱신 중에도 사용자 계정이 연결된 상태로 유지되도록 합니다.

영구 연결을 구현하려면 '슬라이딩 윈도우' 접근 방식을 사용합니다. 갱신 토큰을 순환하는 대신 기존 갱신 토큰의 만료를 연장합니다 (RFC 6749 섹션 6 참고). 이렇게 하면 새 갱신 토큰이 발급되었지만 Google에서 성공적으로 수신하거나 저장하지 못한 경우 발생할 수 있는 경합 상태 및 의도하지 않은 연결 해제를 방지할 수 있습니다.

Google에 등록

계정 연결을 사용 설정하려면 OAuth 2.0 설정의 세부정보와 사용자 인증 정보를 공유해야 합니다. 자세한 내용은 등록을 참고하세요.