Files

object (ConfigFile)

Mehrere Konfigurationsdateien

string

Der relative Pfad der Konfigurationsdatei vom Projektstamm in der SDK-Dateistruktur. Jeder der folgenden Dateitypen hat einen zulässigen Dateipfad. Beispiel: settings/settings.yaml

object (Manifest)

Einzelne Manifestdatei. Zulässiger Dateipfad: manifest.yaml

object (Actions)

Einzelne Aktionsdatei mit allen definierten Aktionen. Zulässige Dateipfade: actions/{language}?/actions.yaml

object (Settings)

Einzelne Einstellungskonfiguration, die nicht lokalisierbare Einstellungen und Einstellungen für die Standardsprache des Projekts (falls angegeben) enthält. Bei einer Datei zum Überschreiben des Gebietsschemas wird nur das Feld "localizedSettings" ausgefüllt. Zulässige Dateipfade: settings/{language}?/settings.yaml Die nicht lokalisierte Einstellungsdatei settings/settings.yaml muss in Anfragen zum Schreibfluss vorhanden sein.

object (Webhook)

Definition eines einzelnen Webhooks. Zulässiger Dateipfad: webhooks/{WebhookName}.yaml

object (Intent)

Definition eines einzelnen Intents. Zulässige Dateipfade: custom/intents/{language}?/{IntentName}.yaml

object (Type)

Definition eines einzelnen Typs. Zulässige Dateipfade: custom/types/{language}?/{TypeName}.yaml

object (EntitySet)

Definition eines Einzelentitäts-Sets. Zulässige Dateipfade: custom/entitySets/{language}?/{EntitySetName}.yaml

object (GlobalIntentEvent)

Einzelne globale Intent-Ereignisdefinition. Zulässige Dateipfade: custom/global/{GlobalIntentEventName}.yaml Der Dateiname (GlobalIntentEventName) muss der Name des Intents sein, dem dieses globale Intent-Ereignis entspricht.

object (Scene)

Definition einer einzelnen Szene. Zulässige Dateipfade: custom/scenes/{SceneName}.yaml

object (StaticPrompt)

Definition einer einzelnen statischen Aufforderung. Zulässige Dateipfade: custom/prompts/{language}?/{StaticPromptName}.yaml

object (AccountLinkingSecret)

Metadaten, die dem Clientschlüssel entsprechen, der bei der Kontoverknüpfung verwendet wurde. Zulässiger Dateipfad: settings/accountLinkingSecret.yaml

object (Struct format)

Einzelnes Ressourcen-Bundle, bei dem es sich um eine Zuordnung von einem String zu einem String oder einer Liste von Strings handelt. Ressourcen-Bundles können zum Lokalisieren von Strings in statischen Prompts verwendet werden. Zulässige Dateipfade: resources/strings/{language}?/{multiple directories}?/{BundleName}.yaml

string

Version des Dateiformats. Die aktuelle Dateiformatversion ist 1.0. Beispiel: „1.0“

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

Ordnen Sie Intents benutzerdefinierten Aktionen zu, um den Aufruf für das Projekt zu konfigurieren. Die Aufruf-Intents können entweder System- oder benutzerdefinierte Intents sein, die in „custom/intents/“ definiert sind. Paket. Für alle hier definierten Intents (System-Intents und benutzerdefinierte Intents) muss im Ordner „custom/global/“ eine entsprechende Intent-Datei vorhanden sein. Paket.

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

object (Engagement)

Engagement-Mechanismen, die mit der Aktion verknüpft sind, um Endnutzern zu helfen, Push-Benachrichtigungen und tägliche Updates zu abonnieren. Der Intent-Name, der in der Konfiguration für tägliche Updates/Push-Benachrichtigungsslots angegeben ist, muss dem Intent entsprechen, der dieser Aktion entspricht, damit Endnutzer diese Updates abonnieren können.

string

Der Titel der Interaktion, der an Endnutzer gesendet wird, um sie um ihre Zustimmung zum Erhalt von Aktualisierungen zu bitten. Die Aufforderung für tägliche Updates an die Endnutzer lautet wie folgt: „Um wie viel Uhr soll ich Ihnen täglich {title}“ senden? und für Push-Benachrichtigungen lautet die Frage "Is it ok if I send push notifications for {title}". Dieses Feld kann lokalisiert werden.

object (PushNotification)

Einstellungen für Push-Benachrichtigungen, die für diese Interaktion unterstützt werden.

object (ActionLink)

Linkkonfiguration für eine Aktion, die bestimmt, ob die Freigabe von Links für die Aktion aktiviert ist, und ggf. den nutzerfreundlichen Anzeigenamen für den Link enthält. ActionLink wurde eingestellt. Verwende stattdessen AssistantLink.

object (AssistantLink)

Linkkonfiguration für eine Aktion, die bestimmt, ob die Freigabe von Links für die Aktion aktiviert ist, und ggf. den nutzerfreundlichen Anzeigenamen für den Link enthält.

object (DailyUpdate)

Einstellungen für tägliche Updates, die durch dieses Engagement unterstützt werden.

string

Nutzerfreundlicher Anzeigetitel für den Link.

string

Nutzerfreundlicher Anzeigetitel für den Link.

string

Actions-Projekt-ID.

string

Sprache, die der Standardwert für das Projekt ist. Bei allen Dateien außer unter resources/ ohne Sprache im Pfad werden die lokalisierten Daten dieser defaultLocale zugeordnet. Bei Dateien unter resources/ bedeutet keine Sprache, dass die Ressource für alle Sprachen anwendbar ist.

string

