Konversationsaktionen werden am 13. Juni 2023 eingestellt. Weitere Informationen finden Sie unter Einstellung von Konversationsaktionen.

AppResponse

Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

AppResponse ist die Antwort, die von der Auftragsausführung an Google Assistant gesendet wird. Beispiele für die Verwendung in Actions on Google finden Sie unter https://developers.google.com/assistant/df-asdk/reference/conversation-webhook-json#conversation-response-body

JSON-Darstellung
{
  "conversationToken": string,
  "userStorage": string,
  "resetUserStorage": boolean,
  "expectUserResponse": boolean,
  "expectedInputs": [
    {
      object (ExpectedInput)
    }
  ],
  "finalResponse": {
    object (FinalResponse)
  },
  "customPushMessage": {
    object (CustomPushMessage)
  },
  "isInSandbox": boolean
}
Felder
conversationToken

string

Ein intransparentes Token, das bei jeder Unterhaltung in die Aktion zurückgeführt wird.

userStorage

string

Ein intransparentes Token, das von der Aktion gesteuert wird und über Unterhaltungen für einen bestimmten Nutzer hinweg beibehalten wird. Ist das Token leer oder nicht angegeben, bleibt das vorhandene Token unverändert. Die maximale Größe des Strings beträgt 10.000 Byte. Wenn mehrere Dialoge für denselben Nutzer gleichzeitig ausgeführt werden, können sich Aktualisierungen dieses Tokens unerwartet überschreiben.

resetUserStorage

boolean

Gibt an, ob der beibehaltene userStorage gelöscht werden soll. Bei der Einstellung „true“ ist das Feld „userStorage“ bei der nächsten Interaktion mit dem Nutzer leer.

expectUserResponse

boolean

Gibt an, ob die Aktion eine Nutzerantwort erwartet. Das ist der Fall, wenn die Unterhaltung aktiv ist, und „false“, wenn sie beendet ist.

expectedInputs[]

object (ExpectedInput)

Liste der Eingaben, die die Aktion erwartet. Jede Eingabe kann eine gemeinsame Aktion im Google-Intent (beginnen mit "actions.") oder eine Eingabe, die eine Liste möglicher Intents umfasst. Derzeit wird nur eine Eingabe unterstützt.

finalResponse

object (FinalResponse)

Letzte Antwort, wenn bei der Aktion keine Eingabe durch den Nutzer erwartet wird.

customPushMessage

object (CustomPushMessage)

Eine benutzerdefinierte Push-Nachricht, mit der Entwickler strukturierte Daten an Actions on Google senden können.

isInSandbox

boolean

Gibt an, ob die Antwort im Sandbox-Modus verarbeitet werden soll. Dieses Bit wird benötigt, um strukturierte Daten im Sandbox-Modus an Google zu senden.

Erwartete Eingabe

JSON-Darstellung
{
  "inputPrompt": {
    object (InputPrompt)
  },
  "possibleIntents": [
    {
      object (ExpectedIntent)
    }
  ],
  "speechBiasingHints": [
    string
  ]
}
Felder
inputPrompt

object (InputPrompt)

Die benutzerdefinierte Aufforderung, mit der der Nutzer um Eingabe gebeten wird.

possibleIntents[]

object (ExpectedIntent)

Liste der Intents, die zum Ausführen dieser Eingabe verwendet werden können. Damit Aktionen auf Google einfach die unbearbeitete Nutzereingabe zurückgeben können, sollte die App nach dem Intent actions.intent.TEXT fragen.

speechBiasingHints[]

string

Liste der Wortgruppen, die Google für die Sprachgewichtung in der Aktion verwenden soll. Es sind bis zu 1.000 Wortgruppen zulässig.

Eingabeaufforderung

Eingabeaufforderung, die Assistant verwendet, um Nutzer zu einer Eingabe für die Frage der App zu leiten.

