ActionPackage zawiera treść wersji roboczej aplikacji oraz każdej wdrożonej wersji. Obejmuje to szczegóły na stronie katalogu, konfigurację rozmowy i łączenie kont.
Zapis JSON | |
---|---|
{ "manifest": { object ( |
Pola | |
---|---|
manifest |
Szczegóły aplikacji. W tym miejscu przechowywane są informacje o katalogu i inne dane identyfikacyjne aplikacji, takie jak displayName. |
accountLinking |
Szczegóły łączenia kont w tej aplikacji. |
actions[] |
Lista działań, które może obsłużyć aplikacja. |
types[] |
Lista typów zdefiniowanych przez dewelopera. |
conversations |
Zmapuj rozmowy, które mogą być udostępniane w usłudze Obiekt zawierający listę par |
locale |
Język tego pakietu działań. Są one reprezentowane przez ciągi językowe BCP-47, takie jak „en”, „en-US”, „fr”, „fr-CA”, „sr-Latn”, „zh-Hans”, „zh-Hans-CN”, „zh-Hant”, „zh-Hant-HK” itp. Jest to wymagane, gdy aplikacja obsługuje więcej niż 1 język. Każde obsługiwane ustawienie regionalne ma własny pakiet ActionPackage. Jeśli nie podasz wartości, domyślnie będzie używany domyślny język agenta. |
Plik manifestu
Zbiór metadanych aplikacji. Treść tej wiadomości jest używana w wielu kontekstach:
- działań na stronie z informacjami o katalogu Google.
- Unikalny identyfikator aplikacji na potrzeby jawnego wywoływania (
displayName
). - Treści z innych części aplikacji
ActionPackage
(nazwashortDescription
jest używana do wyświetlania w języku:AccountLinking
, a nazwadisplayName
jest używana w językuactions
, aby nazwa aplikacji była wyświetlana użytkownikom).
Ta wiadomość jest tylko do odczytu. Pola w tej wiadomości określa się w konsoli działań, a nie bezpośrednio w pakiecie działań.
Zapis 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 ( |
Pola | |
---|---|
displayName |
Domyślna wyświetlana nazwa tej aplikacji (jeśli tłumaczenie nie jest dostępne), np. „Starbucks”. Jest to również metoda umożliwiająca użytkownikom wywoływanie tej aplikacji (oprócz |
invocationName |
Jest to unikalna nazwa aplikacji umożliwiająca wywołanie jej bezpośrednio w kontekście głosowym. Zasady wymagają, aby nazwa wywołania była fonetycznie bardzo podobna do pola |
enabledRegions[] |
Identyfikatory kryteriów AdWords dla regionów, w których aplikacja jest dozwolona na podstawie lokalizacji użytkownika. Więcej informacji znajdziesz na stronie https://developers.google.com/adwords/api/docs/appendix/geotargeting. |
disabledRegions[] |
Identyfikatory kryteriów AdWords dla regionów, w których aplikacja jest blokowana na podstawie lokalizacji użytkownika. Więcej informacji znajdziesz na stronie https://developers.google.com/adwords/api/docs/appendix/geotargeting. |
shortDescription |
Domyślny krótki opis aplikacji (jeśli tłumaczenie nie jest dostępne). Limit wynosi 80 znaków. |
longDescription |
Domyślny długi opis aplikacji (jeśli tłumaczenie nie jest dostępne). Limit wynosi 4000 znaków. |
category |
Kategoria aplikacji. Wartość musi należeć do jednej z kategorii dozwolonych w przypadku aplikacji. Listę dozwolonych kategorii znajdziesz w działaniach w konsoli Google. |
smallSquareLogoUrl |
Mały kwadratowy obraz. Wymagany rozmiar to 192 x 192 piksele. |
largeLandscapeLogoUrl |
Duży obraz poziomy. Rozmiar musi wynosić 2208 x 1242 piksele. |
companyName |
Nazwa firmy, z którą jest powiązana aplikacja. |
contactEmail |
Kontaktowy adres e-mail, pod którym użytkownicy mogą się kontaktować w sprawie aplikacji. |
termsOfServiceUrl |
Adres URL Warunków korzystania z usługi dotyczących aplikacji. |
privacyUrl |
Adres URL polityki prywatności aplikacji. |
sampleInvocation[] |
Przykładowe wyrażenie wywołania wyświetlane w opisie aplikacji w katalogu wszystkich aplikacji. Można podać tylko 5 wartości. |
introduction |
Podsumowanie możliwości aplikacji. Służy do przedstawienia użytkownikom aplikacji. Powinien to być czasownik kończący zdanie, np. „Możesz użyć tej aplikacji, aby...”. |
testingInstructions |
Swobodne instrukcje testowania dla weryfikatora aplikacji. |
voiceName |
Nazwa głosu, która ma być używana. Obsługiwane przykładowe wartości: |
externalVoiceName |
Zewnętrzna nazwa głosu tego agenta. Nie zawiera informacji o lokalizacji. |
voiceLocale |
Język głosu tego agenta. Jeśli jest pusty, w czasie działania wybierany jest język używany przez użytkownika. |
surfaceRequirements |
Zestaw wymagań dotyczących platformy klienckiej Asystenta Google, które muszą zostać spełnione, aby aplikacja została aktywowana. |
SurfaceRequirements
Zawiera zestaw wymagań dotyczących platformy klienta, które muszą zostać spełnione, aby agent został aktywowany. Jeśli którykolwiek z wymienionych tu wymagań nie zostanie spełniony, agent nie zostanie aktywowany.
Zapis JSON | |
---|---|
{
"minimumCapabilities": [
{
object ( |
Pola | |
---|---|
minimumCapabilities[] |
Minimalny zestaw możliwości wymaganych do działania agenta. Jeśli w powierzchni nie będzie żadnego z tych elementów, agent nie zostanie aktywowany. |
Funkcja
Reprezentuje wymóg dotyczący dostępności danej możliwości
Zapis JSON | |
---|---|
{ "name": string } |
Pola | |
---|---|
name |
Nazwa funkcji, np. actions.capability.AUDIO_OUTPUT |
Typ
Typ, do którego można się odwołać w akcji. Mogą to być typy niestandardowe związane z działaniem lub typowe typy zdefiniowane przez Google i odwoływane w ramach działania.
Zapis JSON | |
---|---|
{
"name": string,
"entities": [
{
object ( |
Pola | |
---|---|
name |
nazwa typu niestandardowego w formacie |
entities[] |
Lista elementów tego typu. Każdy zawiera klucz i listę synonimów. |
isUserDefined |
Czy jednostki są zdefiniowane przez użytkownika (inne dla każdego użytkownika). |
Element
Każdy element odpowiadający elementowi jest unikalny dla tego typu. Klucz powinien być niepowtarzalny, a lista synonimów będzie używana do wywołania.
Zapis JSON | |
---|---|
{ "key": string, "synonyms": [ string ] } |
Pola | |
---|---|
key |
Unikalny klucz dla tego elementu. |
synonyms[] |
Lista synonimów, których można użyć w odniesieniu do tego elementu. |