ActionPackage

ActionPackage include i contenuti della bozza di un'app e di ogni versione di cui è stato eseguito il deployment. Ciò include i dettagli dell'elenco delle directory, la configurazione della conversazione e il collegamento dell'account.

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

object (Manifest)

I dettagli dell'app. Questa è la posizione in cui viene conservato l'elenco di directory e altri elementi di identificazione dell'app come displayName.
accountLinking

object (AccountLinking)

I dettagli per il collegamento dell'account su questa App.
actions[]

object (Action)

Elenco di azioni che l'app è in grado di gestire.
types[]

object (Type)

Elenco dei tipi definiti dallo sviluppatore.
conversations

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

Mappa le conversazioni che possono essere condivise tra actions. Ad esempio, vedi conversationName in Fulfillment.

Un oggetto contenente un elenco di "key": value coppie. Esempio: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
locale

string

Le impostazioni internazionali di questo pacchetto di azioni. È rappresentato da stringhe di lingua BCP-47, ad esempio "en", "en-US", "fr", "fr-CA", "sr-Latn", "zh-Hans", "zh-Hans-CN", "zh-Hant", "zh-Hant-HK" e così via. È necessaria quando un'app supporta più di una lingua. Ogni lingua supportata ha un proprio ActionPackage. Se non viene fornito un valore, saranno implicite le impostazioni internazionali predefinite dell'agente.

Manifest

L'insieme di metadati per l'app. I contenuti di questo messaggio vengono utilizzati in più contesti:

  1. azioni nella pagina di elenco della directory Google.
  2. Identificazione univoca di un'app per la chiamata esplicita (displayName).
  3. Contenuti per altre parti di un ActionPackage (shortDescription è utilizzato per la visualizzazione in AccountLinking, displayName è utilizzato in actions per mostrare il nome dell'app agli utenti).

Questo messaggio è di sola lettura. Devi specificare i campi in questo messaggio tramite la console delle azioni e non direttamente nel pacchetto delle azioni.

Rappresentazione 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)
  }
}
Campi
displayName

string

Il nome visualizzato predefinito per questa app (se non è disponibile una traduzione), ad esempio "Starbucks". Viene utilizzato anche come metodo per richiamare questa app (oltre a invocationName). Il nome visualizzato deve essere univoco e foneticamente molto simile a invocationName.
invocationName

string

Si tratta del nome univoco dell'app per richiamarla direttamente in un contesto vocale (vocale). I criteri richiedono che il nome di chiamata sia foneticamente molto simile al campo displayName.
enabledRegions[]

string (int64 format)

Gli ID criterio Google Ads per le regioni in cui l'app è consentita, in base alla località di presenza dell'utente. Consulta la pagina https://developers.google.com/adwords/api/docs/appendix/geotargeting
disabledRegions[]

string (int64 format)

Gli ID criterio Google Ads per le regioni in cui l'app è bloccata, in base alla località di presenza dell'utente. Consulta la pagina https://developers.google.com/adwords/api/docs/appendix/geotargeting
shortDescription

string

La descrizione breve predefinita dell'app (se non è disponibile una traduzione). Può contenere un massimo di 80 caratteri.
longDescription

string

La descrizione lunga predefinita dell'app (se non è disponibile una traduzione). Questo campo è limitato a 4000 caratteri.
category

string

La categoria dell'app. Il valore deve essere una delle categorie consentite per le app. Controlla le azioni nella console Google per consultare l'elenco delle categorie consentite.
smallSquareLogoUrl

string

Immagine quadrata piccola. Le dimensioni devono essere 192 x 192 px.
largeLandscapeLogoUrl

string

Immagine orizzontale di grandi dimensioni. Le dimensioni devono essere di 2208 x 1242 px.
companyName

string

Il nome dell'azienda a cui è associata l'app.
contactEmail

string

L'indirizzo email di contatto per consentire agli utenti di contattarti in merito all'App.
termsOfServiceUrl

string

L'URL dei TdS (Termini di servizio) dell'App.
privacyUrl

string

L'URL delle norme sulla privacy dell'app.
sampleInvocation[]

string

Frase di chiamata di esempio visualizzata come parte della descrizione dell'app nella directory di tutte le app. È possibile specificare solo 5 valori.
introduction

string

Riepilogo di ciò che un'app può fare. Utilizzato per la presentazione dell'app agli utenti. Deve essere una frase verbale che completa una frase come "Puoi usare questa app per..."
testingInstructions

string

Istruzioni per i test in formato libero per il revisore dell'app.
voiceName

string

Il nome della voce da utilizzare. Valori di esempio supportati: male_1, male_2, female_1, female_2.
externalVoiceName

string

Il nome della voce esterna per questo agente. Non contiene informazioni sulle impostazioni internazionali.
voiceLocale

string

Le impostazioni internazionali della voce per questo agente. Se impostata su una stringa vuota, verrà risolta nelle impostazioni internazionali dell'utente al momento dell'attivazione.
surfaceRequirements

object (SurfaceRequirements)

Un insieme di requisiti per la piattaforma client dell'Assistente Google che devono essere soddisfatti per poter attivare l'app.

SurfaceRequirements

Contiene un set di requisiti per la piattaforma client che devono essere soddisfatti affinché l'agente venga attivato. Se uno o più requisiti qui elencati non sono soddisfatti, l'agente non verrà attivato.

Rappresentazione JSON 
{
  "minimumCapabilities": [
    {
      object (Capability)
    }
  ]
}
Campi
minimumCapabilities[]

object (Capability)

L'insieme minimo di capacità necessarie al funzionamento dell'agente. Se nella piattaforma manca uno di questi, l'agente non verrà attivato.

Capacità

Rappresenta un requisito relativo alla disponibilità di una determinata funzionalità

Rappresentazione JSON 
{
  "name": string
}
Campi
name

string

Il nome della funzionalità, ad esempio actions.capability.AUDIO_OUTPUT

Tipo

Un tipo a cui si può fare riferimento in un'azione. Possono essere tipi personalizzati unici per l'azione o tipi comuni definiti da Google e a cui viene fatto riferimento all'interno dell'azione.

Rappresentazione JSON 
{
  "name": string,
  "entities": [
    {
      object (Entity)
    }
  ],
  "isUserDefined": boolean
}
Campi
name

string

del tipo personalizzato, nel formato type.
entities[]
(deprecated)

object (Entity)

Elenco di entità per questo tipo. Ciascuno include una chiave e un elenco di sinonimi.
isUserDefined

boolean

Indica se le entità sono definite dall'utente (diverse per ogni utente).

Entità

Ogni entità corrispondente è univoca per questo tipo. La chiave deve essere univoca e l'elenco di sinonimi deve essere utilizzato per l'attivazione.

Rappresentazione JSON 
{
  "key": string,
  "synonyms": [
    string
  ]
}
Campi
key

string

Chiave univoca per questo elemento.
synonyms[]

string

Elenco di sinonimi che possono essere utilizzati per fare riferimento a questo elemento.