- Rappresentazione JSON
- Utente
- UserProfile
- PackageEntitlement
- Diritto
- SignedData
- Dispositivo
- Superficie
- Capacità
- Conversazione
- Ingresso
- RawInput
AppRequest è una richiesta inviata dall'Assistente Google a un completamento per poter interagire con un'azione. La versione dell'API è specificata nell'intestazione HTTP. Per la versione 1 dell'API, l'intestazione contiene: Google-Assistant-API-Version: v1
. Per la versione 2 dell'API, l'intestazione contiene: Google-actions-API-Version: 2
. Per esempi di come viene utilizzato nelle azioni su Google, consulta la pagina https://developers.google.com/assistant/df-asdk/reference/conversation-webhook-json .
Rappresentazione JSON | |
---|---|
{ "user": { object ( |
Campi | |
---|---|
user |
Utente che ha avviato la conversazione. |
device |
Informazioni sul dispositivo utilizzato dall'utente per interagire con l'azione. |
surface |
Informazioni sulla piattaforma con cui l'utente interagisce, ad esempio se può riprodurre audio o se ha uno schermo. |
conversation |
Contiene i dati della sessione come l'ID conversazione e il token della conversazione. |
inputs[] |
Elenco di input corrispondenti agli input previsti specificati dall'azione. Per l'attivatore di conversazione iniziale, l'input contiene informazioni su come l'utente ha attivato la conversazione. |
isInSandbox |
Indica se la richiesta deve essere gestita in modalità sandbox. |
availableSurfaces[] |
Piattaforme disponibili per il trasferimento di superfici trasversali. |
Utente
Rappresentazione JSON | |
---|---|
{ "idToken": string, "profile": { object ( |
Campi | |
---|---|
idToken |
che rappresenta l'identità dell'utente. Questo è un token web Json che include il profilo codificato. La definizione è disponibile all'indirizzo https://developers.google.com/identity/protocols/OpenIDConnect#obtainuserinfo. |
profile |
Informazioni sull'utente finale. Alcuni campi sono disponibili soltanto se l'utente ha concesso l'autorizzazione a fornire queste informazioni all'azione. |
accessToken |
Un token OAuth2 che identifica l'utente nel sistema. Disponibile solo se l'utente collega il proprio account. |
permissions[] |
Contiene le autorizzazioni concesse dall'utente a questa azione. |
locale |
Impostazione delle impostazioni internazionali principali dell'utente che effettua la richiesta. Segue il codice lingua IETF BCP-47 http://www.rfc-editor.org/rfc/bcp/bcp47.txt Tuttavia, il sottotag dello script non è incluso. |
lastSeen |
Il timestamp dell'ultima interazione con l'utente. Questo campo verrà omesso se l'utente non ha mai interagito con l'agente. Un timestamp in formato "Zulu" UTC RFC3339, preciso al nanosecondo. Esempio: |
userStorage |
Un token opaco fornito dall'applicazione e persistente in tutte le conversazioni di un determinato utente. La dimensione massima della stringa è 10.000 caratteri. |
packageEntitlements[] |
Elenco dei diritti dell'utente per ogni nome di pacchetto elencato nel pacchetto Action, se presente. |
userVerificationStatus |
Indica lo stato di verifica dell'utente. |
UserProfile
Contiene le informazioni personali dell'utente. I campi vengono compilati solo se l'utente concede l'autorizzazione all'azione per un determinato campo.
Rappresentazione JSON | |
---|---|
{ "displayName": string, "givenName": string, "familyName": string } |
Campi | |
---|---|
displayName |
Il nome completo dell'utente, come specificato nell'Account Google. Richiede l'autorizzazione |
givenName |
Il nome dell'utente specificato nell'Account Google. Richiede l'autorizzazione |
familyName |
Il cognome dell'utente specificato nell'Account Google. Tieni presente che questo campo potrebbe essere vuoto. Richiede l'autorizzazione |
PackageEntitlement
Elenco di diritti relativi al nome di un pacchetto
Rappresentazione JSON | |
---|---|
{
"packageName": string,
"entitlements": [
{
object ( |
Campi | |
---|---|
packageName |
Deve corrispondere al nome del pacchetto nel pacchetto azioni |
entitlements[] |
Elenco di diritti per una determinata app |
Diritto
Definisce il diritto digitale dell'utente. Tipi di diritti possibili: app a pagamento,acquisti in-app, abbonamenti in-app.
Rappresentazione JSON | |
---|---|
{ "sku": string, "skuType": enum ( |
Campi | |
---|---|
sku |
SKU del prodotto. Nome del pacchetto per l'app a pagamento, suffisso del documento Finsky per acquisti in-app e abbonamento in-app. Crea una corrispondenza con getSku() nell'API Fatturazione in-app di Play. |
skuType |
|
inAppDetails |
Presente solo per acquisti in-app e abbonamenti in-app. |
SignedData
Rappresentazione JSON | |
---|---|
{ "inAppPurchaseData": { object }, "inAppDataSignature": string } |
Campi | |
---|---|
inAppPurchaseData |
Trova una corrispondenza in INAPP_PURCHASE_DATA dal metodo getPurchases(). Contiene tutti i dati relativi agli acquisti in-app in formato JSON. Consulta i dettagli nella tabella 6 della pagina https://developer.android.com/google/play/billing/billing_reference.html. |
inAppDataSignature |
Corrisponde a IN_APP_DATA_SIGNATURE dal metodo getPurchases() dell'API Fatturazione InApp di Play. |
Dispositivo
Informazioni sul dispositivo utilizzato dall'utente per interagire con l'azione.
Rappresentazione JSON | |
---|---|
{
"location": {
object ( |
Campi | |
---|---|
location |
Rappresenta la posizione effettiva del dispositivo, ad esempio latitudine, longitudine e indirizzo formattato. È necessaria l'autorizzazione |
Piattaforma
Informazioni specifiche per la piattaforma del client dell'Assistente Google con cui l'utente sta interagendo. Surface si distingue dal dispositivo per il fatto che sullo stesso dispositivo potrebbero essere presenti più piattaforme dell'assistente.
Rappresentazione JSON | |
---|---|
{
"capabilities": [
{
object ( |
Campi | |
---|---|
capabilities[] |
Un elenco delle funzionalità supportate dalla piattaforma al momento della richiesta, ad esempio |
Capacità
Rappresenta un'unità di funzionalità che la superficie è in grado di supportare.
Rappresentazione JSON | |
---|---|
{ "name": string } |
Campi | |
---|---|
name |
Il nome della funzionalità, ad esempio |
Conversazione
Rappresentazione JSON | |
---|---|
{
"conversationId": string,
"type": enum ( |
Campi | |
---|---|
conversationId |
ID univoco per la conversazione in più passaggi. È assegnato per il primo turno. Trascorso questo periodo, l'impostazione rimane invariata per le conversazioni successive, fino al termine della conversazione. |
type |
indica lo stato della conversazione nel suo ciclo di vita. |
conversationToken |
Token opaco specificato dall'Azione nell'ultimo turno di conversazione. Può essere utilizzato da un'azione per monitorare la conversazione o archiviare i relativi dati. |
Input
Rappresentazione JSON | |
---|---|
{ "rawInputs": [ { object ( |
Campi | |
---|---|
rawInputs[] |
Trascrizione di input non elaborati da ogni turno di conversazione. Affinché le azioni su Google forniscano alcuni tipi di input all'Azione, potrebbero essere necessari più turni di conversazione. |
intent |
Indica l'intenzione dell'utente. Per il primo turno di conversazione, l'intent farà riferimento all'intento di attivazione dell'azione. Per le conversazioni successive, l'intento sarà un'azione comune relativa all'intent Google (inizia con "azioni"). Ad esempio, se l'input previsto è |
arguments[] |
Un elenco di valori di argomenti forniti per l'input richiesto dall'Azione. |
RawInput
Rappresentazione JSON | |
---|---|
{ "inputType": enum ( |
Campi | ||
---|---|---|
inputType |
Indica come l'utente ha fornito l'input: una risposta digitata, una risposta vocale, non specificata e così via. |
|
Campo unione input . Il valore di input effettivo input può essere solo uno dei seguenti: |
||
query |
Input digitato o pronunciato dall'utente finale. |
|
url |
L'URL di attivazione. |