Method: projects.sendInteraction

string

Obbligatorio. Il progetto in fase di test, indicato dall'ID progetto. Formato: projects/{project}

{
  "query": string,
  "type": enum (InputType)
}

string

Contenuti dell'input inviato dall'utente.

enum (InputType)

Tipo di input.

{
  "surface": enum (Surface),
  "location": {
    object (Location)
  },
  "locale": string,
  "timeZone": string
}

enum (Surface)

Piattaforma utilizzata per interagire con l'azione.

object (Location)

Posizione del dispositivo, ad esempio latitudine, longitudine e indirizzo formattato.

string

Impostazioni internazionali impostate sul dispositivo. Il formato deve essere conforme a BCP 47: https://tools.ietf.org/html/bcp47. Esempi: en, en-US, es-419 (altri esempi all'indirizzo https://tools.ietf.org/html/bcp47#appendix-A).

string

Fuso orario impostato sul dispositivo. Il formato deve seguire il database dei fusi orari IANA, ad esempio "America/New_York": https://www.iana.org/time-zones

{
  "coordinates": {
    object (LatLng)
  },
  "formattedAddress": string,
  "zipCode": string,
  "city": string
}

object (LatLng)

Coordinate geografiche. Richiede [DEVICE_PRECISE_LOCATION] Autorizzazione [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION].

string

Indirizzo visualizzato, ad es. "1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA". Richiede [DEVICE_PRECISE_LOCATION] Autorizzazione [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION].

string

Codice postale. Richiede [DEVICE_PRECISE_LOCATION] [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION] o [DEVICE_COARSE_LOCATION] Autorizzazione [google.actions.v2.Permission.DEVICE_COARSE_LOCATION].

string

Città. Richiede [DEVICE_PRECISE_LOCATION] [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION] o [DEVICE_COARSE_LOCATION] Autorizzazione [google.actions.v2.Permission.DEVICE_COARSE_LOCATION].

{
  "latitude": number,
  "longitude": number
}

number

La latitudine in gradi. Deve essere compreso nell'intervallo [-90,0, +90,0].

number

Longitudine in gradi. Deve essere compreso nell'intervallo [-180,0, +180,0].

{
  "text": string,
  "speech": [
    string
  ],
  "canvas": {
    object (Canvas)
  },
  "actionsBuilderPrompt": {
    object (Prompt)
  }
}

string

Risposta vocale inviata all'utente come stringa normale.

string

Contenuti vocali prodotti dall'Azione. Potrebbero essere inclusi elementi di markup come SSML.

object (Canvas)

Contenuti interattivi su Canvas.

object (Prompt)

Stato del prompt al termine del round di conversazione. Scopri di più sulla richiesta: https://developers.google.com/assistant/conversational/prompts

{
  "url": string,
  "data": [
    value
  ],
  "suppressMic": boolean,
  "enableFullScreen": boolean
}

string

URL dell'app web canvas interattiva da caricare. Se non viene configurato, l'URL del canvas attualmente attivo verrà riutilizzato.

value (Value format)

(Facoltativo) Dati JSON da trasmettere alla pagina web dell'esperienza immersiva sotto forma di evento. Se l'opzione "override" il campo nel prompt contenente è "false" i valori dei dati definiti in questo prompt di Canvas verranno aggiunti dopo i valori dei dati definiti nei prompt di Canvas precedenti.

boolean

(Facoltativo) Valore predefinito: false.

boolean

Se true l'applicazione canvas occupa l'intero schermo e non avrà un'intestazione nella parte superiore. Sulla schermata di caricamento verrà visualizzato anche un messaggio toast che include il nome visualizzato dell'azione, il nome dello sviluppatore e le istruzioni per uscire dall'azione. Valore predefinito: false.

{
  "append": boolean,
  "override": boolean,
  "firstSimple": {
    object (Simple)
  },
  "content": {
    object (Content)
  },
  "lastSimple": {
    object (Simple)
  },
  "suggestions": [
    {
      object (Suggestion)
    }
  ],
  "link": {
    object (Link)
  },
  "canvas": {
    object (Canvas)
  }
}

boolean

