ActionPackage содержит содержимое черновика приложения, а также каждой развернутой версии. Сюда входят сведения о списке каталогов, конфигурация беседы и привязка учетной записи.
JSON-представление | |
---|---|
{ "manifest": { object ( |
Поля | |
---|---|
manifest | Подробности о приложении. Здесь хранится список каталогов, а также другие идентификаторы приложения, такие как displayName. |
accountLinking | Подробная информация о привязке учетной записи в этом приложении. |
actions[] | Список действий, которые может выполнить приложение. |
types[] | Список типов, определенных разработчиком. |
conversations | Составьте карту разговоров, которые можно разделить на Объект, содержащий список пар |
locale | Языковой стандарт для этого пакета действий. Это представлено языковыми строками BCP-47, такими как «en», «en-US», «fr», «fr-CA», «sr-Latn», «zh-Hans», «zh-Hans-CN». «, «zh-Hant», «zh-Hant-HK» и т. д. Это необходимо, если приложение поддерживает более одного языка. Каждая поддерживаемая локаль имеет свой собственный ActionPackage. Если значение не указано, то будет подразумеваться локаль агента по умолчанию. |
Манифест
Набор метаданных для приложения. Содержимое этого сообщения используется в нескольких контекстах:
- действия на странице со списком каталогов Google.
- Уникальный идентификатор приложения для явного вызова (
displayName
). - Содержимое для других частей
ActionPackage
(shortDescription
используется для отображения вAccountLinking
,displayName
используется вactions
для отображения имени приложения пользователям).
Это сообщение доступно только для чтения. Поля в этом сообщении вы указываете через консоль действий, а не непосредственно в пакете действий.
JSON-представление | |
---|---|
{
"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 ( |
Поля | |
---|---|
displayName | Отображаемое имя по умолчанию для этого приложения (если перевод недоступен), например «Starbucks». Это также используется пользователями как метод для вызова этого приложения (в дополнение к |
invocationName | Это уникальное имя для этого приложения, позволяющее напрямую вызывать его в голосовом (речевом) контексте. Политики требуют, чтобы имя вызова фонетически было очень похоже на поле |
enabledRegions[] | Идентификаторы критериев AdWords для регионов, в которых разрешено использование приложения, в зависимости от местоположения пользователя. См. https://developers.google.com/adwords/api/docs/appendix/geotargeting . |
disabledRegions[] | Идентификаторы критериев AdWords для регионов, в которых приложение блокируется, в зависимости от местоположения пользователя. См. https://developers.google.com/adwords/api/docs/appendix/geotargeting . |
shortDescription | Краткое описание приложения по умолчанию (если перевод недоступен). Это ограничено 80 символами. |
longDescription | Полное описание приложения по умолчанию (если перевод недоступен). Оно ограничено 4000 символами. |
category | Категория приложения. Значение должно быть одной из разрешенных категорий для приложений. Список разрешенных категорий см. в действиях в консоли Google. |
smallSquareLogoUrl | Небольшое квадратное изображение. Размеры должны быть 192 х 192 пикселя. |
largeLandscapeLogoUrl | Большое пейзажное изображение. Размеры должны быть 2208х1242 пикселей. |
companyName | Название компании, с которой связано приложение. |
contactEmail | Контактный адрес электронной почты, по которому пользователи смогут связаться по поводу Приложения. |
termsOfServiceUrl | URL-адрес ToS (Условий обслуживания) для приложения. |
privacyUrl | URL-адрес политики конфиденциальности приложения. |
sampleInvocation[] | Пример фразы вызова, отображаемой как часть описания приложения в каталоге всех приложений. Можно указать только 5 значений. |
introduction | Краткое описание возможностей приложения. Используется для ознакомления пользователей с приложением. Это должна быть глагольная группа, завершающая предложение типа «Вы можете использовать это приложение, чтобы…». |
testingInstructions | Инструкции по тестированию в свободной форме для рецензента приложения. |
voiceName | Голосовое имя, которое будет использоваться. Поддерживаемые примеры значений: |
externalVoiceName | Внешнее голосовое имя этого агента. Не содержит информации о локали. |
voiceLocale | Язык голоса этого агента. Если задана пустая строка, она будет преобразована в локаль пользователя во время выполнения. |
surfaceRequirements | Набор требований к клиентской поверхности Google Assistant, которые должны быть выполнены для запуска приложения. |
Требования к поверхности
Содержит набор требований к клиентской поверхности, которые должны быть выполнены для запуска агента. Если какое-либо из перечисленных здесь требований не выполнено, агент не запустится.
JSON-представление | |
---|---|
{
"minimumCapabilities": [
{
object ( |
Поля | |
---|---|
minimumCapabilities[] | Минимальный набор возможностей, необходимый для функционирования агента. Если на поверхности отсутствует какой-либо из них, агент не сработает. |
Возможность
Представляет требование о доступности данной возможности.
JSON-представление | |
---|---|
{ "name": string } |
Поля | |
---|---|
name | Имя возможности, например action.capability.AUDIO_OUTPUT. |
Тип
Тип, на который можно ссылаться в действии. Это могут быть пользовательские типы, уникальные для действия, или общие типы, определенные Google и на которые ссылается действие.
JSON-представление | |
---|---|
{
"name": string,
"entities": [
{
object ( |
Поля | |
---|---|
name | имя пользовательского типа в формате |
entities[] | Список сущностей для этого типа. Каждый включает ключ и список синонимов. |
isUserDefined | Определяются ли сущности пользователем (различно для каждого пользователя). |
Сущность
Каждая соответствующая сущность уникальна для этого типа. Ключ должен быть уникальным, а для запуска используется список синонимов.
JSON-представление | |
---|---|
{ "key": string, "synonyms": [ string ] } |
Поля | |
---|---|
key | Уникальный ключ для этого предмета. |
synonyms[] | Список синонимов, которые можно использовать для обозначения этого элемента. |