JSON-Darstellung
{
  "initialPrompts": [
    {
      object (SpeechResponse)
    }
  ],
  "richInitialPrompt": {
    object (RichResponse)
  },
  "noInputPrompts": [
    {
      object (SimpleResponse)
    }
  ]
}
Felder
initialPrompts[]
(deprecated)

object (SpeechResponse)

Erste Aufforderung, den Nutzer um Eingabe zu bitten. Es wird nur ein „initial_prompt“ unterstützt.

richInitialPrompt

object (RichResponse)

Nutzlast auf Aufforderung.

noInputPrompts[]

object (SimpleResponse)

Aufforderung, mit der der Nutzer gefragt wird, wenn er nichts eingibt.

Sprachantwort

Antwort, die nur Sprache enthält. VERWORFEN.

JSON-Darstellung
{

  // Union field type can be only one of the following:
  "textToSpeech": string,
  "ssml": string
  // End of list of possible types for union field type.
}
Felder
Union-Feld type. Sprachausgabentypen: Sprachausgabe oder SSML Für type ist nur einer der folgenden Werte zulässig:
textToSpeech

string

Nur-Text der Sprachausgabe, z.B. „Wohin möchtest du?“/

ssml

string

Strukturierte gesprochene Antwort an den Nutzer im SSML-Format, z.B. „Tiername nach dem Ton sagen. ". Schließt sich mit textToSpeech aus.

RichResponse

Eine umfangreiche Antwort, die Audio, Text, Karten, Vorschläge und strukturierte Daten enthalten kann.

JSON-Darstellung
{
  "items": [
    {
      object (Item)
    }
  ],
  "suggestions": [
    {
      object (Suggestion)
    }
  ],
  "linkOutSuggestion": {
    object (LinkOutSuggestion)
  }
}
Felder
items[]

object (Item)

Eine Liste von UI-Elementen, aus denen die Antwort besteht. Die Elemente müssen die folgenden Anforderungen erfüllen: 1. Das erste Element muss ein SimpleResponse 2 sein. Höchstens zwei SimpleResponse 3. Höchstens ein umfangreiches Antwortelement (z.B. BasicCard, StructuredResponse, MediaResponse oder HtmlResponse) 4. Sie können kein Rich-Response-Element verwenden, wenn Sie den Intent „actions.intent.OPTION“ verwenden, also ListSelect oder CarouselSelect

suggestions[]

object (Suggestion)

Eine Liste mit Antwortvorschlägen. Diese werden immer am Ende der Antwort angezeigt. Wenn Sie sie in einem FinalResponse verwenden, werden sie ignoriert.

Artikel

Elemente der Antwort.

JSON-Darstellung
{
  "name": string,

  // Union field item can be only one of the following:
  "simpleResponse": {
    object (SimpleResponse)
  },
  "basicCard": {
    object (BasicCard)
  },
  "structuredResponse": {
    object (StructuredResponse)
  },
  "mediaResponse": {
    object (MediaResponse)
  },
  "carouselBrowse": {
    object (CarouselBrowse)
  },
  "tableCard": {
    object (TableCard)
  },
  "htmlResponse": {
    object (HtmlResponse)
  }
  // End of list of possible types for union field item.
}
Felder
name

string

Optionale benannte Kennzeichnung dieses Artikels.

Union-Feld item. Art des Elements. Für item ist nur einer der folgenden Werte zulässig:
simpleResponse

object (SimpleResponse)

Antwort mit Sprach- und Texteingabe.

basicCard

object (BasicCard)

Eine Basiskarte.

structuredResponse

object (StructuredResponse)

Strukturierte Nutzlast, die von Google verarbeitet werden soll.

mediaResponse

object (MediaResponse)

Antwort, die eine Gruppe von Medien angibt, die wiedergegeben werden sollen.

carouselBrowse

object (CarouselBrowse)

Karussell-Karussellkarte, verwenden Sie stattdessen collectionBrowse.

tableCard

object (TableCard)

Tabellenkarte.

htmlResponse

object (HtmlResponse)

HTML-Antwort, die zum Rendern auf Canvas verwendet wird.