(Facoltativo) Modalità per unire questi messaggi a messaggi definiti in precedenza. "false" cancellerà tutti i messaggi definiti in precedenza (primo e ultimo semplice, contenuti, link dei suggerimenti e canvas) e aggiungerà i messaggi definiti in questo prompt. "vero" aggiungerà i messaggi definiti in questo prompt a quelli definiti nelle risposte precedenti. Impostazione di questo campo su "true" l'aggiunta ad alcuni campi all'interno dei prompt semplici, del prompt di suggerimento e del prompt di Canvas (parte del prompt dei contenuti) verrà attivata anche. I messaggi Contenuti e Link vengono sempre sovrascritti, se definiti nel prompt. Il valore predefinito è "false".

boolean

(Facoltativo) Modalità per unire questi messaggi a messaggi definiti in precedenza. "vero" cancella tutti i messaggi definiti in precedenza (primo e ultimo semplice, contenuti, link dei suggerimenti e canvas) e aggiunge i messaggi definiti in questo prompt. "false" aggiunge i messaggi definiti in questo prompt a quelli definiti nelle risposte precedenti. Lasciare questo campo a "false" consente inoltre l'aggiunta ad alcuni campi all'interno dei prompt semplici, del prompt dei suggerimenti e del prompt di Canvas (parte del prompt dei contenuti). Se definito nel prompt, i messaggi Contenuti e Link vengono sempre sovrascritti. Il valore predefinito è "false".

object (Simple)

(Facoltativo) La prima risposta vocale e di solo testo.

object (Content)

(Facoltativo) Contenuti come una scheda, un elenco o contenuti multimediali da mostrare all'utente.

object (Simple)

(Facoltativo) L'ultima risposta vocale e di solo testo.

object (Suggestion)

(Facoltativo) Suggerimenti da mostrare all'utente, che saranno sempre visualizzati alla fine della risposta. Se l'opzione "override" nel prompt contenente è "false", i titoli definiti in questo campo verranno aggiunti ai titoli definiti in qualsiasi prompt di suggerimenti definito in precedenza e i valori duplicati verranno rimossi.

object (Link)

(Facoltativo) Un chip di suggerimento aggiuntivo che può rimandare all'app o al sito associato. Il chip verrà visualizzato con il titolo "Apri ". Massimo 20 caratteri.

object (Canvas)

(Facoltativo) Rappresenta una risposta di Canvas interattiva da inviare all'utente.

{
  "speech": string,
  "text": string
}

string

(Facoltativo) Rappresenta il discorso da pronunciare all'utente. Può essere SSML o sintesi vocale. Se l'opzione "override" nel prompt contenitore è "true", il parlato definito in questo campo sostituisce quello del prompt semplice precedente.

string

Testo facoltativo da visualizzare nel fumetto della chat. Se non viene specificato, verrà utilizzato il rendering del campo vocale riportato sopra. Limitato a 640 caratteri. Se l'opzione "override" nel prompt contenente è "true", il testo definito in questo campo sostituisce il testo del prompt semplice precedente.

{

  // Union field content can be only one of the following:
  "card": {
    object (Card)
  },
  "image": {
    object (Image)
  },
  "table": {
    object (Table)
  },
  "media": {
    object (Media)
  },
  "canvas": {
    object (Canvas)
  },
  "collection": {
    object (Collection)
  },
  "list": {
    object (List)
  }
  // End of list of possible types for union field content.
}

object (Card)

Una carta di base.

object (Image)

Un'immagine.

object (Table)

Scheda tabella.

object (Media)

Risposta che indica un insieme di contenuti multimediali da riprodurre.

object (Canvas)

Una risposta da utilizzare per l'esperienza interattiva sulla tela.

object (Collection)

Una scheda con una raccolta di opzioni tra cui scegliere.

object (List)

Una scheda che presenta un elenco di opzioni tra cui scegliere.

{
  "title": string,
  "subtitle": string,
  "text": string,
  "image": {
    object (Image)
  },
  "imageFill": enum (ImageFill),
  "button": {
    object (Link)
  }
}

string

Titolo generale della scheda. (Facoltativo)

string

(Facoltativo)

string

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.

object (Image)

Un'immagine hero per la carta. L'altezza è fissa a 192 dp. (Facoltativo)

enum (ImageFill)

Il modo in cui lo sfondo dell'immagine verrà riempito. (Facoltativo)

object (Link)

Pulsante. (Facoltativo)

{
  "url": string,
  "alt": string,
  "height": integer,
  "width": integer
}

string

L'URL di origine dell'immagine. Le immagini possono essere in formato JPG, PNG e GIF (animate e non animate). Ad esempio,https://www.agentx.com/logo.png. Obbligatorio.

