- JSON-Darstellung
- Nutzer
- Nutzerprofil
- PackageEntitlement
- Berechtigung
- SignedData
- Gerät
- Oberfläche
- Möglichkeit
- Unterhaltung
- Eingabe
- RawInput.
AppRequest ist eine Anfrage, die von Google Assistant an eine Auftragsausführung gesendet wird, um mit einer Aktion zu interagieren. Die API-Version wird im HTTP-Header angegeben. Bei API-Version 1 enthält der Header Google-Assistant-API-Version: v1
. Bei API-Version 2 enthält der Header Google-actions-API-Version: 2
. Beispiele dafür, wie diese Funktionen in Google-Aktionen verwendet werden, finden Sie unter https://developers.google.com/assistant/df-asdk/reference/conversation-webhook-json .
JSON-Darstellung | |
---|---|
{ "user": { object ( |
Felder | |
---|---|
user |
Nutzer, der die Unterhaltung initiiert hat. |
device |
Informationen zu dem Gerät, über das der Nutzer mit der Aktion interagiert. |
surface |
Informationen zu der Oberfläche, mit der der Nutzer interagiert, z. B. ob es Audio ausgeben oder einen Bildschirm haben kann |
conversation |
Enthält Sitzungsdaten wie die Unterhaltungs-ID und das Unterhaltungstoken. |
inputs[] |
Liste der Eingaben, die den erwarteten Eingaben entsprechen, die durch die Aktion angegeben werden. Beim ersten Trigger für die Unterhaltung enthält die Eingabe Informationen dazu, wie der Nutzer die Unterhaltung ausgelöst hat. |
isInSandbox |
Gibt an, ob die Anfrage im Sandbox-Modus verarbeitet werden soll. |
availableSurfaces[] |
Oberflächen, die für die plattformübergreifende Übergabe verfügbar sind |
Nutzer
JSON-Darstellung | |
---|---|
{ "idToken": string, "profile": { object ( |
Felder | |
---|---|
idToken |
Token, das die Identität des Nutzers darstellt. Dies ist ein JSON-Webtoken, das ein codiertes Profil enthält. Die Definition findest du unter https://developers.google.com/identity/protokolls/OpenIDConnect#obtainuserinfo. |
profile |
Informationen zum Endnutzer. Einige Felder sind nur verfügbar, wenn der Nutzer die Berechtigung zur Bereitstellung dieser Informationen für die Aktion erteilt hat. |
accessToken |
Ein OAuth2-Token, das den Nutzer in Ihrem System identifiziert. Nur verfügbar, wenn der Nutzer sein Konto verknüpft. |
permissions[] |
Enthält Berechtigungen, die der Nutzer dieser Aktion gewährt hat. |
locale |
Primäre Sprache des Nutzers, der die Anfrage stellt. Folgt dem IETF-BCP-47-Sprachcode http://www.rfc-editor.org/rfc/bcp/bcp47.txt, aber das Skript-Subtag ist nicht enthalten. |
lastSeen |
Der Zeitstempel der letzten Interaktion mit diesem Nutzer. Das Feld wird weggelassen, wenn der Nutzer noch nie mit dem Agent interagiert hat. Ein Zeitstempel im Format RFC3339 UTC „Zulu“ in Nanosekunden. Beispiel: |
userStorage |
Ein verschlüsseltes Token, das von der Anwendung bereitgestellt wird und in Unterhaltungen für einen bestimmten Nutzer gespeichert wird. Der String darf maximal 10.000 Zeichen lang sein. |
packageEntitlements[] |
Liste der Nutzerberechtigungen für jeden im Aktionspaket aufgeführten Paketnamen. |
userVerificationStatus |
Gibt den Bestätigungsstatus des Nutzers an. |
Benutzerprofil
Enthält die personenbezogenen Daten des Nutzers. Felder werden nur ausgefüllt, wenn der Nutzer die Berechtigung für die Aktion in einem bestimmten Feld erteilt.
JSON-Darstellung | |
---|---|
{ "displayName": string, "givenName": string, "familyName": string } |
Felder | |
---|---|
displayName |
Der vollständige Name des Nutzers, wie er in seinem Google-Konto angegeben ist. Erfordert die Berechtigung |
givenName |
Der Vorname des Nutzers, wie er in seinem Google-Konto angegeben ist. Erfordert die Berechtigung |
familyName |
Der Nachname des Nutzers, wie er in seinem Google-Konto angegeben ist. Dieses Feld kann leer sein. Erfordert die Berechtigung |
Paketentfernung
Liste der Berechtigungen für einen Paketnamen
JSON-Darstellung | |
---|---|
{
"packageName": string,
"entitlements": [
{
object ( |
Felder | |
---|---|
packageName |
Sollte mit dem Paketnamen im Aktionspaket übereinstimmen |
entitlements[] |
Liste der Berechtigungen für eine bestimmte App |
Entitlement
Definiert die digitale Berechtigung eines Nutzers. Mögliche Berechtigungen: kostenpflichtige Apps,In-App-Käufe, In-App-Abos
JSON-Darstellung | |
---|---|
{ "sku": string, "skuType": enum ( |
Felder | |
---|---|
sku |
Produkt-SKU. Paketname für kostenpflichtige Apps, Suffix von Finsky Docid für In-App-Kauf und In-App-Abo. Gleicht „getSku()“ in der Play InApp Billing API ab. |
skuType |
|
inAppDetails |
Nur für In-App-Käufe und In-App-Abos vorhanden. |
Signierte Daten
JSON-Darstellung | |
---|---|
{ "inAppPurchaseData": { object }, "inAppDataSignature": string } |
Felder | |
---|---|
inAppPurchaseData |
Übereinstimmung mit INAPP_PURCHASE_DATA der Methode „getPurchases()“. Enthält alle Daten zu In-App-Käufen im JSON-Format. Weitere Informationen finden Sie in Tabelle 6 unter https://developer.android.com/google/play/billing/billing_reference.html. |
inAppDataSignature |
Stimmt mit der IN_APP_DATA_SIGNATURE der Methode „getPurchases()“ in der Play InApp Billing API überein. |
Geräte
Informationen zu dem Gerät, über das der Nutzer mit der Aktion interagiert.
JSON-Darstellung | |
---|---|
{
"location": {
object ( |
Felder | |
---|---|
location |
Der tatsächliche Gerätestandort, z. B. Breitengrad, Längengrad und formatierte Adresse. Erfordert die Berechtigung |
Erdoberfläche
Spezifische Informationen für die Google Assistant-Clientoberfläche, mit der der Nutzer interagiert. Die Oberfläche unterscheidet sich vom Gerät, da sich mehrere Assistant-Oberflächen auf demselben Gerät befinden können.
JSON-Darstellung | |
---|---|
{
"capabilities": [
{
object ( |
Felder | |
---|---|
capabilities[] |
Eine Liste der Funktionen, die zum Zeitpunkt der Anfrage von der Oberfläche unterstützt werden, z.B. |
Rechte
Eine Funktionseinheit, die die Oberfläche unterstützt.
JSON-Darstellung | |
---|---|
{ "name": string } |
Felder | |
---|---|
name |
Der Name der Funktion, z. B. |
Unterhaltung
JSON-Darstellung | |
---|---|
{
"conversationId": string,
"type": enum ( |
Felder | |
---|---|
conversationId |
Eindeutige ID für die Unterhaltung mit mehreren Richtungen. Sie ist für die erste Abzweigung zugewiesen. Danach bleibt es bei einer nachfolgenden Unterhaltung unverändert, bis die Unterhaltung beendet wird. |
type |
type gibt den Status der Unterhaltung im Lebenszyklus an. |
conversationToken |
Undurchsichtiges Token, das durch die Aktion in der letzten Unterhaltung angegeben wurde. Damit kann eine Aktion verwendet werden, um die Unterhaltung zu verfolgen oder Daten in Unterhaltung zu speichern. |
Eingabe
JSON-Darstellung | |
---|---|
{ "rawInputs": [ { object ( |
Felder | |
---|---|
rawInputs[] |
Rohtranskription der einzelnen Unterhaltungsrunden. Damit Aktionen auf Google eine Art von Eingabe liefern können, sind unter Umständen mehrere Unterhaltungsrunden erforderlich. |
intent |
Damit wird die Absicht des Nutzers angegeben. In der ersten Unterhaltungsrunde bezieht sich der Intent auf den auslösenden Intent für die Aktion. Bei weiteren Unterhaltungsthreads ist der Intent eine gängige Aktion bei Google Intent (beginnt mit „actions“). Wenn die erwartete Eingabe beispielsweise |
arguments[] |
Eine Liste mit bereitgestellten Argumentwerten für die von der Aktion angeforderte Eingabe. |
Roheingabe
JSON-Darstellung | |
---|---|
{ "inputType": enum ( |
Felder | ||
---|---|---|
inputType |
Gibt an, wie der Nutzer diese Eingabe bereitgestellt hat: eine eingegebene Antwort, eine Sprachantwort, nicht angegeben usw. |
|
Union-Feld input . Der tatsächliche Eingabewert input kann nur einer der folgenden Werte sein: |
||
query |
Eingegebene oder gesprochene Eingabe des Endnutzers. |
|
url |
Die auslösende URL. |