Stellt die Regionen dar, in denen Nutzer deine Aktionen aufrufen können (basierend auf dem Standort des Nutzers). Kann nicht festgelegt werden, wenn disabledRegions festgelegt ist. Wenn sowohl enabledRegions als auch disabledRegions nicht angegeben sind, können Nutzer deine Aktionen in allen Regionen aufrufen. Jede Region wird mithilfe des kanonischen Namens der AdWords-Zielregionen dargestellt. Siehe https://developers.google.com/adwords/api/docs/appendix/geotargeting. Beispiele: – "Deutschland" - "Ghana" - "Griechenland" - "Grenada" - "Vereinigtes Königreich" - "USA" - "Kleinere Amerikanische Überseeinseln" – „Uruguay“

string

Stellt die Regionen dar, in denen deine Aktionen basierend auf dem aktuellen Standort des Nutzers blockiert sind. Kann nicht festgelegt werden, wenn enabledRegions festgelegt ist. Jede Region wird mithilfe des kanonischen Namens der AdWords-Zielregionen dargestellt. Siehe https://developers.google.com/adwords/api/docs/appendix/geotargeting. Beispiele: – "Deutschland" - "Ghana" - "Griechenland" - "Grenada" - "Vereinigtes Königreich" - "USA" - "Kleinere Amerikanische Überseeinseln" – „Uruguay“

enum (Category)

Die Kategorie für dieses Actions-Projekt.

boolean

Gibt an, ob Aktionen Transaktionen verwenden können (z. B. Reservierungen vornehmen, Bestellungen annehmen usw.) Bei „false“ schlägt der Versuch, die Transaktions-APIs zu verwenden, fehl.

boolean

Gibt an, ob Aktionen Transaktionen für digitale Waren durchführen können.

boolean

Gibt an, ob Aktionen den interaktiven Canvas verwenden.

boolean

Gibt an, ob Aktionen die Speicherfunktion des Zuhauses verwenden.

boolean

Gibt an, ob Actions-Inhalte für Familien gedacht sind.

boolean

Ob Aktionen alkohol- oder tabakbezogene Inhalte enthalten

boolean

Legt fest, ob das Mikrofon in Actions ohne explizite Aufforderung während einer Unterhaltung eingeschaltet bleibt.

object (SurfaceRequirements)

Die Oberflächenanforderungen, die eine Client-Oberfläche unterstützen muss, um Aktionen in diesem Projekt aufzurufen.

string

Anleitung zum Testen im freien Format für Actions-Prüfer, z. B. Anleitungen zur Kontoverknüpfung

object (LocalizedSettings)

Lokalisierte Einstellungen für die Standardsprache des Projekts. Für jedes zusätzliche Gebietsschema sollte eine eigene Einstellungsdatei in einem eigenen Verzeichnis vorhanden sein.

object (AccountLinking)

Nutzern erlauben, über Google Log-in und/oder Ihren eigenen OAuth-Dienst Konten zu erstellen oder zu verknüpfen.

string

Android-Apps, die für den Zugriff auf Google Play-Käufe für Transaktionen ausgewählt wurden Dies ist eine Auswahl aus den Android-Apps, die mit dem Actions-Projekt verknüpft sind, um die Markeninhaberschaft zu bestätigen und zusätzliche Funktionen zu aktivieren. Weitere Informationen finden Sie unter https://developers.google.com/assistant/console/brand-verification.

object (CapabilityRequirement)

Die Mindestfunktionen, die zum Aufrufen der Aktionen in Ihrem Projekt erforderlich sind. Fehlt auf der Oberfläche eine dieser Angaben, wird die Aktion nicht ausgelöst.

enum (SurfaceCapability)

Der Typ der Funktion.

string

Erforderlich. Der standardmäßige Anzeigename für dieses Actions-Projekt (falls keine Übersetzung verfügbar ist)

string

Erforderlich. Die Aussprache des Anzeigenamens, der in einem Sprachkontext (gesprochen) aufgerufen wird.

string

Erforderlich. Die standardmäßige Kurzbeschreibung für das Actions-Projekt (falls keine Übersetzung verfügbar ist). Maximal 80 Zeichen.

string

Erforderlich. Die standardmäßige lange Beschreibung für das Actions-Projekt (falls keine Übersetzung verfügbar ist). Maximal 4.000 Zeichen.

string

Erforderlich. Kleines quadratisches Bild, 192 x 192 Pixel Sollte als Verweis auf das entsprechende Bild im Verzeichnis resources/images/ angegeben werden. Beispiel: $resources.images.foo (ohne die Erweiterung) für ein Image in resources/images/foo.jpg. Wenn Sie an einem Projekt arbeiten, das aus der Console abgerufen wird, kann die von Google verwaltete URL verwendet werden. URLs aus externen Quellen sind nicht zulässig.

string

Optional. Großes Bild im Querformat, 1.920 x 1.080 Pixel Sollte als Verweis auf das entsprechende Bild im Verzeichnis resources/images/ angegeben werden. Beispiel: $resources.images.foo (ohne die Erweiterung) für ein Image in resources/images/foo.jpg. Wenn Sie an einem Projekt arbeiten, das aus der Console abgerufen wird, kann die von Google verwaltete URL verwendet werden. URLs aus externen Quellen sind nicht zulässig.

string

Erforderlich. Der Name des Entwicklers, der den Nutzern angezeigt wird.

string

Erforderlich. Die Kontakt-E-Mail-Adresse des Entwicklers.

string

Optional. Die URL der Nutzungsbedingungen.

string

Erforderlich. Der Google Assistant-Sprachtyp, den Nutzer hören, wenn sie mit deinen Aktionen interagieren. Die unterstützten Werte sind „male_1“, „male_2“, „female_1“ und „female_2“.

