계정 연결을 사용하여 사용자의 Google 계정을 인증 시스템의 사용자 계정과 연결할 수 있습니다. 이를 통해 사용자에게 더 풍부한 환경을 제공할 수 있습니다. 예를 들어 사용자의 음식 또는 음악 환경설정, 거래 내역, 더 맞춤설정된 환경을 제공하는 데 사용할 수 있는 기타 정보를 저장할 수 있습니다.
작업이 다양한 플랫폼 (예: 웹 또는 Android)의 기존 앱의 컴패니언인 경우 계정 연결을 사용하여 모든 환경설정을 사용자의 플랫폼에서 안전하게 사용할 수 있으므로 일관적인 크로스 플랫폼 환경이 보장됩니다.
Actions on Google 계정 연결에는 Google의 보안 인증 시스템인 Google 로그인과 필요에 따라 승인을 위한 업계 표준 프로토콜인 OAuth 2.0이 사용됩니다.
계정 연결 흐름 이해하기
어시스턴트가 Google 계정을 사용자와 일치시키면 계정 연결을 사용하여 사용자의 Google 계정 액세스 권한을 요청할 수 있습니다. 계정 데이터를 사용하여 다음 작업을 수행할 수 있습니다.
사용자가 이미 다른 플랫폼에서 내 작업 또는 앱 중 하나를 사용한 경우 인증 시스템에서 계정과 일치하는 항목을 찾습니다.
인증 시스템에서 신규 사용자를 위해 새 계정을 만듭니다.
Actions on Google은 세 가지 계정 연결 유형을 제공합니다.
Google 로그인
그림 1: 어시스턴트만 대상으로 하는 작업에 권장되는 Google 로그인 전용 계정 연결 유형입니다.
어시스턴트용 Google 로그인을 사용하면 대화에서 대화 중에 사용자의 이름, 이메일 주소, 프로필 사진 등 사용자의 Google 프로필에 대한 액세스를 요청할 수 있습니다. 사용자는 음성을 통한 전체 흐름을 완료할 수 있으므로 원활한 로그인 환경이 제공됩니다.
이 유형의 계정 연결은 다음 중 한 가지에 해당하는 경우에 권장됩니다.
기존 인증 시스템이 없습니다.
기존 인증 시스템이 있고 @gmail.com 주소를 사용하여 기존 앱에 가입한 사용자만 연결하려고 합니다.
OAuth 기반 Google 로그인 '간소화된' 연결 유형은 OAuth 기반 계정 연결 위에 Google 로그인을 추가합니다. 이렇게 하면 Google 사용자에게 원활한 음성 기반 연결이 제공되며 Google 이외의 ID로 서비스에 등록한 사용자에게 계정 연결이 가능합니다.
이 흐름을 사용하려면 지원되는 OAuth 2.0 표준 흐름 중 하나를 확장하여 프로토콜의 Google 독점 확장 프로그램에 대한 지원을 추가해야 합니다. 이를 통해 다음을 수행할 수 있습니다.
Google 프로필 정보를 사용하여 계정을 원활하게 연결합니다.
Google 프로필 정보를 사용하여 새 계정을 원활하게 만듭니다 (선택사항).
이 유형의 계정 연결은 기존 인증 시스템이 있고 사용자가 @gmail.com 이외의 주소에 연결할 수 있도록 허용하려는 경우에 권장됩니다.
OAuth 연결 유형은 두 가지 업계 표준 OAuth 2.0 흐름인 암시적 흐름과 승인 코드 흐름을 지원합니다.
이 흐름은 사용자 상호작용을 음성에서 화면으로 전송해야 하므로 사용하지 않는 것이 좋습니다. OAuth 2.0 서버가 이미 구현되어 있고, 토큰 교환 엔드포인트를 확장하여 ID 토큰에서 자동 연결 및 계정 생성을 위한 Google 프로토콜 지원을 추가할 수 없는 경우 이 흐름을 사용하는 것이 좋습니다.
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["필요한 정보가 없음","missingTheInformationINeed","thumb-down"],["너무 복잡함/단계 수가 너무 많음","tooComplicatedTooManySteps","thumb-down"],["오래됨","outOfDate","thumb-down"],["번역 문제","translationIssue","thumb-down"],["샘플/코드 문제","samplesCodeIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2023-11-02(UTC)"],[[["\u003cp\u003eAccount linking lets you connect users' Google accounts with your system, enabling personalized experiences by saving preferences and history.\u003c/p\u003e\n"],["\u003cp\u003eActions on Google offers three account linking types: Google Sign-In (recommended for Assistant-only Actions), OAuth-based Google Sign-in "Streamlined" linking (recommended for multi-platform Actions), and OAuth linking (least recommended).\u003c/p\u003e\n"],["\u003cp\u003eGoogle Sign-In allows users to sign in with their Google profile, including name, email, and picture, providing a frictionless experience.\u003c/p\u003e\n"],["\u003cp\u003eOAuth-based Google Sign-in "Streamlined" linking combines Google Sign-In with OAuth, enabling both Google and non-Google identities for linking.\u003c/p\u003e\n"],["\u003cp\u003eOAuth linking supports standard OAuth flows but is discouraged due to requiring screen interaction; it's suitable if you have an existing OAuth 2.0 server and cannot extend it for automatic linking.\u003c/p\u003e\n"]]],["Account linking connects user accounts across platforms, allowing personalized experiences and consistent cross-platform access. There are three types: Google Sign-In, ideal for Assistant-only Actions or Gmail users; OAuth-based Google Sign-in \"Streamlined\" linking, best for multi-platform users with Google and non-Google accounts; and OAuth linking for existing OAuth 2.0 servers, although voice to screen transition is required. If a linked Action is unhealthy, issues must be resolved in seven days to avoid removal. Account linking is unavailable on Android (Go edition) and KaiOS devices.\n"],null,["# Account linking\n\n| **Note:** Actions that enable account linking aren't currently available on Android (Go edition) or KaiOS devices.\n\nYou can use account linking to connect your users' Google accounts with user\naccounts in your authentication system. This allows you to build richer\nexperiences for your users; for example, you can save the user's food or music\npreferences, history of transactions, and other information that you can use\nto provide a more personalized experience.\n\nIf your Action is a companion of existing apps on different platforms (for example,\nthe web or Android), you can use account linking to securely make users' preferences\navailable to all platforms, which ensures a consistent cross-platform experience.\n\nAccount linking for Actions on Google uses [Google Sign-In](/identity),\nGoogle's secure authentication system, and optionally, [OAuth 2.0](https://oauth.net/2/) ,\nthe industry-standard protocol for authorization.\n| **Note:** Google monitors the functionality of the account linking flow in your Action. If your Action that uses account linking is marked as unhealthy, Google sends you a notification email. Upon receipt of this email, you have 7 days to fix the issue; otherwise, your agent will be taken down. For more information, see [health checks](/assistant/console/health-checks).\n\nUnderstand the account linking flow\n-----------------------------------\n\nWhen Assistant matches a Google account to a user, you can use account\nlinking to ask for the user's permission to access that Google account. You can use\nthe account data to do the following:\n\n- To find a match for the account in your authentication system if the user has already used your Action or one of your apps on other platforms.\n- To create a new account in your authentication system for a new user.\n\nActions on Google offers three different account linking types.\n\n### Google Sign-In\n\n**Figure 1**: The Google Sign-In only account linking type is the recommended solution for Actions that target only Assistant.\n\nWith *Google Sign-In for the Assistant*, your Action can request access to your user's\nGoogle profile during a conversation, including the user's name, email address,\nand profile picture. The user can complete the whole flow over voice, which provides\na frictionless sign-in experience.\n\nThis type of account linking is recommended if **any** of the following applies:\n\n- You don't have an existing authentication system.\n- You have an existing authentication system and only want to link to users who signed up to your existing apps using their @gmail.com address.\n\nTo learn more, see the [Google Sign-In concept guide](/assistant/identity/gsi-concept-guide)\nand [implementation guide](/assistant/identity/google-sign-in).\n\n### OAuth-based Google Sign-in \"Streamlined\" linking\n\n**Figure 2**: Streamlined linking is the recommended solution for multi-platform Actions.\n\nThe *OAuth-based Google Sign-in \"Streamlined\" linking* type adds Google Sign-In on top of OAuth based\naccount linking. This provides seamless voice-based linking for Google users\nwhile also enabling account linking for users who registered to your service\nwith a non-Google identity.\n\nTo use this flow, you need to extend one of the supported OAuth 2.0 standard flows\nto add support for Google proprietary extensions of the protocol, which allow you\nto:\n\n- Seamlessly link accounts using the Google profile information.\n- Seamlessly create new accounts using the Google profile information (optional).\n\nThis type of account linking is recommended if you have an existing authentication\nsystem and you want to allow users to connect to non @gmail.com addresses.\n\nTo learn more, see the [OAuth-based Google Sign-in \"Streamlined\" linking concept guide](/assistant/identity/gsi-oauth-concept-guide)\nand [implementation guide](/assistant/identity/google-sign-in-oauth).\n| **Note:** You can use the Streamlined linking type with the authorization code flow to implement [OAuth-based App Flip](/assistant/identity/app-flip), which provides a faster and easier linking process for the user.\n\n### OAuth linking\n\nThe *OAuth linking* type supports two industry standard OAuth 2.0 flows,\nthe *implicit* and *authorization* code flows.\n\nUsing this flow is discouraged because it requires transferring the user interaction\nfrom voice to screen. You can consider using this flow if you have an existing\nimplementation of an OAuth 2.0 server, and you cannot extend the token exchange endpoint\nto add support for Google's protocols for automatic linking and account creation\nfrom an ID token.\n\nTo learn more, see the [OAuth linking concept guide](/assistant/identity/oauth-concept-guide)\nand [implementation guide](/assistant/identity/oauth2).\n| **Note:** You can use the OAuth linking type with the authorization code flow to implement [OAuth-based App Flip](/assistant/identity/app-flip), which provides a faster and easier linking process for the user.\n\nRelated resources\n-----------------\n\nFor more information about implementing account linking in your Action, see the\nfollowing resource:\n\n- [Account linking: Dialogflow](https://www.youtube.com/watch?v=JYmTBT7DvSM): An introduction to the linking types you can implement in your Action."]]
