AppRequest

AppRequest è una richiesta inviata dall'Assistente Google a un fulfillment per 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 (User)
  },
  "device": {
    object (Device)
  },
  "surface": {
    object (Surface)
  },
  "conversation": {
    object (Conversation)
  },
  "inputs": [
    {
      object (Input)
    }
  ],
  "isInSandbox": boolean,
  "availableSurfaces": [
    {
      object (Surface)
    }
  ]
}
Campi
user

object (User)

Utente che ha avviato la conversazione.
device

object (Device)

Informazioni sul dispositivo utilizzato dall'utente per interagire con l'Azione.
surface

object (Surface)

Informazioni sulla piattaforma con cui l'utente interagisce, ad esempio se può riprodurre audio o avere uno schermo.
conversation

object (Conversation)

Contiene i dati della sessione, ad esempio l'ID conversazione e il token della conversazione.
inputs[]

object (Input)

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

boolean

Indica se la richiesta deve essere gestita in modalità sandbox.
availableSurfaces[]

object (Surface)

Piattaforme disponibili per il trasferimento tra superfici.

Utente

Rappresentazione JSON 
{
  "idToken": string,
  "profile": {
    object (UserProfile)
  },
  "accessToken": string,
  "permissions": [
    enum (Permission)
  ],
  "locale": string,
  "lastSeen": string,
  "userStorage": string,
  "packageEntitlements": [
    {
      object (PackageEntitlement)
    }
  ],
  "userVerificationStatus": enum (UserVerificationStatus)
}
Campi
idToken

string

che rappresenta l'identità dell'utente. Si tratta di un token web Json che include il profilo codificato. La definizione è disponibile all'indirizzo https://developers.google.com/identity/protocols/OpenIDConnect#obtainuserinfo.
profile

object (UserProfile)

Informazioni sull'utente finale. Alcuni campi sono disponibili solo se l'utente ha concesso l'autorizzazione a fornire queste informazioni all'Azione.
accessToken

string

Un token OAuth2 che identifica l'utente nel sistema. Disponibile solo se l'utente collega il proprio account.
permissions[]

enum (Permission)

Contiene le autorizzazioni concesse dall'utente a questa Azione.
locale

string

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.
lastSeen

string (Timestamp format)

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, preciso al nanosecondo. Esempio: "2014-10-02T15:01:23.045123456Z".
userStorage

string

Un token opaco fornito dall'applicazione e mantenuto in tutte le conversazioni di un determinato utente. La dimensione massima della stringa è 10.000 caratteri.
packageEntitlements[]

object (PackageEntitlement)

Elenco dei diritti dell'utente per ogni nome di pacchetto elencato nell'eventuale pacchetto Azioni.
userVerificationStatus

