ActionPackage

ActionPackage は、アプリのドラフトやデプロイ済みの各バージョンのコンテンツを保持します。これには、ディレクトリ リスティングの詳細、会話の構成、アカウント リンクが含まれます。

JSON 表現
{
  "manifest": {
    object (Manifest)
  },
  "accountLinking": {
    object (AccountLinking)
  },
  "actions": [
    {
      object (Action)
    }
  ],
  "types": [
    {
      object (Type)
    }
  ],
  "conversations": {
    string: {
      object(ConversationFulfillment)
    },
    ...
  },
  "locale": string
}
フィールド
manifest

object (Manifest)

アプリの詳細。ここには、ディレクトリ リスティングと、displayName などの他のアプリ識別情報が保持されます。

accountLinking

object (AccountLinking)

このアプリのアカウントのリンクに関する詳細情報。

actions[]

object (Action)

アプリが処理できるアクションのリスト。

types[]

object (Type)

デベロッパーが定義したタイプのリスト。

conversations

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

actions 間で共有できる会話をマッピングします。たとえば、FulfillmentconversationName をご覧ください。

"key": value ペアのリストを含むオブジェクト。例: { "name": "wrench", "mass": "1.3kg", "count": "3" }

locale

string

このアクション パッケージの言語 / 地域。「en」「en-US」「fr」「fr-CA」「sr-Latn」「zh-Hans」「zh-Hans-CN」「zh-Hant」「zh-Hant-HK」などの BCP-47 言語文字列で表現されます。アプリが複数の言語をサポートする場合は必須です。サポートされるロケールごとに固有の ActionPackage があります。値を指定しないと、エージェントのデフォルトのロケールが暗黙的に指定されます。

Manifest

アプリのメタデータのセットです。このメッセージの内容は次のような複数のコンテキストで使用されます。

  1. Actions on Google のディレクトリ リスティング ページ。
  2. 明示的な呼び出しのためのアプリの一意の識別(displayName)。
  3. ActionPackage の他の部分のコンテンツ(shortDescriptionAccountLinking で表示するために使用され、displayNameactions でユーザーにアプリ名を表示するために使用されます)。

このメッセージは読み取り専用です。このメッセージのフィールドは Actions Console で指定し、アクション パッケージでは直接指定しません。

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)
  }
}
フィールド
displayName

string

このアプリのデフォルトの表示名(利用可能な翻訳がない場合)。例:「スターバックス」。これは、(invocationName に加えて)ユーザーがこのアプリを呼び出すためのメソッドとしても使用されます。表示名は一意で、発音が invocationName とよく似ている必要があります。

invocationName

string

これは、このアプリを音声(音声)コンテキスト内で直接呼び出すための一意の名前です。ポリシーにより、呼び出し名は発音が displayName フィールドと非常に類似している必要があります。

enabledRegions[]

string (int64 format)

ユーザーの所在地に基づいて、アプリが許可されている地域の AdWords 条件 ID。https://developers.google.com/adwords/api/docs/appendix/geotargeting をご覧ください。

disabledRegions[]

string (int64 format)

ユーザーの所在地に基づいてアプリがブロックされている地域の AdWords 条件 ID。https://developers.google.com/adwords/api/docs/appendix/geotargeting をご覧ください。

shortDescription

string

アプリのデフォルトの簡単な説明(翻訳がない場合)。最大 80 文字に制限されています。

longDescription

string

アプリのデフォルトの詳しい説明(翻訳がない場合)。最大 4,000 文字に制限されています。

category

string

アプリのカテゴリ。この値は、アプリに対して許可されているカテゴリのいずれかである必要があります。許可されているカテゴリのリストについては、Actions on Google Console をご覧ください。

smallSquareLogoUrl

string

小さい正方形の画像。寸法は 192×192 ピクセルでなければなりません。

largeLandscapeLogoUrl

string

大きい横向きの画像。寸法は 2,208×1,242 ピクセルでなければなりません。

companyName

string

アプリが関連付けられている会社の名前。

contactEmail

string

ユーザーがアプリに関する問い合わせに使用できる連絡先メールアドレス。

termsOfServiceUrl

string

アプリの ToS(利用規約)の URL。

privacyUrl

string

アプリのプライバシー ポリシーの URL。

sampleInvocation[]

string

すべてのアプリのディレクトリでアプリの説明の一部として表示される呼び出しフレーズの例。指定できる値は 5 つだけです。

introduction

string

アプリでできることの概要。アプリをユーザーに紹介する場合に使用します。「このアプリを使用すると...」のような文を完成させる動詞フレーズにする必要があります。

testingInstructions

string

アプリ審査担当者向けの自由形式のテスト手順。

voiceName

string

使用する音声の名前。サポートされている値の例: male_1male_2female_1female_2

externalVoiceName

string

このエージェントの外部音声名。言語 / 地域情報は含まれません。

voiceLocale

string

このエージェントの音声の言語 / 地域。空の文字列に設定すると、実行時にユーザーの言語 / 地域に解決されます。

surfaceRequirements

object (SurfaceRequirements)

アプリがトリガーされるために満たさなければならない、Google アシスタント クライアント サーフェスの一連の要件。

SurfaceRequirements

このエージェントを呼び出すために満たされていなければならないクライアント サーフェスの要件のセットが含まれます。ここに記述された要件が満たされていない場合、エージェントは呼び出されません。

JSON 表現
{
  "minimumCapabilities": [
    {
      object (Capability)
    }
  ]
}
フィールド
minimumCapabilities[]

object (Capability)

エージェントが機能するために必要な最小限の機能セット。これらのいずれか 1 つでも欠けている場合、エージェントは呼び出されません。

Capability

ある特定の機能が備わっていなければならないことを表します。

JSON 表現
{
  "name": string
}
フィールド
name

string

機能の名前。例:actions.capability.AUDIO_OUTPUT

タイプ

アクション内で参照できる型。これらは、そのアクションに固有のカスタム型、または Google によって定義されアクション内で参照される共通型にすることができます。

JSON 表現
{
  "name": string,
  "entities": [
    {
      object (Entity)
    }
  ],
  "isUserDefined": boolean
}
フィールド
name

string

カスタムタイプの名前(type の形式)。

entities[]
(deprecated)

object (Entity)

このタイプのエンティティのリスト。各エンティティにはキーと同義語のリストが含まれます。

isUserDefined

boolean

エンティティがユーザー定義かどうか(ユーザーごとに異なる)。

エンティティ

対応する各エンティティはこの型に固有です。キーは一意である必要があり、同義語のリストはトリガーに使用されます。

JSON 表現
{
  "key": string,
  "synonyms": [
    string
  ]
}
フィールド
key

string

このアイテムの一意のキー。

synonyms[]

string

このアイテムを参照するために使用できる類義語のリスト。