Einfache Antwort

Eine einfache Antwort, die dem Nutzer Sprache oder Text zeigt.

JSON-Darstellung
{
  "textToSpeech": string,
  "ssml": string,
  "displayText": string
}
Felder
textToSpeech

string

Nur-Text der Sprachausgabe, z.B. „Wo möchtest du hin?“ Schließt sich mit ssml aus.

ssml

string

Strukturierte gesprochene Antwort an den Nutzer im SSML-Format, z.B. <speak> Say animal name after the sound. <audio src = 'https://www.pullstring.com/moo.mps' />, what’s the animal? </speak>. Schließt sich mit textToSpeech aus.

displayText

string

Optionaler Text, der im Infofeld angezeigt wird. Wenn nicht angegeben, wird ein Anzeige-Rendering von oben für „textToSpeech“ oder „ssml“ verwendet. Begrenzt auf 640 Zeichen.

Basiskarte

Eine Basiskarte, auf der einige Informationen angezeigt werden, z.B. ein Bild und/oder Text.

JSON-Darstellung
{
  "title": string,
  "subtitle": string,
  "formattedText": string,
  "image": {
    object (Image)
  },
  "buttons": [
    {
      object (Button)
    }
  ],
  "imageDisplayOptions": enum (ImageDisplayOptions)
}
Felder
title

string

Gesamttitel der Karte. Optional.

subtitle

string

Optional.

formattedText

string

Text der Infokarte. Unterstützt eine begrenzte Anzahl von Markdown-Syntaxen für die Formatierung. Erforderlich, sofern kein Bild vorhanden ist.

image

object (Image)

Hero-Image für die Karte Die Höhe ist auf 192 dp festgelegt. Optional.

buttons[]

object (Button)

Schaltflächen. Derzeit wird maximal eine Schaltfläche unterstützt. Optional.

imageDisplayOptions

enum (ImageDisplayOptions)

Art der Bildanzeige. Optional.

Schaltfläche

Ein Schaltflächenobjekt, das normalerweise unten auf einer Karte angezeigt wird.

JSON-Darstellung
{
  "title": string,
  "openUrlAction": {
    object (OpenUrlAction)
  }
}
Felder
title

string

Titel der Schaltfläche. Erforderlich.

openUrlAction

object (OpenUrlAction)

Aktion, die ausgeführt werden soll, wenn ein Nutzer auf die Schaltfläche tippt Erforderlich.

Strukturierte Antwort

Die für die App definierte Antwort, um mit strukturierten Daten zu antworten.

JSON-Darstellung
{

  // Union field data can be only one of the following:
  "orderUpdate": {
    object (OrderUpdate)
  },
  "orderUpdateV3": {
    object (OrderUpdate)
  }
  // End of list of possible types for union field data.
}
Felder
Union-Feld data. Der Container der Nutzlastantwort von Drittanbietern. Für data ist nur einer der folgenden Werte zulässig:
orderUpdate

object (OrderUpdate)

Nach Erhalt der Bestellung wird in der App ein Update angezeigt (z.B. Receipt).

orderUpdateV3

object (OrderUpdate)

Die App bietet nach dem Erhalt der Bestellung eine Aktualisierung im API-Version 3-Format.

OrderUpdate (Bestellupdate)

Verworfen: Verwenden Sie stattdessen V3 Proto. Aktualisieren Sie einen Auftrag.

JSON-Darstellung
{
  "googleOrderId": string,
  "actionOrderId": string,
  "orderState": {
    object (OrderState)
  },
  "orderManagementActions": [
    {
      object (Action)
    }
  ],
  "receipt": {
    object (Receipt)
  },
  "updateTime": string,
  "totalPrice": {
    object (Price)
  },
  "lineItemUpdates": {
    string: {
      object(LineItemUpdate)
    },
    ...
  },
  "userNotification": {
    object (UserNotification)
  },
  "infoExtension": {
    "@type": string,
    field1: ...,
    ...
  },

  // Union field info can be only one of the following:
  "rejectionInfo": {
    object (RejectionInfo)
  },
  "cancellationInfo": {
    object (CancellationInfo)
  },
  "inTransitInfo": {
    object (InTransitInfo)
  },
  "fulfillmentInfo": {
    object (FulfillmentInfo)
  },
  "returnInfo": {
    object (ReturnInfo)
  }
  // End of list of possible types for union field info.
}
Felder
googleOrderId

