ActionPackage

ActionPackage contient le contenu du brouillon d'une application ainsi que de chaque version déployée. Cela inclut les détails de la liste de l'annuaire, la configuration des conversations et l'association de comptes.

Représentation JSON
{
  "manifest": {
    object (Manifest)
  },
  "accountLinking": {
    object (AccountLinking)
  },
  "actions": [
    {
      object (Action)
    }
  ],
  "types": [
    {
      object (Type)
    }
  ],
  "conversations": {
    string: {
      object(ConversationFulfillment)
    },
    ...
  },
  "locale": string
}
Champs
manifest

object (Manifest)

Détails de l'application. C'est ici que le répertoire est conservé, ainsi que d'autres informations permettant d'identifier l'application, comme displayName.

accountLinking

object (AccountLinking)

Détails de l'association de compte dans cette application.

actions[]

object (Action)

Liste des actions que l'application peut gérer.

types[]

object (Type)

Liste des types définis par le développeur.

conversations

map (key: string, value: object (ConversationFulfillment))

Mappez les conversations qui peuvent être partagées sur actions. Par exemple, consultez l'élément conversationName dans Fulfillment.

Objet contenant une liste de paires "key": value. Exemple : { "name": "wrench", "mass": "1.3kg", "count": "3" }.

locale

string

Paramètres régionaux de ce package d'actions. Il est représenté par des chaînes de langue BCP-47, telles que "en", "en-US", "fr", "fr-CA", "sr-Latn", "zh-Hans", "zh-Hans-CN", "zh-Hant", "zh-Hant-HK", etc. Vous devez obligatoirement cocher cette case lorsqu'une application prend en charge plusieurs langues. Chaque paramètre régional pris en charge possède son propre ActionPackage. Si aucune valeur n'est fournie, les paramètres régionaux par défaut de l'agent seront implicites.

Manifest

Ensemble de métadonnées pour l'application. Le contenu de ce message est utilisé dans plusieurs contextes:

  1. sur la fiche de l'annuaire Google.
  2. Identification unique d'une application pour un appel explicite (displayName)
  3. Contenu des autres parties d'un ActionPackage (shortDescription est utilisé pour l'affichage dans AccountLinking, displayName est utilisé dans actions pour montrer le nom de l'application aux utilisateurs).

Ce message est en lecture seule. Vous spécifiez les champs de ce message via la console d'actions, et non directement dans le package d'actions.

Représentation JSON
{
  "displayName": string,
  "invocationName": string,
  "enabledRegions": [
    string
  ],
  "disabledRegions": [
    string
  ],
  "shortDescription": string,
  "longDescription": string,
  "category": string,
  "smallSquareLogoUrl": string,
  "largeLandscapeLogoUrl": string,
  "companyName": string,
  "contactEmail": string,
  "termsOfServiceUrl": string,
  "privacyUrl": string,
  "sampleInvocation": [
    string
  ],
  "introduction": string,
  "testingInstructions": string,
  "voiceName": string,
  "externalVoiceName": string,
  "voiceLocale": string,
  "surfaceRequirements": {
    object (SurfaceRequirements)
  }
}
Champs
displayName

string

Nom à afficher par défaut pour cette application (si aucune traduction n'est disponible), par exemple "Starbucks". Cette méthode permet également aux utilisateurs d'appeler cette application (en plus de invocationName). Le nom à afficher doit être unique et phonétiquement très semblable à invocationName.

invocationName

string

Il s'agit du nom unique qui permet à cette application de l'appeler directement dans un contexte vocal. Les règles exigent que le nom d'appel soit phonétiquement très semblable au champ displayName.

enabledRegions[]

string (int64 format)

ID de critère AdWords pour les régions où l'application est autorisée, en fonction de la localisation de l'utilisateur. Consultez la page https://developers.google.com/adwords/api/docs/appendix/geotargeting.

disabledRegions[]

string (int64 format)

ID de critère AdWords pour les régions où l'application est bloquée en fonction de la présence géographique de l'utilisateur. Consultez la page https://developers.google.com/adwords/api/docs/appendix/geotargeting.

shortDescription

string

Brève description par défaut de l'application (si aucune traduction n'est disponible). Ce champ est limité à 80 caractères.