string

Una descrizione testuale dell'immagine da utilizzare per l'accessibilità, ad es. screen reader. Obbligatorio.

integer

L'altezza dell'immagine in pixel. (Facoltativo)

integer

La larghezza dell'immagine in pixel. (Facoltativo)

{
  "name": string,
  "open": {
    object (OpenUrl)
  }
}

string

Nome del link

object (OpenUrl)

Cosa succede quando un utente apre il link

{
  "url": string,
  "hint": enum (UrlHint)
}

string

Il campo url che può essere uno dei seguenti: - URL http/https per l'apertura di un'app collegata all'app o di una pagina web

enum (UrlHint)

Indica un suggerimento per il tipo di URL.

{
  "title": string,
  "subtitle": string,
  "image": {
    object (Image)
  },
  "columns": [
    {
      object (TableColumn)
    }
  ],
  "rows": [
    {
      object (TableRow)
    }
  ],
  "button": {
    object (Link)
  }
}

string

Titolo generale della tabella. Facoltativi, ma devono essere impostati se sono stati impostati i sottotitoli.

string

Sottotitolo per la tabella. (Facoltativo)

object (Image)

Immagine associata alla tabella. (Facoltativo)

object (TableColumn)

Intestazioni e allineamento delle colonne.

object (TableRow)

Dati delle righe della tabella. È garantita la visualizzazione delle prime tre righe, ma altre potrebbero essere tagliate su determinate superfici. Esegui un test con il simulatore per vedere quali righe verranno visualizzate per una determinata superficie. Sulle piattaforme che supportano la funzionalità WEB_BROWSER, puoi indirizzare l'utente a una pagina web con più dati.

object (Link)

Pulsante.

{
  "header": string,
  "align": enum (HorizontalAlignment)
}

string

Testo dell'intestazione per la colonna.

enum (HorizontalAlignment)

Allineamento orizzontale dei contenuti rispetto alla colonna. Se non specificato, i contenuti verranno allineati al bordo iniziale.

{
  "cells": [
    {
      object (TableCell)
    }
  ],
  "divider": boolean
}

object (TableCell)

Celle in questa riga. È garantita la visualizzazione delle prime 3 celle, ma le altre potrebbero essere tagliate su determinate superfici. Esegui un test con il simulatore per vedere quali celle verranno visualizzate per una determinata superficie.

boolean

Indica se deve esserci un divisore dopo ogni riga.

{
  "text": string
}

string

Contenuto testuale della cella.

{
  "mediaType": enum (MediaType),
  "startOffset": string,
  "optionalMediaControls": [
    enum (OptionalMediaControls)
  ],
  "mediaObjects": [
    {
      object (MediaObject)
    }
  ]
}

enum (MediaType)

Tipo di media.

string (Duration format)

Offset iniziale del primo oggetto multimediale.

Durata in secondi con un massimo di nove cifre frazionarie, terminata da "s". Esempio: "3.5s".

enum (OptionalMediaControls)

Tipi facoltativi di controlli multimediali supportati da questa sessione di risposte multimediali. Se impostato, la richiesta verrà effettuata a terze parti quando si verifica un determinato evento multimediale. Se non viene configurato, 3p deve comunque gestire due tipi di controllo predefiniti, FINISHED e FAILED.

object (MediaObject)

Elenco di oggetti multimediali

{
  "name": string,
  "description": string,
  "url": string,
  "image": {
    object (MediaImage)
  }
}

string

Nome dell'oggetto multimediale.

string

Descrizione di questo oggetto multimediale.

string

L'URL che rimanda ai contenuti multimediali.

object (MediaImage)

Immagine da mostrare con la scheda dei contenuti multimediali.

{

  // Union field image can be only one of the following:
  "large": {
    object (Image)
  },
  "icon": {
    object (Image)
  }
  // End of list of possible types for union field image.
}

object (Image)

Un'immagine di grandi dimensioni, come la copertina dell'album e così via.

object (Image)

Una piccola icona immagine visualizzata a destra rispetto al titolo. Viene ridimensionato a 36 x 36 dp.

{
  "title": string,
  "subtitle": string,
  "items": [
    {
      object (CollectionItem)
    }
  ],
  "imageFill": enum (ImageFill)
}

string

Titolo della raccolta. (Facoltativo)

