ActionPackage

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 (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 la lista del directorio y otras identificaciones de apps, 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 realizar.

types[]

object (Type)

Lista de tipos definidos por el desarrollador.

conversations

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

Conversaciones en el mapa 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

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:

  1. acciones en la página de fichas del directorio de Google.
  2. 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 mostrar 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 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 (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 en un contexto de voz (enunciado). Las políticas requieren que el nombre de la invocación sea fonéticamente muy similar al campo displayName.

enabledRegions[]

string (int64 format)

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[]

string (int64 format)

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

string

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

longDescription

string

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

string

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

string

Imagen cuadrada pequeña. Las dimensiones deben ser de 192 píxeles por 192 píxeles.

largeLandscapeLogoUrl

string

Imagen horizontal grande. Las dimensiones deben ser de 2208 por 1242 píxeles.

companyName

string

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

contactEmail

string

Es la dirección de correo electrónico de contacto para permitir que los usuarios se comuniquen con respecto a la App.

termsOfServiceUrl

string

Es 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 aplicación.

sampleInvocation[]

string

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

string

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

string

Instrucciones de prueba de 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 y 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 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

object (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 (Capability)
    }
  ]
}
Campos
minimumCapabilities[]

object (Capability)

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

string

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 (Entity)
    }
  ],
  "isUserDefined": boolean
}
Campos
name

string

Es el nombre del tipo personalizado, en el formato type.

entities[]
(deprecated)

object (Entity)

Es la lista de entidades para este tipo. Cada una incluye una clave y una lista de sinónimos.

isUserDefined

boolean

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

string

Clave única para este elemento.

synonyms[]

string

Lista de sinónimos que se pueden usar para referirse a este elemento.