ActionPackage enthält den Inhalt für den Entwurf einer App sowie für jede bereitgestellte Version. Dazu gehören Details zum Verzeichniseintrag, die Konfiguration der Unterhaltung und die Kontoverknüpfung.
JSON-Darstellung | |
---|---|
{ "manifest": { object ( |
Felder | |
---|---|
manifest |
Die Details der App. Hier werden der Verzeichniseintrag sowie andere App-Identifikatoren wie „displayName“ gespeichert. |
accountLinking |
Details zur Kontoverknüpfung in dieser App. |
actions[] |
Liste der Aktionen, die die App verarbeiten kann. |
types[] |
Liste der Typen, die vom Entwickler definiert wurden. |
conversations |
Unterhaltungen auf Karten, die mit Ein Objekt, das eine Liste von |
locale |
Die Sprache für dieses Aktionspaket. Dies wird durch BCP-47-Sprachstrings wie „en“, „en-US“, „fr“, „fr-CA“, „sr-Latn“, „zh-Hans“, „zh-Hans-CN“, „zh-Hant“, „zh-Hant-HK“ usw. dargestellt. Dies ist erforderlich, wenn eine App mehr als eine Sprache unterstützt. Jedes unterstützte Gebietsschema hat ein eigenes ActionPackage. Wenn kein Wert angegeben ist, wird die Standardsprache des Agents impliziert. |
Manifest
Der Metadatensatz für die Anwendung. Der Inhalt dieser Nachricht wird in mehreren Kontexten verwendet:
- Aktionen auf der Seite mit dem Eintrag im Google-Verzeichnis.
- Eindeutige Identifizierung einer App für einen expliziten Aufruf (
displayName
). - Inhalte für andere Teile von
ActionPackage
(shortDescription
wird für die Anzeige inAccountLinking
verwendet,displayName
wird inactions
verwendet, um Nutzern den App-Namen anzuzeigen).
Diese Nachricht ist schreibgeschützt. Die Felder in dieser Nachricht werden über die Aktionskonsole und nicht direkt im Aktionspaket angegeben.
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“. Er wird neben |
invocationName |
Dies ist der eindeutige Name für diese Anwendung, um sie direkt in einem Sprachkontext aufzurufen. Gemäß den Richtlinien muss der Aufrufname dem Feld |
enabledRegions[] |
Die AdWords-Kriteriums-IDs für die Regionen, in denen die App auf Grundlage des aktuellen Standorts des Nutzers zulässig ist. Weitere Informationen erhalten Sie unter https://developers.google.com/adwords/api/docs/appendix/geotargeting. |
disabledRegions[] |
Die AdWords-Kriteriums-IDs für die Regionen, in denen die App auf Grundlage des aktuellen Standorts des Nutzers blockiert wird. Weitere Informationen erhalten Sie unter https://developers.google.com/adwords/api/docs/appendix/geotargeting. |
shortDescription |
Die standardmäßige Kurzbeschreibung für die App (falls keine Übersetzung verfügbar ist). Er ist auf 80 Zeichen begrenzt. |
longDescription |
Die standardmäßige lange Beschreibung für die App (falls keine Übersetzung verfügbar ist). Er ist auf maximal 4.000 Zeichen beschränkt. |
category |
Die Kategorie für die App. Der Wert muss eine der zulässigen Kategorien für Apps sein. Eine Liste der zulässigen Kategorien finden Sie in der Google Console unter „Aktionen“. |
smallSquareLogoUrl |
Kleines quadratisches Bild. Die Größe muss 192 x 192 Pixel betragen. |
largeLandscapeLogoUrl |
Großes 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, über die Nutzer sich bezüglich der App kontaktieren 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 eine Aufrufwortgruppe, die als Teil der App-Beschreibung im Verzeichnis aller Apps angezeigt wird. Es können maximal 5 Werte angegeben werden. |
introduction |
Zusammenfassung der Funktionen einer App. Wird verwendet, um Nutzern die App vorzustellen. Dies sollte eine Verbformulierung sein, die einen Satz wie „Mit dieser App kannst du...“ vervollständigt. |
testingInstructions |
Testanleitungen im freien Format für den App-Prüfer. |
voiceName |
Der zu verwendende Voice-Name. Unterstützte Beispielwerte: |
externalVoiceName |
Der Name der externen Stimme für diesen Agent. Enthält keine Sprachinformationen. |
voiceLocale |
Die Sprache der Stimme für diesen Agent. Wird ein leerer String angegeben, wird er zur Laufzeit in die Sprache des Nutzers umgewandelt. |
surfaceRequirements |
Eine Reihe von Anforderungen für die Google Assistant-Clientoberfläche, die erfüllt sein muss, damit die App ausgelöst wird. |
SurfaceRequirements
Enthält eine Reihe von Anforderungen an die Clientoberfläche, die erfüllt sein müssen, damit der Agent ausgelöst wird. Wenn eine der hier aufgeführten Anforderungen nicht erfüllt ist, wird der Agent nicht ausgelöst.
JSON-Darstellung | |
---|---|
{
"minimumCapabilities": [
{
object ( |
Felder | |
---|---|
minimumCapabilities[] |
Die Mindestfunktionen, die für das Funktionieren des Agents erforderlich sind. Wenn auf der Oberfläche eine dieser Angaben fehlt, wird der Agent nicht ausgelöst. |
Funktion
Stellt eine Anforderung zur 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. Dabei kann es sich um benutzerdefinierte Typen handeln, die nur für die Aktion gelten, oder um gängige 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 |
Ob die Entitäten benutzerdefiniert sind (je nach Nutzer unterschiedlich). |
Entität
Jede Entity Entsprechung ist für diesen Typ eindeutig. Der Schlüssel muss eindeutig sein und die Liste der Synonyme wird zum Auslösen verwendet.
JSON-Darstellung | |
---|---|
{ "key": string, "synonyms": [ string ] } |
Felder | |
---|---|
key |
Eindeutiger Schlüssel für dieses Element. |
synonyms[] |
Liste mit Synonymen, mit denen auf dieses Element verwiesen werden kann. |