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 ( |
Champs | |
---|---|
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 |
Détails de l'association de compte dans cette application. |
actions[] |
Liste des actions que l'application peut gérer. |
types[] |
Liste des types définis par le développeur. |
conversations |
Mappez les conversations qui peuvent être partagées sur Objet contenant une liste de paires |
locale |
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:
- sur la fiche de l'annuaire Google.
- Identification unique d'une application pour un appel explicite (
displayName
) - Contenu des autres parties d'un
ActionPackage
(shortDescription
est utilisé pour l'affichage dansAccountLinking
,displayName
est utilisé dansactions
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 ( |
Champs | |
---|---|
displayName |
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 |
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 |
enabledRegions[] |
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[] |
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 |
Brève description par défaut de l'application (si aucune traduction n'est disponible). Ce champ est limité à 80 caractères. |
longDescription |
Description longue par défaut de l'application (si aucune traduction n'est disponible). Ce champ est limité à 4 000 caractères. |
category |
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 |
Petite image carrée. Les dimensions doivent être de 192 x 192 pixels. |
largeLandscapeLogoUrl |
Grande image en mode paysage. Les dimensions doivent être de 2 208 x 1 242 pixels. |
companyName |
Nom de l'entreprise à laquelle l'application est associée. |
contactEmail |
Adresse e-mail permettant aux utilisateurs de vous contacter au sujet de l'application. |
termsOfServiceUrl |
URL des conditions d'utilisation de l'application. |
privacyUrl |
URL des règles de confidentialité de l'application. |
sampleInvocation[] |
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 |
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 |
Instructions concernant les tests de format libre pour l'examinateur de l'application. |
voiceName |
Nom de la voix à utiliser. Exemples de valeurs acceptées: |
externalVoiceName |
Nom de la voix externe pour cet agent. Ne contient pas d'informations sur les paramètres régionaux. |
voiceLocale |
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 |
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 ( |
Champs | |
---|---|
minimumCapabilities[] |
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 |
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 ( |
Champs | |
---|---|
name |
le nom du type personnalisé, au format |
entities[] |
Liste des entités de ce type. Chacun d'entre eux comprend une clé et une liste de synonymes. |
isUserDefined |
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 |
Clé unique pour cet élément. |
synonyms[] |
Liste de synonymes pouvant être utilisés pour faire référence à cet élément. |