string

Die ID der Bestellung ist die von Google ausgestellte ID.

actionOrderId

string

Erforderlich. Die kanonische Bestell-ID, die auf diese Bestellung verweist. Wenn Integratoren die kanonische Bestell-ID in ihrem System nicht generieren, können sie einfach die in der Bestellung enthaltene googleOrderId kopieren.

orderState

object (OrderState)

Der neue Status der Bestellung.

orderManagementActions[]

object (Action)

Aktualisierte Verwaltungsaktionen für den Auftrag, z. B. Verwaltung, Änderung oder Support

receipt

object (Receipt)

Beleg für die Bestellung.

updateTime

string (Timestamp format)

Zeitpunkt der Aktualisierung der Bestellung aus Sicht der App

Ein Zeitstempel im Format RFC3339 UTC „Zulu“ in Nanosekunden. Beispiel: "2014-10-02T15:01:23.045123456Z".

totalPrice

object (Price)

Neuer Gesamtpreis der Bestellung

lineItemUpdates

map (key: string, value: object (LineItemUpdate))

Zuordnung von Änderungen auf Werbebuchungsebene, aufgeschlüsselt nach Element-ID Optional.

Ein Objekt, das eine Liste von "key": value-Paaren enthält. Beispiel: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

userNotification

object (UserNotification)

Wenn angegeben, wird eine Benachrichtigung an den Nutzer mit dem angegebenen Titel und Text angezeigt. Die Angabe einer Benachrichtigung ist ein Vorschlag für die Benachrichtigung und garantiert nicht, dass Sie eine entsprechende Benachrichtigung erhalten.

infoExtension

object

Zusätzliche Daten, die auf einem benutzerdefinierten Bestellstatus oder zusätzlich zu den Informationen eines Standardstatus basieren.

Ein Objekt mit Feldern eines beliebigen Typs. Ein zusätzliches Feld "@type" enthält einen URI zur Identifizierung des Typs. Beispiel: { "id": 1234, "@type": "types.example.com/standard/id" }.

Union-Feld info. Zusätzliche Informationen zum Status der Bestellung. Für info ist nur einer der folgenden Werte zulässig:
rejectionInfo

object (RejectionInfo)

Informationen zum Ablehnungsstatus.

cancellationInfo

object (CancellationInfo)

Informationen zum Kündigungsstatus.

inTransitInfo

object (InTransitInfo)

Informationen zu öffentlichen Verkehrsmitteln.

fulfillmentInfo

object (FulfillmentInfo)

Informationen zum Status der Auftragsausführung.

returnInfo

object (ReturnInfo)

Informationen zum zurückgegebenen Status.

Aktion

Eine Folgeaktion im Zusammenhang mit der Bestellaktualisierung.

JSON-Darstellung
{
  "type": enum (ActionType),
  "button": {
    object (Button)
  }
}
Felder
type

enum (ActionType)

Aktionstyp.

button

object (Button)

Schaltflächenlabel und -link.

Beleg

Verworfen: Verwenden Sie stattdessen V3 Proto. Beleg, wenn das Bundesland den Status CONFIRMED oder einen anderen Status (z. B. IN_TRANSIT, FULFILLED) hat, einschließlich des Status CONFIRMED

JSON-Darstellung
{
  "confirmedActionOrderId": string,
  "userVisibleOrderId": string
}
Felder
confirmedActionOrderId
(deprecated)

string

Bestätigte Bestell-ID, wenn der Integrator die Bestellung erhalten hat. Das ist die kanonische Bestell-ID, die im System des Integrationspartners verwendet wird und auf die Bestellung verweist. Sie kann später als actionOrderId bezeichnet werden.

