ActionPackage

ActionPackage contiene i contenuti della bozza di un'app e di ogni versione di cui è stato eseguito il deployment. Sono inclusi i dettagli dell'elenco della directory, la configurazione delle conversazioni 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. Qui è memorizzata l'elenco della directory e altri dati di identificazione dell'app, ad esempio displayName.
accountLinking

object (AccountLinking)

I dettagli per il collegamento dell'account in questa app.
actions[]

object (Action)

Elenco delle 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

Impostazioni internazionali per questo pacchetto azioni. È rappresentato dalle 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ù lingue. Ogni impostazione internazionale supportata ha il proprio ActionPackage. Se non viene fornito un valore, verranno 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 relativi ad altre parti di ActionPackage (shortDescription viene utilizzato per la visualizzazione in AccountLinking, displayName viene utilizzato in actions per mostrare il nome dell'app agli utenti).

Questo messaggio è di sola lettura. Puoi specificare i campi in questo messaggio tramite la console azioni e non direttamente nel pacchetto 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 consentire agli utenti di 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 all'interno di un contesto vocale. I criteri richiedono che il nome di chiamata sia foneticamente molto simile al campo displayName.
enabledRegions[]

string (int64 format)

ID criterio AdWords per le regioni in cui l'app è consentita in base alla posizione di presenza dell'utente. Vedi https://developers.google.com/adwords/api/docs/appendix/geotargeting
disabledRegions[]

string (int64 format)

ID criterio Google Ads per le regioni in cui l'app è bloccata in base alla posizione di presenza dell'utente. Vedi https://developers.google.com/adwords/api/docs/appendix/geotargeting
shortDescription

string

La descrizione breve predefinita dell'app (se non è disponibile una traduzione). Il limite è di 80 caratteri.
longDescription

string

La descrizione lunga predefinita dell'app (se non è disponibile una traduzione). Il limite è di 4000 caratteri.
category

string

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

string

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

string

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

string

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

string

L'indirizzo email di contatto a cui gli utenti possono contattare 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

Esempio di frase di chiamata visualizzata come parte della descrizione dell'app nella directory di tutte le app. È possibile indicare solo 5 valori.
introduction

string

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

string

Istruzioni per il 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 dell'agente. Non contiene informazioni sulle impostazioni internazionali.
voiceLocale

string

Le impostazioni internazionali della voce dell'agente. Se impostato su una stringa vuota, verrà risolto nelle impostazioni internazionali dell'utente al momento dell'esecuzione.
surfaceRequirements

object (SurfaceRequirements)

Un insieme di requisiti per la piattaforma client dell'Assistente Google che devono essere soddisfatti affinché l'app venga attivata.

SurfaceRequirements

Contiene un insieme di requisiti che la piattaforma client deve soddisfare affinché venga attivato l'agente. Se uno o più requisiti elencati qui non vengono soddisfatti, l'agente non verrà attivato.

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

object (Capability)

L'insieme minimo di funzionalità necessarie per il funzionamento dell'agente. Se nella piattaforma manca uno di questi elementi, 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 è possibile fare riferimento all'interno di un'Azione. Può trattarsi di tipi personalizzati univoci 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

nome 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 (diversa per ogni utente).

Entità

Ogni corrispondenza di entità è 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.