- Richiesta HTTP
- Corpo della richiesta
- Corpo della risposta
- Gestore
- Intenzione
- IntentParameterValue
- Scena
- SlotFillingStatus
- Slot
- SlotMode
- SlotStatus
- Richiesta
- 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
- Elemento
- Suggerimento
- Tela
- ContinuousMatchConfig
- ExpectedPhrase
- OrderUpdate
- Digitare
- Ordine
- UserInfo
- PhoneNumber
- Immagine
- Commerciante
- Località
- LatLng
- PostalAddress
- Sommario
- LineItem
- PriceAttribute
- Digitare
- Stato
- Valore monetario
- Azione
- Digitare
- OpenUrlAction
- AndroidApp
- VersionFilter
- UrlTypeHint
- ActionMetadata
- Divulgazione
- DisclosureText
- TextLink
- DisclosurePresentationOptions
- PresentationRequirement
- PurchaseItemExtension
- PurchaseStatus
- PurchaseType
- MerchantUnitMeasure
- Unità
- PurchaseReturnsInfo
- PurchaseFulfillmentInfo
- Digitare
- 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
- Digitare
- EventCharacter
- Digitare
- 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
- Previsto
RPC, che rappresenta l'API di 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 che ha come obiettivo l'acquisizione di un dato potrebbe avere un gestore con il nome "getFact". |
intent |
Obbligatorio. Rappresenta l'ultimo intent corrispondente. Vedi https://developers.google.com/assistant/conversational/intents. |
scene |
Campo facoltativo. Informazioni sulla scena attuale e successiva quando è stata chiamata la funzione. Verrà compilato quando la chiamata di fulfillment viene effettuata nell'ambito di una scena. Vedi https://developers.google.com/assistant/conversational/scenes. |
session |
Obbligatorio. Contiene i dati della sessione, ad esempio l'ID sessione e i parametri di sessione. |
user |
Obbligatorio. Utente che ha avviato la conversazione. |
home |
Campo 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 |
Campo facoltativo. Informazioni del contesto attuale della richiesta. Sono incluse, a titolo esemplificativo, le informazioni sulle sessioni multimediali attive o le informazioni su 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 |
Campo facoltativo. Rappresentano le richieste da inviare all'utente, che verranno aggiunte ai messaggi aggiunti in precedenza, a meno che non vengano sovrascritte esplicitamente. |
scene |
Campo facoltativo. Rappresenta la scena corrente e quella successiva. Se il criterio |
session |
Campo facoltativo. Descrive i dati della sessione corrente; i parametri di sessione possono essere creati, aggiornati o rimossi dal fulfillment. |
user |
Campo facoltativo. Utilizzalo per specificare i parametri utente da restituire. |
home |
Campo 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 |
Campo facoltativo. Per spostarsi tra i dispositivi con l'assistente a cui l'utente ha accesso. |
expected |
Campo facoltativo. Descrive le aspettative per la prossima svolta del 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 nel fulfillment. Ad esempio, un gestore potrebbe essere utilizzato per ottenere informazioni sulle informazioni relative all'ordine di un utente con un nome gestore come "OrderLookup", mentre un altro potrebbe ricevere informazioni sul prodotto da un database, con un nome gestore come "GetProductInfo".
Rappresentazione JSON | |
---|---|
{ "name": string } |
Campi | |
---|---|
name |
Campo facoltativo. Il nome del gestore. |
Intenzione
Rappresenta un intento. Vedi https://developers.google.com/assistant/conversational/intents.
Rappresentazione JSON | |
---|---|
{
"name": string,
"params": {
string: {
object ( |
Campi | |
---|---|
name |
Obbligatorio. Il nome dell'ultimo intent con corrispondenza. |
params |
Obbligatorio. Rappresenta i parametri identificati come parte della corrispondenza di intent. È una mappa del nome del parametro identificato al valore del parametro identificato dall'input utente. Tutti i parametri definiti nell'intent corrispondente identificati verranno mostrati qui. Un oggetto contenente un elenco di |
query |
Campo facoltativo. Input digitato o vocale dell'utente finale corrispondente a questo intento. Questo campo viene compilato quando viene trovata una corrispondenza con un intent, in base all'input 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 dalle frasi dell'utente. |
resolved |
Obbligatorio. Valore strutturato per il parametro estratto dall'input utente. Verrà compilato solo se il parametro viene definito nell'intent con corrispondenza e se è possibile identificare il valore del parametro durante la corrispondenza dell'intent. |
Scena
Rappresentare una scena. Le scene possono richiamare il completamento, aggiungere prompt e raccogliere valori di slot dall'utente. Le scene vengono attivate da eventi o intent e possono attivare eventi e associare gli intent per passare ad altre scene.
Rappresentazione JSON | |
---|---|
{ "name": string, "slotFillingStatus": enum ( |
Campi | |
---|---|
name |
Obbligatorio. Il nome della scena corrente. |
slotFillingStatus |
Obbligatorio. Lo stato attuale dell'inserimento 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 |
Campo facoltativo. Informazioni sulla scena da eseguire successivamente. |
SlotFillingStatus
Rappresenta lo stato attuale della compilazione degli slot.
Enum | |
---|---|
UNSPECIFIED |
Valore di riserva quando il campo di utilizzo non viene compilato. |
INITIALIZED |
Gli slot sono stati inizializzati, ma il riempimento degli slot non è iniziato. |
COLLECTING |
È in corso la raccolta dei valori degli slot. |
FINAL |
Tutti i valori dell'area annuncio sono definitivi e non possono essere modificati. |
Area
Rappresenta uno slot.
Rappresentazione JSON | |
---|---|
{ "mode": enum ( |
Campi | |
---|---|
mode |
La modalità dello slot (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 comporterà la modifica del valore del riempimento degli slot. |
updated |
Indica se il valore dello slot è stato raccolto nell'ultimo turno. Questo campo è di sola lettura. |
prompt |
Campo facoltativo. Questo messaggio viene inviato all'utente quando serve per riempire uno slot 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 di utilizzo non viene compilato. |
OPTIONAL |
Indica che lo slot non è necessario per completare il riempimento degli slot. |
REQUIRED |
Indica che l'area annuncio è necessaria per completare il riempimento. |
SlotStatus
Rappresenta lo stato di un'area.
Enum | |
---|---|
SLOT_UNSPECIFIED |
Valore di riserva quando il campo di utilizzo non viene 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 lo slot ha un valore. Questo stato non può essere modificato tramite la risposta. |
Prompt
Rappresenta una risposta a un utente. Vedi https://developers.google.com/assistant/conversational/prompts.
Rappresentazione JSON | |
---|---|
{ "override": boolean, "firstSimple": { object ( |
Campi | |
---|---|
override |
Campo facoltativo. Modalità per l'unione di questi messaggi a quelli definiti in precedenza. "true" cancella tutti i messaggi definiti in precedenza (primo e ultimo semplice, contenuti, link ai suggerimenti e canvas) e aggiunge i messaggi definiti in questo prompt. "false" aggiunge i messaggi definiti in questa richiesta ai messaggi definiti nelle risposte precedenti. Se lasci questo campo su "false", puoi anche aggiungere alcuni campi all'interno dei prompt semplici, dei suggerimenti e di Canvas (parte del prompt dei contenuti). I messaggi relativi ai contenuti e ai link vengono sempre sovrascritti, se definiti nel prompt. Il valore predefinito è "false". |
firstSimple |
Campo facoltativo. La prima risposta vocale e di solo testo. |
content |
Campo facoltativo. Contenuti come una scheda, un elenco o un contenuto multimediale da mostrare all'utente. |
lastSimple |
Campo facoltativo. L'ultima risposta vocale e di solo testo. |
suggestions[] |
Campo facoltativo. Suggerimenti da mostrare all'utente, che saranno sempre visualizzati alla fine della risposta. Se il campo "Sostituisci" nel prompt contenente è "false", i titoli definiti in questo campo verranno aggiunti ai titoli definiti nei prompt di suggerimenti definiti in precedenza e i valori duplicati verranno rimossi. |
link |
Campo facoltativo. Un chip di suggerimenti aggiuntivo che può rimandare all'app o al sito associati. Il chip verrà visualizzato con il titolo "Apri (nome)". Massimo 20 caratteri. |
canvas |
Campo facoltativo. Rappresenta una risposta Interactive Canvas da inviare all'utente. |
orderUpdate |
L'Azione facoltativa risponde con un valore OrderUpdate dopo aver ricevuto l'ordine durante il flusso di transazioni. Una volta ricevuto questo messaggio, Google registra questo aggiornamento dell'ordine e, in caso di esito positivo, mostra una 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 |
Campo facoltativo. Rappresenta il parlato che verrà detto all'utente. Può essere SSML o sintesi vocale. Se il campo "override" nel prompt contenente è "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 visualizzato del campo vocale qui sopra. Limite: 640 caratteri. Se il campo "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 prompt di selezione.
Rappresentazione JSON | |
---|---|
{ // Union field |
Campi | ||
---|---|---|
Campo di unione
|
||
card |
Una scheda di base. |
|
image |
Un'immagine. |
|
table |
Scheda tabella. |
|
media |
Risposta che indica un insieme di contenuti multimediali da riprodurre. |
|
collection |
Una scheda che presenta una raccolta di opzioni tra cui scegliere. |
|
list |
Una scheda con un elenco di opzioni tra cui scegliere. |
|
collectionBrowse |
Una scheda che presenta una raccolta di pagine web da aprire. |
Scheda
Una scheda di base per visualizzare alcune informazioni, ad esempio un'immagine e/o del testo. Consulta la pagina 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. Campo facoltativo. |
subtitle |
Campo 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 promozionale per la scheda. L'altezza è fissa a 192 dp. Campo facoltativo. |
imageFill |
Il modo in cui verrà riempito lo sfondo dell'immagine. Campo facoltativo. |
button |
Pulsante con un link in uscita. Campo 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 JPG, PNG e GIF (animate e non animate). Ad esempio, |
alt |
Una descrizione testuale dell'immagine da utilizzare per l'accessibilità, ad esempio screen reader. Obbligatorio. |
height |
L'altezza dell'immagine in pixel. Campo facoltativo. |
width |
La larghezza dell'immagine in pixel. Campo facoltativo. |
ImageFill
Possibili opzioni di visualizzazione dell'immagine che influiscono sulla presentazione dell'immagine. Da utilizzare quando le proporzioni dell'immagine non corrispondono a quelle del contenitore dell'immagine.
Enum | |
---|---|
UNSPECIFIED |
|
GRAY |
Colma gli spazi vuoti tra l'immagine e il contenitore dell'immagine con barre grigie. |
WHITE |
Colma gli spazi vuoti tra l'immagine e il contenitore dell'immagine 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. Questa opzione potrebbe ritagliare la parte superiore e inferiore dell'immagine se l'altezza scalata è maggiore dell'altezza del contenitore oppure ritagliare la parte sinistra e destra dell'immagine se la larghezza dell'immagine scalata è maggiore di quella del contenitore. Questa impostazione è simile alla "modalità zoom" su una TV widescreen quando viene riprodotto un video in formato 4:3. |
Collegamento
Un chip di suggerimenti aggiuntivo che può rimandare all'app o al sito associati. Il chip verrà visualizzato con il titolo "Apri (nome)".
Rappresentazione JSON | |
---|---|
{
"name": string,
"open": {
object ( |
Campi | |
---|---|
name |
Nome del collegamento. Massimo 20 caratteri. |
open |
Che cosa succede quando un utente apre il link |
OpenUrl
Rappresentazione JSON | |
---|---|
{
"url": string,
"hint": enum ( |
Campi | |
---|---|
url |
Il campo dell'URL, che può essere uno dei seguenti: - URL http/https per aprire un'app o una pagina web collegate all'app |
hint |
Indica un suggerimento per il tipo di URL. |
UrlHint
Diversi tipi di suggerimenti URL.
Enum | |
---|---|
LINK_UNSPECIFIED |
Non specificato |
AMP |
URL che rimanda direttamente ai contenuti AMP o a un URL canonico che fa riferimento ai contenuti AMP tramite . Visita la pagina https://amp.dev/. |
Tabella
Una scheda per visualizzare una tabella di testo. Consulta la pagina https://developers.google.com/assistant/conversational/prompts-rich#table_cards.
Rappresentazione JSON | |
---|---|
{ "title": string, "subtitle": string, "image": { object ( |
Campi | |
---|---|
title |
Titolo generale della tabella. Facoltativo, ma deve essere impostato se è impostato un sottotitolo. |
subtitle |
Sottotitolo della tabella. Campo facoltativo. |
image |
Immagine associata alla tabella. Campo facoltativo. |
columns[] |
Intestazioni e allineamento delle colonne. |
rows[] |
Dati delle righe della tabella. È garantito che vengano mostrate le prime 3 righe, ma altre potrebbero essere tagliate su alcune superfici. Fai una prova con il simulatore per vedere quali righe verranno mostrate 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 della colonna dei contenuti in alto. Se non specificati, i contenuti verranno allineati al bordo iniziale. |
HorizontalAlignment
L'allineamento dei contenuti all'interno della cella.
Enum | |
---|---|
UNSPECIFIED |
|
LEADING |
Bordo iniziale della cella. Questa è l'impostazione predefinita. |
CENTER |
I contenuti sono allineati al centro della colonna. |
TRAILING |
I contenuti sono allineati al bordo finale della colonna. |
TableRow
Descrive una riga della tabella.
Rappresentazione JSON | |
---|---|
{
"cells": [
{
object ( |
Campi | |
---|---|
cells[] |
Celle in questa riga. È garantito che le prime 3 celle vengano visualizzate, ma altre potrebbero essere tagliate su determinate superfici. Fai una prova con il simulatore per vedere quali celle verranno mostrate per una determinata superficie. |
divider |
Indica se dopo ogni riga deve essere presente un divisore. |
TableCell
Descrive una cella in una riga.
Rappresentazione JSON | |
---|---|
{ "text": string } |
Campi | |
---|---|
text |
Contenuti testuali della cella. |
Contenuti multimediali
Rappresenta un oggetto multimediale. Contiene informazioni sui contenuti multimediali, come nome, descrizione, URL e così via. Consulta la pagina https://developers.google.com/assistant/conversational/prompts-media.
Rappresentazione JSON | |
---|---|
{ "mediaType": enum ( |
Campi | |
---|---|
mediaType |
|
startOffset |
Offset iniziale del primo oggetto multimediale. Una durata in secondi con un massimo di nove cifre frazionarie, terminata da " |
optionalMediaControls[] |
Tipi di controlli multimediali facoltativi supportati da questa sessione di risposte multimediali. Se impostato, la richiesta verrà effettuata a 3p 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 0 del primo oggetto multimediale da riprodurre nei mediaObjects. 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 contenuti multimediali. |
OptionalMediaControls
Tipi di controlli multimediali facoltativi supportati dalla risposta multimediale
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 multimediale. |
MediaObject
Rappresenta un singolo oggetto multimediale
Rappresentazione JSON | |
---|---|
{
"name": string,
"description": string,
"url": string,
"image": {
object ( |
Campi | |
---|---|
name |
Il 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 Contenuti multimediali. |
MediaImage
Rappresentazione JSON | |
---|---|
{ // Union field |
Campi | ||
---|---|---|
Campo di unione
|
||
large |
Un'immagine di grandi dimensioni, ad esempio la copertina dell'album e così via. |
|
icon |
Una piccola icona con un'immagine visualizzata sulla destra del 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 la sessione multimediale alla fine dell'ultimo oggetto multimediale. |
ALL |
Consente di eseguire il loop all'inizio del primo oggetto multimediale quando viene raggiunta la fine dell'ultimo oggetto multimediale. |
Raccolta
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. Campo facoltativo. |
subtitle |
Sottotitolo della raccolta. Campo 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. Campo facoltativo. |
CollectionItem
Un elemento della raccolta
Rappresentazione JSON | |
---|---|
{ "key": string } |
Campi | |
---|---|
key |
Obbligatorio. La chiave NLU che corrisponde 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. Campo facoltativo. |
subtitle |
Sottotitolo dell'elenco. Campo 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 che corrisponde al nome della chiave di accesso nel tipo associato. |
CollectionBrowse
Presenta un insieme di documenti web come una raccolta di elementi di grandi dimensioni. È possibile selezionare gli elementi per avviare il documento web associato in un visualizzatore web. Vedi 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. |
Articolo
Elemento nella 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. 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 che utilizzano dispositivi compatibili con i display dei chip di suggerimenti quando l'assistente visualizza la richiesta. Utilizza i chip di suggerimenti per suggerire le risposte degli utenti per continuare o cambiare la conversazione. Quando toccato, un chip di suggerimento restituisce il testo visualizzato alla conversazione parola per parola, 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. Una volta toccato, il testo viene pubblicato nuovamente nella conversazione, come se l'utente lo avesse digitato. Ogni titolo deve essere univoco nell'insieme di chip di suggerimenti. Massimo 25 caratteri |
Tela
Rappresenta una risposta Interactive Canvas da inviare all'utente. Questa opzione può essere utilizzata in combinazione con il campo "firstSimple" nel prompt contenitore 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, verrà riutilizzato l'URL della tela attiva corrente. |
data[] |
Campo facoltativo. Dati JSON da trasmettere alla pagina web dell'esperienza immersiva sotto forma di evento. Se il campo "Sostituisci" nel prompt contenente è "false", i valori dei dati definiti nel prompt di Canvas verranno aggiunti dopo i valori dei dati definiti nei prompt di Canvas precedenti. |
suppressMic |
Campo facoltativo. Valore predefinito: false. |
continuousMatchConfig |
Configurazione utilizzata per avviare la modalità corrispondenza continua. |
ContinuousMatchConfig
Configurazione utilizzata per avviare la modalità corrispondenza continua.
Rappresentazione JSON | |
---|---|
{
"expectedPhrases": [
{
object ( |
Campi | |
---|---|
expectedPhrases[] |
Tutte le possibili frasi previste durante questa sessione in modalità corrispondenza continua. |
durationSeconds |
Durata per mantenere attiva la modalità 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 trovare durante una sessione in modalità corrispondenza continua. |
alternativePhrases[] |
Alcune frasi potrebbero essere riconosciute erroneamente dal modello vocale anche con differenziazione della voce. Ciò consente agli sviluppatori di specificare attivatori alternativi per gli omofoni. |
OrderUpdate
Aggiorna un ordine.
Rappresentazione JSON | |
---|---|
{ "type": enum ( |
Campi | |
---|---|
type |
Deprecato: utilizza OrderUpdate.update_mask. Se type = SNAPSHOT, OrderUpdate.order deve essere l'intero ordine. Se type = ORDER_STATUS, questa è la modifica dello stato a livello di ordine. Vengono presi in considerazione solo order.last_update_time e questo stato verticale. Nota: type.ORDER_STATUS supporta solo gli aggiornamenti dello stato PurcahaseOrderExtension e non è previsto l'estensione di questo supporto. Consigliamo invece di utilizzare updateMask, poiché è più generico, estendibile e può essere utilizzato per tutti i verticali. |
order |
|
updateMask |
Nota: vi sono i seguenti suggerimenti/considerazioni per i seguenti campi speciali: 1. order.last_update_time sarà 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 come parte di updateMask. Si tratta di un elenco separato da virgole di nomi completi dei campi. Esempio: |
userNotification |
Se specificato, mostra una notifica all'utente con il titolo e il testo specificati. La specifica di una notifica è un suggerimento per inviare una notifica e non è garantito che venga inviata una notifica. |
reason |
Motivo della modifica o dell'aggiornamento. |
Tipo
Deprecato: utilizza 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 l'istantanea dell'ordine. |
Ordine
Entità dell'ordine. Nota: 1. Se non diversamente specificato, tutte le stringhe a tutti i livelli devono essere inferiori a 1000 caratteri. 2. Se non diversamente specificato, tutti i campi ripetuti a tutti i livelli devono essere inferiori a 50. 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 può essere un valore diverso e più facile da usare. 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 quello visualizzato per questo ordine in altri contesti, tra cui siti web, app ed email. |
|
userVisibleStateLabel |
Deprecato: utilizza 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 in formato "Zulu" UTC RFC3339, 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 in formato "Zulu" UTC RFC3339, con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: |
|
transactionMerchant |
Il commerciante che ha facilitato il pagamento. Questo potrebbe essere diverso da un fornitore a livello di elemento pubblicitario. Esempio: ordine Expedia con elemento pubblicitario di ANA. |
|
contents |
Obbligatorio: i contenuti dell'ordine, che sono un gruppo di elementi pubblicitari. |
|
priceAttributes[] |
Prezzo, sconti, tasse e così via. |
|
followUpActions[] |
Azioni successive a livello di ordine. |
|
paymentData |
Dati relativi al pagamento dell'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 |
Obsoleto: utilizza i verticali. Queste proprietà verranno applicate a tutti gli elementi pubblicitari, a meno che non vengano sostituite in alcuni elementi. 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 di unione verticals . Queste proprietà verranno applicate a tutti gli elementi pubblicitari, a meno che non vengano sostituite in alcuni elementi. 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 |
Vendita di biglietti |
UserInfo
Informazioni sull'utente. È utilizzato per rappresentare le informazioni dell'utente associate a un ordine.
Rappresentazione JSON | |
---|---|
{
"email": string,
"firstName": string,
"lastName": string,
"displayName": string,
"phoneNumbers": [
{
object ( |
Campi | |
---|---|
email |
Email dell'utente, ad esempio janedoe@gmail.com. |
firstName |
Nome dell'utente. |
lastName |
Cognome dell'utente. |
displayName |
Il nome visualizzato dell'utente potrebbe essere diverso dal nome o dal cognome. |
phoneNumbers[] |
Numeri di telefono dell'utente. |
PhoneNumber
Rappresentazione standard del numero di telefono.
Rappresentazione JSON | |
---|---|
{ "e164PhoneNumber": string, "extension": string, "preferredDomesticCarrierCode": string } |
Campi | |
---|---|
e164PhoneNumber |
Numero di telefono in formato E.164, come definito nella Raccomandazione E.164 dell'Unione Internazionale delle Telecomunicazioni (UIT). Link wiki: https://en.wikipedia.org/wiki/E.164 |
extension |
L'estensione non è standardizzata nelle raccomandazioni ITU, ad eccezione del fatto che è definita come una serie di numeri con una lunghezza massima di 40 cifre. È definito come una stringa in questo caso per contenere il possibile utilizzo di uno zero iniziale nell'estensione (le organizzazioni sono completamente liberi di farlo, poiché non esiste uno standard definito). Oltre ai numeri, è possibile che vengano memorizzati altri caratteri di selezione come "," (che indica l'attesa). Ad esempio, nell'interno xxx-xxx-xxxx 123, "123" è l'estensione. |
preferredDomesticCarrierCode |
Il codice di selezione dell'operatore preferito per la chiamata a questo numero di telefono nazionale. Sono inclusi anche i codici che in alcuni paesi devono essere chiamati per chiamate da rete fissa a cellulare o viceversa. Ad esempio, in Colombia, quando chiami da un cellulare a un telefono fisso nazionale, il "3" deve essere digitato prima del numero di telefono stesso, e viceversa. https://en.wikipedia.org/wiki/Telephone_numbers_in_Colombia https://en.wikipedia.org/wiki/Brazilian_Carrier_Selection_Code Tieni presente che questo è il codice "preferito", 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 JPG, PNG e GIF (animate e non animate). Ad esempio, |
accessibilityText |
Una descrizione testuale dell'immagine da utilizzare per l'accessibilità, ad esempio screen reader. Obbligatorio. |
height |
L'altezza dell'immagine in pixel. Campo facoltativo. |
width |
La larghezza dell'immagine in pixel. Campo facoltativo. |
Commerciante
Commerciante del carrello/dell'ordine/dell'articolo 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 Bread". |
image |
L'immagine associata al commerciante. |
phoneNumbers[] |
Numeri di telefono del commerciante. |
address |
Indirizzo del commerciante. |
Località
Contenitore che rappresenta una località.
Rappresentazione JSON | |
---|---|
{ "coordinates": { object ( |
Campi | |
---|---|
coordinates |
Coordinate geografiche. Richiede l'autorizzazione [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION] [DEVICE_PRECISE_LOCATION]. |
formattedAddress |
Indirizzo visualizzato, ad esempio "1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA". Richiede l'autorizzazione [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION] [DEVICE_PRECISE_LOCATION]. |
zipCode |
Codice postale. Richiede l'autorizzazione [DEVICE_PRECISE_LOCATION] [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION] o [DEVICE_COARSE_LOCATION] [google.actions.v2.Permission.DEVICE_COARSE_LOCATION]. |
city |
Città. Richiede l'autorizzazione [DEVICE_PRECISE_LOCATION] [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION] o [DEVICE_COARSE_LOCATION] [google.actions.v2.Permission.DEVICE_COARSE_LOCATION]. |
postalAddress |
Indirizzo postale. Richiede l'autorizzazione [DEVICE_PRECISE_LOCATION] [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION] o [DEVICE_COARSE_LOCATION] [google.actions.v2.Permission.DEVICE_COARSE_LOCATION]. |
name |
Il nome del luogo. |
phoneNumber |
Numero di telefono della località, ad esempio il numero di contatto della sede dell'attività commerciale o il numero di telefono della località di consegna. |
notes |
Note sulla località. |
placeId |
placeId viene utilizzato con l'API Places per recuperare i dettagli di un luogo. Consulta la pagina https://developers.google.com/places/web-service/place-id |
LatLng
Un oggetto che rappresenta una coppia di latitudine/longitudine. Questo valore viene espresso come una 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 in intervalli normalizzati.
Rappresentazione JSON | |
---|---|
{ "latitude": number, "longitude": number } |
Campi | |
---|---|
latitude |
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 la consegna o gli indirizzi per i pagamenti. Dato un indirizzo postale, un servizio postale può consegnare gli articoli a una sede, a una casella postale o simili. Non è stato progettato per modellare le località geografiche (strade, città, montagne).
Nell'uso tipico, un indirizzo viene creato tramite l'input utente o dall'importazione di dati esistenti, a seconda del tipo di processo.
Consigli sull'inserimento / modifica dell'indirizzo: - Usa un widget per gli indirizzi compatibile con i18n, come https://github.com/google/libaddressinput). - Agli utenti non devono essere presentati elementi UI per l'inserimento o la modifica di campi al di fuori dei paesi in cui viene utilizzato questo 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. Questo non viene mai dedotto e spetta all'utente verificare che il valore sia corretto. Per informazioni dettagliate, visita i siti http://cldr.unicode.org/ e http://www.unicode.org/cldr/charts/30/supplemental/territory_information.html. Esempio: "CH" per la Svizzera. |
languageCode |
Campo 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 nel paese/nella regione dell'indirizzo o ai relativi equivalenti trascritti. Ciò può influire sulla formattazione in alcuni paesi, ma non è fondamentale per la correttezza dei dati e non influirà mai sulla convalida o su altre operazioni correlate a non formattazione. Se questo valore non è noto, deve essere omesso (anziché specificare un valore predefinito potenzialmente errato). Esempi: "zh-Hant", "ja", "ja-Latn", "en". |
postalCode |
Campo facoltativo. Codice postale dell'indirizzo. Non tutti i paesi utilizzano o richiedono la presenza di codici postali. Tuttavia, se vengono utilizzati, possono attivare un'ulteriore convalida con altre parti dell'indirizzo (ad es. la convalida del codice postale negli Stati Uniti). |
sortingCode |
Campo facoltativo. Codice di ordinamento aggiuntivo specifico per il paese. Questa opzione non è utilizzata nella maggior parte delle regioni. Se viene utilizzato, il valore è una stringa come "CEDEX", facoltativamente seguito da un numero (ad es. "CEDEX 7") o solo un numero che rappresenta il "codice del settore" (Giamaica), "indicatore dell'area di consegna" (Malawi) o "indicatore dell'ufficio postale" (ad es. Costa d'Avorio). |
administrativeArea |
Campo facoltativo. Suddivisione amministrativa di livello più alto utilizzata per gli indirizzi postali di un paese o di una regione. Ad esempio, uno stato, una provincia, un oblast o una prefettura. Nello specifico, 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 esempio, in Svizzera questo campo deve essere lasciato vuoto. |
locality |
Campo facoltativo. Si riferisce generalmente alla parte relativa alla città dell'indirizzo. Esempi: città degli Stati Uniti, comune italiano, città del 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 |
Campo facoltativo. Circoscrizione dell'indirizzo. ad esempio quartieri, distretti o distretti. |
addressLines[] |
Righe indirizzo non strutturate che descrivono i livelli inferiori di un indirizzo. Poiché i valori in addressLines non contengono 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 indirizzo deve essere "ordine busta" per il paese/la regione dell'indirizzo. Nei luoghi in cui può variare (ad esempio in Giappone), viene utilizzato address_language per renderlo esplicito (ad es. "ja" per ordinamento da grande a piccolo e "ja-Latn" o "en" per ordine piccolo-grande). 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 elemento regioneCode con tutte le informazioni rimanenti inserite nelle righe dell'indirizzo. Sarebbe possibile formattare un indirizzo di questo tipo in modo molto approssimativo senza geocodifica, ma non è stato possibile fare un ragionamento semantico su nessuno dei componenti dell'indirizzo fino a quando non fosse stato risolto almeno parzialmente. La creazione di un indirizzo contenente solo regioneCode e indirizzoLines, quindi la geocodifica è il metodo consigliato per gestire indirizzi completamente non strutturati (invece di indovinare quali parti dell'indirizzo dovrebbero essere località o aree amministrative). |
recipients[] |
Campo facoltativo. Il destinatario all'indirizzo. In determinate circostanze, questo campo può contenere informazioni su più righe. Ad esempio, potrebbe contenere informazioni di tipo "cura di". |
organization |
Campo 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. È obbligatorio almeno un elemento pubblicitario, al massimo 50 consentiti. 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/componenti aggiuntivi devono essere definiti nei prototipi verticali in base ai relativi casi d'uso. Nota: 1. Se non diversamente specificato, tutte le stringhe a tutti i livelli devono essere inferiori a 1000 caratteri. 2. Se non diversamente specificato, tutti i campi ripetuti a tutti i livelli devono essere inferiori a 50. 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: l'identificatore assegnato dal commerciante all'elemento pubblicitario. Utilizzato per identificare gli elementi pubblicitari esistenti nell'applicazione di aggiornamenti parziali. La lunghezza massima consentita è 64 caratteri. |
|
name |
Il nome dell'elemento pubblicitario così come appare sulla ricevuta. La lunghezza massima consentita è 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 di uno specifico elemento pubblicitario, se diverso dall'ordine complessivo. Esempio: ordine Expedia con il fornitore dell'elemento pubblicitario ANA. |
|
priceAttributes[] |
Prezzo e aggiustamenti a livello di elemento pubblicitario. |
|
followUpActions[] |
Azioni successive all'elemento pubblicitario. |
|
recipients[] |
Clienti a livello di elemento pubblicitario, che potrebbe essere diverso dall'acquirente a livello di ordine. Esempio: l'utente X ha prenotato un ristorante con il nome dell'utente Y. |
|
image |
Immagine piccola associata all'elemento, se presente. |
|
description |
Descrizione dell'elemento pubblicitario. |
|
notes[] |
Note aggiuntive applicabili a questa particolare voce, ad esempio le norme sulla cancellazione. |
|
disclosures[] |
Informative associate a questo elemento pubblicitario. |
|
vertical |
Obsoleto: utilizza i verticali. Obbligatorio: contenuti semantici dell'elemento pubblicitario in base al tipo/verticale. Ogni verticale deve includere i propri dettagli di evasione degli ordini. Deve essere uno dei seguenti valori: Un oggetto che contiene campi di tipo arbitrario. Un campo aggiuntivo |
|
Campo di unione verticals . Obbligatorio: contenuti semantici dell'elemento pubblicitario in base al tipo/verticale. Ogni verticale deve includere i propri dettagli di evasione degli ordini. verticals può essere solo uno dei seguenti: |
||
purchase |
Ordini di acquisto come beni, cibo e così via |
|
reservation |
Ordini di prenotazione come ristorante, taglio di capelli ecc. |
PriceAttribute
Attributo di prezzo di un ordine o di un elemento pubblicitario.
Rappresentazione JSON | |
---|---|
{ "type": enum ( |
Campi | ||
---|---|---|
type |
Obbligatorio: attributo tipo di denaro. |
|
name |
Obbligatorio: la stringa dell'attributo prezzo mostrata all'utente. Questo messaggio viene inviato e localizzato dal commerciante. |
|
id |
Facoltativo: ID dell'elemento pubblicitario a cui corrisponde il prezzo. |
|
state |
Obbligatorio: stato del prezzo: stima ed effettivo. |
|
taxIncluded |
Indica se il prezzo è comprensivo di tasse. |
|
Campo di unione spec . Rappresenta un importo monetario o una percentuale in millisecondi. spec può essere solo uno dei seguenti: |
||
amount |
Importo monetario. |
|
amountMillipercentage |
La specifica percentuale, a 1/1000 di percentuale. Ad esempio, 8,750% è rappresentato da 8750, le percentuali negative rappresentano sconti percentuali. Questo campo verrà ritirato. Puoi prendere in considerazione la possibilità di riaggiungerlo quando è necessario un caso d'uso solido. |
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 ecc. |
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 tariffe. |
FEE |
Eventuali commissioni aggiuntive. |
GRATUITY |
Da aggiungere al totale parziale. |
TOTAL |
È 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 si avvicinerà a questo importo. Esempio: nei casi in cui l'imposta non sia nota con precisione al momento della transazione, il totale è un importo STIMATE. |
ACTUAL |
Il prezzo effettivo che verrà addebitato all'utente. |
Valuta
Rappresenta un importo di denaro con il relativo tipo di valuta.
Rappresentazione JSON | |
---|---|
{ "currencyCode": string, "amountInMicros": string } |
Campi | |
---|---|
currencyCode |
Il codice valuta di 3 lettere definito nello standard 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 |
Titolo o etichetta dell'azione, mostrati all'utente. La lunghezza massima consentita è 100 caratteri. |
openUrlAction |
Azione da intraprendere. |
actionMetadata |
I metadati associati a un'azione. |
Tipo
Possibili azioni di follow-up.
Enum | |
---|---|
TYPE_UNSPECIFIED |
Azione non specificata. |
VIEW_DETAILS |
Azione Visualizza dettagli ordine. |
MODIFY |
Azione Modifica ordine. |
CANCEL |
Annulla azione 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 email. |
CALL |
Invito all'azione. |
REORDER |
Riordina azione. |
REVIEW |
Rivedi l'azione dell'ordine. |
CUSTOMER_SERVICE |
Contatta l'assistenza clienti. |
FIX_ISSUE |
Rivolgiti al sito o all'app del commerciante per risolvere il problema. |
DIRECTION |
Link alle indicazioni stradali. |
OpenUrlAction
Apre l'URL specificato.
Rappresentazione JSON | |
---|---|
{ "url": string, "androidApp": { object ( |
Campi | |
---|---|
url |
Il campo dell'URL, che può essere uno dei seguenti: - URL http/https per aprire un'app o una pagina web collegate all'app |
androidApp |
Informazioni sull'app per Android se l'URL dovrebbe essere compilato 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 pacchetto Il nome del pacchetto deve essere specificato durante la specifica dell'evasione degli ordini Android. |
versions[] |
Se vengono specificati più filtri, qualsiasi corrispondenza di filtro attiverà l'app. |
VersionFilter
VersionFilter deve essere incluso se sono necessarie versioni specifiche dell'app.
Rappresentazione JSON | |
---|---|
{ "minVersion": integer, "maxVersion": integer } |
Campi | |
---|---|
minVersion |
Codice versione minimo o 0 inclusi. |
maxVersion |
Codice 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, non specificare minVersion e maxVersion. Per specificare tutte le versioni fino a maxVersion, non specificare minVersion. Per specificare tutte le versioni da minVersion, non specificare maxVersion. |
UrlTypeHint
Diversi tipi di suggerimenti URL.
Enum | |
---|---|
URL_TYPE_HINT_UNSPECIFIED |
Non specificato |
AMP_CONTENT |
URL che rimanda 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 e ora di scadenza dell'azione. Un timestamp in formato "Zulu" UTC RFC3339, con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: |
Informativa
Un'informativa su prodotti, servizi o norme che potrebbe essere presentata all'utente.
Rappresentazione JSON | |
---|---|
{ "title": string, "disclosureText": { object ( |
Campi | |
---|---|
title |
Titolo dell'informativa. Esempio: "Informazioni sulla sicurezza". |
disclosureText |
Contenuti dell'informativa. I link web sono consentiti. |
presentationOptions |
Opzioni di presentazione per l'informativa. |
DisclosureText
Rappresentano 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: "ATTENZIONE: questo prodotto può esporti a sostanze chimiche che, secondo lo stato della California, causano il 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. La prima verrà sostituita con "{0}" nella stringa modello, la seconda con "{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 dovrebbe essere mostrato agli utenti. |
url |
URL a cui gli utenti devono essere indirizzati quando il link viene attivato. |
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 compressa. |
PresentationRequirement
Requisito per la presentazione dell'informativa.
Enum | |
---|---|
REQUIREMENT_UNSPECIFIED |
Requisito non specificato. Non deve essere impostato esplicitamente. |
REQUIREMENT_OPTIONAL |
L'informativa è facoltativa. Può essere ignorato se il dispositivo non supporta la visualizzazione delle informative. |
REQUIREMENT_REQUIRED |
L'informativa è obbligatoria. Se il dispositivo non supporta la visualizzazione delle informative, verrà inviata un'email di risposta alla conversazione. |
PurchaseItemExtension
Contenuti dell'elemento pubblicitario del verticale di acquisto.
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'elemento nelle unità scelte. La dimensione, insieme al prezzo attivo, viene utilizzata 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 per questa voce. Se non viene configurato, questo elemento pubblicitario eredita le informazioni di evasione a livello di ordine. |
itemOptions[] |
Altri componenti aggiuntivi o elementi secondari. |
productDetails |
Dettagli sul prodotto. |
extension |
Eventuali campi aggiuntivi scambiati tra il commerciante e Google. Nota: è sconsigliato utilizzare questa estensione. In base al caso d'uso o alle circostanze, considera uno dei seguenti aspetti: 1. Definisci i campi in PurchaseItemExtension se potrebbe essere utilizzato per altri casi d'uso (ad es. capacità/funzionalità generiche). 2. Utilizza vertical_extension se si tratta di una funzionalità/un caso d'uso 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 particolare 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_PREPARATION" potrebbe avere un significato diverso a seconda del contesto. Per l'ordine CIBO potrebbe essere la preparazione del cibo. Per la vendita al dettaglio, potrebbe trattarsi di un articolo in fase di confezionamento. |
CREATED |
L'ordine è stato 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 l'elemento pubblicitario è stato annullato dall'utente. |
CHANGE_REQUESTED |
L'utente ha richiesto una modifica all'ordine e l'integratore la sta elaborando. Dopo la gestione della richiesta, l'ordine deve essere spostato in un altro stato. |
PurchaseType
La categoria di acquisto.
Enum | |
---|---|
PURCHASE_TYPE_UNSPECIFIED |
Valore sconosciuto. |
RETAIL |
Sono inclusi acquisti come beni fisici. |
FOOD |
Sono incluse le ordinazioni di cibo. |
GROCERY |
Acquisto di prodotti alimentari. |
MOBILE_RECHARGE |
Acquisto di ricariche di dispositivi mobili prepagate. |
MerchantUnitMeasure
Misura del prezzo per unità 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 |
Grammo. |
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 il valore è true, è consentito restituire. |
daysToReturn |
Il reso è consentito entro quel 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 evasione degli ordini. |
expectedFulfillmentTime |
Una finestra se si specifica un intervallo di tempo o un orario di arrivo stimato se si specifica un orario singolo. Orario di consegna o ritiro previsto. |
expectedPreparationTime |
Una finestra se si specifica un intervallo di tempo o un orario di arrivo stimato se si specifica un orario singolo. Tempo previsto per la preparazione del cibo. È preferibile una sola volta. |
location |
Località di ritiro o consegna. |
expireTime |
L'ora di scadenza di questa opzione di evasione degli ordini. Un timestamp in formato "Zulu" UTC RFC3339, 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 Walmart in cui è avvenuta l'evasione dell'ordine. https://support.google.com/business/answer/3370250?ref_topic=4596653. |
pickupInfo |
Informazioni aggiuntive sulla modalità di scelta dell'ordine. Questo campo è applicabile solo se il tipo di evasione è PICKUP. |
Tipo
Tipo di evasione degli ordini.
Enum | |
---|---|
TYPE_UNSPECIFIED |
Tipo non specificato. |
DELIVERY |
Questo ordine verrà consegnato. |
PICKUP |
Questo ordine deve essere ritirato. |
Ora
Costruire l'ora per rappresentare l'ora di un evento da utilizzare quando viene mostrato un ordine all'utente.
Rappresentazione JSON | |
---|---|
{ "timeIso8601": string } |
Campi | |
---|---|
timeIso8601 |
Rappresenta un orario dell'evento dell'ordine, ad esempio l'orario di prenotazione, quello di consegna e così via. Può essere una durata (ora di inizio e di fine), solo la data, la data e l'ora. Consulta la pagina https://en.wikipedia.org/wiki/ISO_8601 per conoscere tutti i formati supportati. |
PickupInfo
Dettagli sul ritiro di un ordine. Include informazioni come il tipo di ritiro ed eventuali metadati aggiuntivi allegati a ogni tipo.
Rappresentazione JSON | |
---|---|
{ "pickupType": enum ( |
Campi | |
---|---|
pickupType |
Metodo di ritiro, ad esempio INSTORE, CURBSIDE ecc. |
curbsideInfo |
Dettagli specifici sulle informazioni all'esterno. Se pickupType non è "CURBSIDE", questo campo verrà ignorato. |
checkInInfo[] |
Elenco dei vari metodi supportati dal partner per supportare il check-in. |
PickupType
Elenco dei tipi di ritiro supportati.
Enum | |
---|---|
UNSPECIFIED |
Tipo di ritiro non specificato. |
INSTORE |
Raccogliere il cibo all'interno del ristorante. |
CURBSIDE |
Parcheggia il veicolo in un punto apposito all'esterno del ristorante, dove qualcuno doveva consegnare cibo. |
CurbsideInfo
Dettagli su come verrà agevolato 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 evasione scelto, i dettagli corrispondenti verranno raccolti dall'utente. |
userVehicle |
Dettagli del veicolo dell'utente che effettua l'ordine. |
CurbsideFulfillmentType
Valori possibili dei tipi di completamento all'esterno.
Enum | |
---|---|
UNSPECIFIED |
Tipo di completamento 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"). Questo nome viene mostrato all'utente e deve essere localizzato. Obbligatorio. |
model |
Modello del veicolo (ad es. "Grom"). Questo nome 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 esempio nero Facoltativo. |
image |
URL a una foto del veicolo. La foto verrà visualizzata con dimensioni di circa 256 x 256 px. Deve essere un file jpg o png. Campo facoltativo. |
CheckInInfo
I 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 sul check-in verranno inviate via email. |
SMS |
Le informazioni sul check-in verranno inviate tramite 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 che sono articoli, 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 |
Global Trade Item Number (GTIN) del prodotto. Utile se offerId non è presente in Merchant Center. Campo facoltativo. |
plu |
I codici di ricerca dei prezzi, comunemente denominati codici PLU, numeri PLU, PLU, codici di produzione o etichette di prodotti, sono un sistema di numeri che identifica in modo univoco i prodotti all'ingrosso venduti nei supermercati e nei supermercati. |
productType |
Categoria di prodotto definita dal commerciante. Ad esempio: "Casa > Alimentari > Latticini e uova > Latte > Latte intero" |
productAttributes |
Dettagli sul prodotto forniti dal commerciante, ad esempio { "allergen": "peanut" }. Utile se offerId non è presente in Merchant Center. Campo 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 della 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 |
L'ora in cui è pianificato l'evento del servizio/dell'evento. Può essere un intervallo di tempo, una data o un'ora esatta. |
userAcceptableTimeRange |
Intervallo di tempo accettabile per l'utente. |
confirmationCode |
Codice di conferma della prenotazione. |
partySize |
Il numero di persone. |
staffFacilitators[] |
I facilitatori del personale che si occuperanno della prenotazione. Ad es. Il parrucchiere. |
location |
Luogo del servizio/evento. |
ReservationStatus
Stato della prenotazione.
Enum | |
---|---|
RESERVATION_STATUS_UNSPECIFIED |
Stato non specificato. |
PENDING |
La prenotazione è in attesa. |
CONFIRMED |
La prenotazione è confermata. |
CANCELLED |
La prenotazione viene annullata dall'utente. |
FULFILLED |
La prenotazione è stata evasa. |
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 dal parrucchiere. |
StaffFacilitator
Informazioni sulla persona incaricato del servizio.
Rappresentazione JSON | |
---|---|
{
"name": string,
"image": {
object ( |
Campi | |
---|---|
name |
Il nome del facilitatore del personale. Ad es. "Mario Rossi" |
image |
Immagini dell'artista. |
PaymentData
Dati di pagamento relativi a un ordine.
Rappresentazione JSON | |
---|---|
{ "paymentResult": { object ( |
Campi | |
---|---|
paymentResult |
Risultato del 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 rivolta agli utenti. |
PaymentResult
Risultato del pagamento utilizzato dall'integratore per il completamento di una transazione.
Rappresentazione JSON | |
---|---|
{ // Union field |
Campi | ||
---|---|---|
Campo di 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 l'elaboratore dei pagamenti è elencato come elaboratore dei pagamenti supportato da Google qui: https://developers.google.com/pay/api/ accedi a tale elaboratore tramite il link per ulteriori dettagli. In caso contrario, consulta la seguente documentazione per i dettagli del payload. https://developers.google.com/pay/api/payment-data-cryptography |
|
merchantPaymentMethodId |
Metodo di pagamento fornito dal commerciante o 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 del metodo di pagamento utilizzato per la transazione. |
paymentMethodProvenance |
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 del pagamento utilizzato dall'integratore per il completamento di una transazione.
Rappresentazione JSON | |
---|---|
{
"paymentType": enum ( |
Campi | |
---|---|
paymentType |
Il tipo di pagamento. |
paymentMethodDisplayName |
Nome del metodo di pagamento visibile all'utente. Ad esempio: VISA **** 1234 Conto corrente **** 5678 |
paymentMethodVoiceName |
Nome del metodo di pagamento da pronunciare all'utente per i dispositivi con l'assistente 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 con ottimizzazione vocale da usare al posto di paymentMethodDisplayName per i dispositivi con l'assistente vocale. Se questa stringa non è impostata, paymentMethodDisplayName verrà invece pronunciato all'utente. |
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 esempio PayPal |
PaymentMethodProvenance
Indica la provenienza del metodo di pagamento utilizzato per la transazione.
Enum | |
---|---|
PAYMENT_METHOD_PROVENANCE_UNSPECIFIED |
Provenienza non specificata. |
PAYMENT_METHOD_PROVENANCE_GOOGLE |
La provenienza è Google. |
PAYMENT_METHOD_PROVENANCE_MERCHANT |
La provenienza è commerciante. |
Promozione
Promozioni/offerte aggiunte al carrello.
Rappresentazione JSON | |
---|---|
{ "coupon": string } |
Campi | |
---|---|
coupon |
Obbligatorio: codice coupon applicato a questa offerta. |
PurchaseOrderExtension
Estensione di ordine per il verticale di 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 generale dell'ordine. |
userVisibleStatusLabel |
Etichetta/stringa visibile all'utente per lo stato. La lunghezza massima consentita è di 50 caratteri. |
type |
Obbligatorio: tipo di acquisto. |
returnsInfo |
Informazioni di reso per l'ordine. |
fulfillmentInfo |
Informazioni di evasione dell'ordine. |
purchaseLocationType |
Luogo di acquisto (in negozio / online) |
errors[] |
(Facoltativo) Errori per cui l'ordine è stato rifiutato. |
extension |
Eventuali campi aggiuntivi scambiati tra il commerciante e Google. Nota: è sconsigliato utilizzare questa estensione. In base al caso d'uso o alle circostanze, considera uno dei seguenti aspetti: 1. Definisci i campi in PurchaseOrderExtension se potrebbe essere utilizzato per altri casi d'uso (ad es. capacità/funzionalità generiche). 2. Utilizza vertical_extension se si tratta di una funzionalità/un caso d'uso personalizzato e non generico. Un oggetto che contiene campi di tipo arbitrario. Un campo aggiuntivo |
PurchaseLocationType
Tipo di località dell'acquisto.
Enum | |
---|---|
UNSPECIFIED_LOCATION |
Valore sconosciuto. |
ONLINE_PURCHASE |
Tutti gli acquisti effettuati 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 dettagliato per cui un ordine viene rifiutato dal commerciante. |
description |
Descrizione aggiuntiva dell'errore. |
entityId |
ID entità che corrisponde all'errore. Ad esempio, può corrispondere a LineItemId / ItemOptionId. |
updatedPrice |
Pertinente in caso di tipo di errore PRICE_CHANGED / INCORRECT_PRICE. |
availableQuantity |
Quantità disponibile ora. Applicabile in caso di AVAILABILITY_CHANGED. |
ErrorType
Possibili tipi di errore.
Enum | |
---|---|
ERROR_TYPE_UNSPECIFIED |
Errore sconosciuto |
NOT_FOUND |
Entità non trovata. Potrebbe essere Articolo, FulfillmentOption, Promozione. ID entità obbligatorio. |
INVALID |
I dati dell'entità non sono validi. Possono essere Item, FulfillmentOption, Promotion. ID entità obbligatorio. |
AVAILABILITY_CHANGED |
Articolo non disponibile o articoli insufficienti per soddisfare la richiesta. ID entità obbligatorio. |
PRICE_CHANGED |
Il prezzo dell'articolo è diverso dal prezzo nell'entità articolo. L'ID entità e il prezzo aggiornato sono obbligatori. |
INCORRECT_PRICE |
Errori di prezzo in Tariffe, totale. L'ID entità e il prezzo aggiornato sono obbligatori. |
REQUIREMENTS_NOT_MET |
Vincoli per accettare l'ordine non soddisfatti, dimensioni minime del carrello ecc. |
TOO_LATE |
FulfillmentOption è scaduta. |
NO_CAPACITY |
Nessuna capacità di servizio disponibile. Utilizza questo codice di errore se non è applicabile nessuno dei tipi di errore più granulari. |
NO_COURIER_AVAILABLE |
Non è stato trovato alcun corriere per la consegna. Un tipo di errore granulare che può essere classificato come NO_CAPACITY. |
INELIGIBLE |
Utente non idoneo a effettuare l'ordine (non autorizzato). |
OUT_OF_SERVICE_AREA |
Impossibile recapitare all'indirizzo richiesto a causa di regole di confine ecc. |
CLOSED |
Il ristorante è chiuso al momento dell'ordinazione. |
PROMO_NOT_APPLICABLE |
Codice di errore generico per rilevare tutti i casi di mancata applicazione del codice promozionale, se nessuno dei seguenti è idoneo. Aggiungi il codice promozionale come ID entità. |
PROMO_NOT_RECOGNIZED |
Il codice coupon non è stato riconosciuto dal partner. Aggiungi il codice promozionale come ID entità. |
PROMO_EXPIRED |
Impossibile presentare la promozione perché è scaduta. Aggiungi il codice promozionale come ID entità. |
PROMO_USER_INELIGIBLE |
L'utente corrente non è idoneo per questo coupon. Aggiungi il codice promozionale come ID entità. |
PROMO_ORDER_INELIGIBLE |
L'ordine corrente non è idoneo per questo coupon. Aggiungi il codice promozionale come ID entità. |
UNAVAILABLE_SLOT |
Lo slot per ordinare non è disponibile. |
FAILED_PRECONDITION |
Vincoli per l'accettazione dell'ordine non rispettati - dimensioni minime del carrello ecc. |
PAYMENT_DECLINED |
Pagamento non valido. |
MERCHANT_UNREACHABLE |
Commerciante non raggiungibile. Questa funzionalità è utile se un partner è un aggregatore e non può contattare il commerciante. |
ACCOUNT_LINKING_FAILED |
Il commerciante ha provato a collegare l'Account Google dell'utente a un account nel suo sistema, ma ha riscontrato un errore. |
TicketOrderExtension
Ordinare contenuti per ordinazioni di biglietti come film, sport ecc.
Rappresentazione JSON | |
---|---|
{
"ticketEvent": {
object ( |
Campi | |
---|---|
ticketEvent |
L'evento applicato a tutti i biglietti dell'elemento pubblicitario. |
TicketEvent
Rappresenta un singolo evento.
Rappresentazione JSON | |
---|---|
{ "type": enum ( |
Campi | |
---|---|
type |
Obbligatorio: tipo del biglietto dell'evento, ad esempio film o concerto. |
name |
Obbligatorio: nome dell'evento. Ad esempio, se l'evento è un film, questo deve essere il nome del film. |
description |
Descrizione dell'evento. |
url |
URL delle informazioni sull'evento. |
location |
Il luogo in cui si svolge l'evento o in cui si trova l'organizzazione. |
eventCharacters[] |
I personaggi relativi a questo evento. Può trattarsi di registi o attori di un evento cinematografico o di artisti di un concerto e così via. |
startDate |
Ora di inizio |
endDate |
Ora di fine |
doorTime |
L'orario di ingresso, che potrebbe essere diverso dall'ora di inizio dell'evento, ad esempio alle 9:00, mentre l'ora di ingresso è alle 08:30. |
Tipo
Il tipo di evento.
Enum | |
---|---|
EVENT_TYPE_UNKNOWN |
Tipo di evento sconosciuto. |
MOVIE |
Film. |
CONCERT |
Concerto. |
SPORTS |
Sport. |
EventCharacter
Un personaggio dell'evento, ad esempio organizzatore, esecutore e così via.
Rappresentazione JSON | |
---|---|
{ "type": enum ( |
Campi | |
---|---|
type |
Tipo del personaggio dell'evento, ad esempio attore o regista. |
name |
Il nome del personaggio. |
image |
Le immagini dei personaggi. |
Tipo
Tipo di carattere.
Enum | |
---|---|
TYPE_UNKNOWN |
Tipo sconosciuto. |
ACTOR |
Attore. |
PERFORMER |
Artista. |
DIRECTOR |
Regista. |
ORGANIZER |
Organizzatore. |
UserNotification
Notifica utente facoltativa da visualizzare nell'ambito dell'aggiornamento dell'ordine.
Rappresentazione JSON | |
---|---|
{ "title": string, "text": string } |
Campi | |
---|---|
title |
Il titolo della notifica per gli utenti. La lunghezza massima consentita è di 30 caratteri. |
text |
Il contenuto della notifica. La lunghezza massima consentita è 100 caratteri. |
NextScene
Rappresenta la scena da eseguire successivamente.
Rappresentazione JSON | |
---|---|
{ "name": string } |
Campi | |
---|---|
name |
Nome della scena successiva da eseguire. |
Sessione
Contiene informazioni sulla sessione della 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. "Chiave" indica il nome del parametro. I parametri definiti qui verranno uniti a quelli già definiti nella sessione. I parametri con valore null verranno rimossi dalla sessione. Consulta la documentazione sullo spazio di archiviazione di sessione: https://developers.google.com/assistant/conversational/storage-session. Un oggetto contenente un elenco di |
typeOverrides[] |
Campo facoltativo. Tipi con ambito a livello di sessione. Le definizioni del tipo di sessione possono 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 diversa dalle impostazioni internazionali dell'utente se l'azione utilizza funzionalità multilingue. Ad esempio, quando viene impostato gestore_response.expected.language_code, viene modificata la lingua della conversazione per tutti i turni successivi, che si rifletteranno 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 ad 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 alle definizioni dei tipi 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 relativa a un tipo di sinonimo.
Rappresentazione JSON | |
---|---|
{
"name": string,
"synonyms": [
string
],
"display": {
object ( |
Campi | |
---|---|
name |
Obbligatorio. Nome della voce (ad esempio "bicicletta"). La voce in questo campo deve essere inclusa nel campo dei sinonimi ripetuti per essere riconosciuta come valore di tipo valido. |
synonyms[] |
Obbligatorio. Elenco di sinonimi per la voce (ad es. "bici", "ciclo"). |
display |
Campo facoltativo. Le informazioni dell'elemento. |
EntryDisplay
Rappresentazione JSON | |
---|---|
{ "title": string, "description": string, "image": { object ( |
Campi | |
---|---|
title |
Obbligatorio. Titolo dell'elemento. Una volta toccato, il testo viene pubblicato nuovamente nella conversazione, come se l'utente lo avesse digitato. Ogni titolo deve essere univoco nell'insieme di elementi della raccolta. |
description |
Campo facoltativo. Corpo del testo della scheda. |
image |
Campo facoltativo. L'immagine da visualizzare. |
footer |
Campo facoltativo. Testo a piè di pagina per l'elemento della raccolta di navigazione, visualizzato sotto la descrizione. Singola riga di testo, troncata con i puntini di sospensione. |
openUrl |
URL del documento associato all'elemento del carosello di navigazione. Obbligatorio per la navigazione in carosello. |
Utente
Rappresenta l'utente che effettua una richiesta all'Azione.
Rappresentazione JSON | |
---|---|
{ "locale": string, "params": { string: value, ... }, "accountLinkingStatus": enum ( |
Campi | |
---|---|
locale |
L'impostazione internazionale principale dell'utente che ha effettuato 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 |
Campo facoltativo. Elenco di tutti i parametri associati all'utente corrente. Consulta la documentazione sullo spazio di archiviazione degli utenti: https://developers.google.com/assistant/conversational/storage-user. Un oggetto contenente un elenco di |
accountLinkingStatus |
Indica 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 in precedenza. Un timestamp in formato "Zulu" UTC RFC3339, con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: |
engagement |
Il coinvolgimento dell'utente corrente, incluse 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 di più conversazioni utilizzando il campo dei parametri o il collegamento degli 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 si è registrato l'utente corrente. Ad esempio, può essere utile sapere a quali intent l'utente è già abbonato, per evitare di chiedere di nuovo lo stesso intent. Ad esempio, queste informazioni possono essere utilizzate per indirizzare a una scena in modo condizionale e configurare DailyUpdates o PushNotifiche solo se l'utente non ha già effettuato l'iscrizione. Consulta la documentazione sul 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 un IntentSubscription esistente.
Rappresentazione JSON | |
---|---|
{ "intent": string, "contentTitle": string } |
Campi | |
---|---|
intent |
Il nome dell'intent a cui è stata effettuata la sottoscrizione. |
contentTitle |
Una breve descrizione dell'abbonamento. Viene utilizzata come etichetta della notifica e quando l'assistente richiede l'autorizzazione all'utente. |
PackageEntitlements
Un elenco dei diritti dell'utente relativi al nome di un pacchetto. Consulta la documentazione sulle transazioni valide digitali: 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 azioni. |
entitlements[] |
I diritti dell'utente per il pacchetto specificato. |
Diritto
Definisce il diritto digitale di un utente.
Rappresentazione JSON | |
---|---|
{ "sku": string, "skuType": enum ( |
Campi | |
---|---|
sku |
SKU del prodotto Nome del pacchetto per l'app a pagamento, suffisso di Finsky docid per gli acquisti in-app e l'abbonamento in-app. Associa getSku() nell'API InApp Billing 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 |
Abbonamenti |
APP |
App a pagamento |
SignedData
Rappresentazione JSON | |
---|---|
{ "inAppPurchaseData": { object }, "inAppDataSignature": string } |
Campi | |
---|---|
inAppPurchaseData |
Contiene tutti i dati relativi agli acquisti inapp in formato JSON. Consulta i dettagli nella tabella 6 di https://developer.android.com/google/play/billing/billing_reference.html. |
inAppDataSignature |
Corrisponde a IN_APP_DATA_SIGNATURE dal metodo getPurchases() nell'API InApp Billing di Play. |
Autorizzazione
Valori possibili per l'autorizzazione.
Enum | |
---|---|
PERMISSION_UNSPECIFIED |
Autorizzazione non specificata. |
DEVICE_PRECISE_LOCATION |
Chiedi la posizione esatta, la latitudine/longitudine dell'utente e l'indirizzo formattato. |
DEVICE_COARSE_LOCATION |
Chiedi informazioni su posizione approssimativa, codice postale, città e codice paese dell'utente. |
UPDATE |
Chiedi le autorizzazioni per inviare aggiornamenti. Consulta 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 |
Campo facoltativo. Elenco di parametri associati alla struttura Home Graph a cui appartiene il dispositivo di destinazione. Consulta la documentazione sullo spazio di 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 effettuare una richiesta all'Azione.
Rappresentazione JSON | |
---|---|
{ "capabilities": [ enum ( |
Campi | |
---|---|
capabilities[] |
Obbligatorio. Le funzionalità del dispositivo che effettua una richiesta all'Azione. |
currentLocation |
Campo facoltativo. La posizione del dispositivo dell'utente. Tieni presente che questo campo viene compilato solo dopo che le autorizzazioni di accesso alla posizione sono state concesse dall'utente finale. Per ulteriori dettagli sui campi impostati in base alle autorizzazioni generiche e quelle granulari, consulta il messaggio relativo alla posizione. Consulta la documentazione sulle autorizzazioni: https://developers.google.com/assistant/conversational/permissions. |
timeZone |
Campo facoltativo. Fuso orario associato al dispositivo client. Può essere utilizzata per risolvere i valori data/ora. |
Capacità
Funzionalità supportate dalla piattaforma al momento della richiesta.
Enum | |
---|---|
UNSPECIFIED |
Funzionalità del dispositivo non specificata. |
SPEECH |
Il dispositivo può parlare con l'utente tramite sintesi vocale o SSML. |
RICH_RESPONSE |
Il dispositivo può mostrare risposte avanzate come schede, elenchi e tabelle. |
LONG_FORM_AUDIO |
Il dispositivo può riprodurre contenuti multimediali audio in formato esteso come musica e podcast. |
INTERACTIVE_CANVAS |
Il dispositivo può visualizzare una risposta canvas interattiva. |
WEB_LINK |
Il dispositivo può utilizzare 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 domestico. |
Località
Contenitore 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, vengono compilati solo i campi "postalCode" e "locality". 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 del database del fuso orario IANA, ad esempio "America/New_York". |
version |
Campo facoltativo. Numero di versione del database dei fusi orari IANA, 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 sulla tela 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. Una 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 sulla tela corrente.
Rappresentazione JSON | |
---|---|
{ "state": value } |
Campi | |
---|---|
state |
Campo 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, "last_page" : 3, } Il limite per le dimensioni è 50 kB. |
Previsto
Descrive le aspettative per la prossima svolta del dialogo.
Rappresentazione JSON | |
---|---|
{ "speech": [ string ] } |
Campi | |
---|---|
speech[] |
Elenco di frasi che l'Azione si aspetta dalle frasi dell'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. |