Dieses Feld wurde eingestellt. Bitte übergeben Sie das Feld stattdessen über OrderUpdate.action_order_id.

userVisibleOrderId

string

Optional. Die ID des Nutzers für die aktuelle Bestellung, die auf der Belegkarte angezeigt wird, sofern vorhanden. Dabei sollte es sich um die ID handeln, die normalerweise auf einem ausgedruckten Beleg oder Beleg an die E-Mail-Adresse des Nutzers erscheint. Der Nutzer sollte diese ID verwenden können, um auf seine Bestellung für den Kundenservice von Integratoren zu verweisen. Beachten Sie, dass dieses Feld ausgefüllt sein muss, wenn der Integrationspartner eine nutzerseitige ID für eine Bestellung mit einem ausgedruckten / E-Mail-Beleg generiert.

Ablehnungsinformationen

Die Ablehnungsinformationen, wenn der Status REJECTED ist. Diese Nachricht kann bei der ersten Bestellaktualisierung in einer Unterhaltung oder durch eine nachfolgende asynchrone Bestellaktualisierung ausgefüllt werden.

JSON-Darstellung
{
  "type": enum (ReasonType),
  "reason": string
}
Felder
type

enum (ReasonType)

Ablehnungstyp.

reason

string

Ursache des Fehlers.

Stornierungsinformationen

Verworfen: Verwenden Sie stattdessen V3 Proto. Die Stornierungsinformationen, wenn der Status CANCELLED ist.

JSON-Darstellung
{
  "reason": string
}
Felder
reason

string

Kündigungsgrund.

Informationen zu öffentlichen Verkehrsmitteln

Verworfen: Verwenden Sie stattdessen V3 Proto. Informationen zu öffentlichen Verkehrsmitteln, wenn der Status IN_TRANSIT lautet.

JSON-Darstellung
{
  "updatedTime": string
}
Felder
updatedTime

string (Timestamp format)

Zuletzt aktualisiert.

Ein Zeitstempel im Format RFC3339 UTC „Zulu“ in Nanosekunden. Beispiel: "2014-10-02T15:01:23.045123456Z".

FulfillmentInfo

Verworfen: Verwenden Sie stattdessen V3 Proto. Die Informationen zur Auftragsausführung, wenn der Status FULFILLED ist.

JSON-Darstellung
{
  "deliveryTime": string
}
Felder
deliveryTime

string (Timestamp format)

Wann wird die Bestellung ausgeführt?

Ein Zeitstempel im Format RFC3339 UTC „Zulu“ in Nanosekunden. Beispiel: "2014-10-02T15:01:23.045123456Z".

Rückgabeinformationen

Verworfen: Verwenden Sie stattdessen V3 Proto. Die Rückgabeinformationen, wenn der Status REJECTED ist.

JSON-Darstellung
{
  "reason": string
}
Felder
reason

string

Rückgabegrund.

Nutzerbenachrichtigung

Optionale Nutzerbenachrichtigung, die im Rahmen der Bestellaktualisierung angezeigt wird.

JSON-Darstellung
{
  "title": string,
  "text": string
}
Felder
title

string

Der Titel der Nutzerbenachrichtigung.

text

string

Der Inhalt der Benachrichtigung.

MediaResponse

Die Antwort, die eine Reihe von Medien angibt, die in der Unterhaltung abgespielt werden sollen.

JSON-Darstellung
{
  "mediaType": enum (MediaType),
  "mediaObjects": [
    {
      object (MediaObject)
    }
  ]
}
Felder
mediaType

enum (MediaType)

der Medientyp in dieser Antwort.

mediaObjects[]

object (MediaObject)

Die Liste der Medienobjekte.

Media-Objekt

Ein Medienobjekt, das mit MediaResponse zurückgegeben wird Enthält Informationen zum Medium wie Name, Beschreibung und URL.

