- Représentation JSON
- Utilisateur
<ph type="x-smartling-placeholder">
- </ph>
- Représentation JSON
- UserProfile
<ph type="x-smartling-placeholder">
- </ph>
- Représentation JSON
- PackageEntitlement
<ph type="x-smartling-placeholder">
- </ph>
- Représentation JSON
- Droit d'accès
<ph type="x-smartling-placeholder">
- </ph>
- Représentation JSON
- SignedData
<ph type="x-smartling-placeholder">
- </ph>
- Représentation JSON
- Appareil
<ph type="x-smartling-placeholder">
- </ph>
- Représentation JSON
- Surface
<ph type="x-smartling-placeholder">
- </ph>
- Représentation JSON
- Capacité
- Conversation
<ph type="x-smartling-placeholder">
- </ph>
- Représentation JSON
- Entrée
<ph type="x-smartling-placeholder">
- </ph>
- Représentation JSON
- RawInput
<ph type="x-smartling-placeholder">
- </ph>
- Représentation JSON
AppRequest est une requête envoyée par l'Assistant Google à un traitement afin d'interagir avec une action. La version de l'API est spécifiée dans l'en-tête HTTP. Pour la version 1 de l'API, l'en-tête contient: Google-Assistant-API-Version: v1
. Pour la version 2 de l'API, l'en-tête contient: Google-actions-API-Version: 2
. Pour voir des exemples d'utilisation dans les actions sur Google, consultez https://developers.google.com/assistant/df-asdk/reference/conversation-webhook-json .
Représentation JSON | |
---|---|
{ "user": { object ( |
Champs | |
---|---|
user |
Utilisateur ayant initié la conversation. |
device |
Informations sur l'appareil utilisé par l'utilisateur pour interagir avec l'action. |
surface |
Les informations sur la surface avec laquelle l'utilisateur interagit, par exemple s'il dispose d'un écran ou d'une sortie audio. |
conversation |
Contient les données de session telles que l'ID et le jeton de conversation. |
inputs[] |
Liste des entrées correspondant aux entrées attendues spécifiées par l'action. Pour le déclencheur de conversation initial, l'entrée contient des informations sur la manière dont l'utilisateur a déclenché la conversation. |
isInSandbox |
Indique si la requête doit être traitée en mode bac à sable. |
availableSurfaces[] |
Surfaces disponibles pour un transfert de surface transversale. |
Utilisateur
Représentation JSON | |
---|---|
{ "idToken": string, "profile": { object ( |
Champs | |
---|---|
idToken |
qui représente l'identité de l'utilisateur. Il s'agit d'un jeton Web JSON comprenant un profil encodé. La définition est disponible à l'adresse https://developers.google.com/identity/protocols/OpenIDConnect#obtainuserinfo. |
profile |
Informations sur l'utilisateur final. Certains champs ne sont disponibles que si l'utilisateur a autorisé l'envoi de ces informations à l'action. |
accessToken |
Un jeton OAuth2 qui identifie l'utilisateur dans votre système. Disponible uniquement si l'utilisateur associe son compte. |
permissions[] |
Contient les autorisations accordées par l'utilisateur à cette action. |
locale |
Paramètre régional principal de l'utilisateur à l'origine de la requête. Suit le code de langue IETF BCP-47 http://www.rfc-editor.org/rfc/bcp/bcp47.txt. Le sous-tag de script n'est toutefois pas inclus. |
lastSeen |
Code temporel de la dernière interaction avec cet utilisateur. Ce champ sera omis si l'utilisateur n'a jamais interagi avec l'agent auparavant. Horodatage au format RFC3339 UTC "Zulu", précis à la nanoseconde près. Exemple : |
userStorage |
Jeton opaque fourni par l'application et conservé dans les conversations d'un utilisateur particulier. La taille maximale de la chaîne est de 10 000 caractères. |
packageEntitlements[] |
Liste des droits d'accès des utilisateurs pour chaque nom de package répertorié dans le package Action, le cas échéant. |
userVerificationStatus |
Indique l'état de validation de l'utilisateur. |
UserProfile
Contient les informations personnelles de l'utilisateur. Les champs ne sont renseignés que si l'utilisateur accorde l'autorisation à l'action pour un champ particulier.
Représentation JSON | |
---|---|
{ "displayName": string, "givenName": string, "familyName": string } |
Champs | |
---|---|
displayName |
Nom complet de l'utilisateur (tel que spécifié dans son compte Google) Nécessite l'autorisation |
givenName |
Prénom de l'utilisateur (tel qu'indiqué dans le compte Google) Nécessite l'autorisation |
familyName |
Nom de famille de l'utilisateur (tel que spécifié dans le compte Google) Notez que ce champ peut être vide. Nécessite l'autorisation |
PackageEntitlement
Liste des droits d'accès associés à un nom de package
Représentation JSON | |
---|---|
{
"packageName": string,
"entitlements": [
{
object ( |
Champs | |
---|---|
packageName |
Doit correspondre au nom du package d'actions |
entitlements[] |
Liste des droits d'accès pour une application donnée |
Droit d'accès
Définit les droits d'accès numériques d'un utilisateur. Types de droits possibles: achats via une application ou abonnements via une application.
Représentation JSON | |
---|---|
{ "sku": string, "skuType": enum ( |
Champs | |
---|---|
sku |
SKU du produit Nom du package de l'application payante, suffixe de Finsky Docid pour les achats et les abonnements via l'application. Mise en correspondance de getSku() dans l'API Play InApp Billing. |
skuType |
|
inAppDetails |
Présent uniquement pour les achats via l'application et les abonnements via l'application. |
SignedData
Représentation JSON | |
---|---|
{ "inAppPurchaseData": { object }, "inAppDataSignature": string } |
Champs | |
---|---|
inAppPurchaseData |
Recherche une correspondance entre INAPP_PURCHASE_DATA et la méthode getPurchases(). Contient toutes les données d'achat via une application au format JSON. Pour en savoir plus, consultez le tableau 6 de la page https://developer.android.com/google/play/billing/billing_reference.html. |
inAppDataSignature |
Correspond à IN_APP_DATA_SIGNATURE de la méthode getPurchases() de l'API Play InApp Billing. |
Appareil
Informations sur l'appareil utilisé par l'utilisateur pour interagir avec l'action.
Représentation JSON | |
---|---|
{
"location": {
object ( |
Champs | |
---|---|
location |
Représente la position réelle de l'appareil, telle que la latitude, la longitude et l'adresse formatée. Nécessite l'autorisation |
Surface
Informations spécifiques à la surface client de l'Assistant Google avec laquelle l'utilisateur interagit. La surface se distingue de l'appareil par le fait que plusieurs surfaces de l'Assistant peuvent être installées sur le même appareil.
Représentation JSON | |
---|---|
{
"capabilities": [
{
object ( |
Champs | |
---|---|
capabilities[] |
Liste des fonctionnalités prises en charge par la surface au moment de la requête (par exemple, |
Capacité
Représente une unité de fonctionnalité que la surface peut prendre en charge.
Représentation JSON | |
---|---|
{ "name": string } |
Champs | |
---|---|
name |
Nom de la capacité (par exemple, |
Conversation
Représentation JSON | |
---|---|
{
"conversationId": string,
"type": enum ( |
Champs | |
---|---|
conversationId |
ID unique de la conversation multitours. Il s'agit du premier tour. Passé ce délai, il reste inchangé pour les conversations suivantes, jusqu'à ce que la conversation soit terminée. |
type |
indique l'état de la conversation dans son cycle de vie. |
conversationToken |
Jeton opaque spécifié par l'action lors du dernier tour de conversation. Il peut être utilisé par une action pour suivre la conversation ou pour stocker des données liées à la conversation. |
Entrée
Représentation JSON | |
---|---|
{ "rawInputs": [ { object ( |
Champs | |
---|---|
rawInputs[] |
Transcription de l'entrée brute de chaque tour de conversation. Plusieurs tours de conversation peuvent être nécessaires pour que les actions sur Google fournissent certains types d'informations à l'action. |
intent |
Indique l'intention de l'utilisateur. Lors du premier tour de conversation, l'intent fait référence à l'intent déclencheur de l'action. Pour les tours de conversation suivants, l'intent sera une action courante sur l'intent Google (commençant par "actions"). Par exemple, si l'entrée attendue est |
arguments[] |
Liste des valeurs d'argument fournies pour l'entrée demandée par l'action. |
RawInput
Représentation JSON | |
---|---|
{ "inputType": enum ( |
Champs | ||
---|---|---|
inputType |
Indique la manière dont l'utilisateur a fourni cette entrée: réponse saisie, réponse vocale, non spécifié, etc. |
|
Champ d'union input . La valeur d'entrée réelle input ne peut être que l'une des valeurs suivantes: |
||
query |
Entrée saisie ou vocale de l'utilisateur final. |
|
url |
URL de déclenchement. |