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

ActionPackage

ActionPackage enthält den Inhalt des App-Entwurfs sowie die einzelnen bereitgestellten Versionen. Dazu gehören Angaben zum Verzeichnis, zur Konfiguration der Unterhaltung und zur Kontoverknüpfung.

JSON-Darstellung
{
  "manifest": {
    object (Manifest)
  },
  "accountLinking": {
    object (AccountLinking)
  },
  "actions": [
    {
      object (Action)
    }
  ],
  "types": [
    {
      object (Type)
    }
  ],
  "conversations": {
    string: {
      object(ConversationFulfillment)
    },
    ...
  },
  "locale": string
}
Felder
manifest

object (Manifest)

Die Details der App. Hier werden der Verzeichniseintrag und andere App-IDs wie displayName gespeichert.

accountLinking

object (AccountLinking)

Details zur Kontoverknüpfung in dieser App

actions[]

object (Action)

Liste der Aktionen, die die App verarbeiten kann.

types[]

object (Type)

Liste der vom Entwickler definierten Typen.

conversations

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

Ordnen Sie Unterhaltungen zu, die in actions geteilt werden können. Beispiel: conversationName in Fulfillment.

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

locale

string

Die Sprache für dieses Aktionspaket. Das wird durch BCP-47-Sprachstrings dargestellt, wie „en“, „en-US“, „fr“, „fr-CA“, „sr-Latn“, „zh-Hans“, „zh-Hans-CN“, „zh-Hant“ und „zh-Hant-HK“. Das ist erforderlich, wenn eine App mehr als eine Sprache unterstützt. Jede unterstützte Sprache hat ein eigenes ActionPackage. Wenn kein Wert angegeben ist, wird die Standardsprache des Agents impliziert.

Manifest

Der Metadatensatz für die App. Der Inhalt dieser Nachricht wird in mehreren Kontexten verwendet:

  1. Aktionen auf der Seite mit dem Google-Verzeichniseintrag.
  2. Eindeutige Kennung einer App für einen expliziten Aufruf (displayName).
  3. Inhalte für andere Elemente einer ActionPackage (shortDescription wird für die Anzeige in AccountLinking verwendet, displayName wird in actions verwendet, um Nutzern den App-Namen anzuzeigen).

Diese Nachricht ist schreibgeschützt. Sie geben die Felder in dieser Nachricht über die Aktionskonsole an und nicht direkt im Aktionspaket.

JSON-Darstellung
{
  "displayName": string,
  "invocationName": string,
  "enabledRegions": [
    string
  ],
  "disabledRegions": [
    string
  ],
  "shortDescription": string,
  "longDescription": string,
  "category": string,
  "smallSquareLogoUrl": string,
  "largeLandscapeLogoUrl": string,
  "companyName": string,
  "contactEmail": string,
  "termsOfServiceUrl": string,
  "privacyUrl": string,
  "sampleInvocation": [
    string
  ],
  "introduction": string,
  "testingInstructions": string,
  "voiceName": string,
  "externalVoiceName": string,
  "voiceLocale": string,
  "surfaceRequirements": {
    object (SurfaceRequirements)
  }
}
Felder
displayName

string

Der standardmäßige Anzeigename für diese App, falls keine Übersetzung verfügbar ist, z.B. "Starbucks". Der Name wird auch als Methode zum Aufrufen der App verwendet (zusätzlich zu invocationName). Der angezeigte Name muss eindeutig und phonetisch ähnlich wie invocationName sein.

invocationName

string

Dies ist der eindeutige Name für diese App, mit der sie direkt in einem Sprachkontext aufgerufen wird. Gemäß den Richtlinien muss der Aufrufname phonetisch dem Feld displayName ähneln.

enabledRegions[]

string (int64 format)

AdWords-Kriterien-IDs für die Regionen, in denen die App auf Grundlage des Nutzerstandorts zulässig ist. Weitere Informationen

disabledRegions[]

string (int64 format)

AdWords-Kriterien-IDs für die Regionen, in denen die App blockiert wird, je nach Standort des Nutzers Weitere Informationen

shortDescription

string

Dies ist die standardmäßige Kurzbeschreibung für die App, falls keine Übersetzung verfügbar ist. Er ist auf 80 Zeichen beschränkt.