JSON-Darstellung
{
  "name": string,
  "description": string,
  "contentUrl": string,

  // Union field image can be only one of the following:
  "largeImage": {
    object (Image)
  },
  "icon": {
    object (Image)
  }
  // End of list of possible types for union field image.
}
Felder
name

string

Name dieses Medienobjekts.

description

string

Beschreibung dieses Medienobjekts.

contentUrl

string

Die URL, die auf den Medieninhalt verweist.

Union-Feld image. Bild, das mit der Medienkarte angezeigt werden soll. Für image ist nur einer der folgenden Werte zulässig:
largeImage

object (Image)

Ein großes Bild, wie etwa das Cover des Albums usw.

icon

object (Image)

Ein kleines Bildsymbol rechts neben dem Titel. Die Größe wird auf 36 x 36 dp angepasst.

KarussellDurchsuchen

Stellt eine Reihe von AMP-Dokumenten als Karussell mit großen Kacheln dar Unter Umständen können Elemente ausgewählt werden, um das entsprechende AMP-Dokument in einem AMP-Viewer zu starten.

JSON-Darstellung
{
  "items": [
    {
      object (Item)
    }
  ],
  "imageDisplayOptions": enum (ImageDisplayOptions)
}
Felder
items[]

object (Item)

Min.: 2. Max: 10

imageDisplayOptions

enum (ImageDisplayOptions)

Art der Bildanzeige. Optional.

Artikel

Element im Karussell.

JSON-Darstellung
{
  "title": string,
  "description": string,
  "footer": string,
  "image": {
    object (Image)
  },
  "openUrlAction": {
    object (OpenUrlAction)
  }
}
Felder
title

string

Titel des Karussellelements. Erforderlich.

description

string

Beschreibung des Karussellelements. Optional.

footer

string

Fußzeilentext für das Karussellelement, das unter der Beschreibung angezeigt wird. Einzelne Textzeile mit Auslassungspunkten. Optional.

image

object (Image)

Hero-Image für das Karussellelement. Optional.

openUrlAction

object (OpenUrlAction)

URL des Dokuments, das mit dem Karussellelement verknüpft ist. Das Dokument kann HTML-Inhalte oder, wenn „urlTypeHint“ auf AMP_CONTENT eingestellt ist, AMP-Inhalte enthalten. Erforderlich.

Tischkarte

Eine Tabellenkarte zum Anzeigen einer Texttabelle

JSON-Darstellung
{
  "title": string,
  "subtitle": string,
  "image": {
    object (Image)
  },
  "columnProperties": [
    {
      object (ColumnProperties)
    }
  ],
  "rows": [
    {
      object (Row)
    }
  ],
  "buttons": [
    {
      object (Button)
    }
  ]
}
Felder
title

string

Gesamttitel der Tabelle. Optional, muss aber festgelegt werden, wenn Untertitel festgelegt werden.

subtitle

string

Untertitel für die Tabelle. Optional.

image

object (Image)

Mit der Tabelle verknüpftes Bild. Optional.

columnProperties[]

object (ColumnProperties)

Überschriften und Ausrichtung von Spalten.

rows[]

object (Row)

Zeilendaten der Tabelle Die ersten 3 Zeilen sind garantiert zu sehen, aber auf anderen Oberflächen sind die Schnitte möglicherweise abgeschnitten. Bitte testen Sie mit dem Simulator, welche Zeilen für eine bestimmte Oberfläche angezeigt werden. Auf Oberflächen, die die Funktion WEB_BROWSER unterstützen, können Sie den Nutzer auf eine Webseite mit weiteren Daten verweisen.

buttons[]

object (Button)

Schaltflächen. Derzeit wird maximal eine Schaltfläche unterstützt. Optional.

Spalteneigenschaften

Behält Eigenschaften von Spalten (einschließlich Headern).

JSON-Darstellung
{
  "header": string,
  "horizontalAlignment": enum (HorizontalAlignment)
}
Felder
header

string

Kopfzeilentext für die Spalte.

horizontalAlignment

enum (HorizontalAlignment)

