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 ( |
Felder | |
---|---|
manifest |
Die Details der App. Hier werden der Verzeichniseintrag und andere App-IDs wie displayName gespeichert. |
accountLinking |
Details zur Kontoverknüpfung in dieser App |
actions[] |
Liste der Aktionen, die die App verarbeiten kann. |
types[] |
Liste der vom Entwickler definierten Typen. |
conversations |
Ordnen Sie Unterhaltungen zu, die in Ein Objekt, das eine Liste von |
locale |
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:
- Aktionen auf der Seite mit dem Google-Verzeichniseintrag.
- Eindeutige Kennung einer App für einen expliziten Aufruf (
displayName
). - Inhalte für andere Elemente einer
ActionPackage
(shortDescription
wird für die Anzeige inAccountLinking
verwendet,displayName
wird inactions
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 ( |
Felder | |
---|---|
displayName |
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 |
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 |
enabledRegions[] |
AdWords-Kriterien-IDs für die Regionen, in denen die App auf Grundlage des Nutzerstandorts zulässig ist. Weitere Informationen |
disabledRegions[] |
AdWords-Kriterien-IDs für die Regionen, in denen die App blockiert wird, je nach Standort des Nutzers Weitere Informationen |
shortDescription |
Dies ist die standardmäßige Kurzbeschreibung für die App, falls keine Übersetzung verfügbar ist. Er ist auf 80 Zeichen beschränkt. |
longDescription |
Die standardmäßige lange Beschreibung der App, falls keine Übersetzung verfügbar ist. Er ist auf 4.000 Zeichen begrenzt. |
category |
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 |
Kleines quadratisches Bild. Die Abmessungen müssen 192 x 192 Pixel betragen. |
largeLandscapeLogoUrl |
Bild im Querformat. Die Größe muss 2.208 x 1.242 Pixel betragen. |
companyName |
Der Name des Unternehmens, mit dem die App verknüpft ist. |
contactEmail |
Die Kontakt-E-Mail-Adresse, unter der sich Nutzer bezüglich der App melden können. |
termsOfServiceUrl |
Die URL zu den Nutzungsbedingungen für die App. |
privacyUrl |
Die URL für die Datenschutzerklärung der App. |
sampleInvocation[] |
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 |
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 |
Anleitung zum Testen im freien Format für den App-Prüfer. |
voiceName |
Der Name, der verwendet werden soll. Unterstützte Beispielwerte: |
externalVoiceName |
Der externe Voice-Name für diesen Agent. Enthält keine Informationen zur Sprache. |
voiceLocale |
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 |
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 ( |
Felder | |
---|---|
minimumCapabilities[] |
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 |
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 ( |
Felder | |
---|---|
name |
Name des benutzerdefinierten Typs im Format |
entities[] |
Liste der Entitäten für diesen Typ. Jede enthält einen Schlüssel und eine Liste mit Synonymen. |
isUserDefined |
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 |
Eindeutiger Schlüssel für dieses Element. |
synonyms[] |
Liste von Synonymen, mit denen auf dieses Element verwiesen werden kann. |