ActionPackage

ActionPackage incluye el contenido del borrador de una app, así como de cada versión implementada. Esto incluye los detalles de la ficha del directorio, la configuración de las conversaciones y la vinculación de cuentas.

Representación JSON 
{
  "manifest": {
    object (Manifest)
  },
  "accountLinking": {
    object (AccountLinking)
  },
  "actions": [
    {
      object (Action)
    }
  ],
  "types": [
    {
      object (Type)
    }
  ],
  "conversations": {
    string: {
      object(ConversationFulfillment)
    },
    ...
  },
  "locale": string
}
Campos
manifest

object (Manifest)

Los detalles de la app Aquí es donde se guarda el listado del directorio y otra identificación de la app, como displayName.
accountLinking

object (AccountLinking)

Los detalles de la vinculación de cuentas en esta app.
actions[]

object (Action)

Lista de acciones que la app puede controlar.
types[]

object (Type)

Lista de tipos definidos por el desarrollador.
conversations

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

Asigna conversaciones que se pueden compartir en actions. Por ejemplo, consulta conversationName en Fulfillment.

Es un objeto que contiene una lista de pares "key": value. Ejemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
locale

string

Es la configuración regional de este paquete de acciones. Esto 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.

Manifiesto

El conjunto de metadatos de la app. El contenido de este mensaje se usa en varios contextos:

  1. Actions on Google en la página de la ficha del directorio de Google.
  2. Es la identificación única de una app para la invocación explícita (displayName).
  3. Contenido de otras partes de una ActionPackage (shortDescription se usa para mostrarse en AccountLinking, displayName se usa en actions para mostrar el nombre de la app a los usuarios).

Este mensaje es de solo lectura. Debes especificar los campos de este mensaje a través de la consola de acciones 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 (SurfaceRequirements)
  }
}
Campos
displayName

string

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). El nombre visible debe ser único y fonéticamente muy similar a invocationName.
invocationName

string

Este es el nombre único de esta app para invocarla directamente dentro de un contexto de voz (de voz). Las políticas requieren que el nombre de la invocación sea fonéticamente muy similar al campo displayName.
enabledRegions[]

string (int64 format)

ID de criterio de AdWords para las regiones donde la aplicación está permitida según la ubicación de presencia del usuario. Consulte https://developers.google.com/adwords/api/docs/appendix/geotargeting (en inglés).
disabledRegions[]

string (int64 format)

ID de criterio de AdWords para las regiones donde la aplicación está bloqueada según la ubicación de presencia del usuario Consulte https://developers.google.com/adwords/api/docs/appendix/geotargeting (en inglés).
shortDescription

string

La descripción breve predeterminada de la app (si no hay una traducción disponible). Tiene un límite de 80 caracteres.
longDescription

string

La descripción larga predeterminada de la app (si no hay una traducción disponible) Tiene un límite de 4,000 caracteres.
category

string

Es la categoría de la app. El valor debe ser una de las categorías permitidas para apps. Consulta las acciones en la consola de Google para conocer la lista de categorías permitidas.
smallSquareLogoUrl

string

Imagen cuadrada pequeña Las dimensiones deben ser de 192 px por 192 px.
largeLandscapeLogoUrl

string

Imagen horizontal grande. Las dimensiones deben ser de 2208 px por 1242 px.
companyName

string

El nombre de la empresa con la que está asociada la app.
contactEmail

string

La dirección de correo electrónico de contacto que permite a los usuarios comunicarse en relación con la Aplicación.
termsOfServiceUrl

string

La URL de las Condiciones del Servicio (Condiciones del Servicio) de la app
privacyUrl

string

La URL de la política de privacidad de la app.
sampleInvocation[]

string

Ejemplo de frase de invocación que se muestra como parte de la descripción de la app en el directorio de todas las apps Solo se pueden proporcionar 5 valores.
introduction

string

Resumen de lo que puede hacer una app. Se utiliza para la presentación de la aplicación ante los usuarios. Debe ser una frase verbal que complete una oración, como "Puedes usar esta app para..."
testingInstructions

string

Instrucciones de prueba en formato libre para el revisor de apps.
voiceName

string

El nombre de voz que se usará. Valores de ejemplo admitidos: male_1, male_2, female_1, female_2.
externalVoiceName

string

El nombre de la voz externa de este agente. No contiene información sobre la configuración regional.
voiceLocale

string

La configuración regional de la voz para este agente. Si se establece como una cadena vacía, se resolverá según la configuración regional del usuario durante el tiempo de ejecución.
surfaceRequirements

object (SurfaceRequirements)

Un conjunto de requisitos de la plataforma cliente del Asistente de Google que se deben cumplir para que se active la app.

SurfaceRequirements

Contiene un conjunto de requisitos de la plataforma del cliente que deben cumplirse para que se active el agente. Si no se cumple alguno de los requisitos que se indican aquí, no se activará el agente.

Representación JSON 
{
  "minimumCapabilities": [
    {
      object (Capability)
    }
  ]
}
Campos
minimumCapabilities[]

object (Capability)

El conjunto mínimo de capacidades necesarias para que funcione el agente. Si a la superficie le falta alguno de estos, no se activará el agente.

Función

Representa un requisito sobre la disponibilidad de una función determinada.

Representación JSON 
{
  "name": string
}
Campos
name

string

El nombre de la función, p.ej., actions.capability.AUDIO_OUTPUT

Tipo

Es un tipo al que se puede hacer referencia en una acción. Pueden ser tipos personalizados exclusivos de 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 (Entity)
    }
  ],
  "isUserDefined": boolean
}
Campos
name

string

Es el nombre del tipo personalizado, en el formato de type.
entities[]
(deprecated)

object (Entity)

Lista de entidades para este tipo. Cada uno incluye una clave y una lista de sinónimos.
isUserDefined

boolean

Si las entidades están definidas por el usuario (diferentes para cada usuario)

Entidad

Cada correspondencia de entidad 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

string

Clave única para este elemento.
synonyms[]

string

Lista de sinónimos que pueden usarse para hacer referencia a este elemento.