- Rappresentazione JSON
- Utente
- UserProfile
- PackageEntitlement
- Diritto
- SignedData
- Dispositivo
- Piattaforma
- Funzionalità
- Conversazione
- Input
- RawInput
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 ( |
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 avere uno schermo. |
conversation |
Contiene i dati della sessione, ad esempio 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 tra superfici. |
Utente
Rappresentazione JSON | |
---|---|
{ "idToken": string, "profile": { object ( |
Campi | |
---|---|
idToken |
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 |
Informazioni sull'utente finale. Alcuni campi sono disponibili solo 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 |
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 |
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: |
userStorage |
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[] |
Elenco dei diritti dell'utente per ogni nome di pacchetto elencato nell'eventuale pacchetto Azioni. |
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 |
Il nome completo dell'utente, come specificato nel suo Account Google. Richiede l'autorizzazione |
givenName |
Il nome dell'utente specificato nel suo Account Google. Richiede l'autorizzazione |
familyName |
Il cognome dell'utente specificato nel suo 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 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 ( |
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. |
skuType |
|
inAppDetails |
Presente solo per acquisti in-app e abbonamenti in-app. |
SignedData
Rappresentazione JSON | |
---|---|
{ "inAppPurchaseData": { object }, "inAppDataSignature": string } |
Campi | |
---|---|
inAppPurchaseData |
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 |
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 ( |
Campi | |
---|---|
location |
Rappresenta la posizione effettiva del dispositivo, ad esempio latitudine, longitudine e indirizzo formattato. Richiede l'autorizzazione |
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 ( |
Campi | |
---|---|
capabilities[] |
Un elenco di 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 |
Dialogo
Rappresentazione JSON | |
---|---|
{
"conversationId": string,
"type": enum ( |
Campi | |
---|---|
conversationId |
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 |
"type" indica lo stato della conversazione nel suo ciclo di vita. |
conversationToken |
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 ( |
Campi | |
---|---|
rawInputs[] |
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 |
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 è |
arguments[] |
Un elenco di valori di argomento forniti per l'input richiesto dall'Azione. |
RawInput
Rappresentazione JSON | |
---|---|
{ "inputType": enum ( |
Campi | ||
---|---|---|
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 |
Input digitato o vocale dell'utente finale. |
|
url |
L'URL di attivazione. |