ActionPackage contiene el contenido del borrador de una app, además de cada versión implementada. Esto incluye los detalles de la ficha del directorio, la configuración de la conversación y la vinculación de cuentas.
Representación JSON | |
---|---|
{ "manifest": { object ( |
Campos | |
---|---|
manifest |
Los detalles de la app. Aquí es donde se guarda la lista del directorio y otras identificaciones de apps, como displayName. |
accountLinking |
Los detalles de la vinculación de cuentas en esta app. |
actions[] |
Lista de acciones que la app puede realizar. |
types[] |
Lista de tipos definidos por el desarrollador. |
conversations |
Conversaciones en el mapa que se pueden compartir en Es un objeto que contiene una lista de pares |
locale |
La configuración regional de este paquete de acciones. Se representa con cadenas de idioma BCP-47, como "en", "en-US", "fr", "fr-CA", "sr-Latn", "zh-Hans", "zh-Hans-CN", "zh-Hant", "zh-Hant-HK", etc. Esto es obligatorio cuando una app admite más de un idioma. Cada configuración regional compatible tiene su propio ActionPackage. Si no se proporciona un valor, se implicará la configuración regional predeterminada del agente. |
Manifest
El conjunto de metadatos para la app. El contenido de este mensaje se usa en varios contextos:
- acciones en la página de fichas del directorio de Google.
- Identificación única de una app para la invocación explícita (
displayName
). - Contenido de otras partes de una
ActionPackage
(shortDescription
se usa para mostrar enAccountLinking
,displayName
se usa enactions
para mostrar el nombre de la app a los usuarios).
Este mensaje es de solo lectura. Debes especificar los campos de este mensaje mediante la consola de Actions y no directamente en el paquete de acciones.
Representación 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 ( |
Campos | |
---|---|
displayName |
El nombre visible predeterminado de esta app (si no hay una traducción disponible), p.ej., "Starbucks". También se usa como método para que los usuarios invoquen esta app (además de |
invocationName |
Este es el nombre único de esta app para invocarla directamente en un contexto de voz (enunciado). Las políticas requieren que el nombre de la invocación sea fonéticamente muy similar al campo |
enabledRegions[] |
Los ID de criterio de AdWords para las regiones donde la aplicación está permitida en función de la ubicación de presencia del usuario. Consulte https://developers.google.com/adwords/api/docs/appendix/geotargeting. |
disabledRegions[] |
Los IDs de criterio de AdWords para las regiones donde la aplicación está bloqueada en función de la ubicación de presencia del usuario. Consulte https://developers.google.com/adwords/api/docs/appendix/geotargeting. |
shortDescription |
Es la descripción breve predeterminada de la app (si no hay una traducción disponible). con un límite de 80 caracteres. |
longDescription |
Es la descripción larga predeterminada para la app (si no hay una traducción disponible). con un límite de 4,000 caracteres. |
category |
Es la categoría de la app. El valor debe ser una de las categorías permitidas para las apps. Consulta las acciones en la consola de Google para conocer la lista de las categorías permitidas. |
smallSquareLogoUrl |
Imagen cuadrada pequeña. Las dimensiones deben ser de 192 píxeles por 192 píxeles. |
largeLandscapeLogoUrl |
Imagen horizontal grande. Las dimensiones deben ser de 2208 por 1242 píxeles. |
companyName |
El nombre de la empresa con la que está asociada la app. |
contactEmail |
Es la dirección de correo electrónico de contacto para permitir que los usuarios se comuniquen con respecto a la App. |
termsOfServiceUrl |
Es la URL de las Condiciones del Servicio (Condiciones del Servicio) de la App. |
privacyUrl |
La URL de la política de privacidad de la aplicación. |
sampleInvocation[] |
Ejemplo de frase de invocación que aparece como parte de la descripción de la app en el directorio de todas las apps Solo se pueden proporcionar 5 valores. |
introduction |
Resumen de lo que puede hacer una app. Se usa para presentación de la app a los usuarios. Debe ser una frase verbal que complete una oración como "Puedes usar esta app para..." |
testingInstructions |
Instrucciones de prueba de formato libre para el revisor de apps |
voiceName |
El nombre de voz que se usará. Valores de ejemplo admitidos: |
externalVoiceName |
El nombre de la voz externa de este agente. No contiene información sobre la configuración regional. |
voiceLocale |
La configuración regional de la voz de este agente. Si se configura como una string vacía, se resolverá según la configuración regional del usuario durante el tiempo de ejecución. |
surfaceRequirements |
Es un conjunto de requisitos para la plataforma del cliente de Asistente de Google que se debe cumplir para que se active la app. |
SurfaceRequirements
Contiene un conjunto de requisitos para la plataforma del cliente que debe cumplirse a fin de que se active el agente. Si no se cumple alguno de los requisitos mencionados aquí, no se activará el agente.
Representación JSON | |
---|---|
{
"minimumCapabilities": [
{
object ( |
Campos | |
---|---|
minimumCapabilities[] |
El conjunto mínimo de capacidades necesarias para que el agente funcione. Si a la plataforma le falta alguno de ellos, no se activará el agente. |
Capacidades
Representa un requisito sobre la disponibilidad de una capacidad determinada
Representación JSON | |
---|---|
{ "name": string } |
Campos | |
---|---|
name |
El nombre de la función, p.ej., actions.capability.AUDIO_OUTPUT |
Tipo
Un tipo al que se puede hacer referencia dentro de una Acción. Pueden ser tipos personalizados únicos para la acción o tipos comunes definidos por Google y a los que se hace referencia en la acción.
Representación JSON | |
---|---|
{
"name": string,
"entities": [
{
object ( |
Campos | |
---|---|
name |
Es el nombre del tipo personalizado, en el formato |
entities[] |
Es la lista de entidades para este tipo. Cada una incluye una clave y una lista de sinónimos. |
isUserDefined |
Indica si las entidades están definidas por el usuario (diferentes para cada usuario). |
Entidad
Cada Entity corresponde es única para este tipo. La clave debe ser única, y la lista de sinónimos se usa para la activación.
Representación JSON | |
---|---|
{ "key": string, "synonyms": [ string ] } |
Campos | |
---|---|
key |
Clave única para este elemento. |
synonyms[] |
Lista de sinónimos que se pueden usar para referirse a este elemento. |