ActionPackage

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 (Manifest)
  },
  "accountLinking": {
    object (AccountLinking)
  },
  "actions": [
    {
      object (Action)
    }
  ],
  "types": [
    {
      object (Type)
    }
  ],
  "conversations": {
    string: {
      object(ConversationFulfillment)
    },
    ...
  },
  "locale": string
}
Pola
manifest

object (Manifest)

Szczegóły aplikacji. W tym miejscu przechowywane są informacje o katalogu i 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 może obsłużyć aplikacja.

types[]

object (Type)

Lista typów zdefiniowanych przez dewelopera.

conversations

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

Zmapuj rozmowy, które mogą być udostępniane 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ń. 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:

  1. działań na stronie z informacjami o katalogu Google.
  2. Unikalny identyfikator aplikacji na potrzeby jawnego wywoływania (displayName).
  3. Treści z innych części aplikacji ActionPackage (nazwa shortDescription jest używana do wyświetlania w języku: AccountLinking, a nazwa displayName jest używana w języku actions, 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 (SurfaceRequirements)
  }
}
Pola
displayName

string

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). Wyświetlana nazwa musi być unikalna i fonetycznie bardzo podobna do nazwy invocationName.

invocationName

string

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 displayName.

enabledRegions[]

string (int64 format)

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[]

string (int64 format)

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

string

Domyślny krótki opis aplikacji (jeśli tłumaczenie nie jest dostępne). Limit wynosi 80 znaków.

longDescription

string

Domyślny długi opis aplikacji (jeśli tłumaczenie nie jest dostępne). Limit wynosi 4000 znaków.

category

string

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

string

Mały kwadratowy obraz. Wymagany rozmiar to 192 x 192 piksele.

largeLandscapeLogoUrl

string

Duży obraz poziomy. Rozmiar musi 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ę kontaktować w sprawie aplikacji.

termsOfServiceUrl

string

Adres URL Warunków korzystania z usługi dotyczących aplikacji.

privacyUrl

string

Adres URL polityki prywatności aplikacji.

sampleInvocation[]

string

Przykładowe wyrażenie wywołania wyświetlane w opisie aplikacji w katalogu wszystkich aplikacji. Można podać tylko 5 wartości.

introduction

string

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

string

Swobodne instrukcje testowania dla weryfikatora aplikacji.

voiceName

string

Nazwa głosu, która ma być używana. Obsługiwane przykładowe wartości: male_1, male_2, female_1, female_2.

externalVoiceName

string

Zewnętrzna nazwa głosu tego agenta. Nie zawiera informacji o lokalizacji.

voiceLocale

string

Język głosu tego agenta. Jeśli jest pusty, w czasie działania wybierany jest język używany przez użytkownika.

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órykolwiek z wymienionych tu wymagań nie zostanie spełniony, agent nie zostanie aktywowany.

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

object (Capability)

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

string

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 (Entity)
    }
  ],
  "isUserDefined": boolean
}
Pola
name

string

nazwa typu niestandardowego w formacie type.

entities[]
(deprecated)

object (Entity)

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

isUserDefined

boolean

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

string

Unikalny klucz dla tego elementu.

synonyms[]

string

Lista synonimów, których można użyć w odniesieniu do tego elementu.