longDescription

string

Die standardmäßige lange Beschreibung der App, falls keine Übersetzung verfügbar ist. Er ist auf 4.000 Zeichen begrenzt.

category

string

Die Kategorie für die App. Der Wert muss eine der zulässigen Kategorien für Apps sein. In der Google Console finden Sie eine Liste der zulässigen Kategorien.

smallSquareLogoUrl

string

Kleines quadratisches Bild. Die Abmessungen müssen 192 x 192 Pixel betragen.

largeLandscapeLogoUrl

string

Bild im Querformat. Die Größe muss 2.208 x 1.242 Pixel betragen.

companyName

string

Der Name des Unternehmens, mit dem die App verknüpft ist.

contactEmail

string

Die Kontakt-E-Mail-Adresse, unter der sich Nutzer bezüglich der App melden können.

termsOfServiceUrl

string

Die URL zu den Nutzungsbedingungen für die App.

privacyUrl

string

Die URL für die Datenschutzerklärung der App.

sampleInvocation[]

string

Beispiel für Aufrufaufruf, der als Teil der App-Beschreibung im Verzeichnis aller Apps angezeigt wird Es können maximal fünf Werte angegeben werden.

introduction

string

Zusammenfassung der Funktionen einer App. Diese werden bei der App-Einführung für Nutzer verwendet. Dies sollte ein Verb sein, der einen Satz wie „Sie können diese App verwenden, um...“ zu vervollständigen

testingInstructions

string

Anleitung zum Testen im freien Format für den App-Prüfer.

voiceName

string

Der Name, der verwendet werden soll. Unterstützte Beispielwerte: male_1, male_2, female_1, female_2.

externalVoiceName

string

Der externe Voice-Name für diesen Agent. Enthält keine Informationen zur Sprache.

voiceLocale

string

Die Sprache der Stimme für diesen Agent. Wenn ein leerer String festgelegt ist, wird er zur Laufzeit in die Sprache des Nutzers aufgelöst.

surfaceRequirements

object (SurfaceRequirements)

Eine Reihe von Anforderungen für die Google Assistant-Clientoberfläche, die erfüllt sein müssen, damit die App ausgelöst werden kann.

Anforderungen an die Oberfläche

Enthält eine Reihe von Anforderungen für die Clientoberfläche, die erfüllt sein müssen, damit der Agent ausgelöst werden kann. Wird eine der hier aufgeführten Anforderungen nicht erfüllt, wird der Agent nicht ausgelöst.

JSON-Darstellung
{
  "minimumCapabilities": [
    {
      object (Capability)
    }
  ]
}
Felder
minimumCapabilities[]

object (Capability)

Die minimale Anzahl von Funktionen, die für die Funktionsweise des Agents erforderlich sind. Fehlt die Oberfläche, wird der Agent nicht ausgelöst.

Rechte

Stellt eine Anforderung bezüglich der Verfügbarkeit einer bestimmten Funktion dar

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

string

Der Name der Funktion, z.B. actions.capability.AUDIO_OUTPUT

Typ

Ein Typ, auf den in einer Aktion verwiesen werden kann. Das können benutzerdefinierte Typen sein, die nur für die Aktion gelten, oder allgemeine Typen, die von Google definiert und in der Aktion referenziert werden.

JSON-Darstellung
{
  "name": string,
  "entities": [
    {
      object (Entity)
    }
  ],
  "isUserDefined": boolean
}
Felder
name

string

Name des benutzerdefinierten Typs im Format type.

entities[]
(deprecated)

object (Entity)

Liste der Entitäten für diesen Typ. Jede enthält einen Schlüssel und eine Liste mit Synonymen.

isUserDefined

boolean

Gibt an, ob die Entitäten von Nutzern definiert sind (für jeden Nutzer anders).

Entität

Jede Entität entspricht für diesen Typ eindeutig. Der Schlüssel muss eindeutig sein und die Liste der Synonyme wird für den Trigger verwendet.

JSON-Darstellung
{
  "key": string,
  "synonyms": [
    string
  ]
}
Felder
key

string

Eindeutiger Schlüssel für dieses Element.

synonyms[]

string

Liste von Synonymen, mit denen auf dieses Element verwiesen werden kann.