enum (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 campo specifico.

Rappresentazione JSON 
{
  "displayName": string,
  "givenName": string,
  "familyName": string
}
Campi
displayName

string

Il nome completo dell'utente, come specificato nel suo Account Google. Richiede l'autorizzazione NAME.
givenName

string

Il nome dell'utente specificato nel suo Account Google. Richiede l'autorizzazione NAME.
familyName

string

Il cognome dell'utente specificato nel suo Account Google. Tieni presente che questo campo potrebbe essere vuoto. Richiede l'autorizzazione NAME.

PackageEntitlement

Elenco di diritti relativi al nome di un pacchetto

Rappresentazione JSON 
{
  "packageName": string,
  "entitlements": [
    {
      object (Entitlement)
    }
  ]
}
Campi
packageName

string

Deve corrispondere al nome del pacchetto nel pacchetto azioni
entitlements[]

object (Entitlement)

Elenco dei diritti per una determinata app

Diritto

Definisce il diritto digitale di un utente. Tipi di diritti possibili: app a pagamento,acquisti in-app, abbonamenti in-app.

Rappresentazione JSON 
{
  "sku": string,
  "skuType": enum (SkuType),
  "inAppDetails": {
    object (SignedData)
  }
}
Campi
sku

string

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.
skuType

enum (SkuType)
inAppDetails

object (SignedData)

Presente solo per acquisti in-app e abbonamenti in-app.

SignedData

Rappresentazione JSON 
{
  "inAppPurchaseData": {
    object
  },
  "inAppDataSignature": string
}
Campi
inAppPurchaseData

object (Struct format)

Trova la corrispondenza di INAPP_PURCHASE_DATA con il metodo getPurchases(). 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

string

Corrisponde a IN_APP_DATA_SIGNATURE dal metodo getPurchases() nell'API InApp Billing di Play.

Dispositivo

Informazioni sul dispositivo utilizzato dall'utente per interagire con l'Azione.

Rappresentazione JSON 
{
  "location": {
    object (Location)
  }
}
Campi
location

object (Location)

Rappresenta la posizione effettiva del dispositivo, ad esempio latitudine, longitudine e indirizzo formattato. Richiede l'autorizzazione DEVICE_COARSE_LOCATION o DEVICE_PRECISE_LOCATION.

Piattaforma

Informazioni specifiche della piattaforma client dell'Assistente Google con cui l'utente interagisce. Surface si distingue dal dispositivo per il fatto che più piattaforme con l'assistente possono risiedere sullo stesso dispositivo.

Rappresentazione JSON 
{
  "capabilities": [
    {
      object (Capability)
    }
  ]
}
Campi
capabilities[]

object (Capability)

Un elenco di funzionalità supportate dalla piattaforma al momento della richiesta, ad esempio actions.capability.AUDIO_OUTPUT

Capacità

Rappresenta un'unità di funzionalità che la superficie è in grado di supportare.

Rappresentazione JSON 
{
  "name": string
}
Campi
name

string

Il nome della funzionalità, ad esempio actions.capability.AUDIO_OUTPUT

Dialogo

Rappresentazione JSON 
{
  "conversationId": string,
  "type": enum (ConversationType),
  "conversationToken": string
}
Campi
conversationId

string

ID univoco per la conversazione a turni multipli. È assegnato al primo turno. Dopodiché, la conversazione rimane invariata per i turni successivi fino alla conclusione della conversazione.
type

enum (ConversationType)

"type" indica lo stato della conversazione nel suo ciclo di vita.
conversationToken

string

Token opaco specificato dall'Azione nell'ultimo turno della conversazione. Può essere utilizzato da un'Azione per monitorare la conversazione o per archiviare i relativi dati.

Input

Rappresentazione JSON 
{
  "rawInputs": [
    {
      object (RawInput)
    }
  ],
  "intent": string,
  "arguments": [
    {
      object (Argument)
    }
  ]
}
Campi
rawInputs[]

object (RawInput)

Trascrizione dell'input non elaborato a ogni svolta di conversazione. Affinché le azioni su Google forniscano alcuni tipi di input nell'Azione, potrebbero essere necessari più turni di conversazione.
intent

string

Indica l'intenzione dell'utente. Nel primo turno della conversazione, l'intent farà riferimento all'intent che attiva l'Azione. Per i successivi turni di conversazione, l'intent sarà un'azione comune sull'intent di Google (inizia con "azioni"). Ad esempio, se l'input previsto è actions.intent.OPTION, l'intent specificato qui sarà actions.intent.OPTION se l'Assistente Google è riuscito a soddisfare questo intento oppure actions.intent.TEXT se l'utente ha fornito altre informazioni. Vedi https://developers.google.com/assistant/df-asdk/reference/intents.
arguments[]

object (Argument)

Un elenco di valori di argomento forniti per l'input richiesto dall'Azione.

RawInput

Rappresentazione JSON 
{
  "inputType": enum (InputType),

  // Union field input can be only one of the following:
  "query": string,
  "url": string
  // End of list of possible types for union field input.
}
Campi
inputType

enum (InputType)

Indica in che modo l'utente ha fornito questo input: una risposta digitata, una risposta vocale, una risposta non specificata e così via.
Campo di unione input. Il valore di input effettivo input può essere solo uno dei seguenti:
query

string

Input digitato o vocale dell'utente finale.
url

string

L'URL di attivazione.