string

Optional. Die Sprache für die angegebene Stimme. Wenn keine Angabe erfolgt, wird die Assistant-Sprache des Nutzers verwendet. Wenn angegeben, muss die Sprache der Sprache mit der in „LocalizedSettings“ angegebenen Sprache übereinstimmen.

string

Erforderlich. Die URL der Datenschutzerklärung.

string

Optional. Beispiele für Aufrufformulierungen, die als Teil der Beschreibung Ihres Actions-Projekts im Assistant-Verzeichnis angezeigt werden. So lernen die Nutzenden, wie sie verwendet werden.

object (ThemeCustomization)

Optional. Designanpassungen für visuelle Komponenten deiner Aktionen.

string

Hintergrundfarbe von Karten Fungiert als Fallback, wenn background_image nicht von Entwicklern bereitgestellt wird oder background_image für bestimmte Oberflächen nicht geeignet ist. Beispielverwendung: #FAFAFA

string

Die primäre Designfarbe der Aktion wird verwendet, um die Textfarbe für den Titel und die Hintergrundfarbe der Aufgaben für Actions on Google-Karten festzulegen. Beispielverwendung: #FAFAFA

string

Die Schriftfamilie, die für den Titel der Karten verwendet wird. Unterstützte Schriftarten: - Serifenschrift - Serifenlose Schriften - Serifenlose Schriften - Serifenlose Schriften - Serifen ohne Serifen Schwarz - Gesprochen

enum (ImageCornerStyle)

Rahmenlinienstil des Vordergrundbilds von Karten. Sie kann beispielsweise auf das Vordergrundbild einer Standard- oder Karussellkarte angewendet werden.

string

Querformat (mindestens 1.920 x 1.200 Pixel) Sollte als Verweis auf das entsprechende Bild im Verzeichnis resources/images/ angegeben werden. Beispiel: $resources.images.foo (ohne die Erweiterung) für ein Image in resources/images/foo.jpg. Wenn Sie an einem Projekt arbeiten, das aus der Console abgerufen wird, kann die von Google verwaltete URL verwendet werden.

string

Porträtmodus (mindestens 1.200 × 1.920 Pixel) Sollte als Verweis auf das entsprechende Bild im Verzeichnis resources/images/ angegeben werden. Beispiel: $resources.images.foo (ohne die Erweiterung) für ein Image in resources/images/foo.jpg. Wenn Sie an einem Projekt arbeiten, das aus der Console abgerufen wird, kann die von Google verwaltete URL verwendet werden.

boolean

Erforderlich. Wenn true, können Nutzer sich per Sprachbefehl für neue Konten registrieren. Wenn false, ist die Kontoerstellung nur auf Ihrer Website zulässig. Wählen Sie diese Option aus, wenn Sie Ihre Nutzungsbedingungen anzeigen oder bei der Registrierung die Nutzereinwilligung einholen möchten. „linkingType“ darf nicht GOOGLE_SIGN_IN sein, wenn false verwendet wird. „linkingType“ darf nicht OAUTH sein, wenn true verwendet wird.

enum (LinkingType)

Erforderlich. Der zu verwendende Verknüpfungstyp. Weitere Informationen zu den Verknüpfungstypen finden Sie unter https://developers.google.com/assistant/identity.

enum (AuthGrantType)

Optional. Gibt den Authentifizierungstyp für OAUTH LinkingType an.

string

Optional. Client-ID, die von deiner App an Google ausgestellt wurde. Dies ist die OAuth2-Client-ID, mit der Google für Ihren Dienst identifiziert wird. Wird nur bei Verwendung von OAuth festgelegt.

string

Optional. Endpunkt für deine Anmeldewebseite, der OAuth2-Code oder implizite Abläufe unterstützt. Die URL muss HTTPS verwenden. Wird nur bei Verwendung von OAuth festgelegt.

string

Optional. OAuth2-Endpunkt für Tokenaustausch. Die URL muss HTTPS verwenden. Dieser wird nicht festgelegt, wenn nur OAuth mit IMPLICIT-Berechtigung als Verknüpfungstyp verwendet wird. Wird nur bei Verwendung von OAuth festgelegt.

string

Optional. Liste der Berechtigungen, denen der Nutzer zustimmen muss, um Ihren Dienst nutzen zu können. Wird nur bei Verwendung von OAuth festgelegt. Wenn Sie dieses Feld angeben, müssen Sie in den Verzeichnisinformationen im Abschnitt „LocalizedSettings.terms_of_service_url“ Nutzungsbedingungen angeben.

string

Optional. Dies ist die Webseite in Ihrem Dienst, auf der die Berechtigungen beschrieben werden, die der Nutzer Google gewährt. Wird nur bei Verwendung von OAuth und Google Log-in festgelegt. Wenn Sie dieses Feld angeben, müssen Sie in den Verzeichnisinformationen im Abschnitt „LocalizedSettings.terms_of_service_url“ Nutzungsbedingungen angeben.

boolean

Optional. Falls wahr, erlauben Sie Google, die Client-ID und den Clientschlüssel über den Header für die HTTP-Basisauthentifizierung zu übertragen. Andernfalls verwendet Google die Client-ID und den Secret im Text des Posts. Wird nur bei Verwendung von OAuth festgelegt. Wenn Sie dieses Feld angeben, müssen Sie in den Verzeichnisinformationen im Abschnitt „LocalizedSettings.terms_of_service_url“ Nutzungsbedingungen angeben.

object (Handler)

Liste der Handler für diesen Webhook.

object (HttpsEndpoint)

Benutzerdefinierter Webhook-HTTPS-Endpunkt.

