- JSON-Darstellung
- Nutzer
- UserProfile
- PackageEntitlement
- Berechtigung
- SignedData
- Gerät
- Oberfläche
- Funktion
- Unterhaltung
- Eingabe
- RawInput
Eine App-Anfrage 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 für die Verwendung dieser Informationen in Actions on Google finden Sie unter https://developers.google.com/assistant/df-asdk/reference/conversation-webhook-json .
JSON-Darstellung | |
---|---|
{ "user": { object ( |
Felder | |
---|---|
user |
Nutzer, der die Unterhaltung gestartet hat |
device |
Informationen zu dem Gerät, das der Nutzer für die Interaktion mit der Aktion verwendet. |
surface |
Informationen über die Oberfläche, mit der Nutzende interagieren, z.B. ob sie Audio ausgeben kann oder über einen Bildschirm verfügt. |
conversation |
Enthält Sitzungsdaten wie die Unterhaltungs-ID und das Unterhaltungstoken. |
inputs[] |
Liste der Eingaben, die den erwarteten Eingaben entsprechen, die von der Aktion angegeben wurden. Für den Trigger der ersten Unterhaltung enthält die Eingabe Informationen darüber, 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 Cross-Oberfläche-Übermittlung 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 mit einem codierten Profil. Die Definition finden Sie unter https://developers.google.com/identity/protocols/OpenIDConnect#obtainuserinfo. |
profile |
Informationen über die Endnutzer. Einige Felder sind nur verfügbar, wenn der Nutzer die entsprechende Berechtigung für die Aktion erteilt hat. |
accessToken |
Ein OAuth2-Token, das den Nutzer in deinem System identifiziert. Nur verfügbar, wenn der Nutzer sein Konto verknüpft. |
permissions[] |
Enthält Berechtigungen, die der Nutzer für diese Aktion gewährt hat. |
locale |
Primäre Spracheinstellung des Nutzers, der die Anfrage stellt. Entspricht dem IETF-BCP-47-Sprachcode http://www.rfc-editor.org/rfc/bcp/bcp47.txt. Das Skript-Subtag ist jedoch nicht enthalten. |
lastSeen |
Zeitstempel der letzten Interaktion mit diesem Nutzer Dieses Feld wird weggelassen, wenn der Nutzer noch nicht mit dem Agent interagiert hat. Ein Zeitstempel im Format RFC3339 UTC „Zulu“ in Nanosekunden. Beispiel: |
userStorage |
Ein von der Anwendung bereitgestelltes intransparentes Token, das für alle Konversationen eines bestimmten Nutzers beibehalten wird. Der String darf maximal 10.000 Zeichen lang sein. |
packageEntitlements[] |
Liste der Nutzerberechtigungen für jeden im Aktionspaket aufgeführten Paketnamen, falls vorhanden. |
userVerificationStatus |
Gibt den Bestätigungsstatus des Nutzers an. |
UserProfile
Enthält die personenbezogenen Daten des Nutzers. Die Felder werden nur gefüllt, wenn der Nutzer der Aktion die entsprechende Berechtigung für ein bestimmtes Feld erteilt hat.
JSON-Darstellung | |
---|---|
{ "displayName": string, "givenName": string, "familyName": string } |
Felder | |
---|---|
displayName |
Der vollständige Name des Nutzers, wie im Google-Konto angegeben. Erfordert die Berechtigung |
givenName |
Der Vorname des Nutzers, wie er im Google-Konto angegeben ist. Erfordert die Berechtigung |
familyName |
Der Nachname des Nutzers, wie er im Google-Konto angegeben ist. Dieses Feld kann leer sein. Erfordert die Berechtigung |
PackageEntitlement
Liste der Berechtigungen für einen Paketnamen
JSON-Darstellung | |
---|---|
{
"packageName": string,
"entitlements": [
{
object ( |
Felder | |
---|---|
packageName |
Muss mit dem Paketnamen im Aktionspaket übereinstimmen |
entitlements[] |
Liste der Berechtigungen für eine bestimmte App |
Berechtigung
Definiert die digitale Berechtigung eines Nutzers. Arten möglicher Berechtigungen: kostenpflichtige Apps,In-App-Käufe, In-App-Abos.
JSON-Darstellung | |
---|---|
{ "sku": string, "skuType": enum ( |
Felder | |
---|---|
sku |
Produkt-SKU Paketname für kostenpflichtige App, Suffix „Finsky docid“ für In-App-Käufe und In-App-Abos. Stimmt mit „getSku()“ in der Play InApp Billing API überein. |
skuType |
|
inAppDetails |
Nur für In-App-Käufe und In-App-Abos vorhanden. |
SignedData
JSON-Darstellung | |
---|---|
{ "inAppPurchaseData": { object }, "inAppDataSignature": string } |
Felder | |
---|---|
inAppPurchaseData |
Gleicht INAPP_PURCHASE_DATA aus der getPurchases()-Methode ab. 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 IN_APP_DATA_SIGNATURE aus der getPurchases()-Methode in der Play InApp Billing API überein. |
Gerät
Informationen zu dem Gerät, das der Nutzer für die Interaktion mit der Aktion verwendet.
JSON-Darstellung | |
---|---|
{
"location": {
object ( |
Felder | |
---|---|
location |
Gibt den tatsächlichen Gerätestandort an, z. B. Breitengrad, Längengrad und formatierte Adresse. Erfordert die Berechtigung |
Plattform/Oberfläche
Informationen, die sich auf die Google Assistant-Clientoberfläche beziehen, mit der der Nutzer interagiert. Die Oberfläche unterscheidet sich dadurch von einem Gerät, dass sich mehrere Assistant-Oberflächen auf demselben Gerät befinden können.
JSON-Darstellung | |
---|---|
{
"capabilities": [
{
object ( |
Felder | |
---|---|
capabilities[] |
Eine Liste der Funktionen, die die Oberfläche zum Zeitpunkt der Anfrage unterstützt, z.B. |
Funktion
Stellt eine Funktionseinheit dar, die die Oberfläche unterstützen kann.
JSON-Darstellung | |
---|---|
{ "name": string } |
Felder | |
---|---|
name |
Der Name der Capability, z. B. |
Unterhaltung
JSON-Darstellung | |
---|---|
{
"conversationId": string,
"type": enum ( |
Felder | |
---|---|
conversationId |
Eindeutige ID für die Multi-Turn-Unterhaltung. Sie ist für die erste Abzweigung zugewiesen. Danach bleibt sie für alle nachfolgenden Unterhaltungen gleich, bis sie beendet wird. |
type |
type gibt den Status der Konversation in ihrem Lebenszyklus an. |
conversationToken |
Intransparentes Token, das von der Aktion in der letzten Unterhaltungsrunde angegeben wurde. Sie kann von einer Aktion verwendet werden, um die Unterhaltung zu verfolgen oder konversationelle Daten zu speichern. |
Eingabe
JSON-Darstellung | |
---|---|
{ "rawInputs": [ { object ( |
Felder | |
---|---|
rawInputs[] |
Transkription von Rohdaten aus jeder Unterhaltungsrunde. Für Aktionen in Google, um bestimmte Arten von Input für die Aktion bereitzustellen, können mehrere Unterhaltungsrunden erforderlich sein. |
intent |
Gibt den Intent des Nutzers an. In der ersten Unterhaltungsrunde bezieht sich der Intent auf den auslösenden Intent für die Aktion. Bei nachfolgenden Unterhaltungsrunden ist der Intent eine gängige Aktion in Google-Intent, die mit „actions.“ beginnt. Wenn die erwartete Eingabe beispielsweise |
arguments[] |
Eine Liste der bereitgestellten Argumentwerte für die von der Aktion angeforderte Eingabe. |
RawInput
JSON-Darstellung | |
---|---|
{ "inputType": enum ( |
Felder | ||
---|---|---|
inputType |
Gibt an, wie der Nutzer diese Eingabe gemacht hat: eine eingegebene Antwort, eine Sprachantwort, keine Angabe usw. |
|
Union-Feld input . Der tatsächliche Eingabewert input kann nur einer der folgenden Werte sein: |
||
query |
Durch Tippen oder gesprochene Eingabe des Endnutzers |
|
url |
Die auslösende URL. |