longDescription

string

Description longue par défaut de l'application (si aucune traduction n'est disponible). Ce champ est limité à 4 000 caractères.

category

string

Catégorie de l'application. Elle doit correspondre à l'une des catégories autorisées pour les applications. Consultez les actions disponibles dans la console Google pour consulter la liste des catégories autorisées.

smallSquareLogoUrl

string

Petite image carrée. Les dimensions doivent être de 192 x 192 pixels.

largeLandscapeLogoUrl

string

Grande image en mode paysage. Les dimensions doivent être de 2 208 x 1 242 pixels.

companyName

string

Nom de l'entreprise à laquelle l'application est associée.

contactEmail

string

Adresse e-mail permettant aux utilisateurs de vous contacter au sujet de l'application.

termsOfServiceUrl

string

URL des conditions d'utilisation de l'application.

privacyUrl

string

URL des règles de confidentialité de l'application.

sampleInvocation[]

string

Exemple d'appel affiché dans la description de l'application dans le répertoire de toutes les applications Vous ne pouvez indiquer que cinq valeurs.

introduction

string

Résumé des fonctionnalités d'une application. Utilisé pour la présentation de l'application aux utilisateurs. Il doit s'agir d'une phrase verbale qui termine une phrase comme "Vous pouvez utiliser cette appli pour..."

testingInstructions

string

Instructions concernant les tests de format libre pour l'examinateur de l'application.

voiceName

string

Nom de la voix à utiliser. Exemples de valeurs acceptées: male_1, male_2, female_1, female_2.

externalVoiceName

string

Nom de la voix externe pour cet agent. Ne contient pas d'informations sur les paramètres régionaux.

voiceLocale

string

Paramètres régionaux de la voix pour cet agent. S'il est défini sur une chaîne vide, il sera résolu en fonction des paramètres régionaux de l'utilisateur au moment de l'exécution.

surfaceRequirements

object (SurfaceRequirements)

Ensemble d'exigences pour la surface client Assistant Google qui doivent être remplies pour que l'appli soit déclenchée.

SurfaceRequirements

Contient un ensemble d'exigences pour la surface client qui doivent être remplies pour que l'agent soit déclenché. Si l'une des conditions listées ici n'est pas remplie, l'agent ne se déclenche pas.

Représentation JSON
{
  "minimumCapabilities": [
    {
      object (Capability)
    }
  ]
}
Champs
minimumCapabilities[]

object (Capability)

Ensemble minimal de fonctionnalités nécessaires au fonctionnement de l'agent. S'il manque l'un de ces éléments sur la surface, l'agent ne se déclenchera pas.

Capacité

Représente une exigence concernant la disponibilité d'une capacité donnée

Représentation JSON
{
  "name": string
}
Champs
name

string

Nom de la capacité (par exemple, actions.capability.AUDIO_OUTPUT).

Type

Type pouvant être référencé dans une action. Il peut s'agir de types personnalisés propres à l'action ou de types courants définis par Google et référencés dans l'action.

Représentation JSON
{
  "name": string,
  "entities": [
    {
      object (Entity)
    }
  ],
  "isUserDefined": boolean
}
Champs
name

string

le nom du type personnalisé, au format type.

entities[]
(deprecated)

object (Entity)

Liste des entités de ce type. Chacun d'entre eux comprend une clé et une liste de synonymes.

isUserDefined

boolean

Indique si les entités sont définies par l'utilisateur (différentes pour chaque utilisateur).

Entité

Chaque entité Entity correspond à ce type. La clé doit être unique et la liste de synonymes sera utilisée pour le déclenchement.

Représentation JSON
{
  "key": string,
  "synonyms": [
    string
  ]
}
Champs
key

string

Clé unique pour cet élément.

synonyms[]

string

Liste de synonymes pouvant être utilisés pour faire référence à cet élément.