object (InlineCloudFunction)

Metadaten für Cloud Functions-Funktionen, die aus Code im Ordner „Webhooks“ bereitgestellt werden.

string

Erforderlich. Name des Handlers. Muss für alle Handler im Actions-Projekt eindeutig sein. Sie können den Namen dieses Handlers überprüfen, um die richtige Funktion in Ihrem Quellcode für die Auftragsausführung aufzurufen.

string

Die HTTPS-Basis-URL für Ihren Auftragsausführungsendpunkt (HTTP wird nicht unterstützt). Handler-Namen werden gemäß dem Styleguide unter https://cloud.google.com/apis/design/custom_methods) nach einem Doppelpunkt an den Basis-URL-Pfad angehängt. Beispiel: Die Basis-URL „https://gactions.service.com/api“ würde Anfragen mit der URL „https://gactions.service.com/api:{method}“ empfangen.

map (key: string, value: string)

Zuordnung von HTTP-Parametern, die in die POST-Anfrage einbezogen werden sollen.

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

integer

Version des vom Endpunkt verwendeten Protokolls. Dies ist das Protokoll, das von allen Auftragsausführungstypen gemeinsam verwendet wird und nicht spezifisch für den Google-Auftragsausführungstyp.

string

Der Name des Cloud Functions-Einstiegspunkts. Der Wert in diesem Feld sollte mit dem Namen der Methode übereinstimmen, die aus dem Quellcode exportiert wurde.

object (IntentParameter)

Die Liste der Parameter in den Trainingsformulierungen. Hier müssen alle Parameter definiert werden, damit sie in der Trainingsformulierung verwendet werden können.

string

Trainingsformulierungen ermöglichen es der NLU von Google, Intents automatisch mit Nutzereingaben abzugleichen. Je mehr eindeutige Wortgruppen angegeben sind, desto höher ist die Wahrscheinlichkeit, dass dieser Intent zugeordnet wird. Im Folgenden finden Sie das Format der Trainingsformulierungen, die annotiert sind. Das Feld auto ist optional und das Standardverhalten, wenn auto nicht angegeben ist, entspricht auto=false. ($<paramName> '<sample text>' auto=<true or false>) auto = true bedeutet, dass der Teil automatisch von NLU annotiert wurde. auto = false bedeutet, dass der Teil vom Nutzer mit einer Anmerkung versehen wurde. Dies ist die Standardeinstellung, wenn „auto“ nicht festgelegt ist. Beispiel: "Buchen Sie einen Flug von ($source 'San Francisco' auto=false) nach ($dest 'Vancouver')"

string

Erforderlich. Eindeutiger Name des Intent-Parameters. Kann in Bedingungen und Antworten verwendet werden, um auf von NLU mit $intent.params.[name].resolved extrahierte Intent-Parameter zu verweisen.

object (ClassReference)

Optional. Deklariert den Datentyp dieses Parameters. Für integrierte Intents sollte dies nicht festgelegt werden.

object (EntitySetReferences)

Optional. Verweise auf die Gruppen zulässiger Entitäten für diesen Intent-Parameter. Nur gültig für die Parameter eines integrierten Intents. Diese Verweise verweisen auf Entitäts-Sets in „custom/entitySets“ -Verzeichnis.

string

Erforderlich. Name eines integrierten oder benutzerdefinierten Typs des Parameters. Beispiele: PizzaToppings, actions.type.Number

boolean

Optional. Gibt an, ob der Datentyp eine Liste von Werten darstellt.

object (EntitySetReference)

Erforderlich. Entitäts-Set-Referenzen für einen Intent-Parameter

string

Erforderlich. Gibt die spezifische Sammlung von Entitäten an, die für einen bestimmten Parameter zu berücksichtigen ist. Die entsprechende Entitäts-Set-Definition muss im Verzeichnis „custom/entitySets/“ vorhanden sein.

string

Gruppe außergewöhnlicher Wörter/Wortgruppen, die nicht mit dem Typ abgeglichen werden sollten Hinweis: Wenn ein Wort oder eine Wortgruppe mit dem Typ übereinstimmt, aber als Ausschluss aufgelistet wird, wird es nicht im Ergebnis der Parameterextraktion zurückgegeben. Dieses Feld kann lokalisiert werden.

object (SynonymType)

Synonymtyp, der im Wesentlichen eine Aufzählung ist.

object (RegularExpressionType)

Regex-Typ; ermöglicht den Abgleich regulärer Ausdrücke.

object (FreeTextType)

Freitexttyp.

enum (MatchType)

Optional. Die Keyword-Option für das Synonym.

boolean

Optional. Wenn die Richtlinie auf „true“ gesetzt ist, werden unbekannte Wörter oder Wortgruppen anhand der umgebenden Eingabe- und Intent-Trainingsdaten abgeglichen, z. B. Artikel, die einer Einkaufsliste hinzugefügt werden könnten.

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

Erforderlich. Benannte Karte mit Synonymentitäten.

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

object (EntityDisplay)

Optional. Die Entitätsdetails.

string

Optional. Die Liste der Synonyme für die Entität. Dieses Feld kann lokalisiert werden.

string

Optional. Titel des Symbols.

string

Erforderlich. URL des Symbols

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

Erforderlich. Benannte Zuordnung von Entitäten, die jeweils Regex-Strings enthalten.

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

object (EntityDisplay)

Optional. Elemente, die auf dem Canvas angezeigt werden, nachdem ein Element aus einer Abfrage extrahiert wurde. Nur für Canvas-fähige Apps relevant.

string