Horizontale Ausrichtung des Inhalts in der Spalte „w.r.t“. Wenn Sie nichts angeben, wird der Inhalt am oberen Rand ausgerichtet.

Row

Beschreibt eine Zeile in der Tabelle.

JSON-Darstellung
{
  "cells": [
    {
      object (Cell)
    }
  ],
  "dividerAfter": boolean
}
Felder
cells[]

object (Cell)

Zellen in dieser Zeile. Die ersten 3 Zellen sind garantiert, aber auf anderen Oberflächen könnten andere abgeschnitten werden. Bitte testen Sie mit dem Simulator, welche Zellen für eine bestimmte Oberfläche angezeigt werden.

dividerAfter

boolean

Gibt an, ob nach jeder Zeile eine Trennlinie stehen muss.

Zelle

Beschreibt eine Zelle in einer Zeile.

JSON-Darstellung
{
  "text": string
}
Felder
text

string

Textinhalt der Zelle.

HTMLAntwort

Antwort, bei der mit der interaktiven Canvas-Funktion HTML angezeigt wird Die maximale Größe der Antwort beträgt 50.000 Byte.

JSON-Darstellung
{
  "updatedState": value,
  "suppressMic": boolean,
  "url": string
}
Felder
updatedState

value (Value format)

Kommunizieren Sie das folgende JSON-Objekt mit der App.

suppressMic

boolean

Wählen Sie eine Option aus, damit das Mikrofon nach dieser immersiven Antwort nicht geöffnet wird.

url

string

Die URL der Anwendung.

Vorschlag

Ein Vorschlags-Chip, auf den der Nutzer tippen kann, um schnell eine Antwort auf die Unterhaltung zu posten.

JSON-Darstellung
{
  "title": string
}
Felder
title

string

Der Text, der im Vorschlagschip angezeigt wird. Wenn du darauf tippst, wird dieser Text wortgetreu wieder so gepostet, als ob der Nutzer ihn eingegeben hätte. Jeder Titel muss innerhalb der Reihe von Vorschlags-Chips eindeutig sein. Max. 25 Zeichen erforderlich

LinkOutSuggestion

Erstellt einen Vorschlags-Chip, der es dem Nutzer ermöglicht, zu der mit diesem Agent verknüpften App oder Website zu springen.

JSON-Darstellung
{
  "destinationName": string,
  "url": string,
  "openUrlAction": {
    object (OpenUrlAction)
  }
}
Felder
destinationName

string

Der Name der App oder Website, mit der dieser Chip verknüpft ist. Der Chip wird mit dem Titel „Öffnen“ gerendert. Es sind maximal 20 Zeichen zulässig. Erforderlich.

url
(deprecated)

string

Veraltet. Verwenden Sie stattdessen OpenUrlAction.

openUrlAction

object (OpenUrlAction)

Die URL der App oder Website, die geöffnet wird, wenn der Nutzer auf den Chip für Vorschläge tippt. Die Inhaberschaft dieser App bzw. URL muss in den Aktionen der Google Developer Console bestätigt werden. Andernfalls wird dem Nutzer der Vorschlag nicht angezeigt. Open URL Action unterstützt HTTP, HTTPS und Intent-URLs. Weitere Informationen zu Intent-URLs finden Sie unter https://developer.chrome.com/multidevice/android/intents.

Erwarteter Intent

Der erwartete Intent, den die App dem Assistenten zur Verfügung stellt.

JSON-Darstellung
{
  "intent": string,
  "inputValueData": {
    "@type": string,
    field1: ...,
    ...
  },
  "parameterName": string
}
Felder
intent

string

Der integrierte Intent-Name, z.B. actions.intent.TEXT, oder im Intent-Paket definierte Intents. Wenn der angegebene Intent kein integrierter Intent ist, wird er nur für die Sprachgewichtung verwendet. Die von Google Assistant bereitgestellte Eingabe ist der Intent actions.intent.TEXT.

inputValueData

object