string

Sottotitolo della raccolta. (Facoltativo)

object (CollectionItem)

min: 2 max: 10

enum (ImageFill)

Il modo in cui verranno riempiti gli sfondi delle immagini degli elementi della raccolta. (Facoltativo)

{
  "key": string
}

string

Obbligatorio. La chiave NLU corrispondente al nome della chiave di accesso nel tipo associato.

{
  "title": string,
  "subtitle": string,
  "items": [
    {
      object (ListItem)
    }
  ]
}

string

Titolo dell'elenco. (Facoltativo)

string

Sottotitolo dell'elenco. (Facoltativo)

object (ListItem)

min: 2 max: 30

{
  "key": string
}

string

Obbligatorio. La chiave NLU corrispondente al nome della chiave di accesso nel tipo associato.

{
  "title": string
}

string

Obbligatorio. Il testo mostrato nel chip di suggerimento. Se toccato, il testo viene pubblicato nella conversazione parola per parola, come se l'utente lo avesse digitato. Ogni titolo deve essere univoco tra l'insieme di chip di suggerimento. Massimo 25 caratteri

{
  "actionsBuilderEvents": [
    {
      object (ExecutionEvent)
    }
  ]
}

object (ExecutionEvent)

Elenco di eventi con dettagli sull'elaborazione del ciclo di conversazione nelle fasi del modello di interazione di Actions Builder. Compilato per Actions Builder e Solo app SDK Actions.

{
  "eventTime": string,
  "executionState": {
    object (ExecutionState)
  },
  "status": {
    object (Status)
  },
  "warningMessages": [
    string
  ],

  // Union field EventData can be only one of the following:
  "userInput": {
    object (UserConversationInput)
  },
  "intentMatch": {
    object (IntentMatch)
  },
  "conditionsEvaluated": {
    object (ConditionsEvaluated)
  },
  "onSceneEnter": {
    object (OnSceneEnter)
  },
  "webhookRequest": {
    object (WebhookRequest)
  },
  "webhookResponse": {
    object (WebhookResponse)
  },
  "webhookInitiatedTransition": {
    object (WebhookInitiatedTransition)
  },
  "slotMatch": {
    object (SlotMatch)
  },
  "slotRequested": {
    object (SlotRequested)
  },
  "slotValidated": {
    object (SlotValidated)
  },
  "formFilled": {
    object (FormFilled)
  },
  "waitingUserInput": {
    object (WaitingForUserInput)
  },
  "endConversation": {
    object (EndConversation)
  }
  // End of list of possible types for union field EventData.
}

string (Timestamp format)

Timestamp dell'evento.

Un timestamp nel formato RFC3339 UTC "Zulu" con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

object (ExecutionState)

Stato dell'esecuzione durante questo evento.

object (Status)

Stato risultante di un determinato passaggio di esecuzione.

string

Elenco di avvisi generati durante l'esecuzione di questo evento. Gli avvisi sono suggerimenti per lo sviluppatore che vengono scoperti durante la richiesta di conversazione. Di solito non sono critiche e non interrompono l'esecuzione della richiesta. Ad esempio, potrebbe essere generato un avviso quando il webhook tenta di eseguire l'override di un tipo personalizzato che non esiste. Gli errori vengono segnalati come codice di stato di errore, ma possono essere presenti avvisi anche quando lo stato è OK.

object (UserConversationInput)

Evento di gestione dell'input utente.

object (IntentMatch)

Evento di corrispondenza di intent.

object (ConditionsEvaluated)

Evento di valutazione delle condizioni.

object (OnSceneEnter)

Evento di esecuzione OnSceneEnter.

object (WebhookRequest)

Evento di invio richiesta webhook.

object (WebhookResponse)

Evento di ricevuta della risposta del webhook.

object (WebhookInitiatedTransition)

Evento di transizione avviato dal webhook.

object (SlotMatch)

Evento di corrispondenza dell'area.

object (SlotRequested)

Evento di richiesta di slot.

object (SlotValidated)

Evento di convalida degli slot.

object (FormFilled)

Evento di compilazione di moduli.

object (WaitingForUserInput)

Evento in attesa di input dell'utente.

object (EndConversation)

Evento di fine conversazione.

{
  "currentSceneId": string,
  "sessionStorage": {
    object
  },
  "slots": {
    object (Slots)
  },
  "promptQueue": [
    {
      object (Prompt)
    }
  ],
  "userStorage": {
    object
  },
  "householdStorage": {
    object
  }
}