Erforderlich. Verwendet RE2-Regex-Syntax (weitere Informationen unter https://github.com/google/re2/wiki/Syntax)

object (EntityDisplay)

Optional. Elemente, die auf dem Canvas angezeigt werden, nachdem ein Element aus einer Abfrage extrahiert wurde. Nur für Canvas-fähige Apps relevant.

object (Entity)

Erforderlich. Die Liste der Entitäten, die von diesem Entitäts-Set unterstützt werden.

string

Erforderlich. Die ID der Entität. Eine Liste der integrierten Intent-Parameter und ihrer unterstützten Entitäten finden Sie unter https://developers.google.com/assistant/conversational/build/built-in-intents.

string

Optional. Zielszene, zu dem die Unterhaltung springen soll. Der Status der aktuellen Szene wird beim Übergang gelöscht.

object (EventHandler)

Optional. Event-Handler, der ausgelöst wird, wenn der Intent zugeordnet wird. Sollte vor dem Übergang zur Zielszene ausgeführt werden. Nützlich, um Aufforderungen als Reaktion auf Ereignisse zu generieren.

string

Name des aufzurufenden Webhook-Handlers.

object (StaticPrompt)

Statischer Inline-Prompt. Kann Verweise auf Stringressourcen in Bundles enthalten.

string

Name der statischen Aufforderung, die aufgerufen werden soll.

object (StaticPromptCandidate)

Die Liste der möglichen Prompts, die an den Client gesendet werden sollen. Jeder Prompt hat einen Selector, um festzulegen, wann er verwendet werden kann. Der erste Selector, der einer Anfrage entspricht, wird gesendet und der Rest ignoriert.

object (Selector)

Optional. Die Kriterien dafür, ob dieser Prompt mit einer Anfrage übereinstimmt. Wenn die Auswahl leer ist, wird diese Aufforderung immer ausgelöst.

object (StaticPromptResponse)

Die mit der Auswahl verknüpfte Prompt-Antwort.

object (SurfaceCapabilities)

Die erforderlichen Oberflächenfunktionen.

enum (Capability)

Erforderlich. Die Fähigkeiten der Oberfläche, die eine Anfrage an die Aktion sendet.

object (StaticSimplePrompt)

Optional. Die erste reine Sprach- und Textantwort.

object (StaticContentPrompt)

Optional. Ein Inhalt wie eine Karte, eine Liste oder ein Medium, das bzw. der dem Nutzer angezeigt werden soll.

object (StaticSimplePrompt)

Optional. Die letzte reine Sprach- und Textantwort.

object (Suggestion)

Optional. Vorschläge, die dem Nutzer angezeigt werden und immer am Ende der Antwort angezeigt werden. Wenn das Feld append im zugehörigen Prompt true lautet, werden die in diesem Feld definierten Titel den Titeln hinzugefügt, die in zuvor definierten Prompts für Vorschläge definiert wurden. Doppelte Werte werden entfernt.

object (StaticLinkPrompt)

Optional. Ein zusätzlicher Vorschlags-Chip, der auf die verknüpfte App oder Website verweisen kann. Der Chip wird mit dem Titel „Öffnen “ gerendert. Maximal 20 Zeichen.

boolean

Optional. Modus zum Zusammenführen dieser Nachrichten mit zuvor definierten Nachrichten. true löscht alle zuvor definierten Nachrichten (erste und letzte einfache Nachricht, Inhalt, Link für Vorschläge und Canvas) und fügt in diesem Prompt definierte Nachrichten hinzu. false fügt die in diesem Prompt definierten Nachrichten den in früheren Antworten definierten Nachrichten hinzu. Wenn du dieses Feld auf false setzt, wird auch das Anfügen an einige Felder in einfachen Prompts, der Aufforderung „Vorschläge“ und der Canvas-Aufforderung (Teil der Inhaltsaufforderung) aktiviert. Die Inhalts- und Linkmeldungen werden immer überschrieben, wenn sie im Prompt definiert werden. Der Standardwert ist false.

object (StaticCanvasPrompt)

Eine Antwort, die für das interaktive Canvas-Erlebnis verwendet werden soll.

object (Variant)

Liste der möglichen Varianten.

string

Optional. Stellt die Sprache dar, die dem Nutzer vorgelesen werden soll. Kann SSML oder Sprachausgabe sein. Standardmäßig wird die Sprachausgabe an die vorherige einfache Aufforderung angehängt. Wenn das Feld override im zugehörigen Prompt true lautet, überschreibt die in diesem Feld definierte Sprache die vorherige Sprache des einfachen Prompts.

string

Optional. Text, der im Chat-Infofeld angezeigt wird. Wenn nicht angegeben, wird eine Anzeigedarstellung des obigen Sprachfelds verwendet. Auf 640 Zeichen begrenzt. Standardmäßig wird der Text an den vorherigen einfachen Prompt-Text angehängt. Wenn das Feld override im enthaltenen Prompt true lautet, überschreibt der in diesem Feld definierte Text den vorherigen einfachen Prompt-Text.

object (StaticCardPrompt)

Eine einfache Karte.

object (StaticImagePrompt)

Ein Bild.

object (StaticTablePrompt)

Tabellenkarte.

object (StaticMediaPrompt)

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

object (StaticListPrompt)

Eine Karte, auf der eine Liste mit Optionen präsentiert wird.

object (StaticCollectionPrompt)

Eine Karte mit einer Liste von Optionen zur Auswahl.

object (StaticCollectionBrowsePrompt)

Eine Karte mit einer Sammlung von Webseiten, die geöffnet werden können.

string

Optional. Gesamttitel der Karte

string

Optional. Untertitel der Karte

string

Erforderlich. Text der Karte, der erforderlich ist, sofern kein Bild vorhanden ist Unterstützt einen begrenzten Satz von Markdown-Syntax für die Formatierung.

object (StaticImagePrompt)

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

enum (ImageFill)

Optional. Legt fest, wie der Bildhintergrund ausgefüllt wird.

object (StaticLinkPrompt)

Optional. Eine anklickbare Schaltfläche, die auf der Karte angezeigt wird.

string

Erforderlich. Die Quell-URL des Bildes. Bilder können das Format JPG, PNG und GIF haben (animiert und nicht animiert). Beispiel: https://www.agentx.com/logo.png.

string

Erforderlich. Eine Textbeschreibung des Bildes, das für Barrierefreiheit verwendet werden soll, z.B. Screenreadern.

integer

Optional. Die Höhe des Bilds in Pixeln

integer

Optional. Die Breite des Bilds in Pixeln

string

Name des Links

object (OpenUrl)

Definiert das Verhalten, wenn der Nutzer den Link öffnet.

string

Das URL-Feld, entweder http- oder https-URLs zum Öffnen einer mit Apps verknüpften App oder einer Webseite

enum (UrlHint)

Gibt einen Hinweis für den URL-Typ an.

string

Optional. Gesamttitel der Tabelle Muss festgelegt werden, wenn Untertitel festgelegt sind.

string

Optional. Untertitel für die Tabelle.

object (StaticImagePrompt)

Optional. Mit der Tabelle verknüpftes Bild.

object (TableColumn)

Optional. Überschriften und Ausrichtung von Spalten.

object (TableRow)

Optional. Zeilendaten der Tabelle. Die ersten 3 Zeilen werden garantiert angezeigt, aber die anderen werden möglicherweise an bestimmten Oberflächen abgeschnitten. Führen Sie einen Test mit dem Simulator durch, um zu sehen, welche Zeilen für eine bestimmte Oberfläche angezeigt werden. Auf Oberflächen, die die Funktion WEB_BROWSER unterstützen, kannst du den Nutzer auf eine Webseite mit weiteren Daten verweisen.

object (StaticLinkPrompt)

Optional. Schaltfläche.

string

Überschrift für die Spalte.

enum (HorizontalAlignment)

Horizontale Ausrichtung des Inhalts mit der Spalte. Wenn kein Wert angegeben ist, wird der Inhalt an der Spitze ausgerichtet.

object (TableCell)

Zellen in dieser Zeile. Die ersten 3 Zellen werden garantiert angezeigt, aber andere werden möglicherweise an bestimmten Oberflächen ausgeschnitten. Führen Sie einen Test mit dem Simulator durch, um zu sehen, welche Zellen für eine bestimmte Oberfläche angezeigt werden.

boolean

Gibt an, ob nach jeder Zeile eine Trennlinie vorhanden sein soll.

string

Textinhalt der Zelle.

enum (MediaType)

Medientyp dieser Antwort.

string (Duration format)

Startversatz des ersten Medienobjekts.

Dauer in Sekunden mit bis zu neun Nachkommastellen und einem 's' an letzter Stelle. Beispiel: "3.5s".

enum (OptionalMediaControls)

Optionale Mediensteuerungstypen, die diese Medienantwortsitzung unterstützen kann. Wenn festgelegt, wird die Anfrage an 3p gesendet, wenn ein bestimmtes Medienereignis eintritt. Wenn die Richtlinie nicht konfiguriert ist, muss 3p dennoch die beiden Standardsteuerungstypen FINISHED und FAILED verarbeiten.

object (MediaObject)

Liste der Medienobjekte.

enum (RepeatMode)

Wiederholungsmodus für die Liste der Medienobjekte.

string

Name dieses Medienobjekts.

string

Beschreibung dieses Medienobjekts.

string

Die URL, die auf den Medieninhalt verweist

object (MediaImage)

Bild, das mit der Medienkarte angezeigt werden soll.

object (StaticImagePrompt)

Ein großes Bild, z. B. das Cover des Albums

object (StaticImagePrompt)

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

string

Optional. Titel der Liste.

string

Optional. Untertitel der Liste.

object (ListItem)

Erforderlich. Listenelemente.

string

Erforderlich. Der NLU-Schlüssel, der mit dem Namen des Eingabeschlüssels im verknüpften Typ übereinstimmt. Wenn ein Element angetippt wird, wird diese Taste als Parameter für die Auswahloption zurückgegeben.

string

Erforderlich. Titel des Artikels. Wenn dieser Text angetippt wird, wird er wörtlich in der Unterhaltung gepostet, als ob der Nutzer ihn eingegeben hätte. Jeder Titel muss innerhalb der Gruppe von Elementen eindeutig sein.

string

Optional. Text des Elements.

object (StaticImagePrompt)

Optional. Bild des Artikels.

string

Optional. Titel der Sammlung.

string

Optional. Untertitel der Sammlung.

object (CollectionItem)

Erforderlich. Sammlungselemente.

enum (ImageFill)

Optional. Art der Bildanzeigeoption.

string

Erforderlich. Der NLU-Schlüssel, der mit dem Namen des Eingabeschlüssels im verknüpften Typ übereinstimmt. Wenn ein Element angetippt wird, wird diese Taste als Parameter für die Auswahloption zurückgegeben.

string

Erforderlich. Titel des Artikels. Wenn dieser Text angetippt wird, wird er wörtlich in der Unterhaltung gepostet, als ob der Nutzer ihn eingegeben hätte. Jeder Titel muss innerhalb der Gruppe von Elementen eindeutig sein.

string

Optional. Text des Elements.

object (StaticImagePrompt)

Optional. Bild des Artikels.

object (CollectionBrowseItem)

Elemente in der Sammlung „Stöbern“. Die Listengröße sollte im Bereich [2, 10] liegen.

enum (ImageFill)

Anzeigeoption für Bilder in der Sammlung.

string

Erforderlich. Titel des Sammlungselements.

string

Beschreibung des Sammlungselements.

string

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

object (StaticImagePrompt)

Bild für das Sammlungselement.

object (OpenUrl)

Erforderlich. URI, der geöffnet werden soll, wenn das Element ausgewählt ist.

string

Erforderlich. Der Text, der im Vorschlags-Chip angezeigt wird. Wenn dieser Text angetippt wird, wird er wörtlich in der Unterhaltung gepostet, als ob der Nutzer ihn eingegeben hätte. Jeder Titel muss unter den Vorschlags-Chips eindeutig sein. Maximal 25 Zeichen

string

Erforderlich. URL der zu ladenden Webansicht.

value (Value format)

Optional. JSON-Daten, die als Ereignis an die Webseite des immersiven Erlebnisses übergeben werden. Wenn das Feld override im enthaltenen Prompt false enthält, werden die in diesem Canvas-Prompt definierten Datenwerte nach den in vorherigen Canvas-Prompts definierten Datenwerten hinzugefügt.

boolean

Optional. Ein wahrer Wert bedeutet, dass das Mikrofon nicht für die Erfassung von Eingaben geöffnet wird, nachdem die immersive Antwort dem Nutzer präsentiert wurde.

boolean

Optional. Bei true sind unterhaltungsbezogene Metadaten enthalten und werden an die Canvas-Anwendung zurückgesendet.

boolean

Optional. Wenn true aktiviert ist, füllt die Canvas-Anwendung den gesamten Bildschirm aus und hat oben keine Kopfzeile. Außerdem wird auf dem Ladebildschirm eine Toast-Nachricht mit dem Anzeigenamen der Aktion, dem Namen des Entwicklers und einer Anleitung zum Beenden der Aktion angezeigt. Standardwert: false.

object (EventHandler)

Handler, der beim Übergang zu dieser Szene aufgerufen wird.

object (IntentEvent)

Die Liste der Ereignisse, die basierend auf Intents ausgelöst werden. Diese Ereignisse können jederzeit ausgelöst werden, nachdem der on_load-Handler aufgerufen wurde. Wichtig: Diese Ereignisse definieren die Gruppe von Intents, die sich auf diese Szene beziehen. Sie haben Vorrang vor global definierten Ereignissen mit denselben Intents oder ihren Trigger-Ausdrücken. Intent-Namen müssen innerhalb einer Szene eindeutig sein.

object (ConditionalEvent)

Die Liste der Ereignisse, die basierend auf bedingten Anweisungen ausgelöst werden sollen. Diese werden ausgewertet, nachdem das Formular ausgefüllt wurde, oder sofort nach on_load, falls diese Szene kein Formular enthält (die Bewertung erfolgt nur einmal). Nur das erste übereinstimmende Ereignis wird ausgelöst.

object (Slot)

Sortierte Liste von Slots. Jeder Slot definiert den Typ der aufzulösenden Daten und die Konfiguration, um die Darstellung dieser Auflösung anzupassen (z.B. Aufforderungen).

object (EventHandler)

Handler aufgerufen, wenn eine Statusänderung eines Slots auftritt, die nicht durch Updates in einem anderen Handler verursacht wird. Dadurch können Slots, die Szene ungültig gemacht oder andere Änderungen am Szenenstatus vorgenommen werden.

string

Erforderlich. Intent, der das Ereignis auslöst.

string

Optional. Zielszene, zu dem die Unterhaltung springen soll. Der Status der aktuellen Szene wird beim Übergang gelöscht.

object (EventHandler)

Optional. Event-Handler, der ausgelöst wird, wenn der Intent zugeordnet wird. Sollte vor dem Übergang zur Zielszene ausgeführt werden. Nützlich, um Prompts als Reaktion auf Ereignisse zu generieren.

string

Erforderlich. Filterbedingung für das Auslösen dieses Ereignisses. Wenn die Bedingung als „true“ ausgewertet wird, wird die zugehörige handler ausgelöst. Die folgenden Variablenverweise werden unterstützt: $session – um auf Daten im Sitzungsspeicher zu verweisen. $user – um auf Daten im Nutzerspeicher zu verweisen. Die folgenden booleschen Operatoren werden unterstützt (mit Beispielen): && – session.params.counter > 0 && session.params.counter < 100 || – session.params.foo == "John" || session.params.counter == "Adam" ! – !(session.params.counter == 5) Die folgenden Vergleiche werden unterstützt: ==, !=, <, >, <=, >= Die folgenden Listen- und Stringoperatoren werden unterstützt (mit Beispielen): in – "Wassermelone" in session.params.fruitList size–size(session.params.fruitList) > 2 substring–session.params.fullName.contains("John")

string

Optional. Zielszene, zu der die Unterhaltung springen soll, wenn die zugehörige Bedingung als „true“ ausgewertet wird. Der Status der aktuellen Szene wird beim Übergang gelöscht.

object (EventHandler)

Optional. Event-Handler, der ausgelöst wird, wenn die zugehörige Bedingung als true ausgewertet wird. Sollte vor dem Übergang zur Zielszene ausgeführt werden. Nützlich, um Aufforderungen als Reaktion auf Ereignisse zu generieren.

string

Erforderlich. Name des Slots.

object (ClassReference)

Erforderlich. Deklariert den Datentyp dieses Slots.

boolean

Optional. Gibt an, ob die Anzeigenfläche vor dem Fortfahren gefüllt werden muss. Nicht gefüllte Anzeigenflächen lösen eine anpassbare Aufforderung an den Nutzer aus.

object (PromptSettings)

Optional. Registriert Aufforderungen für verschiedene Phasen der Slot-Füllung.

object (CommitBehavior)

Optional. Commit-Verhalten in Verbindung mit der Anzeigenfläche.

value (Value format)

Optional. Zusätzliche Konfiguration für den Slot, der zum Füllen des Slots verwendet wird. Das Format der Konfiguration ist spezifisch für den Slottyp. Dieser Konfiguration können Ressourcenverweise auf Nutzer- oder Sitzungsparameter hinzugefügt werden. Diese Konfiguration wird benötigt, um Slots im Zusammenhang mit Transaktionen und Nutzer-Engagement zu füllen.

Beispiel: Für einen Slot vom Typ actions.type.CompletePurchaseValue schlägt die folgende Konfiguration eine digitale Ware mit einem Verweis auf einen clientseitig definierten Sitzungsparameter userSelectedSkuId vor:

{ "@type": "type.googleapis.com/ google.actions.transactions.v3.CompletePurchaseValueSpec", "skuId": { "skuType": "SKU_TYPE_IN_APP", "id": "$session.params.userSelectedSkuId", "packageName": "com.example.company" }

object (DefaultValue)

Optional. Konfiguration zum Ausfüllen eines Standardwerts für diese Anzeigenfläche.

object (EventHandler)

Fragt den Slotwert selbst ab. Beispiel: „Welche Größe wollten Sie?“

object (EventHandler)

Eine Aufforderung, die ausgegeben wird, wenn die Eingabe des Nutzers zum ersten Mal nicht dem erwarteten Werttyp für den Slot entspricht. Beispiel: „Tut mir leid, das habe ich nicht verstanden.“

object (EventHandler)

Eine Aufforderung, die ausgegeben wird, wenn die Eingabe des Nutzers zum zweiten Mal nicht mit dem erwarteten Werttyp für den Slot übereinstimmt. Beispiel: „Tut mir leid, das habe ich nicht verstanden.“

object (EventHandler)

Aufforderung, die ausgegeben wird, wenn die Eingabe des Nutzers zum letzten Mal nicht mit dem erwarteten Werttyp für den Slot übereinstimmt. Beispiel: „Tut mir leid, das habe ich nicht verstanden.“

object (EventHandler)

Aufforderung, die gegeben wird, wenn der Nutzer nicht zum ersten Mal eine Eingabe macht. Beispiel: „Tut mir leid, das habe ich nicht verstanden.“

object (EventHandler)

Aufforderung zu geben, wenn der Nutzer zum zweiten Mal keine Eingabe macht. Beispiel: „Tut mir leid, das habe ich nicht verstanden.“

object (EventHandler)

Aufforderung, die gegeben wird, wenn der Nutzer zum letzten Mal nichts eingegeben hat. Beispiel: „Tut mir leid, das habe ich nicht verstanden.“

string

Der Sitzungsparameter zum Schreiben des Slotwerts, nachdem er gefüllt wurde. Beachten Sie, dass verschachtelte Pfade derzeit nicht unterstützt werden. „€€“ wird verwendet, um den Slotwert in einen Sitzungsparameter mit dem Namen des Slots zu schreiben. Beispiel: writeSessionParam = "Obst" "$session.params.fruit" entspricht. writeSessionParam = "Ticket" entspricht "$session.params.ticket".

string

Optional. Der Sitzungsparameter, der zum Initialisieren des Slotwerts verwendet wird, wenn er einen nicht leeren Wert hat. Der Typ des Werts muss mit dem Typ der Anzeigenfläche übereinstimmen. Beachten Sie, dass verschachtelte Pfade derzeit nicht unterstützt werden. Beispiel: sessionParam = "fruit" entspricht $session.params.fruit. sessionParam = "ticket" entspricht $session.params.ticket.

value (Value format)

Optional. Konstanter Standardwert für die Anzeigenfläche. Wird nur verwendet, wenn ein Wert für diese Anzeigenfläche nicht über sessionParam ausgefüllt wurde. Der Typ für diesen Wert muss mit dem Typ der Anzeigenfläche übereinstimmen.

object (DataFile)

Mehrere Datendateien

string

Der relative Pfad der Datendatei vom Projektstamm in der SDK-Dateistruktur. Zulässige Dateipfade: – Bilder: resources/images/{multiple directories}?/{ImageName}.{extension} – Audio: resources/audio/{multiple directories}?/{AudioFileName}.{extension} – Cloud Functions-Inline-Code: webhooks/{WebhookName}.zip Zulässige Erweiterungen: – Bilder: png, jpg, jpeg – Audio: mp3, mpeg – Cloud Functions-Inline-Funktionen: zip

string

Erforderlich. Der Inhaltstyp dieses Assets. Beispiel: text/html. Der Inhaltstyp muss der Spezifikation (http://www.w3.org/Protocols/rfc1341/4_Content-Type.html) entsprechen. Cloud Functions-Funktionen müssen im ZIP-Format vorliegen und der Inhaltstyp muss application/zip;zip_type=cloud_function sein. Der Parameter „zip_type“ gibt an, dass die ZIP-Datei für eine Cloud Functions-Funktion bestimmt ist.

string (bytes format)

Inhalt der Datendatei. Beispiele hierfür sind Rohbyte von Bildern, Audiodateien oder das ZIP-Format mit Cloud Functions-Funktionen. Für die Nutzlastgröße gilt eine strikte Beschränkung von 10 MB.

Ein base64-codierter String.