AccountLinking
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
AccountLinking permet à Google de guider l'utilisateur pour qu'il se connecte aux services Web de l'application.
Pour les types d'association Google Sign-In et OAuth + Google Sign In, Google génère un ID client identifiant votre application auprès de Google ("ID client attribué par Google pour vos actions" dans l'interface utilisateur de la console). Ce champ est en lecture seule et peut être vérifié en accédant à la page "Association de comptes" dans l'interface utilisateur de la console. Consultez la page https://developers.google.com/assistant/identity/google-sign-in.
Remarque: Pour tous les types de paramètres d'association de comptes (à l'exception de Google Sign-In), vous devez fournir un nom d'utilisateur et un mot de passe pour un compte test dans Settings.testing_instructions afin que l'équipe chargée de l'examen puisse examiner l'application (ils ne seront pas visibles par les utilisateurs).
| Représentation YAML |
enableAccountCreation: boolean
linkingType: enum (LinkingType)
authGrantType: enum (AuthGrantType)
appClientId: string
authorizationUrl: string
tokenUrl: string
scopes:
- string
learnMoreUrl: string
useBasicAuthHeader: boolean |
| Champs |
enableAccountCreation |
boolean
Obligatoire. Si la valeur est true, les utilisateurs sont autorisés à créer de nouveaux comptes par commande vocale. Si la valeur est false, la création de compte n'est autorisée que sur votre site Web. Sélectionnez cette option si vous souhaitez afficher vos conditions d'utilisation ou obtenir le consentement de l'utilisateur lors de l'inscription. linkType ne peut pas être GOOGLE_SIGN_IN lorsque la valeur est false. linkType ne peut pas être OAUTH lorsque la valeur est true.
|
linkingType |
enum (LinkingType)
Obligatoire. Type d'association à utiliser. Pour en savoir plus sur les types d'associations, consultez la page https://developers.google.com/assistant/identity.
|
authGrantType |
enum (AuthGrantType)
Facultatif. Indique le type d'authentification pour le type de liaison OAUTH.
|
appClientId |
string
Facultatif. ID client attribué par votre application à Google. Il s'agit de l'ID client OAuth2 qui identifie Google auprès de votre service. Défini uniquement lors de l'utilisation d'OAuth.
|
authorizationUrl |
string
Facultatif. Point de terminaison de votre page Web de connexion compatible avec le code OAuth2 ou les flux implicites. L'URL doit utiliser le protocole HTTPS. Défini uniquement lors de l'utilisation d'OAuth.
|
tokenUrl |
string
Facultatif. Point de terminaison OAuth2 pour l'échange de jetons. L'URL doit utiliser le protocole HTTPS. Ce paramètre n'est pas défini lorsque vous utilisez uniquement le protocole OAuth avec l'attribution IMPLICIT comme type d'association. Défini uniquement lors de l'utilisation d'OAuth.
|
scopes[] |
string
Facultatif. Liste des autorisations que l'utilisateur doit accorder pour utiliser votre service. Défini uniquement lors de l'utilisation d'OAuth. Si vous spécifiez ce champ, veillez à fournir des conditions d'utilisation dans les informations du répertoire de la section LocalizedSettings.terms_of_service_url.
|
learnMoreUrl |
string
Facultatif. Il s'agit de la page Web de votre service qui décrit les autorisations que l'utilisateur accorde à Google. Défini uniquement si vous utilisez OAuth et Google Sign-In. Si vous spécifiez ce champ, veillez à fournir des conditions d'utilisation dans les informations du répertoire de la section LocalizedSettings.terms_of_service_url.
|
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/07/26 (UTC).
[null,null,["Dernière mise à jour le 2025/07/26 (UTC)."],[[["\u003cp\u003eAccount Linking enables users to sign in to your app's web services through Google.\u003c/p\u003e\n"],["\u003cp\u003eFor Google Sign-In and OAuth linking, a Client ID is generated by Google and displayed in the Actions Console.\u003c/p\u003e\n"],["\u003cp\u003eFor all other linking types, provide test account credentials for review purposes in \u003ccode\u003eSettings.testing_instructions\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eYou must configure account linking settings like \u003ccode\u003eenableAccountCreation\u003c/code\u003e, \u003ccode\u003elinkingType\u003c/code\u003e, and optional OAuth parameters in your action's YAML configuration.\u003c/p\u003e\n"],["\u003cp\u003eWhen using OAuth, provide necessary information like authorization and token URLs, scopes, and optionally, a \u003ccode\u003elearnMoreUrl\u003c/code\u003e and basic authentication settings.\u003c/p\u003e\n"]]],["Account linking enables Google to guide users to sign in to an app's web services. For certain linking types, Google provides a read-only Client ID. Settings require a test account's username and password, except with Google Sign In. The YAML representation defines fields like `enableAccountCreation`, `linkingType`, `authGrantType`, and URLs for authorization and token exchange. OAuth requires specifying `appClientId`, `scopes`, and possibly `learnMoreUrl` and `useBasicAuthHeader`. The `enableAccountCreation` boolean determines if account creation is done via voice.\n"],null,["# AccountLinking\n\n- [YAML representation](#SCHEMA_REPRESENTATION)\n\nAccountLinking allows Google to guide the user to sign-in to the App's web services.\n\nFor Google Sign In and OAuth + Google Sign In linking types, Google generates a client ID identifying your App to Google (\"Client ID issued by Google to your Actions\" on Console UI). This field is read-only and can be checked by navigating to the Console UI's Account Linking page. See: \u003chttps://developers.google.com/assistant/identity/google-sign-in\u003e\n\nNote: For all account linking setting types (except for Google Sign In), you must provide a username and password for a test account in Settings.testing_instructions for the review team to review the app (they will not be visible to users).\n\n| YAML representation ||\n|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---|\n| ``` enableAccountCreation: boolean linkingType: enum (/assistant/actionssdk/reference/rest/Shared.Types/LinkingType) authGrantType: enum (/assistant/actionssdk/reference/rest/Shared.Types/AuthGrantType) appClientId: string authorizationUrl: string tokenUrl: string scopes: - string learnMoreUrl: string useBasicAuthHeader: boolean ``` |\n\n| Fields ||\n|-------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `enableAccountCreation` | `boolean` Required. If `true`, users are allowed to sign up for new accounts via voice. If `false`, account creation is only allowed on your website. Select this option if you want to display your terms of service or obtain user consents during sign-up. linkingType cannot be GOOGLE_SIGN_IN when this is `false`. linkingType cannot be OAUTH when this is `true`. |\n| `linkingType` | `enum (`[LinkingType](/assistant/actionssdk/reference/rest/Shared.Types/LinkingType)`)` Required. The linking type to use. See \u003chttps://developers.google.com/assistant/identity\u003e for further details on the linking types. |\n| `authGrantType` | `enum (`[AuthGrantType](/assistant/actionssdk/reference/rest/Shared.Types/AuthGrantType)`)` Optional. Indicates the type of authentication for OAUTH linkingType. |\n| `appClientId` | `string` Optional. Client ID issued by your App to Google. This is the OAuth2 Client ID identifying Google to your service. Only set when using OAuth. |\n| `authorizationUrl` | `string` Optional. Endpoint for your sign-in web page that supports OAuth2 code or implicit flows. URL must use HTTPS. Only set when using OAuth. |\n| `tokenUrl` | `string` Optional. OAuth2 endpoint for token exchange. URL must use HTTPS. This is not set when only using OAuth with IMPLICIT grant as the linking type. Only set when using OAuth. |\n| `scopes[]` | `string` Optional. List of permissions the user must consent to in order to use your service. Only set when using OAuth. Make sure to provide a Terms of Service in the directory information in LocalizedSettings.terms_of_service_url section if specifying this field. |\n| `learnMoreUrl` | `string` Optional. This is the web page on your service which describes the permissions the user is granting to Google. Only set if using OAuth and Google Sign In. Make sure to provide a Terms of Service in the directory information in LocalizedSettings.terms_of_service_url section if specifying this field. |\n| `useBasicAuthHeader` | `boolean` Optional. If true, allow Google to transmit client ID and secret via HTTP basic auth header. Otherwise, Google uses the client ID and secret inside the post body. Only set when using OAuth. Make sure to provide a Terms of Service in the directory information in LocalizedSettings.terms_of_service_url section if specifying this field. |"]]