string

ID della scena attualmente attiva.

object (Struct format)

Stato dello spazio di archiviazione della sessione: https://developers.google.com/assistant/conversational/storage-session

object (Slots)

Stato della compilazione degli slot, se applicabile: https://developers.google.com/assistant/conversational/scenes#slot_filling

object (Prompt)

Coda di prompt: https://developers.google.com/assistant/conversational/prompts

object (Struct format)

Stato dello spazio di archiviazione dell'utente: https://developers.google.com/assistant/conversational/storage-user

object (Struct format)

Stato dello spazio di archiviazione domestico: https://developers.google.com/assistant/conversational/storage-home.

{
  "status": enum (SlotFillingStatus),
  "slots": {
    string: {
      object (Slot)
    },
    ...
  }
}

enum (SlotFillingStatus)

Lo stato attuale di riempimento degli slot.

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

Gli slot associati alla scena corrente.

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

{
  "mode": enum (SlotMode),
  "status": enum (SlotStatus),
  "value": value,
  "updated": boolean,
  "prompt": {
    object (Prompt)
  }
}

enum (SlotMode)

La modalità dello spazio (obbligatoria o facoltativa). Può essere impostato dallo sviluppatore.

enum (SlotStatus)

Lo stato dell'area.

value (Value format)

Il valore dell'area. La modifica di questo valore nella risposta modificherà il valore nel riempimento degli slot.

boolean

Indica se il valore dello slot è stato raccolto nell'ultimo turno. Questo campo è di sola lettura.

object (Prompt)

(Facoltativo) Questo prompt viene inviato all'utente quando è necessario riempire uno spazio richiesto. Questo prompt sostituisce il prompt esistente definito nella console. Questo campo non è incluso nella richiesta webhook.

{
  "code": integer,
  "message": string,
  "details": [
    {
      "@type": string,
      field1: ...,
      ...
    }
  ]
}

integer

Il codice di stato, che deve essere un valore enum pari a google.rpc.Code.

string

Un messaggio di errore rivolto agli sviluppatori, che deve essere in inglese. Qualsiasi messaggio di errore rivolto agli utenti deve essere localizzato e inviato nel campo google.rpc.Status.details oppure deve essere localizzato dal client.

object

Un elenco di messaggi con i dettagli dell'errore. Le API possono utilizzare un insieme comune di tipi di messaggi.

Un oggetto che contiene campi di tipo arbitrario. Un campo aggiuntivo "@type" contiene un URI che identifica il tipo. Esempio: { "id": 1234, "@type": "types.example.com/standard/id" }.

{
  "type": string,
  "originalQuery": string
}

string

Tipo di input utente. Ad es. tastiera, voce, tocco, ecc.

string

Input di testo originale dell'utente.

{
  "intentId": string,
  "intentParameters": {
    string: {
      object (IntentParameterValue)
    },
    ...
  },
  "handler": string,
  "nextSceneId": string
}

string

ID intent che ha attivato questa interazione.

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

I parametri dell'intent che hanno attivato questa interazione.

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

string

Nome del gestore associato a questa interazione.

string

Scena a cui porta questa interazione.

{
  "failedConditions": [
    {
      object (Condition)
    }
  ],
  "successCondition": {
    object (Condition)
  }
}

object (Condition)

Elenco di condizioni valutate come "false".

object (Condition)

La prima condizione valutata come "true", se presente.

{
  "expression": string,
  "handler": string,
  "nextSceneId": string
}

string

Espressione specificata in questa condizione.

string

Nome del gestore specificato nella condizione valutata.

string

Scena di destinazione specificata nella condizione valutata.

{
  "handler": string
}

string

Nome del gestore specificato nell'evento onSceneEnter.

{
  "requestJson": string
}

string

Payload della richiesta webhook.

{
  "responseJson": string
}

string

Payload della risposta webhook.

{
  "nextSceneId": string
}

string

ID della scena a cui rimanda la transizione.

{
  "nluParameters": {
    string: {
      object (IntentParameterValue)
    },
    ...
  }
}

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

Parametri estratti da NLU dall'input dell'utente.

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

{
  "slot": string,
  "prompt": {
    object (Prompt)
  }
}

string

Nome dello spazio richiesto.

object (Prompt)

Prompt di slot.