AppRequest

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 (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 se ha uno schermo.

conversation

object (Conversation)

Contiene i dati della sessione come 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 di superfici trasversali.

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. Questo è 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 soltanto 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

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

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.

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 persistente 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 nel pacchetto Action, se presente.

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 determinato campo.

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

string

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

givenName

string

Il nome dell'utente specificato nell'Account Google. Richiede l'autorizzazione NAME.

familyName

string

Il cognome dell'utente specificato nell'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 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 (SkuType),
  "inAppDetails": {
    object (SignedData)
  }
}
Campi
sku

string

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

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

string

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 (Location)
  }
}
Campi
location

object (Location)

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

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 (Capability)
    }
  ]
}
Campi
capabilities[]

object (Capability)

Un elenco delle 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

Conversazione

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

string

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

enum (ConversationType)

indica lo stato della conversazione nel suo ciclo di vita.

conversationToken

string

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 (RawInput)
    }
  ],
  "intent": string,
  "arguments": [
    {
      object (Argument)
    }
  ]
}
Campi
rawInputs[]

object (RawInput)

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

string

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 è actions.intent.OPTION, l'intent specificato qui sarà actions.intent.OPTION se l'Assistente Google è riuscito a soddisfare questo intent 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 argomenti 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 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

string

Input digitato o pronunciato dall'utente finale.

url

string

L'URL di attivazione.