ActionPackage

Pakiet ActionPackage zawiera treść wersji roboczej aplikacji oraz każdej wdrożonej wersji. Obejmuje to szczegóły w katalogu, konfigurację rozmów oraz łączenie kont.

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

object (Manifest)

Szczegóły aplikacji. Zawiera ona informacje o katalogu oraz inne dane identyfikacyjne aplikacji, takie jak displayName.
accountLinking

object (AccountLinking)

Szczegóły łączenia kont w tej aplikacji.
actions[]

object (Action)

Lista działań, które aplikacja może obsługiwać.
types[]

object (Type)

Lista typów zdefiniowanych przez dewelopera.
conversations

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

Rozmowy na mapie, które można udostępniać w usłudze actions. Zobacz na przykład conversationName w języku: Fulfillment.

Obiekt zawierający listę par "key": value. Przykład: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
locale

string

Język tego pakietu działań. Jest ona reprezentowana przez ciągi tekstowe BCP-47, takie jak „en”, „en-US”, „fr”, „fr-CA”, „sr-Latn”, „zh-Hans”, „zh-Hans-CN”, „zh-Hant”, „zh-Hant-HK”. Jest to wymagane, gdy aplikacja obsługuje więcej niż 1 język. Każdy obsługiwany język ma własny pakiet ActionPackage. Jeśli nie zostanie podana wartość, domyślnie będzie podane domyślne ustawienie regionalne agenta.

Plik manifestu

Zbiór metadanych aplikacji. Treść tej wiadomości jest używana w wielu kontekstach:

  1. na stronie z informacjami w katalogu Google.
  2. Unikalny identyfikator aplikacji na potrzeby jawnego wywołania (displayName).
  3. Zawartość innych części aplikacji ActionPackage (shortDescription jest używana do wyświetlania w AccountLinking, a displayName jest używana w actions, by wyświetlać nazwę aplikacji użytkownikom).

Ta wiadomość jest tylko do odczytu. Pola w tej wiadomości musisz określić 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 (SurfaceRequirements)
  }
}
Pola
displayName

string

Domyślna wyświetlana nazwa tej aplikacji (jeśli tłumaczenie jest niedostępne), np. „Starbucks”. Jest ona również używana jako metoda wywoływania tej aplikacji przez użytkowników (oprócz invocationName). Wyświetlana nazwa musi być niepowtarzalna i fonetycznie bardzo podobna do invocationName.
invocationName

string

Jest to unikalna nazwa tej aplikacji, która powoduje jej bezpośrednie wywołanie w kontekście głosowym (wypowiadanym). Zgodnie z zasadami nazwa wywołania musi być fonetycznie bardzo podobna do nazwy pola displayName.
enabledRegions[]

string (int64 format)

Identyfikatory kryteriów Google Ads w regionach, w których aplikacja jest dozwolona, określone na podstawie lokalizacji użytkownika. Więcej informacji znajdziesz na stronie https://developers.google.com/adwords/api/docs/appendix/geotargeting.
disabledRegions[]

string (int64 format)

Identyfikatory kryteriów Google Ads dla regionów, w których aplikacja jest blokowana, określane na podstawie lokalizacji użytkownika. Więcej informacji znajdziesz na stronie https://developers.google.com/adwords/api/docs/appendix/geotargeting.
shortDescription

string

Domyślny krótki opis aplikacji (jeśli tłumaczenie jest niedostępne). Może mieć maksymalnie 80 znaków.
longDescription

string

Domyślny długi opis aplikacji (jeśli tłumaczenie jest niedostępne). Może mieć maksymalnie 4000 znaków.
category

string

Kategoria aplikacji. Wartość musi być jedną z kategorii dozwolonych w przypadku aplikacji. Listę dozwolonych kategorii znajdziesz w działaniach w konsoli Google.
smallSquareLogoUrl

string

Mały kwadratowy obraz. Wymiary muszą wynosić 192 x 192 piksele.
largeLandscapeLogoUrl

string

Duży obraz poziomy. Wymiary muszą wynosić 2208 x 1242 piksele.
companyName

string

Nazwa firmy, z którą jest powiązana aplikacja.
contactEmail

string

Kontaktowy adres e-mail, pod którym użytkownicy mogą się z Tobą kontaktować w sprawie aplikacji.
termsOfServiceUrl

string

Adres URL Warunków korzystania z aplikacji.
privacyUrl

string

Adres URL polityki prywatności aplikacji.
sampleInvocation[]

string

Przykładowe wyrażenie wywołania wyświetlane jako część opisu aplikacji w katalogu wszystkich aplikacji. Możesz podać tylko 5 wartości.
introduction

string

Podsumowanie funkcji aplikacji. Służy do przedstawiania użytkownikom aplikacji. Powinien to być czasownik kończący zdanie, np. „Możesz używać tej aplikacji, aby...”
testingInstructions

string

Instrukcje testowania swobodnego dla weryfikatora aplikacji.
voiceName

string

Nazwa głosu, którego chcesz użyć. Przykładowe obsługiwane wartości: male_1, male_2, female_1, female_2.
externalVoiceName

string

Zewnętrzna nazwa głosu tego agenta. Nie zawiera informacji o języku.
voiceLocale

string

Język głosu tego agenta. Jeśli jest ustawiony na pusty ciąg znaków, język jest rozpoznawany w czasie działania.
surfaceRequirements

object (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órekolwiek z podanych tu wymagań nie zostaną spełnione, agent nie zostanie aktywowany.

Zapis JSON 
{
  "minimumCapabilities": [
    {
      object (Capability)
    }
  ]
}
Pola
minimumCapabilities[]

object (Capability)

Minimalny zestaw funkcji wymaganych do działania agenta. Jeśli na powierzchni brakuje któregoś z tych elementów, agent nie zostanie aktywowany.

Możliwości

Reprezentuje wymaganie dotyczące dostępności danej funkcji

Zapis JSON 
{
  "name": string
}
Pola
name

string

Nazwa funkcji, np. actions.capability.AUDIO_OUTPUT

Typ

Typ, do którego można się odwoływać w ramach akcji. Mogą to być typy niestandardowe unikalne dla działania lub typowe typy zdefiniowane przez Google, do których odwołuje się działanie.

Zapis JSON 
{
  "name": string,
  "entities": [
    {
      object (Entity)
    }
  ],
  "isUserDefined": boolean
}
Pola
name

string

nazwa typu niestandardowego w formacie type.
entities[]
(deprecated)

object (Entity)

Lista elementów tego typu. Każdy element zawiera klucz i listę synonimów.
isUserDefined

boolean

Określa, czy elementy są definiowane przez użytkownika (różne dla każdego użytkownika).

Jednostka

Każda encja jest unikalna dla tego typu. Klucz powinien być unikalny, a lista synonimów musi być używana do aktywowania.

Zapis JSON 
{
  "key": string,
  "synonyms": [
    string
  ]
}
Pola
key

string

Unikalny klucz tego elementu.
synonyms[]

string

Lista synonimów, których można użyć, aby odwołać się do tego elementu.