Zusätzliche Konfigurationsdaten, die für einen integrierten Intent erforderlich sind. Mögliche Werte für die integrierten Intents: actions.intent.OPTION -> google.actions.v2.OptionValueSpec, actions.intent.CONFIRMATION -> google.actions.v2.ConfirmationValueSpec, actions.intent.TRANSACTION_REQUIREMENTS_CHECK -> google.actions.v2.TransactionRequirementsCheckSpec, actions.intent.DELIVERY_ADDRESS -> google.actions.v2.DeliveryAddressValueSpec, actions.intent.TRANSACTION_DECISION -> google.actions.v2.TransactionDecisionValueSpec, actions.intent.PLACE -> google.actions.v2.PlaceValueSpec, actions.intent.Link -> google.actions.v2.LinkValueSpec

Ein Objekt mit Feldern eines beliebigen Typs. Ein zusätzliches Feld "@type" enthält einen URI zur Identifizierung des Typs. Beispiel: { "id": 1234, "@type": "types.example.com/standard/id" }.

parameterName

string

Optional: Ein Parameter des angefragten Intents. Nur für angeforderte Intents gültig. Wird für die Sprachgewichtung verwendet.

Letzte Antwort

Die endgültige Antwort, wenn die Nutzereingabe nicht erwartet wird.

JSON-Darstellung
{

  // Union field response can be only one of the following:
  "speechResponse": {
    object (SpeechResponse)
  },
  "richResponse": {
    object (RichResponse)
  }
  // End of list of possible types for union field response.
}
Felder
Union-Feld response. Mögliche Antworttypen. Für response ist nur einer der folgenden Werte zulässig:
speechResponse
(deprecated)

object (SpeechResponse)

Gesprochene Antwort, wenn der Nutzer keine Eingabe vornehmen muss.

richResponse

object (RichResponse)

Umfassende Antwort, wenn der Nutzer keine Eingabe vornehmen muss.

Benutzerdefinierte Push-Nachricht

Eine benutzerdefinierte Push-Nachricht, die strukturierte Daten enthält, die für die Aktionen Fulfillment API übertragen werden.

JSON-Darstellung
{
  "target": {
    object (Target)
  },

  // Union field content can be only one of the following:
  "orderUpdate": {
    object (OrderUpdate)
  },
  "userNotification": {
    object (UserNotification)
  }
  // End of list of possible types for union field content.
}
Felder
target

object (Target)

Das angegebene Ziel für die Push-Anfrage.

Union-Feld content. Die verschiedenen Nutzlasttypen. Für content ist nur einer der folgenden Werte zulässig:
orderUpdate

object (OrderUpdate)

Ein Bestellupdate, das Bestellungen über Transaktions-APIs aktualisiert.

userNotification

object (UserNotification)

Wenn angegeben, wird eine Benachrichtigung für den Nutzer mit dem angegebenen Titel und Text angezeigt.

Nutzerbenachrichtigung

Nutzerbenachrichtigung wird mit einer Anfrage angezeigt.

JSON-Darstellung
{
  "title": string,
  "text": string
}
Felder
title

string

Der Titel der Benachrichtigung.

text

string

Der Inhalt der Benachrichtigung.

Ziel

Das angegebene Ziel für die Push-Anfrage.

JSON-Darstellung
{
  "userId": string,
  "intent": string,
  "argument": {
    object (Argument)
  },
  "locale": string
}
Felder
userId

string

Der Nutzer, auf den die Anzeige ausgerichtet werden soll.

intent

string

Der Intent für die Ausrichtung.

argument

object (Argument)

Das Argument für die Ausrichtung auf einen Intent. Für V1 wird nur ein Argument unterstützt.

locale

string

Die Zielsprache. Entspricht dem Sprachcode IETF BCP-47. Kann von einer mehrsprachigen App verwendet werden, um eine Ausrichtung auf einen Nutzer einer bestimmten lokalisierten App vorzunehmen. Wenn keine Angabe erfolgt, wird standardmäßig „en-US“ verwendet.