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 ( |
Campi | |
---|---|
manifest |
I dettagli dell'app. Qui è memorizzata l'elenco della directory e altri dati di identificazione dell'app, ad esempio displayName. |
accountLinking |
I dettagli per il collegamento dell'account in questa app. |
actions[] |
Elenco delle azioni che l'app è in grado di gestire. |
types[] |
Elenco dei tipi definiti dallo sviluppatore. |
conversations |
Mappa le conversazioni che possono essere condivise tra Un oggetto contenente un elenco di |
locale |
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:
- azioni nella pagina di elenco della directory Google.
- Identificazione univoca di un'app per la chiamata esplicita (
displayName
). - Contenuti relativi ad altre parti di
ActionPackage
(shortDescription
viene utilizzato per la visualizzazione inAccountLinking
,displayName
viene utilizzato inactions
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 ( |
Campi | |
---|---|
displayName |
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 |
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 |
enabledRegions[] |
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[] |
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 |
La descrizione breve predefinita dell'app (se non è disponibile una traduzione). Il limite è di 80 caratteri. |
longDescription |
La descrizione lunga predefinita dell'app (se non è disponibile una traduzione). Il limite è di 4000 caratteri. |
category |
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 |
Immagine quadrata piccola. Le dimensioni devono essere 192 x 192 px. |
largeLandscapeLogoUrl |
Immagine orizzontale grande. Le dimensioni devono essere 2208 x 1242 px. |
companyName |
Il nome dell'azienda a cui è associata l'app. |
contactEmail |
L'indirizzo email di contatto a cui gli utenti possono contattare in merito all'App. |
termsOfServiceUrl |
L'URL dei TdS (Termini di servizio) dell'app. |
privacyUrl |
L'URL delle norme sulla privacy dell'app. |
sampleInvocation[] |
Esempio di frase di chiamata visualizzata come parte della descrizione dell'app nella directory di tutte le app. È possibile indicare solo 5 valori. |
introduction |
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 |
Istruzioni per il test in formato libero per il revisore dell'app. |
voiceName |
Il nome della voce da utilizzare. Valori di esempio supportati: |
externalVoiceName |
Il nome della voce esterna dell'agente. Non contiene informazioni sulle impostazioni internazionali. |
voiceLocale |
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 |
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 ( |
Campi | |
---|---|
minimumCapabilities[] |
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 |
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 ( |
Campi | |
---|---|
name |
nome del tipo personalizzato nel formato |
entities[] |
Elenco di entità per questo tipo. Ciascuno include una chiave e un elenco di sinonimi. |
isUserDefined |
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 |
Chiave univoca per questo elemento. |
synonyms[] |
Elenco di sinonimi che possono essere utilizzati per fare riferimento a questo elemento. |