- Richiesta HTTP
- Corpo della richiesta
- Corpo della risposta
- Gestore
- Intenzione
- IntentParameterValue
- Scena
- SlotFillingStatus
- Slot
- SlotMode
- SlotStatus
- Prompt
- Semplice
- Contenuti
- Carta
- Immagine
- ImageFill
- Collega
- OpenUrl
- UrlHint
- Tabella
- TableColumn
- HorizontalAlignment
- TableRow
- TableCell
- Contenuti multimediali
- MediaType
- OptionalMediaControls
- MediaObject
- MediaImage
- RepeatMode
- Raccolta
- CollectionItem
- Elenco
- ListItem
- CollectionBrowse
- Articolo
- Suggerimento
- Tela
- ContinuousMatchConfig
- ExpectedPhrase
- OrderUpdate
- Tipo
- Ordine
- Informazioni utente
- PhoneNumber
- Immagine
- Commerciante
- Località
- LatLng
- PostalAddress
- Sommario
- LineItem
- PriceAttribute
- Tipo
- Stato
- Denaro
- Azione
- Tipo
- OpenUrlAction
- AndroidApp
- VersionFilter
- UrlTypeHint
- ActionMetadata
- Divulgazione
- DisclosureText
- TextLink
- DisclosurePresentationOptions
- PresentationRequirement
- PurchaseItemExtension
- PurchaseStatus
- PurchaseType
- MerchantUnitMeasure
- Unità
- PurchaseReturnsInfo
- PurchaseFulfillmentInfo
- Tipo
- Ora
- PickupInfo
- PickupType
- CurbsideInfo
- CurbsideFulfillmentType
- Veicolo
- CheckInInfo
- CheckInType
- ItemOption
- ProductDetails
- ReservationItemExtension
- ReservationStatus
- ReservationType
- StaffFacilitator
- PaymentData
- PaymentResult
- PaymentInfo
- PaymentMethodDisplayInfo
- PaymentType
- PaymentMethodProvenance
- Promozione
- PurchaseOrderExtension
- PurchaseLocationType
- PurchaseError
- ErrorType
- TicketOrderExtension
- TicketEvent
- Tipo
- EventCharacter
- Tipo
- UserNotification
- NextScene
- Sessione
- TypeOverride
- TypeOverrideMode
- SynonymType
- Voce
- EntryDisplay
- Utente
- AccountLinkingStatus
- UserVerificationStatus
- Coinvolgimento
- IntentSubscription
- PackageEntitlements
- Diritto
- SkuType
- SignedData
- Autorizzazione
- Home page
- Dispositivo
- Capacità
- Località
- TimeZone
- Contesto
- MediaContext
- CanvasContext
- Prevista
RPC, che rappresenta l'API fulfillment
Richiesta HTTP
POST https://webhook_handler_service.googleapis.com/fulfill
L'URL utilizza la sintassi di transcodifica gRPC.
Corpo della richiesta
Il corpo della richiesta contiene dati con la seguente struttura:
Rappresentazione JSON | |
---|---|
{ "handler": { object ( |
Campi | |
---|---|
handler |
Obbligatorio. Informazioni da completare su come gestire la richiesta. Ad esempio, una richiesta con l'intenzione di ottenere un fatto potrebbe avere un gestore con il nome "getFact". |
intent |
Obbligatorio. Rappresenta l'ultimo intent corrispondente. Vedi https://developers.google.com/assistant/conversational/intents. |
scene |
(Facoltativo) Informazioni sulla scena corrente e su quella successiva in cui è stata chiamata la funzione. Il campo verrà compilato quando la chiamata di completamento viene effettuata nell'ambito di una scena. Visita la pagina https://developers.google.com/assistant/conversational/scenes. |
session |
Obbligatorio. Contiene i dati della sessione, come l'ID e i parametri della sessione. |
user |
Obbligatorio. Utente che ha avviato la conversazione. |
home |
(Facoltativo) Informazioni relative alla struttura di Home Graph a cui appartiene il dispositivo di destinazione. Consulta la pagina https://developers.google.com/actions/smarthome/concepts/homegraph. |
device |
Obbligatorio. Informazioni sul dispositivo utilizzato dall'utente per interagire con l'Azione. |
context |
(Facoltativo) Informazioni sul contesto attuale della richiesta. Sono incluse, a titolo esemplificativo, le informazioni sulle sessioni multimediali attive o sulle canvas. |
Corpo della risposta
In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:
Rappresenta una risposta inviata dal fulfillment di uno sviluppatore ad Actions on Google.
Rappresentazione JSON | |
---|---|
{ "prompt": { object ( |
Campi | |
---|---|
prompt |
(Facoltativo) Rappresenta le richieste da inviare all'utente, che verranno aggiunte ai messaggi aggiunti in precedenza, a meno che non vengano sovrascritte esplicitamente. |
scene |
(Facoltativo) Rappresenta la scena attuale e quella successiva. Se il criterio |
session |
(Facoltativo) Descrive i dati della sessione corrente. I parametri della sessione possono essere creati, aggiornati o rimossi dal fulfillment. |
user |
(Facoltativo) Utilizzalo per specificare i parametri utente da restituire. |
home |
(Facoltativo) Utilizzato per specificare i parametri relativi alla struttura di Home Graph a cui appartiene il dispositivo di destinazione. Consulta la pagina https://developers.google.com/actions/smarthome/concepts/homegraph. |
device |
(Facoltativo) Da usare per spostarsi tra i dispositivi con l'assistente a cui l'utente ha accesso. |
expected |
(Facoltativo) Descrive le aspettative per la successiva svolta di dialogo. |
Handler
Rappresenta un gestore del fulfillment che mappa le informazioni sugli eventi da Actions on Google al fulfillment. Utilizza il nome del gestore per determinare quale codice eseguire. Ad esempio, si potrebbe usare un gestore per ottenere informazioni sulle informazioni relative all'ordine di un utente con un nome gestore come "OrderLookup". mentre un altro potrebbe ricevere informazioni sui prodotti da un database, con un nome gestore come "GetProductInfo".
Rappresentazione JSON | |
---|---|
{ "name": string } |
Campi | |
---|---|
name |
(Facoltativo) Il nome del gestore. |
Intenzione
Rappresenta un'intenzione. Vedi https://developers.google.com/assistant/conversational/intents.
Rappresentazione JSON | |
---|---|
{
"name": string,
"params": {
string: {
object ( |
Campi | |
---|---|
name |
Obbligatorio. Il nome dell'ultimo intent corrispondente. |
params |
Obbligatorio. Rappresenta i parametri identificati come parte della corrispondenza di intent. Questa è una mappa tra il nome del parametro identificato e il valore del parametro identificato dall'input dell'utente. Tutti i parametri definiti nell'intent corrispondente identificati verranno mostrati qui. Un oggetto contenente un elenco di |
query |
(Facoltativo) Input digitato o pronunciato dall'utente finale corrispondente a questa intenzione. Il campo verrà compilato quando viene trovata una corrispondenza con un intent, in base all'input dell'utente. |
IntentParameterValue
Rappresenta un valore per il parametro di intent. Vedi https://developers.google.com/assistant/conversational/types.
Rappresentazione JSON | |
---|---|
{ "original": string, "resolved": value } |
Campi | |
---|---|
original |
Obbligatorio. Valore del testo originale estratto dalla frase dell'utente. |
resolved |
Obbligatorio. Valore strutturato per il parametro estratto dall'input dell'utente. Il campo verrà compilato solo se il parametro è definito nell'intent con corrispondenza e il valore del parametro potrebbe essere identificato durante la corrispondenza dell'intent. |
Scena
Rappresenta una scena. Le scene possono chiamare il completamento delle chiamate, aggiungere richieste e raccogliere i valori degli slot dall'utente. Le scene vengono attivate da eventi o intent e possono attivare eventi e abbinare gli intent per passare ad altre scene.
Rappresentazione JSON | |
---|---|
{ "name": string, "slotFillingStatus": enum ( |
Campi | |
---|---|
name |
Obbligatorio. Nome della scena attuale. |
slotFillingStatus |
Obbligatorio. Lo stato attuale di riempimento degli slot. Questo campo è di sola lettura. |
slots |
Gli slot associati alla scena corrente. Le risposte del gestore non possono restituire spazi che non sono stati inviati nella richiesta. Un oggetto contenente un elenco di |
next |
(Facoltativo) Informazioni sulla scena successiva da eseguire. |
SlotFillingStatus
Rappresenta lo stato attuale di riempimento degli slot.
Enum | |
---|---|
UNSPECIFIED |
Valore di riserva quando il campo dell'utilizzo non è compilato. |
INITIALIZED |
Gli slot sono stati inizializzati, ma il riempimento degli slot non è iniziato. |
COLLECTING |
I valori degli slot sono in fase di raccolta. |
FINAL |
Tutti i valori degli slot sono definitivi e non possono essere modificati. |
Slot
Rappresenta uno slot.
Rappresentazione JSON | |
---|---|
{ "mode": enum ( |
Campi | |
---|---|
mode |
La modalità dello spazio (obbligatoria o facoltativa). Può essere impostato dallo sviluppatore. |
status |
Lo stato dell'area. |
value |
Il valore dell'area. La modifica di questo valore nella risposta modificherà il valore nel riempimento degli slot. |
updated |
Indica se il valore dello slot è stato raccolto nell'ultimo turno. Questo campo è di sola lettura. |
prompt |
(Facoltativo) Questo prompt viene inviato all'utente quando è necessario riempire uno spazio richiesto. Questo prompt sostituisce il prompt esistente definito nella console. Questo campo non è incluso nella richiesta webhook. |
SlotMode
Rappresenta la modalità di uno slot, ovvero se è obbligatoria o meno.
Enum | |
---|---|
MODE_UNSPECIFIED |
Valore di riserva quando il campo dell'utilizzo non è compilato. |
OPTIONAL |
Indica che lo slot non è necessario per completare la compilazione degli slot. |
REQUIRED |
Indica che lo slot è necessario per completare la compilazione. |
SlotStatus
Rappresenta lo stato di un'area.
Enum | |
---|---|
SLOT_UNSPECIFIED |
Valore di riserva quando il campo dell'utilizzo non è compilato. |
EMPTY |
Indica che l'area non ha valori. Questo stato non può essere modificato tramite la risposta. |
INVALID |
Indica che il valore dello slot non è valido. Questo stato può essere impostato tramite la risposta. |
FILLED |
Indica che l'area ha un valore. Questo stato non può essere modificato tramite la risposta. |
Prompt
Rappresenta una risposta a un utente. Visita la pagina https://developers.google.com/assistant/conversational/prompts.
Rappresentazione JSON | |
---|---|
{ "override": boolean, "firstSimple": { object ( |
Campi | |
---|---|
override |
(Facoltativo) Modalità per unire questi messaggi a messaggi definiti in precedenza. "vero" cancella tutti i messaggi definiti in precedenza (primo e ultimo semplice, contenuti, link dei suggerimenti e canvas) e aggiunge i messaggi definiti in questo prompt. "false" aggiunge i messaggi definiti in questo prompt a quelli definiti nelle risposte precedenti. Lasciare questo campo a "false" consente inoltre l'aggiunta ad alcuni campi all'interno dei prompt semplici, del prompt dei suggerimenti e del prompt di Canvas (parte del prompt dei contenuti). Se definito nel prompt, i messaggi Contenuti e Link vengono sempre sovrascritti. Il valore predefinito è "false". |
firstSimple |
(Facoltativo) La prima risposta vocale e di solo testo. |
content |
(Facoltativo) Contenuti come una scheda, un elenco o contenuti multimediali da mostrare all'utente. |
lastSimple |
(Facoltativo) L'ultima risposta vocale e di solo testo. |
suggestions[] |
(Facoltativo) Suggerimenti da mostrare all'utente, che saranno sempre visualizzati alla fine della risposta. Se l'opzione "override" nel prompt contenente è "false", i titoli definiti in questo campo verranno aggiunti ai titoli definiti in qualsiasi prompt di suggerimenti definito in precedenza e i valori duplicati verranno rimossi. |
link |
(Facoltativo) Un chip di suggerimento aggiuntivo che può rimandare all'app o al sito associato. Il chip verrà visualizzato con il titolo "Apri (nome)". Massimo 20 caratteri. |
canvas |
(Facoltativo) Rappresenta una risposta di Canvas interattiva da inviare all'utente. |
orderUpdate |
L'azione facoltativa risponde con un OrderUpdate dopo aver ricevuto l'ordine durante il flusso delle transazioni. Una volta ricevuto il messaggio, Google registra l'aggiornamento dell'ordine e, in caso di esito positivo, mostra una scheda con la ricevuta insieme alla sintesi vocale inviata sui dispositivi di visualizzazione. |
Semplice
Rappresenta un semplice prompt da inviare a un utente. Vedi https://developers.google.com/assistant/conversational/prompts-simple.
Rappresentazione JSON | |
---|---|
{ "speech": string, "text": string } |
Campi | |
---|---|
speech |
(Facoltativo) Rappresenta il discorso da pronunciare all'utente. Può essere SSML o sintesi vocale. Se l'opzione "override" nel prompt contenitore è "true", il parlato definito in questo campo sostituisce quello del prompt semplice precedente. Vedi https://developers.google.com/assistant/conversational/ssml. |
text |
Testo facoltativo da visualizzare nel fumetto della chat. Se non viene specificato, verrà utilizzato il rendering del campo vocale riportato sopra. Limitato a 640 caratteri. Se l'opzione "override" nel prompt contenente è "true", il testo definito in questo campo sostituisce il testo del prompt semplice precedente. |
Contenuti
Oggetto container per prompt avanzati o di selezione.
Rappresentazione JSON | |
---|---|
{ // Union field |
Campi | ||
---|---|---|
Campo unione
|
||
card |
Una carta di base. |
|
image |
Un'immagine. |
|
table |
Scheda tabella. |
|
media |
Risposta che indica un insieme di contenuti multimediali da riprodurre. |
|
collection |
Una scheda con una raccolta di opzioni tra cui scegliere. |
|
list |
Una scheda che presenta un elenco di opzioni tra cui scegliere. |
|
collectionBrowse |
Una scheda con una raccolta di pagine web da aprire. |
Scheda
Una scheda di base per visualizzare alcune informazioni, ad esempio un'immagine e/o del testo. Vedi https://developers.google.com/assistant/conversational/prompts-rich#basic_card.
Rappresentazione JSON | |
---|---|
{ "title": string, "subtitle": string, "text": string, "image": { object ( |
Campi | |
---|---|
title |
Titolo generale della scheda. (Facoltativo) |
subtitle |
(Facoltativo) |
text |
Corpo del testo della scheda. Supporta un insieme limitato di sintassi di Markdown per la formattazione. Obbligatorio, a meno che non sia presente un'immagine. |
image |
Un'immagine hero per la carta. L'altezza è fissa a 192 dp. (Facoltativo) |
imageFill |
Il modo in cui lo sfondo dell'immagine verrà riempito. (Facoltativo) |
button |
Pulsante con un link in uscita. (Facoltativo) |
Immagine
Un'immagine visualizzata nella scheda. Consulta la pagina https://developers.google.com/assistant/conversational/prompts-rich#image-cards.
Rappresentazione JSON | |
---|---|
{ "url": string, "alt": string, "height": integer, "width": integer } |
Campi | |
---|---|
url |
L'URL di origine dell'immagine. Le immagini possono essere in formato JPG, PNG e GIF (animate e non animate). Ad esempio, |
alt |
Una descrizione testuale dell'immagine da utilizzare per l'accessibilità, ad es. screen reader. Obbligatorio. |
height |
L'altezza dell'immagine in pixel. (Facoltativo) |
width |
La larghezza dell'immagine in pixel. (Facoltativo) |
ImageFill
Possibili opzioni di visualizzazione dell'immagine che influiscono sulla presentazione dell'immagine stessa. Questa opzione deve essere utilizzata quando le proporzioni dell'immagine non corrispondono a quelle del contenitore di immagini.
Enum | |
---|---|
UNSPECIFIED |
|
GRAY |
Riempi gli spazi vuoti tra l'immagine e il contenitore di immagini con barre grigie. |
WHITE |
Riempi gli spazi vuoti tra l'immagine e il contenitore di immagini con barre bianche. |
CROPPED |
L'immagine viene ridimensionata in modo che la larghezza e l'altezza dell'immagine corrispondano o superino le dimensioni del contenitore. In questo modo, la parte superiore e inferiore dell'immagine potrebbero essere ritagliate se l'altezza dell'immagine scalata è superiore all'altezza del contenitore oppure potrebbe essere ritagliata a sinistra e a destra dell'immagine se la larghezza dell'immagine scalata è superiore a quella del contenitore. È simile alla "Modalità zoom" su una TV widescreen durante la riproduzione di un video in 4:3. |
Link
Un chip di suggerimento aggiuntivo che può rimandare all'app o al sito associato. Il chip verrà visualizzato con il titolo "Apri (nome)".
Rappresentazione JSON | |
---|---|
{
"name": string,
"open": {
object ( |
Campi | |
---|---|
name |
Nome del link. Massimo 20 caratteri. |
open |
Cosa succede quando un utente apre il link |
OpenUrl
Rappresentazione JSON | |
---|---|
{
"url": string,
"hint": enum ( |
Campi | |
---|---|
url |
Il campo url che può essere uno dei seguenti: - URL http/https per l'apertura di un'app collegata all'app o di una pagina web |
hint |
Indica un suggerimento per il tipo di URL. |
UrlHint
Diversi tipi di suggerimenti URL.
Enum | |
---|---|
LINK_UNSPECIFIED |
Non specificato |
AMP |
URL che indirizza direttamente ai contenuti AMP o a un URL canonico che fa riferimento ai contenuti AMP tramite . Vedi https://amp.dev/. |
Tabella
Una scheda per visualizzare una tabella di testo. Vedi https://developers.google.com/assistant/conversational/prompts-rich#table_cards.
Rappresentazione JSON | |
---|---|
{ "title": string, "subtitle": string, "image": { object ( |
Campi | |
---|---|
title |
Titolo generale della tabella. Facoltativi, ma devono essere impostati se sono stati impostati i sottotitoli. |
subtitle |
Sottotitolo per la tabella. (Facoltativo) |
image |
Immagine associata alla tabella. (Facoltativo) |
columns[] |
Intestazioni e allineamento delle colonne. |
rows[] |
Dati delle righe della tabella. È garantita la visualizzazione delle prime tre righe, ma altre potrebbero essere tagliate su determinate superfici. Esegui un test con il simulatore per vedere quali righe verranno visualizzate per una determinata superficie. Sulle piattaforme che supportano la funzionalità WEB_BROWSER, puoi indirizzare l'utente a una pagina web con più dati. |
button |
Pulsante. |
TableColumn
Rappresentazione JSON | |
---|---|
{
"header": string,
"align": enum ( |
Campi | |
---|---|
header |
Testo dell'intestazione per la colonna. |
align |
Allineamento orizzontale dei contenuti rispetto alla colonna. Se non specificato, i contenuti verranno allineati al bordo iniziale. |
HorizontalAlignment
L'allineamento dei contenuti all'interno della cella.
Enum | |
---|---|
UNSPECIFIED |
|
LEADING |
Bordo d'ingresso della cella. Questa è l'impostazione predefinita. |
CENTER |
I contenuti sono allineati al centro della colonna. |
TRAILING |
Il contenuto è allineato al bordo finale della colonna. |
TableRow
Descrive una riga della tabella.
Rappresentazione JSON | |
---|---|
{
"cells": [
{
object ( |
Campi | |
---|---|
cells[] |
Celle in questa riga. È garantita la visualizzazione delle prime 3 celle, ma le altre potrebbero essere tagliate su determinate superfici. Esegui un test con il simulatore per vedere quali celle verranno visualizzate per una determinata superficie. |
divider |
Indica se deve esserci un divisore dopo ogni riga. |
TableCell
Descrive una cella in una riga.
Rappresentazione JSON | |
---|---|
{ "text": string } |
Campi | |
---|---|
text |
Contenuto testuale della cella. |
Media
Rappresenta un oggetto multimediale. Contiene informazioni sui contenuti multimediali, come nome, descrizione, URL e così via. Visita la pagina https://developers.google.com/assistant/conversational/prompts-media.
Rappresentazione JSON | |
---|---|
{ "mediaType": enum ( |
Campi | |
---|---|
mediaType |
|
startOffset |
Offset iniziale del primo oggetto multimediale. Durata in secondi con un massimo di nove cifre frazionarie, terminata da " |
optionalMediaControls[] |
Tipi facoltativi di controlli multimediali supportati da questa sessione di risposte multimediali. Se impostato, la richiesta verrà effettuata a terze parti quando si verifica un determinato evento multimediale. Se non viene configurato, 3p deve comunque gestire due tipi di controllo predefiniti, FINISHED e FAILED. |
mediaObjects[] |
Elenco di oggetti multimediali |
repeatMode |
Modalità di ripetizione per l'elenco di oggetti multimediali. |
firstMediaObjectIndex |
Indice in base a 0 del primo oggetto multimediale in mediaObject da riprodurre. Se non specificato, zero o fuori intervallo, la riproduzione inizia dal primo oggetto multimediale in mediaObjects. |
MediaType
Tipo multimediale di questa risposta.
Enum | |
---|---|
MEDIA_TYPE_UNSPECIFIED |
|
AUDIO |
File audio. |
MEDIA_STATUS_ACK |
Risposta per confermare un report sullo stato dei media. |
OptionalMediaControls
Tipi di controlli multimediali facoltativi che la risposta multimediale può supportare
Enum | |
---|---|
OPTIONAL_MEDIA_CONTROLS_UNSPECIFIED |
Valore non specificato |
PAUSED |
Evento in pausa. Si attiva quando l'utente mette in pausa i contenuti multimediali. |
STOPPED |
Evento interrotto. Si attiva quando l'utente esce dalla sessione di terze parti durante la riproduzione di contenuti multimediali. |
MediaObject
Rappresenta un singolo oggetto multimediale
Rappresentazione JSON | |
---|---|
{
"name": string,
"description": string,
"url": string,
"image": {
object ( |
Campi | |
---|---|
name |
Nome dell'oggetto multimediale. |
description |
Descrizione di questo oggetto multimediale. |
url |
L'URL che rimanda ai contenuti multimediali. I file MP3 devono essere ospitati su un server web ed essere disponibili pubblicamente tramite un URL HTTPS. Il live streaming è supportato solo per il formato MP3. |
image |
Immagine da mostrare con la scheda dei contenuti multimediali. |
MediaImage
Rappresentazione JSON | |
---|---|
{ // Union field |
Campi | ||
---|---|---|
Campo unione
|
||
large |
Un'immagine di grandi dimensioni, come la copertina dell'album e così via. |
|
icon |
Una piccola icona immagine visualizzata a destra rispetto al titolo. Viene ridimensionato a 36 x 36 dp. |
RepeatMode
I tipi di modalità di ripetizione per un elenco di oggetti multimediali.
Enum | |
---|---|
REPEAT_MODE_UNSPECIFIED |
Equivale a OFF. |
OFF |
Termina sessione multimediale alla fine dell'ultimo oggetto multimediale. |
ALL |
Consente di ripetere continuamente l'inizio del primo oggetto multimediale quando viene raggiunta la fine dell'ultimo oggetto multimediale. |
Collezione
Una scheda per presentare una raccolta di opzioni tra cui scegliere. Consulta la pagina https://developers.google.com/assistant/conversational/prompts-selection#collection
Rappresentazione JSON | |
---|---|
{ "title": string, "subtitle": string, "items": [ { object ( |
Campi | |
---|---|
title |
Titolo della raccolta. (Facoltativo) |
subtitle |
Sottotitolo della raccolta. (Facoltativo) |
items[] |
Un elenco di elementi. Può avere un minimo di 2 e un massimo di 10. |
imageFill |
Il modo in cui verranno riempiti gli sfondi delle immagini degli elementi della raccolta. (Facoltativo) |
CollectionItem
Un elemento nella raccolta
Rappresentazione JSON | |
---|---|
{ "key": string } |
Campi | |
---|---|
key |
Obbligatorio. La chiave NLU corrispondente al nome della chiave di accesso nel tipo associato. |
Elenco
Una scheda per presentare un elenco di opzioni tra cui scegliere. Consulta la pagina https://developers.google.com/assistant/conversational/prompts-selection#list
Rappresentazione JSON | |
---|---|
{
"title": string,
"subtitle": string,
"items": [
{
object ( |
Campi | |
---|---|
title |
Titolo dell'elenco. (Facoltativo) |
subtitle |
Sottotitolo dell'elenco. (Facoltativo) |
items[] |
Un elenco di elementi. Può avere un minimo di 2 e un massimo di 30. |
ListItem
Un elemento dell'elenco
Rappresentazione JSON | |
---|---|
{ "key": string } |
Campi | |
---|---|
key |
Obbligatorio. La chiave NLU corrispondente al nome della chiave di accesso nel tipo associato. |
CollectionBrowse
Presenta un insieme di documenti web come raccolta di elementi di grandi dimensioni. Gli elementi possono essere selezionati per avviare il documento web associato in un visualizzatore web. Consulta la pagina https://developers.google.com/assistant/conversational/prompts-selection#collectionBrowse.
Rappresentazione JSON | |
---|---|
{ "items": [ { object ( |
Campi | |
---|---|
items[] |
Un elenco di elementi. Può avere un minimo di 2 e un massimo di 10. |
imageFill |
Tipo di opzione di visualizzazione dell'immagine. |
Elemento
Elemento della raccolta.
Rappresentazione JSON | |
---|---|
{ "title": string, "description": string, "footer": string, "image": { object ( |
Campi | |
---|---|
title |
Obbligatorio. Titolo dell'elemento della raccolta. |
description |
Descrizione dell'elemento della raccolta. |
footer |
Testo a piè di pagina per l'elemento della raccolta, visualizzato sotto la descrizione. Una singola riga di testo, troncata con i puntini di sospensione. |
image |
Immagine per l'elemento della raccolta. |
openUriAction |
Obbligatorio. URI da aprire se l'elemento selezionato. |
Suggerimento
I suggerimenti forniscono agli utenti sui dispositivi con funzionalità di visualizzazione dei chip di suggerimento quando l'assistente mostra la richiesta. Utilizza i chip di suggerimento per suggerire le risposte degli utenti e continuare o ruotare la conversazione. Quando viene toccato, un chip di suggerimento restituisce il testo visualizzato alla conversazione testualmente, come se l'utente lo avesse digitato. Consulta la pagina https://developers.google.com/assistant/conversational/prompts#suggestions.
Rappresentazione JSON | |
---|---|
{ "title": string } |
Campi | |
---|---|
title |
Obbligatorio. Il testo mostrato nel chip di suggerimento. Se toccato, il testo viene pubblicato nella conversazione parola per parola, come se l'utente lo avesse digitato. Ogni titolo deve essere univoco tra l'insieme di chip di suggerimento. Massimo 25 caratteri |
Tela
Rappresenta una risposta di Canvas interattiva da inviare all'utente. Può essere utilizzato in combinazione con il campo "firstSimple" nel prompt contenente per parlare con l'utente oltre a visualizzare una risposta canvas interattiva. La dimensione massima della risposta è 50.000 byte. Consulta la pagina https://developers.google.com/assistant/interactivecanvas.
Rappresentazione JSON | |
---|---|
{
"url": string,
"data": [
value
],
"suppressMic": boolean,
"continuousMatchConfig": {
object ( |
Campi | |
---|---|
url |
URL dell'app web canvas interattiva da caricare. Se non viene configurato, l'URL del canvas attualmente attivo verrà riutilizzato. |
data[] |
(Facoltativo) Dati JSON da trasmettere alla pagina web dell'esperienza immersiva sotto forma di evento. Se l'opzione "override" il campo nel prompt contenente è "false" i valori dei dati definiti in questo prompt di Canvas verranno aggiunti dopo i valori dei dati definiti nei prompt di Canvas precedenti. |
suppressMic |
(Facoltativo) Valore predefinito: false. |
continuousMatchConfig |
Configurazione utilizzata per avviare la modalità di corrispondenza continua. |
ContinuousMatchConfig
Configurazione utilizzata per avviare la modalità di corrispondenza continua.
Rappresentazione JSON | |
---|---|
{
"expectedPhrases": [
{
object ( |
Campi | |
---|---|
expectedPhrases[] |
Tutte le possibili frasi previste durante questa sessione in modalità di corrispondenza continua. |
durationSeconds |
Durata per mantenere attiva la modalità di corrispondenza continua. Se specificato, il microfono verrà chiuso allo scadere del tempo. Il valore massimo consentito è 180. |
ExpectedPhrase
Rappresentazione JSON | |
---|---|
{ "phrase": string, "alternativePhrases": [ string ] } |
Campi | |
---|---|
phrase |
La frase da abbinare durante la sessione in modalità di corrispondenza continua. |
alternativePhrases[] |
Alcune frasi potrebbero essere erroneamente riconosciute dal modello vocale anche con la differenziazione del parlato. Ciò consente agli sviluppatori di specificare trigger alternativi per gli omofoni. |
OrderUpdate
Effettua l'aggiornamento a un ordine.
Rappresentazione JSON | |
---|---|
{ "type": enum ( |
Campi | |
---|---|
type |
Deprecato: utilizza invece OrderUpdate.update_mask. Se tipo = SNAPSHOT, OrderUpdate.order deve rappresentare l'intero ordine. Se il tipo = ORDER_STATUS, si tratta della modifica dello stato a livello di ordine. Vengono selezionati solo order.last_update_time e questo stato del verticale. Nota: type.ORDER_STATUS supporta solo gli aggiornamenti dello stato di PurcahaseOrder Extension e non è prevista alcuna estensione di questo supporto. Consigliamo invece di utilizzare updateMask in quanto è più generica ed estensibile e può essere utilizzato per tutti i verticali. |
order |
|
updateMask |
Nota: per i seguenti campi speciali sono previsti i seguenti suggerimenti: 1. order.last_update_time verrà sempre aggiornato come parte della richiesta di aggiornamento. 2. order.create_time, order.google_order_id e order.merchant_order_id verranno ignorati se forniti nell'ambito della maschera di aggiornamento. Si tratta di un elenco di nomi completi dei campi separati da virgole. Esempio: |
userNotification |
Se specificato, mostra una notifica all'utente con il titolo e il testo specificati. Se viene specificata una notifica, si intende l'invio di una notifica e non è garantito che venga inviata una notifica. |
reason |
Motivo della modifica/aggiornamento. |
Tipo
Deprecato: utilizza invece OrderUpdate.update_mask. Aggiornamenti consentiti per un ordine.
Enum | |
---|---|
TYPE_UNSPECIFIED |
Tipo non specificato. Non deve essere impostato in modo esplicito. |
ORDER_STATUS |
Aggiorna solo lo stato dell'ordine. |
SNAPSHOT |
Aggiorna istantanea ordine. |
Ordine
Entità ordine. Nota: 1. Se non diversamente specificato, tutte le stringhe a tutti i livelli devono avere una lunghezza inferiore a 1000 caratteri. 2. Tutti i campi ripetuti a tutti i livelli devono essere inferiori a 50, se non diversamente specificato. 3. Tutti i timestamp a tutti i livelli, se specificati, devono essere timestamp validi.
Rappresentazione JSON | |
---|---|
{ "googleOrderId": string, "merchantOrderId": string, "userVisibleOrderId": string, "userVisibleStateLabel": string, "buyerInfo": { object ( |
Campi | ||
---|---|---|
googleOrderId |
ID ordine assegnato da Google. |
|
merchantOrderId |
Obbligatorio: ID ordine interno assegnato dal commerciante. Questo ID deve essere univoco ed è obbligatorio per le successive operazioni di aggiornamento dell'ordine. Questo ID può essere impostato sul valore googleOrderId fornito o su qualsiasi altro valore univoco. Tieni presente che l'ID presentato agli utenti è userVisibileOrderId, che potrebbe essere un valore diverso e più intuitivo. La lunghezza massima consentita è di 128 caratteri. |
|
userVisibleOrderId |
L'ID rivolto all'utente che fa riferimento all'ordine corrente. Questo ID deve essere coerente con l'ID visualizzato per quest'ordine in altri contesti, tra cui siti web, app ed email. |
|
userVisibleStateLabel |
Deprecato: utilizza invece lo stato Order Extensions. Etichetta visibile all'utente per lo stato di questo ordine. |
|
buyerInfo |
Informazioni sull'acquirente. |
|
image |
Immagine associata all'ordine. |
|
createTime |
Obbligatorio: data e ora di creazione dell'ordine. Un timestamp nel formato RFC3339 UTC "Zulu" con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: |
|
lastUpdateTime |
La data e l'ora dell'ultimo aggiornamento dell'ordine. Obbligatorio per OrderUpdate. Un timestamp nel formato RFC3339 UTC "Zulu" con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: |
|
transactionMerchant |
Commerciante che ha facilitato il pagamento. Potrebbe essere diverso da un fornitore a livello di elemento pubblicitario. Esempio: ordine Expedia con elemento pubblicitario proveniente da ANA. |
|
contents |
Obbligatorio: ordina i contenuti, ovvero un gruppo di elementi pubblicitari. |
|
priceAttributes[] |
Prezzo, sconti, tasse e così via. |
|
followUpActions[] |
Azioni di follow-up a livello di ordine. |
|
paymentData |
Dati relativi al pagamento relativi all'ordine. |
|
termsOfServiceUrl |
Un link ai Termini di servizio applicabili all'ordine/ordine proposto. |
|
note |
Note allegate a un ordine. |
|
promotions[] |
Tutte le promozioni associate a questo ordine. |
|
disclosures[] |
Informative associate a questo ordine. |
|
vertical |
Deprecato: utilizza i verticali. Queste proprietà verranno applicate a tutti gli elementi pubblicitari, a meno che non vengano sostituite in alcuni. Questo verticale deve corrispondere al tipo di verticale a livello di elemento pubblicitario. Valori possibili: Un oggetto che contiene campi di tipo arbitrario. Un campo aggiuntivo |
|
Campo unione verticals . Queste proprietà verranno applicate a tutti gli elementi pubblicitari, a meno che non vengano sostituite in alcuni. Questo verticale deve corrispondere al tipo di verticale a livello di elemento pubblicitario. verticals può essere solo uno dei seguenti: |
||
purchase |
Ordine di acquisto |
|
ticket |
Ordine biglietto |
UserInfo
Informazioni sull'utente. Queste informazioni vengono utilizzate per rappresentare le informazioni dell'utente associate a un ordine.
Rappresentazione JSON | |
---|---|
{
"email": string,
"firstName": string,
"lastName": string,
"displayName": string,
"phoneNumbers": [
{
object ( |
Campi | |
---|---|
email |
Indirizzo email dell'utente, ad esempio janedoe@gmail.com. |
firstName |
Nome dell'utente. |
lastName |
Cognome dell'utente. |
displayName |
Il nome visualizzato dell'utente, che potrebbe essere diverso dal nome o dal cognome. |
phoneNumbers[] |
Numeri di telefono dell'utente. |
Numero di telefono
Rappresentazione standard del numero di telefono.
Rappresentazione JSON | |
---|---|
{ "e164PhoneNumber": string, "extension": string, "preferredDomesticCarrierCode": string } |
Campi | |
---|---|
e164PhoneNumber |
Numero di telefono nel formato E.164, come definito nella Raccomandazione dell'Unione internazionale delle telecomunicazioni (ITU) E.164. link wiki: https://en.wikipedia.org/wiki/E.164 |
extension |
L'estensione non è standardizzata nei suggerimenti ITU, ad eccezione di una serie di numeri con una lunghezza massima di 40 cifre. È definita come una stringa qui per soddisfare il possibile utilizzo di uno zero iniziale nell'estensione (le organizzazioni hanno totale libertà di farlo, in quanto non esiste uno standard definito). Altri caratteri diversi dai numeri, come "," (che indica un'attesa) potrebbero essere archiviati qui. Ad esempio, nell'estensione xxx-xxx-xxxx 123, "123" è l'estensione. |
preferredDomesticCarrierCode |
Il codice di selezione dell'operatore preferito per chiamare questo numero di telefono nazionale. Sono inclusi anche i codici che devono essere compositi in alcuni paesi per le chiamate da rete fissa a cellulare e viceversa. Ad esempio, in Colombia, un "3" deve essere composto prima del numero di telefono stesso quando si chiama da un cellulare a un telefono fisso nazionale e viceversa. https://en.wikipedia.org/wiki/Telephone_numbers_in_Colombia https://en.wikipedia.org/wiki/Brazilian_Carrier_Selection_Code Tieni presente che questa è la categoria "preferita" il che significa che potrebbero funzionare anche altri codici. |
Immagine
Un'immagine visualizzata nella scheda.
Rappresentazione JSON | |
---|---|
{ "url": string, "accessibilityText": string, "height": integer, "width": integer } |
Campi | |
---|---|
url |
L'URL di origine dell'immagine. Le immagini possono essere in formato JPG, PNG e GIF (animate e non animate). Ad esempio, |
accessibilityText |
Una descrizione testuale dell'immagine da utilizzare per l'accessibilità, ad es. screen reader. Obbligatorio. |
height |
L'altezza dell'immagine in pixel. (Facoltativo) |
width |
La larghezza dell'immagine in pixel. (Facoltativo) |
Commerciante
Commerciante del carrello/ordine/elemento pubblicitario.
Rappresentazione JSON | |
---|---|
{ "id": string, "name": string, "image": { object ( |
Campi | |
---|---|
id |
ID facoltativo assegnato al commerciante, se presente. |
name |
Il nome del commerciante, ad esempio "Panera". |
image |
L'immagine associata al commerciante. |
phoneNumbers[] |
Numeri di telefono del commerciante. |
address |
L'indirizzo del commerciante. |
Località
Container che rappresenta una località.
Rappresentazione JSON | |
---|---|
{ "coordinates": { object ( |
Campi | |
---|---|
coordinates |
Coordinate geografiche. Richiede [DEVICE_PRECISE_LOCATION] Autorizzazione [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION]. |
formattedAddress |
Indirizzo visualizzato, ad es. "1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA". Richiede [DEVICE_PRECISE_LOCATION] Autorizzazione [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION]. |
zipCode |
Codice postale. Richiede [DEVICE_PRECISE_LOCATION] [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION] o [DEVICE_COARSE_LOCATION] Autorizzazione [google.actions.v2.Permission.DEVICE_COARSE_LOCATION]. |
city |
Città. Richiede [DEVICE_PRECISE_LOCATION] [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION] o [DEVICE_COARSE_LOCATION] Autorizzazione [google.actions.v2.Permission.DEVICE_COARSE_LOCATION]. |
postalAddress |
Indirizzo postale. Richiede [DEVICE_PRECISE_LOCATION] [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION] o [DEVICE_COARSE_LOCATION] Autorizzazione [google.actions.v2.Permission.DEVICE_COARSE_LOCATION]. |
name |
Il nome del luogo. |
phoneNumber |
Numero di telefono della sede, ad es. numero di contatto della sede dell'attività o numero di telefono della sede di consegna. |
notes |
Note sulla posizione. |
placeId |
placeId viene utilizzato con l'API Places per recuperare i dettagli di un luogo. Visita la pagina https://developers.google.com/places/web-service/place-id |
LatLng
Un oggetto che rappresenta una coppia latitudine/longitudine. Questo valore è espresso come coppia di doppi per rappresentare i gradi di latitudine e i gradi di longitudine. Se non diversamente specificato, questo oggetto deve essere conforme allo standard WGS84. I valori devono essere compresi negli intervalli normalizzati.
Rappresentazione JSON | |
---|---|
{ "latitude": number, "longitude": number } |
Campi | |
---|---|
latitude |
La latitudine in gradi. Deve essere compreso nell'intervallo [-90,0, +90,0]. |
longitude |
Longitudine in gradi. Deve essere compreso nell'intervallo [-180,0, +180,0]. |
PostalAddress
Rappresenta un indirizzo postale, ad esempio per gli indirizzi di consegna postale o di pagamento. Dato un indirizzo postale, un servizio postale può consegnare gli articoli a una sede, una P.O. Box o simile. Non è progettato per creare modelli di località geografiche (strade, città, montagne).
Nell'utilizzo tipico, un indirizzo verrebbe creato tramite l'input dell'utente o importando dati esistenti, a seconda del tipo di processo.
Consigli sull'inserimento / modifica di indirizzi: - Usa un widget degli indirizzi compatibile con i18n, come https://github.com/google/libaddressinput. - Agli utenti non devono essere mostrati elementi di interfaccia utente per l'inserimento o la modifica di campi al di fuori dei paesi in cui viene utilizzato quel campo.
Per ulteriori indicazioni su come utilizzare questo schema, consulta la pagina: https://support.google.com/business/answer/6397478
Rappresentazione JSON | |
---|---|
{ "revision": integer, "regionCode": string, "languageCode": string, "postalCode": string, "sortingCode": string, "administrativeArea": string, "locality": string, "sublocality": string, "addressLines": [ string ], "recipients": [ string ], "organization": string } |
Campi | |
---|---|
revision |
La revisione dello schema di Tutte le nuove revisioni devono essere compatibili con le versioni precedenti. |
regionCode |
Obbligatorio. Codice regione CLDR del paese o della regione dell'indirizzo. Ciò non viene mai dedotto e spetta all'utente assicurarsi che il valore sia corretto. Per informazioni dettagliate, visita le pagine http://cldr.unicode.org/ e http://www.unicode.org/cldr/charts/30/supplemental/territory_information.html. Esempio: "CH" per la Svizzera. |
languageCode |
(Facoltativo) Codice lingua BCP-47 dei contenuti di questo indirizzo (se noto). Spesso si tratta della lingua dell'interfaccia utente del modulo di input o dovrebbe corrispondere a una delle lingue utilizzate nell'indirizzo. paese/regione o i loro equivalenti traslitterati. Questo può influenzare la formattazione in alcuni paesi, ma non è fondamentale per la correttezza dei dati e non influirà mai su convalida o altre operazioni correlate alla formattazione. Se questo valore non è noto, dovrebbe essere omesso (anziché specificare un valore predefinito potenzialmente errato). Esempi: "zh-Hant", "ja", "ja-Latn", "en". |
postalCode |
(Facoltativo) Codice postale dell'indirizzo. Non tutti i paesi utilizzano o richiedono la presenza di codici postali, ma se vengono utilizzati, possono attivare un'ulteriore convalida con altre parti dell'indirizzo (ad es. convalida stato/codice postale negli Stati Uniti). |
sortingCode |
(Facoltativo) Codice di ordinamento aggiuntivo specifico per il paese. Questa opzione non è utilizzata nella maggior parte delle regioni. Dove viene utilizzato, il valore è una stringa come "CEDEX", facoltativamente seguita da un numero (ad es. "CEDEX 7") o solo un numero, che rappresenta il "codice di settore" (Giamaica), "indicatore zona di consegna" (Malawi) o "indicatore dell'ufficio postale" (ad es. Costa d'Avorio). |
administrativeArea |
(Facoltativo) Suddivisione amministrativa di livello più elevato utilizzata per gli indirizzi postali di un paese o di una regione. Ad esempio, può essere uno stato, una provincia, un oblast o una prefettura. In particolare, per la Spagna si tratta della provincia e non della comunità autonoma (ad es. "Barcellona" e non "Catalogna"). Molti paesi non utilizzano un'area amministrativa negli indirizzi postali. Ad es. in Svizzera, deve essere lasciato vuoto. |
locality |
(Facoltativo) In genere si riferisce alla porzione di città dell'indirizzo. Esempi: città USA, comune in Italia, città postale nel Regno Unito. Nelle regioni del mondo in cui le località non sono ben definite o non si adattano bene a questa struttura, lascia il campo della località vuoto e utilizza addressLines. |
sublocality |
(Facoltativo) Quartiere dell'indirizzo. Ad esempio, possono essere quartieri, quartieri e distretti. |
addressLines[] |
Righe di indirizzo non strutturate che descrivono i livelli inferiori di un indirizzo. Poiché i valori in addressLines non hanno informazioni sul tipo e a volte possono contenere più valori in un singolo campo (ad es. "Austin, TX"), è importante che l'ordine delle righe sia chiaro. L'ordine delle righe dell'indirizzo deve essere "ordine busta" per il paese o la regione dell'indirizzo. Nei luoghi dove questo valore può variare (ad es. in Giappone), viene utilizzato address_language per renderlo esplicito (ad es. "ja" per ordinamenti di grandi dimensioni e "ja-Latn" o "en" per valori di piccole dimensioni). In questo modo, è possibile selezionare la riga più specifica di un indirizzo in base alla lingua. La rappresentazione strutturale minima consentita di un indirizzo è composta da un regionalCode con tutte le informazioni rimanenti inserite in addressLines. Sarebbe possibile formattare un indirizzo del genere in modo molto approssimativo senza geocodifica, ma non è stato possibile effettuare alcun ragionamento semantico su nessuno dei componenti dell'indirizzo fino a quando non è stato almeno parzialmente risolto. Creare un indirizzo che contenga solo countryCode e addressLines e poi la geocodifica è il metodo consigliato per gestire indirizzi completamente non strutturati (anziché indovinare quali parti dell'indirizzo devono essere località o aree amministrative). |
recipients[] |
(Facoltativo) Il destinatario all'indirizzo. In determinate circostanze, questo campo può contenere informazioni su più righe. Ad esempio, potrebbe contenere "cura di" informazioni. |
organization |
(Facoltativo) Il nome dell'organizzazione all'indirizzo. |
Sommario
Wrapper per gli elementi pubblicitari.
Rappresentazione JSON | |
---|---|
{
"lineItems": [
{
object ( |
Campi | |
---|---|
lineItems[] |
Elenco degli elementi pubblicitari dell'ordine. È richiesto almeno un elemento pubblicitario, ma ne sono consentiti al massimo 50. Tutti gli elementi pubblicitari devono appartenere allo stesso verticale. |
LineItem
Un elemento pubblicitario contiene un verticale. Un ordine o un carrello può avere più elementi pubblicitari dello stesso verticale. Gli elementi pubblicitari secondari, i componenti aggiuntivi e così via devono essere definiti in protocolli verticali in base ai relativi casi d'uso. Nota: 1. Se non diversamente specificato, tutte le stringhe a tutti i livelli devono avere una lunghezza inferiore a 1000 caratteri. 2. Tutti i campi ripetuti a tutti i livelli devono essere inferiori a 50, se non diversamente specificato. 3. Tutti i timestamp a tutti i livelli, se specificati, devono essere timestamp validi.
Rappresentazione JSON | |
---|---|
{ "id": string, "name": string, "userVisibleStateLabel": string, "provider": { object ( |
Campi | ||
---|---|---|
id |
Obbligatorio: identificatore assegnato dal commerciante per l'elemento pubblicitario. Utilizzato per identificare l'elemento pubblicitario esistente nell'applicazione di aggiornamenti parziali. La lunghezza massima consentita è di 64 caratteri. |
|
name |
Nome della voce così come appare sullo scontrino. La lunghezza massima consentita è di 100 caratteri. |
|
userVisibleStateLabel |
Deprecato. Utilizza invece lo stato a livello verticale. Ad esempio, per gli acquisti, utilizza PurchaseOrderextension.status. Etichetta visibile all'utente per lo stato di questo elemento pubblicitario. |
|
provider |
Il fornitore dell'elemento pubblicitario specifico, se diverso dall'ordine complessivo. Esempio: ordine Expedia con fornitore di elementi pubblicitari ANA. |
|
priceAttributes[] |
Prezzo e aggiustamenti a livello di elemento pubblicitario. |
|
followUpActions[] |
Azioni di follow-up a livello di elemento pubblicitario. |
|
recipients[] |
Clienti a livello di elemento pubblicitario, potrebbe essere diverso dall'acquirente a livello di ordine. Esempio: l'utente X ha effettuato una prenotazione al ristorante con il nome dell'utente Y. |
|
image |
Piccola immagine associata a questo elemento, se presente. |
|
description |
Descrizione dell'elemento pubblicitario. |
|
notes[] |
Note aggiuntive applicabili a questo particolare elemento pubblicitario, ad esempio le norme sull'annullamento. |
|
disclosures[] |
Informative associate a questo elemento pubblicitario. |
|
vertical |
Deprecato: utilizza i verticali. Obbligatorio: contenuti semantici dell'elemento pubblicitario in base al tipo/verticale. Ogni verticale deve includere i propri dettagli di evasione. Deve essere uno dei seguenti valori: Un oggetto che contiene campi di tipo arbitrario. Un campo aggiuntivo |
|
Campo unione verticals . Obbligatorio: contenuti semantici dell'elemento pubblicitario in base al tipo/verticale. Ogni verticale deve includere i propri dettagli di evasione. verticals può essere solo uno dei seguenti: |
||
purchase |
Ordini di acquisto come merci, cibo, ecc. |
|
reservation |
Ordini di prenotazione come ristorante, taglio di capelli e così via. |
PriceAttribute
Attributo prezzo di un ordine o di un elemento pubblicitario.
Rappresentazione JSON | |
---|---|
{ "type": enum ( |
Campi | ||
---|---|---|
type |
Obbligatorio: attributo Type of money. |
|
name |
Obbligatorio: l'utente ha visualizzato la stringa dell'attributo prezzo. Questo viene inviato e localizzato dal commerciante. |
|
id |
Facoltativo: ID dell'elemento pubblicitario a cui corrisponde questo prezzo. |
|
state |
Obbligatorio: stato del prezzo: stimato ed effettivo. |
|
taxIncluded |
Indica se il prezzo è comprensivo di IVA. |
|
Campo unione spec . Rappresenta l'importo monetario o la percentuale in millisecondi. spec può essere solo uno dei seguenti: |
||
amount |
Importo monetario. |
|
amountMillipercentage |
La specifica percentuale, a 1/1000 di una percentuale. Ad esempio: 8,750% è rappresentato da 8750, le percentuali negative rappresentano sconti percentuali. Stai ritirando questo campo. Valuta la possibilità di aggiungere di nuovo quando è necessario un caso d'uso concreto. |
Tipo
Rappresenta il tipo di denaro.
Enum | |
---|---|
TYPE_UNSPECIFIED |
Il tipo non è specificato. I client non devono impostarlo in modo esplicito. |
REGULAR |
Prezzo visualizzato normale, prima dell'applicazione di eventuali sconti e così via. |
DISCOUNT |
Da sottrarre dal totale parziale. |
TAX |
Da aggiungere al totale parziale. |
DELIVERY |
Da aggiungere al totale parziale. |
SUBTOTAL |
Subtotale prima dell'aggiunta di alcune commissioni. |
FEE |
Qualsiasi tariffa aggiuntiva. |
GRATUITY |
Da aggiungere al totale parziale. |
TOTAL |
È stato visualizzato il prezzo dell'ordine o dell'elemento pubblicitario. |
Stato
Rappresenta lo stato del prezzo.
Enum | |
---|---|
STATE_UNSPECIFIED |
Non specificato. |
ESTIMATE |
Il prezzo è solo una stima, ma l'importo finale sarebbe vicino a questo importo. Esempio: nei casi in cui l'imposta non sia nota con precisione al momento della transazione, il totale sarà un importo STIMATO. |
ACTUAL |
Prezzo effettivo che verrà addebitato all'utente. |
Denaro
Rappresenta un importo di denaro con il tipo di valuta.
Rappresentazione JSON | |
---|---|
{ "currencyCode": string, "amountInMicros": string } |
Campi | |
---|---|
currencyCode |
Il codice valuta di tre lettere definito in ISO 4217. |
amountInMicros |
Importo in micro. Ad esempio, questo campo deve essere impostato su 1990000 per $1,99. |
Azione
Un'azione di follow-up associata all'ordine o all'elemento pubblicitario.
Rappresentazione JSON | |
---|---|
{ "type": enum ( |
Campi | |
---|---|
type |
Obbligatorio: tipo di azione. |
title |
Il titolo o l'etichetta dell'azione, mostrata all'utente. La lunghezza massima consentita è di 100 caratteri. |
openUrlAction |
Azione da intraprendere. |
actionMetadata |
Metadati associati a un'azione. |
Tipo
Possibili azioni di follow-up.
Enum | |
---|---|
TYPE_UNSPECIFIED |
Azione non specificata. |
VIEW_DETAILS |
Visualizza l'azione dei dettagli dell'ordine. |
MODIFY |
Azione di modifica ordine. |
CANCEL |
Azione di annullamento dell'ordine. |
RETURN |
Azione dell'ordine di reso. |
EXCHANGE |
Azione ordine di scambio. |
EMAIL |
Azione email. I tipi EMAIL e CALL sono stati ritirati. openUrlAction.url può essere utilizzato come numero di telefono o come indirizzo email. |
CALL |
Richiama azione. |
REORDER |
Riordina l'azione. |
REVIEW |
Rivedi l'azione dell'ordine. |
CUSTOMER_SERVICE |
Contatta l'assistenza clienti. |
FIX_ISSUE |
Indirizza al sito o all'app del commerciante per risolvere il problema. |
DIRECTION |
Link di indicazioni stradali. |
OpenUrlAction
Apre l'URL specificato.
Rappresentazione JSON | |
---|---|
{ "url": string, "androidApp": { object ( |
Campi | |
---|---|
url |
Il campo url che può essere uno dei seguenti: - URL http/https per l'apertura di un'app collegata all'app o di una pagina web |
androidApp |
Informazioni sull'app per Android, se si prevede che l'URL venga soddisfatto da un'app per Android. |
urlTypeHint |
Indica un suggerimento per il tipo di URL. |
AndroidApp
Specifica dell'app per Android per le limitazioni di evasione degli ordini
Rappresentazione JSON | |
---|---|
{
"packageName": string,
"versions": [
{
object ( |
Campi | |
---|---|
packageName |
Nome del pacchetto Il nome del pacchetto deve essere specificato durante la specifica di Android Fulfillment. |
versions[] |
Quando vengono specificati più filtri, l'app viene attivata da qualsiasi corrispondenza di filtro. |
VersionFilter
VersionFilter deve essere incluso se sono necessarie versioni specifiche dell'app.
Rappresentazione JSON | |
---|---|
{ "minVersion": integer, "maxVersion": integer } |
Campi | |
---|---|
minVersion |
Codice di versione minimo o 0, inclusi. |
maxVersion |
Codice di versione massimo incluso. L'intervallo considerato è [minVersion:maxVersion]. Un intervallo nullo implica qualsiasi versione. Esempi: per specificare una singola versione, utilizza [target_version:target_version]. Per specificare qualsiasi versione, lascia minVersion e maxVersion non specificati. Per specificare tutte le versioni fino a maxVersion, lascia minVersion non specificata. Per specificare tutte le versioni di minVersion, lascia maxVersion non specificato. |
UrlTypeHint
Diversi tipi di suggerimenti URL.
Enum | |
---|---|
URL_TYPE_HINT_UNSPECIFIED |
Non specificato |
AMP_CONTENT |
URL che indirizza direttamente ai contenuti AMP o a un URL canonico che fa riferimento ai contenuti AMP tramite <link rel="amphtml">. |
ActionMetadata
Metadati correlati per azione.
Rappresentazione JSON | |
---|---|
{ "expireTime": string } |
Campi | |
---|---|
expireTime |
Data di scadenza dell'azione. Un timestamp nel formato RFC3339 UTC "Zulu" con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: |
Informativa
Un'informativa su prodotti, servizi o norme che può essere presentata all'utente.
Rappresentazione JSON | |
---|---|
{ "title": string, "disclosureText": { object ( |
Campi | |
---|---|
title |
Titolo dell'informativa. Esempio: "Informazioni sulla sicurezza". |
disclosureText |
Contenuto della divulgazione. I link web sono consentiti. |
presentationOptions |
Opzioni di presentazione per l'informativa. |
DisclosureText
Rappresenta un testo normale con link web.
Rappresentazione JSON | |
---|---|
{
"template": string,
"textLinks": [
{
object ( |
Campi | |
---|---|
template |
Testo da visualizzare, contenente segnaposto come "{0}" e "{1}" per ogni link di testo da inserire. Esempio: "AVVISO: questo prodotto può esporti a sostanze chimiche che sono note allo stato della California come causa di cancro. Per ulteriori informazioni, visita la pagina {0}." Il testo dell'informativa non deve includere contenuti promozionali o simili a quelli degli annunci. |
textLinks[] |
Link di testo che devono essere sostituiti nel modello. Il primo verrà sostituito con "{0}" nella stringa del modello, la seconda per "{1}" e così via. |
TextLink
Un link di testo che deve essere sostituito nel modello.
Rappresentazione JSON | |
---|---|
{ "displayText": string, "url": string } |
Campi | |
---|---|
displayText |
Testo che deve essere mostrato agli utenti. |
url |
URL a cui gli utenti devono essere indirizzati quando viene attivato il link. |
DisclosurePresentationOptions
Opzioni per la presentazione di un'informativa.
Rappresentazione JSON | |
---|---|
{
"presentationRequirement": enum ( |
Campi | |
---|---|
presentationRequirement |
Requisito di presentazione dell'informativa. |
initiallyExpanded |
Indica se i contenuti dell'informativa devono essere inizialmente espansi. Per impostazione predefinita, inizialmente è compresso. |
PresentationRequirement
Obbligo di presentazione dell'informativa.
Enum | |
---|---|
REQUIREMENT_UNSPECIFIED |
Requisito non specificato. Non deve essere impostato in modo esplicito. |
REQUIREMENT_OPTIONAL |
L'informativa è facoltativa. Puoi saltare questo passaggio se il dispositivo non supporta la visualizzazione delle informative. |
REQUIREMENT_REQUIRED |
L'informativa è obbligatoria. La conversazione verrà indirizzata al telefono se il dispositivo non supporta la visualizzazione di informative. |
PurchaseItemExtension
Contenuti degli elementi pubblicitari del verticale Acquista.
Rappresentazione JSON | |
---|---|
{ "status": enum ( |
Campi | |
---|---|
status |
Obbligatorio: stato a livello di elemento pubblicitario. |
userVisibleStatusLabel |
Obbligatorio: etichetta/stringa visibile all'utente per lo stato. La lunghezza massima consentita è di 50 caratteri. |
type |
Obbligatorio: tipo di acquisto. |
productId |
ID prodotto o offerta associato a questo elemento pubblicitario. |
quantity |
Quantità dell'articolo. |
unitMeasure |
Unità di misura. Specifica la dimensione dell'articolo nelle unità scelte. La taglia, insieme al prezzo attivo, vengono utilizzati per determinare il prezzo unitario. |
returnsInfo |
Restituisce le informazioni per questo elemento pubblicitario. Se il criterio non viene configurato, questo elemento pubblicitario eredita le informazioni sui resi a livello di ordine. |
fulfillmentInfo |
Informazioni di evasione ordine per questo elemento pubblicitario. Se il criterio non viene configurato, l'elemento pubblicitario eredita le informazioni di evasione a livello di ordine. |
itemOptions[] |
Ulteriori componenti aggiuntivi o elementi secondari. |
productDetails |
Dettagli sul prodotto. |
extension |
Eventuali campi aggiuntivi scambiati tra il commerciante e Google. Nota: ti sconsigliamo di utilizzare questa estensione. In base al caso d'uso o alle circostanze, considera una delle seguenti situazioni: 1. Definisci i campi in PurchaseItemestensione se potrebbe essere utilizzato per altri casi d'uso (ad esempio funzionalità/funzionalità generiche). 2. Utilizza vertical_extension se è specifico per un caso d'uso/funzionalità personalizzato e non generico. Un oggetto che contiene campi di tipo arbitrario. Un campo aggiuntivo |
PurchaseStatus
Stato di acquisto associato a un ordine di acquisto o a un determinato elemento pubblicitario.
Enum | |
---|---|
PURCHASE_STATUS_UNSPECIFIED |
Stato non specificato. |
READY_FOR_PICKUP |
Pronto per il ritiro. |
SHIPPED |
Spedito. |
DELIVERED |
Consegnato. |
OUT_OF_STOCK |
Non disponibile. |
IN_PREPARATION |
"IN_PREPARAZIONE" potrebbe avere un significato diverso in un contesto diverso. Per l'ordine CIBO, potrebbe essere il cibo in fase di preparazione. Nel caso della vendita al dettaglio, potrebbe trattarsi di un articolo in fase di confezionamento. |
CREATED |
L'ordine viene creato. |
CONFIRMED |
Il commerciante ha confermato l'ordine. |
REJECTED |
Il commerciante ha rifiutato l'ordine o l'elemento pubblicitario. |
RETURNED |
L'articolo è stato restituito dall'utente. |
CANCELLED |
L'ordine o la voce è stato annullato dall'utente. |
CHANGE_REQUESTED |
L'utente ha richiesto una modifica all'ordine e l'integratore sta elaborando questa modifica. L'ordine deve essere spostato in un altro stato dopo la gestione della richiesta. |
PurchaseType
La categoria di acquisto.
Enum | |
---|---|
PURCHASE_TYPE_UNSPECIFIED |
Valore sconosciuto. |
RETAIL |
Sono inclusi gli acquisti come beni fisici. |
FOOD |
Include l'acquisto di ordini di cibo. |
GROCERY |
Acquisto di generi alimentari. |
MOBILE_RECHARGE |
Acquisto di ricariche di dispositivi mobili prepagate. |
MerchantUnitMeasure
Misura per il prezzo unitario del commerciante.
Rappresentazione JSON | |
---|---|
{
"measure": number,
"unit": enum ( |
Campi | |
---|---|
measure |
Valore: esempio 1.2. |
unit |
Unità: esempio POUND, GRAM. |
Unità
Enum | |
---|---|
UNIT_UNSPECIFIED |
Unità non specificata. |
MILLIGRAM |
Milligrammo. |
GRAM |
Nonna |
KILOGRAM |
Chilogrammo. |
OUNCE |
Oncia. |
POUND |
Sterlina. |
PurchaseReturnsInfo
Restituisce le informazioni associate a un ordine o a un determinato elemento pubblicitario.
Rappresentazione JSON | |
---|---|
{ "isReturnable": boolean, "daysToReturn": integer, "policyUrl": string } |
Campi | |
---|---|
isReturnable |
Se impostato su true, il ritorno è consentito. |
daysToReturn |
La restituzione è consentita entro questo numero di giorni. |
policyUrl |
Link alle norme sui resi. |
PurchaseFulfillmentInfo
Informazioni di evasione associate a un ordine di acquisto o a una determinata voce.
Rappresentazione JSON | |
---|---|
{ "id": string, "fulfillmentType": enum ( |
Campi | |
---|---|
id |
Identificatore univoco per questa opzione di servizio. |
fulfillmentType |
Obbligatorio: il tipo di completamento. |
expectedFulfillmentTime |
Una finestra se è specificato un intervallo di tempo o un orario di arrivo stimato se è stato specificato un singolo orario. Orario di consegna o ritiro previsto. |
expectedPreparationTime |
Una finestra se è specificato un intervallo di tempo o un orario di arrivo stimato se è stato specificato un singolo orario. Tempo previsto per la preparazione del cibo. Preferito una tantum. |
location |
Località di ritiro o consegna. |
expireTime |
Ora di scadenza di questa opzione di evasione degli ordini. Un timestamp nel formato RFC3339 UTC "Zulu" con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: |
price |
Costo di questa opzione. |
fulfillmentContact |
Contatto utente per questo fulfillment. |
shippingMethodName |
Nome del metodo di spedizione selezionato dall'utente. |
storeCode |
StoreCode della località. Esempio: Walmart è il commerciante e storeCode è il negozio di Walmart in cui è avvenuta l'evasione dell'ordine. https://support.google.com/business/answer/3370250?ref_topic=4596653. |
pickupInfo |
Ulteriori informazioni su come verrà scelto l'ordine. Questo campo è applicabile solo se il tipo di completamento è PICKUP. |
Tipo
Tipo di evasione ordine.
Enum | |
---|---|
TYPE_UNSPECIFIED |
Tipo non specificato. |
DELIVERY |
Questo ordine verrà consegnato. |
PICKUP |
Questo ordine deve essere ritirato. |
Ora
Costrutto temporale per rappresentare l'ora di un evento da utilizzare per mostrare un ordine all'utente.
Rappresentazione JSON | |
---|---|
{ "timeIso8601": string } |
Campi | |
---|---|
timeIso8601 |
Rappresenta l'ora dell'evento dell'ordine, ad esempio l'ora della prenotazione, i tempi di consegna e così via. Può essere una durata (ora di inizio e di fine), soltanto la data, la data e così via. Consulta la pagina https://en.wikipedia.org/wiki/ISO_8601 per tutti i formati supportati. |
PickupInfo
Dettagli su come viene ritirato un ordine. Include dettagli come il tipo di ritiro ed eventuali metadati aggiuntivi allegati a ogni tipo.
Rappresentazione JSON | |
---|---|
{ "pickupType": enum ( |
Campi | |
---|---|
pickupType |
Metodo di ritiro, come INSTORE, ALL'ABBONAMENTO ecc. |
curbsideInfo |
Dettagli specifici delle informazioni all'esterno. Se pickupType non è "CURBSIDE", questo campo verrà ignorato. |
checkInInfo[] |
Elenco dei vari metodi supportati dal partner per il supporto del check-in. |
PickupType
Elenco dei tipi di ritiro supportati.
Enum | |
---|---|
UNSPECIFIED |
Tipo di ritiro non specificato. |
INSTORE |
Ritirare il cibo all'interno del ristorante. |
CURBSIDE |
Parcheggia il veicolo in un punto designato fuori dal ristorante dove qualcuno consegna il cibo. |
CurbsideInfo
Dettagli su come agevolare l'ordine all'esterno.
Rappresentazione JSON | |
---|---|
{ "curbsideFulfillmentType": enum ( |
Campi | |
---|---|
curbsideFulfillmentType |
I partner hanno bisogno di informazioni aggiuntive per agevolare gli ordini con ritiro all'esterno. A seconda del tipo di completamento scelto, i dettagli corrispondenti verranno raccolti dall'utente. |
userVehicle |
Dettagli del veicolo dell'utente che effettua l'ordine. |
CurbsideFulfillmentType
Possibili valori per i tipi di distribuzione all'esterno.
Enum | |
---|---|
UNSPECIFIED |
Tipo di fulfillment all'esterno non specificato. |
VEHICLE_DETAIL |
Dettagli del veicolo obbligatori per facilitare il ritiro all'esterno. |
Veicolo
Dettagli su un veicolo
Rappresentazione JSON | |
---|---|
{
"make": string,
"model": string,
"licensePlate": string,
"colorName": string,
"image": {
object ( |
Campi | |
---|---|
make |
Marca del veicolo (ad es. "Honda"). Viene mostrato all'utente e deve essere localizzato. Obbligatorio. |
model |
Modello del veicolo (ad es. "Grom"). Viene mostrato all'utente e deve essere localizzato. Obbligatorio. |
licensePlate |
Numero di targa del veicolo (ad es. "1ABC234"). Obbligatorio. |
colorName |
Nome del colore del veicolo, ad es. nero Facoltativo. |
image |
URL a una foto del veicolo. La foto verrà visualizzata a circa 256 x 256 px. Deve essere in formato jpg o png. (Facoltativo) |
CheckInInfo
Metadati richiesti dal partner per supportare un metodo di check-in.
Rappresentazione JSON | |
---|---|
{
"checkInType": enum ( |
Campi | |
---|---|
checkInType |
Metodo utilizzato per inviare istruzioni per il check-in. |
CheckInType
Vari metodi utilizzati per inviare istruzioni per il check-in.
Enum | |
---|---|
CHECK_IN_TYPE_UNSPECIFIED |
Valore sconosciuto. |
EMAIL |
Le informazioni per il check-in verranno inviate via email. |
SMS |
Le informazioni per il check-in verranno inviate via SMS. |
ItemOption
Rappresenta componenti aggiuntivi o elementi secondari.
Rappresentazione JSON | |
---|---|
{ "id": string, "name": string, "prices": [ { object ( |
Campi | |
---|---|
id |
Per le opzioni che sono articoli, ID articolo univoco. |
name |
Nome opzione. |
prices[] |
Prezzo totale dell'opzione. |
note |
Nota relativa all'opzione. |
quantity |
Per le opzioni relative agli articoli, alla quantità. |
productId |
ID prodotto o offerta associato a questa opzione. |
subOptions[] |
Per definire altre opzioni secondarie nidificate. |
ProductDetails
Dettagli sul prodotto.
Rappresentazione JSON | |
---|---|
{ "productId": string, "gtin": string, "plu": string, "productType": string, "productAttributes": { string: string, ... } } |
Campi | |
---|---|
productId |
ID prodotto o offerta associato a questo elemento pubblicitario. |
gtin |
Codice Global Trade Item Number (GTIN) del prodotto. Utile se offerId non è presente in Merchant Center. (Facoltativo) |
plu |
I codici di ricerca dei prezzi, comunemente chiamati codici PLU, numeri PLU, PLU, codici di prodotto o etichette di prodotti, sono un sistema di numeri che identificano in modo univoco i prodotti all'ingrosso venduti nei negozi di alimentari e supermercati. |
productType |
Categoria di prodotto definita dal commerciante. Ad es. "Home page > Alimentari > Latticini e Uova > Latte > Latte intero" |
productAttributes |
Dettagli forniti dal commerciante sul prodotto, ad es. { "allergen": "peanut" }. Utile se offerId non è presente in Merchant Center. (Facoltativo) Un oggetto contenente un elenco di |
ReservationItemExtension
Contenuti degli elementi pubblicitari per ordini di prenotazione come ristorante, taglio di capelli e così via.
Rappresentazione JSON | |
---|---|
{ "status": enum ( |
Campi | |
---|---|
status |
Obbligatorio: stato di prenotazione. |
userVisibleStatusLabel |
Obbligatorio: etichetta/stringa visibile all'utente per lo stato. La lunghezza massima consentita è di 50 caratteri. |
type |
Tipo di prenotazione. Può essere annullata se nessuna delle opzioni del tipo è applicabile. |
reservationTime |
Ora in cui è pianificato il servizio/l'evento. Può essere un intervallo di tempo, una data o una data e un'ora esatte. |
userAcceptableTimeRange |
Intervallo di tempo accettabile per l'utente. |
confirmationCode |
Codice di conferma per questa prenotazione. |
partySize |
Il numero di persone. |
staffFacilitators[] |
Agevolazioni del personale che si occuperanno della prenotazione. Ad esempio, Il parrucchiere. |
location |
Luogo del servizio/dell'evento. |
ReservationStatus
Stato della prenotazione.
Enum | |
---|---|
RESERVATION_STATUS_UNSPECIFIED |
Stato non specificato. |
PENDING |
La prenotazione è in attesa. |
CONFIRMED |
La prenotazione è confermata. |
CANCELLED |
La prenotazione è stata annullata dall'utente. |
FULFILLED |
La prenotazione è stata completata. |
CHANGE_REQUESTED |
È stata richiesta la modifica della prenotazione |
REJECTED |
Prenotazione scaduta o rifiutata dall'integratore. |
ReservationType
Tipo di prenotazione.
Enum | |
---|---|
RESERVATION_TYPE_UNSPECIFIED |
Tipo non specificato. |
RESTAURANT |
Prenotazione al ristorante. |
HAIRDRESSER |
Prenotazione per il parrucchiere. |
StaffFacilitator
Informazioni sulla persona del servizio.
Rappresentazione JSON | |
---|---|
{
"name": string,
"image": {
object ( |
Campi | |
---|---|
name |
Il nome del facilitatore del personale. Ad esempio, "Mario Rossi" |
image |
Immagini dell'artista. |
PaymentData
Dati di pagamento relativi a un ordine.
Rappresentazione JSON | |
---|---|
{ "paymentResult": { object ( |
Campi | |
---|---|
paymentResult |
Risultato di pagamento utilizzato dall'integratore per completare una transazione. Questo campo verrà compilato da Actions on Google se l'esperienza di pagamento è gestita da Actions-on-Google. |
paymentInfo |
Dati di pagamento relativi all'ordine utili per l'interazione con l'utente. |
PaymentResult
Risultato di pagamento utilizzato dall'integratore per completare una transazione.
Rappresentazione JSON | |
---|---|
{ // Union field |
Campi | ||
---|---|---|
Campo unione result . Vengono forniti i dati di pagamento di Google o il metodo di pagamento del commerciante. result può essere solo uno dei seguenti: |
||
googlePaymentData |
Dati del metodo di pagamento forniti da Google. Se il tuo elaboratore dei pagamenti è indicato come elaboratore dei pagamenti supportato da Google, consulta la pagina https://developers.google.com/pay/api/. Per ulteriori dettagli, accedi al tuo elaboratore dei pagamenti tramite il link. In caso contrario, consulta la seguente documentazione per i dettagli sul payload. https://developers.google.com/pay/api/payment-data-cryptography |
|
merchantPaymentMethodId |
Metodo di pagamento fornito dal commerciante/dall'azione scelto dall'utente. |
PaymentInfo
Dati di pagamento relativi all'ordine effettuato. Questo protocollo acquisisce informazioni utili per l'interazione rivolta agli utenti.
Rappresentazione JSON | |
---|---|
{ "paymentMethodDisplayInfo": { object ( |
Campi | |
---|---|
paymentMethodDisplayInfo |
Le informazioni visualizzate sul metodo di pagamento utilizzato per la transazione. |
paymentMethodProvenance |
La provenienza del metodo di pagamento utilizzato per la transazione. L'utente potrebbe aver registrato lo stesso metodo di pagamento sia con Google sia con il commerciante. |
PaymentMethodDisplayInfo
Risultato di pagamento utilizzato dall'integratore per completare una transazione.
Rappresentazione JSON | |
---|---|
{
"paymentType": enum ( |
Campi | |
---|---|
paymentType |
Il tipo di pagamento. |
paymentMethodDisplayName |
Nome visibile all'utente del metodo di pagamento. Ad esempio, VISA **** 1234 Saving acct **** 5678 |
paymentMethodVoiceName |
Nome del metodo di pagamento da pronunciare all'utente per i dispositivi con assistente solo vocale. Ad esempio, "visto che termina con uno due tre quattro" o "conto corrente che termina con cinque sei sette otto". Nota: questa è la stringa ottimizzata per la voce da utilizzare al posto di paymentMethodDisplayName per i dispositivi con l'assistente solo vocale. Se questa stringa non viene impostata, all'utente verrà pronunciato il metodo paymentMethodDisplayName. |
PaymentType
PaymentType indica la forma di pagamento utilizzata per il metodo di pagamento fornito dal commerciante. L'azione deve anche fornire un nome visualizzato per il metodo di pagamento.
Enum | |
---|---|
PAYMENT_TYPE_UNSPECIFIED |
Tipo di pagamento non specificato. |
PAYMENT_CARD |
Una carta di credito/debito o prepagata. |
BANK |
Il metodo di pagamento è un conto bancario. |
LOYALTY_PROGRAM |
Il metodo di pagamento è un programma fedeltà. |
CASH |
Il metodo di pagamento è in contanti. |
GIFT_CARD |
Il metodo di pagamento è una carta regalo. |
WALLET |
Portafoglio di terze parti, ad es. PayPal |
PaymentMethodProvenance
Rappresenta la provenienza del metodo di pagamento utilizzata per la transazione.
Enum | |
---|---|
PAYMENT_METHOD_PROVENANCE_UNSPECIFIED |
La provenienza non è specificata. |
PAYMENT_METHOD_PROVENANCE_GOOGLE |
La provenienza è Google. |
PAYMENT_METHOD_PROVENANCE_MERCHANT |
La provenienza è il commerciante. |
Promozione
Promozioni/offerte aggiunte al carrello.
Rappresentazione JSON | |
---|---|
{ "coupon": string } |
Campi | |
---|---|
coupon |
Obbligatorio: codice coupon applicato a questa offerta. |
PurchaseOrderExtension
Estensione dell'ordine per il verticale Acquisto. Queste proprietà sono applicabili a tutti gli elementi pubblicitari all'interno dell'ordine, a meno che non vengano sostituite in un elemento pubblicitario.
Rappresentazione JSON | |
---|---|
{ "status": enum ( |
Campi | |
---|---|
status |
Obbligatorio: stato complessivo dell'ordine. |
userVisibleStatusLabel |
Etichetta/stringa visibile all'utente per lo stato. La lunghezza massima consentita è di 50 caratteri. |
type |
Obbligatorio: tipo di acquisto. |
returnsInfo |
Le informazioni per il reso dell'ordine. |
fulfillmentInfo |
Informazioni di evasione ordine per l'ordine. |
purchaseLocationType |
Luogo di acquisto (in negozio / online) |
errors[] |
(Facoltativo) Errori a causa dei quali l'ordine è stato rifiutato. |
extension |
Eventuali campi aggiuntivi scambiati tra il commerciante e Google. Nota: ti sconsigliamo di utilizzare questa estensione. In base al caso d'uso o alle circostanze, considera una delle seguenti situazioni: 1. Definisci i campi in PurchaseOrderEstensione se potrebbe essere utilizzato per altri casi d'uso (ad esempio, funzionalità/funzionalità generica). 2. Utilizza vertical_extension se è specifico per un caso d'uso/funzionalità personalizzato e non generico. Un oggetto che contiene campi di tipo arbitrario. Un campo aggiuntivo |
PurchaseLocationType
Tipo di località in cui è stato effettuato l'acquisto.
Enum | |
---|---|
UNSPECIFIED_LOCATION |
Valore sconosciuto. |
ONLINE_PURCHASE |
Tutti gli acquisti sono stati acquistati online. |
INSTORE_PURCHASE |
Tutti gli acquisti in negozio. |
PurchaseError
Errori per i quali un ordine di acquisto può essere rifiutato.
Rappresentazione JSON | |
---|---|
{ "type": enum ( |
Campi | |
---|---|
type |
Obbligatorio: rappresenta il motivo granulare per cui un ordine viene rifiutato dal commerciante. |
description |
Descrizione aggiuntiva dell'errore. |
entityId |
L'ID entità corrispondente all'errore. Ad esempio, può corrispondere a LineItemId / ItemOptionId. |
updatedPrice |
Rilevante in caso di tipo di errore PRICE_CHANGED / INCORRECT_PRICE. |
availableQuantity |
Quantità disponibile ora. Applicabile in caso di AVAILABILITY_CHANGED. |
ErrorType
Tipi di errori possibili.
Enum | |
---|---|
ERROR_TYPE_UNSPECIFIED |
Errore sconosciuto |
NOT_FOUND |
Entità non trovata, ad esempio Articolo, FulfillmentOption, Promozione. ID entità obbligatorio. |
INVALID |
Dati entità non validi. potrebbe essere Articolo, FulfillmentOption, Promozione. ID entità obbligatorio. |
AVAILABILITY_CHANGED |
Articolo non disponibile o insufficiente per soddisfare la richiesta. ID entità obbligatorio. |
PRICE_CHANGED |
Il prezzo dell'articolo è diverso dal prezzo dell'entità elemento. ID entità e prezzo aggiornato obbligatori. |
INCORRECT_PRICE |
Errori di prezzo in Tariffe, Totale. ID entità e prezzo aggiornato obbligatori. |
REQUIREMENTS_NOT_MET |
Vincoli per l'accettazione dell'ordine non soddisfatti: dimensioni minime del carrello e così via |
TOO_LATE |
FulfillmentOption scaduto. |
NO_CAPACITY |
Nessuna capacità del servizio disponibile. Utilizza questo codice di errore se nessuno dei tipi di errore più granulari è applicabile. |
NO_COURIER_AVAILABLE |
Nessun corriere di consegna trovato. Un tipo di errore granulare che può essere classificato come NO_CAPACITY. |
INELIGIBLE |
L'utente non è idoneo a effettuare un ordine (nella lista nera). |
OUT_OF_SERVICE_AREA |
Impossibile effettuare il recapito all'indirizzo richiesto a causa di regole di confine e così via. |
CLOSED |
Il ristorante è chiuso per l'attività al momento dell'ordinazione. |
PROMO_NOT_APPLICABLE |
Codice di errore generico per individuare tutti i casi di mancata applicazione del codice promozionale, se nessuno di quelli indicati di seguito è idoneo. Aggiungi un codice promozionale come ID entità. |
PROMO_NOT_RECOGNIZED |
Codice coupon non riconosciuto dal partner. Aggiungi un codice promozionale come ID entità. |
PROMO_EXPIRED |
Impossibile applicare la promozione perché è scaduta. Aggiungi un codice promozionale come ID entità. |
PROMO_USER_INELIGIBLE |
L'utente corrente non è idoneo per questo coupon. Aggiungi un codice promozionale come ID entità. |
PROMO_ORDER_INELIGIBLE |
L'ordine corrente non è idoneo per questo coupon. Aggiungi un codice promozionale come ID entità. |
UNAVAILABLE_SLOT |
Lo slot per ordinare non è disponibile. |
FAILED_PRECONDITION |
Limitazioni per l'accettazione dell'ordine non soddisfatte: dimensioni minime del carrello e così via |
PAYMENT_DECLINED |
Pagamento non valido. |
MERCHANT_UNREACHABLE |
Commerciante non raggiungibile. Ciò è utile quando un partner è un aggregatore e non riesce a contattare il commerciante. |
ACCOUNT_LINKING_FAILED |
Il commerciante ha provato a collegare l'Account Google dell'utente a un account nel proprio sistema, ma si è verificato un errore. |
TicketOrderExtension
Contenuti degli ordini di biglietti come film, eventi sportivi e così via
Rappresentazione JSON | |
---|---|
{
"ticketEvent": {
object ( |
Campi | |
---|---|
ticketEvent |
L'evento applicato a tutti i biglietti degli elementi pubblicitari. |
TicketEvent
Rappresenta un singolo evento.
Rappresentazione JSON | |
---|---|
{ "type": enum ( |
Campi | |
---|---|
type |
Obbligatorio: tipo di biglietto dell'evento, ad esempio un film, un concerto. |
name |
Obbligatorio: nome dell'evento. Ad esempio, se l'evento è un film, dovrebbe essere il nome del film. |
description |
Descrizione dell'evento. |
url |
URL delle informazioni sull'evento. |
location |
Il luogo in cui si tiene l'evento o il luogo in cui si trova un'organizzazione. |
eventCharacters[] |
I caratteri correlati a questo evento. Può trattarsi dei registi o degli attori di un evento cinematografico, degli artisti di un concerto e così via. |
startDate |
Ora di inizio |
endDate |
Ora di fine |
doorTime |
L'ora di ingresso, che potrebbe essere diversa dall'ora di inizio dell'evento. ad es. l’evento inizierà alle 9, ma l’ingresso è alle 8:30. |
Tipo
Il tipo di evento.
Enum | |
---|---|
EVENT_TYPE_UNKNOWN |
Tipo di evento sconosciuto. |
MOVIE |
Film. |
CONCERT |
Concerto. |
SPORTS |
Sport. |
EventCharacter
Un carattere evento, ad esempio organizzatore, artista ecc.
Rappresentazione JSON | |
---|---|
{ "type": enum ( |
Campi | |
---|---|
type |
Tipo di carattere dell'evento, ad esempio attore o regista. |
name |
Nome del carattere. |
image |
Immagini del personaggio. |
Tipo
Tipo di carattere.
Enum | |
---|---|
TYPE_UNKNOWN |
Tipo sconosciuto. |
ACTOR |
Attore. |
PERFORMER |
Artista. |
DIRECTOR |
Regista. |
ORGANIZER |
Organizzatore. |
UserNotification
Notifica utente facoltativa da visualizzare come parte dell'aggiornamento dell'ordine.
Rappresentazione JSON | |
---|---|
{ "title": string, "text": string } |
Campi | |
---|---|
title |
Il titolo della notifica per l'utente. La lunghezza massima consentita è di 30 caratteri. |
text |
I contenuti della notifica. La lunghezza massima consentita è di 100 caratteri. |
NextScene
Rappresenta la scena successiva da eseguire.
Rappresentazione JSON | |
---|---|
{ "name": string } |
Campi | |
---|---|
name |
Nome della scena successiva da eseguire. |
Sessione
Contiene informazioni sulla sessione di conversazione corrente
Rappresentazione JSON | |
---|---|
{
"id": string,
"params": {
string: value,
...
},
"typeOverrides": [
{
object ( |
Campi | |
---|---|
id |
Obbligatorio. ID univoco a livello globale della sessione di conversazione corrente. Questo campo è di sola lettura. |
params |
Obbligatorio. Elenco di tutti i parametri raccolti da moduli e intent durante la sessione. La chiave è il nome del parametro. I parametri definiti qui verranno uniti a quelli già definiti nella sessione. I parametri con un valore nullo verranno rimossi dalla sessione. Consulta la documentazione relativa all'archiviazione delle sessioni: https://developers.google.com/assistant/conversational/storage-session. Un oggetto contenente un elenco di |
typeOverrides[] |
(Facoltativo) Tipi con ambito alla sessione. La definizione del tipo di sessione può integrare o sostituire i tipi esistenti. I nomi dei tipi devono essere univoci. |
languageCode |
Lingua della sessione di conversazione corrente. Segue il codice lingua IETF BCP-47 http://www.rfc-editor.org/rfc/bcp/bcp47.txt. Potrebbe essere diverso dalle impostazioni internazionali dell'utente se l'azione utilizza funzionalità multilingue. Ad esempio, se viene impostato gestore_response.expected.language_code, modifica la lingua della conversazione per tutte le svolte successive. I dati verranno riportati in questo campo. |
TypeOverride
Rappresenta un override per un tipo.
Rappresentazione JSON | |
---|---|
{ "name": string, "mode": enum ( |
Campi | |
---|---|
name |
Obbligatorio. Nome del tipo da integrare o sostituire. |
mode |
Obbligatorio. Modalità di unione di questo tipo con altri valori di tipo. |
synonym |
|
TypeOverrideMode
I tipi di modifiche per un tipo di entità sessione.
Enum | |
---|---|
TYPE_UNSPECIFIED |
Non specificato. Questo valore non deve mai essere utilizzato. |
TYPE_REPLACE |
Le definizioni del tipo in questa risposta sostituiranno le definizioni del tipo definite in precedenza. |
TYPE_MERGE |
Le definizioni del tipo in questa risposta verranno unite a quelle definite in precedenza. Le nuove definizioni del tipo sovrascriveranno quelle esistenti. |
SynonymType
Rappresenta un tipo con sinonimi.
Rappresentazione JSON | |
---|---|
{
"entries": [
{
object ( |
Campi | |
---|---|
entries[] |
Obbligatorio. Elenco di voci per il tipo di sinonimo. |
Voce
Rappresenta una voce per un tipo di sinonimo.
Rappresentazione JSON | |
---|---|
{
"name": string,
"synonyms": [
string
],
"display": {
object ( |
Campi | |
---|---|
name |
Obbligatorio. Nome della voce (ad es. "bicicletta"). La voce in questo campo deve essere inclusa nel campo dei sinonimi ripetuti per poter essere riconosciuta come un valore di tipo valido. |
synonyms[] |
Obbligatorio. Elenco di sinonimi della voce (ad es. "bike", "cycle"). |
display |
(Facoltativo) Le informazioni della visualizzazione dell'articolo. |
EntryDisplay
Rappresentazione JSON | |
---|---|
{ "title": string, "description": string, "image": { object ( |
Campi | |
---|---|
title |
Obbligatorio. Titolo dell'articolo. Se toccato, il testo viene pubblicato nella conversazione parola per parola, come se l'utente lo avesse digitato. Ogni titolo deve essere univoco nell'insieme di elementi della raccolta. |
description |
(Facoltativo) Corpo del testo della scheda. |
image |
(Facoltativo) L'immagine da visualizzare. |
footer |
(Facoltativo) Testo a piè di pagina per l'elemento della raccolta Esplora, visualizzato sotto la descrizione. Una singola riga di testo, troncata con i puntini di sospensione. |
openUrl |
URL del documento associato all'elemento di navigazione del carosello. Obbligatorio per sfogliare il carosello. |
Utente
Rappresenta l'utente che invia una richiesta all'azione.
Rappresentazione JSON | |
---|---|
{ "locale": string, "params": { string: value, ... }, "accountLinkingStatus": enum ( |
Campi | |
---|---|
locale |
Impostazione delle impostazioni internazionali principali dell'utente che effettua la richiesta. Segue il codice lingua IETF BCP-47 http://www.rfc-editor.org/rfc/bcp/bcp47.txt. Tuttavia, il sottotag dello script non è incluso. |
params |
(Facoltativo) Elenco di tutti i parametri associati all'utente corrente. Consulta la documentazione relativa allo spazio di archiviazione dell'utente: https://developers.google.com/assistant/conversational/storage-user. Un oggetto contenente un elenco di |
accountLinkingStatus |
Se l'account utente è collegato all'app. |
verificationStatus |
Indica lo stato di verifica dell'utente. |
lastSeenTime |
Il timestamp dell'ultima interazione con l'utente. Questo campo verrà omesso se l'utente non ha mai interagito con l'agente. Un timestamp nel formato RFC3339 UTC "Zulu" con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: |
engagement |
Il coinvolgimento dell'utente corrente, incluse le eventuali iscrizioni agli intent. |
packageEntitlements[] |
Diritti dell'utente relativi al pacchetto Android associato all'azione corrente. |
permissions[] |
Contiene le autorizzazioni concesse dall'utente a questa azione. |
AccountLinkingStatus
Indica se l'utente finale ha collegato il proprio account a questa app. Consulta la documentazione sul collegamento degli account: https://developers.google.com/assistant/identity.
Enum | |
---|---|
ACCOUNT_LINKING_STATUS_UNSPECIFIED |
Sconosciuto. |
NOT_LINKED |
L'utente non ha collegato il proprio account a questa app. |
LINKED |
L'utente ha collegato il proprio account a questa app. |
UserVerificationStatus
Indica se Google ha verificato l'utente. Lo stato VERIFICATO indica che puoi salvare i dati delle varie conversazioni utilizzando il campo dei parametri o collegando l'account.
Enum | |
---|---|
USER_VERIFICATION_STATUS_UNSPECIFIED |
Sconosciuto. |
GUEST |
Utente ospite. |
VERIFIED |
Utente verificato. |
Coinvolgimento
Fornisce ulteriori informazioni di sola lettura sui meccanismi di coinvolgimento a cui l'utente corrente si è registrato. Ad esempio, può essere utile sapere a quali intent l'utente è già abbonato per evitare di chiedergli di abbonarsi nuovamente alla stessa intenzione. Ad esempio, queste informazioni possono essere utilizzate per indirizzare in modo condizionale a una scena e impostare DailyUpdates o Push Notifications solo se l'utente non ha già effettuato l'iscrizione. Consulta la documentazione relativa al coinvolgimento degli utenti: https://developers.google.com/assistant/engagement.
Rappresentazione JSON | |
---|---|
{ "pushNotificationIntents": [ { object ( |
Campi | |
---|---|
pushNotificationIntents[] |
Contiene un elenco di intent per i quali l'utente ha attivato le notifiche push. |
dailyUpdateIntents[] |
Contiene un elenco di intent per i quali l'utente ha attivato l'aggiornamento giornaliero. |
IntentSubscription
Descrive una sottoscrizione Intent esistente.
Rappresentazione JSON | |
---|---|
{ "intent": string, "contentTitle": string } |
Campi | |
---|---|
intent |
Nome dell'intent a cui hai sottoscritto l'abbonamento. |
contentTitle |
Una breve descrizione dell'abbonamento. Viene utilizzato come etichetta della notifica e quando l'assistente richiede l'autorizzazione all'utente. |
PackageEntitlements
Un elenco di diritti dell'utente relativi a un nome pacchetto. Consulta la documentazione sulle transazioni idonee per il digitale: https://developers.google.com/assistant/transactions/digital/dev-guide-digital-non-consumables.
Rappresentazione JSON | |
---|---|
{
"packageName": string,
"entitlements": [
{
object ( |
Campi | |
---|---|
packageName |
Il nome del pacchetto Android specificato nel pacchetto di azioni. |
entitlements[] |
I diritti dell'utente per il pacchetto specificato. |
Diritto
Definisce il diritto digitale dell'utente.
Rappresentazione JSON | |
---|---|
{ "sku": string, "skuType": enum ( |
Campi | |
---|---|
sku |
SKU del prodotto. Nome del pacchetto per l'app a pagamento, suffisso del documento Finsky per acquisti in-app e abbonamento in-app. Crea una corrispondenza con getSku() nell'API Fatturazione in-app di Play. Consulta la documentazione relativa alla Fatturazione in-app di Play: https://developer.android.com/google/play/billing. |
skuType |
Il tipo di SKU. |
inAppDetails |
Presente solo per acquisti in-app e abbonamenti in-app. |
SkuType
Enum | |
---|---|
SKU_TYPE_UNSPECIFIED |
|
IN_APP |
Acquisto in-app |
SUBSCRIPTION |
Iscrizioni |
APP |
App a pagamento |
SignedData
Rappresentazione JSON | |
---|---|
{ "inAppPurchaseData": { object }, "inAppDataSignature": string } |
Campi | |
---|---|
inAppPurchaseData |
Contiene tutti i dati sugli acquisti inapp in formato JSON. Consulta i dettagli nella tabella 6 della pagina https://developer.android.com/google/play/billing/billing_reference.html. |
inAppDataSignature |
Corrisponde a IN_APP_DATA_SIGNATURE dal metodo getPurchases() dell'API Fatturazione InApp di Play. |
Autorizzazione
Valori possibili per l'autorizzazione.
Enum | |
---|---|
PERMISSION_UNSPECIFIED |
Autorizzazione non specificata. |
DEVICE_PRECISE_LOCATION |
Chiedi la posizione esatta, la latitudine/longitudine e l'indirizzo formattato dell'utente. |
DEVICE_COARSE_LOCATION |
Chiedi all'utente la posizione approssimativa, il codice postale, la città e il codice paese. |
UPDATE |
Chiedi le autorizzazioni per inviare aggiornamenti. Visita la pagina https://developers.google.com/assistant/engagement/daily. |
Home
Rappresenta la struttura di Home Graph a cui appartiene il dispositivo di destinazione dell'utente.
Rappresentazione JSON | |
---|---|
{ "params": { string: value, ... } } |
Campi | |
---|---|
params |
(Facoltativo) Elenco di parametri associati alla struttura Home Graph a cui appartiene il dispositivo di destinazione. Consulta la documentazione relativa all'archiviazione in casa: https://developers.google.com/assistant/conversational/storage-home. Un oggetto contenente un elenco di |
Dispositivo
Rappresenta il dispositivo utilizzato dall'utente per inviare una richiesta all'azione.
Rappresentazione JSON | |
---|---|
{ "capabilities": [ enum ( |
Campi | |
---|---|
capabilities[] |
Obbligatorio. le capacità del dispositivo che invia una richiesta all'Azione. |
currentLocation |
(Facoltativo) La posizione del dispositivo dell'utente. Tieni presente che il campo viene compilato solo dopo che l'utente finale ha concesso le autorizzazioni di accesso alla posizione. Consulta il messaggio della posizione per ulteriori dettagli su quali campi vengono impostati in base all'autorizzazione approssimativa o granulare. Consulta la documentazione sulle autorizzazioni: https://developers.google.com/assistant/conversational/permissions. |
timeZone |
(Facoltativo) Fuso orario associato al dispositivo client. Può essere utilizzato per risolvere i valori data/ora. |
Capacità
Funzionalità supportate dalla piattaforma del dispositivo al momento della richiesta.
Enum | |
---|---|
UNSPECIFIED |
Capacità dispositivo non specificata. |
SPEECH |
Il dispositivo può parlare con l'utente tramite la sintesi vocale o SSML. |
RICH_RESPONSE |
Il dispositivo può visualizzare risposte avanzate come schede, elenchi e tabelle. |
LONG_FORM_AUDIO |
Il dispositivo può riprodurre contenuti multimediali audio nel formato lungo, come musica e podcast. |
INTERACTIVE_CANVAS |
Il dispositivo può visualizzare una risposta canvas interattiva. |
WEB_LINK |
Il dispositivo può usare link web nelle risposte avanzate per aprire un browser web. |
HOME_STORAGE |
Il dispositivo può supportare il salvataggio e il recupero dello spazio di archiviazione della casa. |
Località
Container che rappresenta una località.
Rappresentazione JSON | |
---|---|
{ "coordinates": { object ( |
Campi | |
---|---|
coordinates |
Coordinate geografiche. Richiede l'autorizzazione [DEVICE_PRECISE_LOCATION]. |
postalAddress |
Indirizzo postale. Richiede l'autorizzazione [DEVICE_PRECISE_LOCATION] o [DEVICE_COARSE_LOCATION]. Quando viene concessa l'autorizzazione di accesso alla posizione approssimativa, solo il "postalCode" e "locality" devono essere compilati. L'autorizzazione di accesso alla posizione esatta completerà campi aggiuntivi come "administrativeArea" e "addressLines". |
TimeZone
Rappresenta un fuso orario del database dei fusi orari IANA.
Rappresentazione JSON | |
---|---|
{ "id": string, "version": string } |
Campi | |
---|---|
id |
Fuso orario IANA Time Zone Database, ad esempio "America/New_York". |
version |
(Facoltativo) Numero di versione di IANA Time Zone Database, ad esempio "2019a". |
Contesto
Contiene informazioni sul contesto quando l'utente esegue una query. Questo contesto include, a titolo esemplificativo, informazioni sulla sessione multimediale attiva, sullo stato dell'app web canvas e così via.
Rappresentazione JSON | |
---|---|
{ "media": { object ( |
Campi | |
---|---|
media |
Contiene informazioni contestuali sulla sessione multimediale attiva corrente. |
canvas |
Contiene informazioni contestuali sul canvas corrente. |
MediaContext
Contiene informazioni contestuali sulla sessione multimediale attiva corrente.
Rappresentazione JSON | |
---|---|
{ "progress": string, "index": integer } |
Campi | |
---|---|
progress |
Avanzamento dei contenuti multimediali del file multimediale attivo corrente. Durata in secondi con un massimo di nove cifre frazionarie, terminata da " |
index |
Indice in base a 0 del file multimediale attivo corrente nell'elenco dei file multimediali nella risposta multimediale. |
CanvasContext
Contiene informazioni contestuali sul canvas corrente.
Rappresentazione JSON | |
---|---|
{ "state": value } |
Campi | |
---|---|
state |
(Facoltativo) Stato impostato dall'app Interactive Canvas di terze parti. È impostato solo per la richiesta, non per la risposta. Ad esempio, se si tratta di un'app di ricette, lo stato può essere un valore di struct : { "current_page" : 5, "ultima_pagina" : 3, } Il limite di dimensione è 50 kB. |
Attesi
Descrive le aspettative per la successiva svolta di dialogo.
Rappresentazione JSON | |
---|---|
{ "speech": [ string ] } |
Campi | |
---|---|
speech[] |
Elenco di frasi che l'azione si aspetta dalle parole pronunciate dall'utente per la differenziazione della voce. Sono consentite fino a 1000 frasi. Nota: questo campo ha lo stesso significato di ExpectInput.Speech_biasing_hints nell'API v2. |