REST Resource: projects.locations.apps.deployments

リソース: Deployment

デプロイは、アプリの不変でクエリ可能なバージョンを表します。特定のチャンネル プロファイルでアプリのバージョンをデプロイするために使用されます。

JSON 表現 
{
  "name": string,
  "displayName": string,
  "appVersion": string,
  "channelProfile": {
    object (ChannelProfile)
  },
  "createTime": string,
  "updateTime": string,
  "etag": string,
  "experimentConfig": {
    object (ExperimentConfig)
  },
  "whatsappCredentials": {
    object (WhatsAppCredentials)
  },
  "instagramCredentials": {
    object (InstagramCredentials)
  },
  "modelSettings": {
    object (ModelSettings)
  },
  "modality": enum (Deployment.Modality),
  "agentRegistryDeployment": {
    object (AgentRegistryDeployment)
  }
}
フィールド
name

string

ID。デプロイのリソース名。形式: projects/{project}/locations/{location}/apps/{app}/deployments/{deployment}
displayName

string

必須。デプロイの表示名。
appVersion

string

省略可。デプロイするアプリ バージョンのリソース名。形式: projects/{project}/locations/{location}/apps/{app}/versions/{version} 下書きアプリを使用するには、projects/{project}/locations/{location}/apps/{app}/versions/- を使用します。
channelProfile

object (ChannelProfile)

必須。デプロイで使用されるチャンネル プロファイル。
createTime

string (Timestamp format)

出力専用。このデプロイが作成されたときのタイムスタンプ。

RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"、"2014-10-02T15:01:23+05:30"。
updateTime

string (Timestamp format)

出力専用。このデプロイが最後に更新されたときのタイムスタンプ。

RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"、"2014-10-02T15:01:23+05:30"。
etag

string

出力専用。読み取り / 変更 / 書き込みオペレーション中にオブジェクトが変更されていないことを確認するために使用される ETag。etag が空の場合、更新によって同時変更が上書きされます。
experimentConfig

object (ExperimentConfig)

省略可。デプロイのテスト構成。
whatsappCredentials

object (WhatsAppCredentials)

省略可。入力専用。WhatsApp チャンネル プロファイルを構成するときに必要なエフェメラル WhatsApp 認証情報。
instagramCredentials

object (InstagramCredentials)

省略可。入力専用。Instagram チャンネル プロフィールを構成する際に必要な一時的な Instagram 認証情報。
modelSettings

object (ModelSettings)

省略可。デプロイのモデル設定。アプリ/エージェント レベルで構成されたモデル設定をオーバーライドします。注: デプロイレベルのモデル設定のオーバーライドは、許可リストで制御されます。このフィールドを有効にするには、CXAS チームにお問い合わせください。
modality

enum (Deployment.Modality)

省略可。デプロイのモダリティ。注: デプロイレベルのモダリティのオーバーライドは、許可リストでゲートされています。このフィールドを有効にするには、CXAS チームにお問い合わせください。
agentRegistryDeployment

object (AgentRegistryDeployment)

省略可。このデプロイを Agent Registry にデプロイするための構成。存在する場合、このデプロイは Agent Registry に公開されます。

ExperimentConfig

デプロイのテスト。

JSON 表現 
{
  "versionRelease": {
    object (ExperimentConfig.VersionRelease)
  }
}
フィールド
versionRelease

object (ExperimentConfig.VersionRelease)

省略可。テストのバージョン リリース。

ExperimentConfig.VersionRelease

テストのバージョン リリース。

JSON 表現 
{
  "state": enum (ExperimentConfig.State),
  "trafficAllocations": [
    {
      object (ExperimentConfig.VersionRelease.TrafficAllocation)
    }
  ]
}
フィールド
state

enum (ExperimentConfig.State)

省略可。バージョンのリリースの状態。
trafficAllocations[]

object (ExperimentConfig.VersionRelease.TrafficAllocation)

省略可。バージョン リリースのトラフィック割り当て。

ExperimentConfig.State

テストの状態。

列挙型
STATE_UNSPECIFIED 未指定の状態
PENDING 非推奨: この状態は使用されなくなりました。
RUNNING 実行状態。テストが実行中で有効です。
DONE 非推奨: この状態は使用されなくなりました。
EXPIRED 非推奨: この状態は使用されなくなりました。

ExperimentConfig.VersionRelease.TrafficAllocation

バージョン リリースのトラフィックの割り当て。

JSON 表現 
{
  "id": string,
  "trafficPercentage": integer,
  "appVersion": string
}
フィールド
id

string

省略可。トラフィックの割り当ての ID。自由形式の文字列。最大 128 文字。
trafficPercentage

integer

省略可。トラフィックの割り当てのトラフィックの割合。0 ～ 100 の範囲で指定してください。
appVersion

string

省略可。トラフィックの割り当てのアプリのバージョン。形式: projects/{project}/locations/{location}/apps/{app}/versions/{version}

WhatsAppCredentials

WhatsApp ネイティブ統合用の一時的な Meta 認証情報。

JSON 表現 
{
  "authCode": string,
  "pin": string,
  "phoneNumber": string,
  "businessAccountId": string,
  "wabaId": string,
  "conversationProfileId": string
}
フィールド
authCode

string

必須。埋め込み登録フローで提供される Meta 認証コード。
pin

string

必須。2 段階認証プロセス用にユーザーが作成した 6 桁の PIN。
phoneNumber

string

必須。WhatsApp に登録する電話番号。
businessAccountId

string

必須。電話番号に使用するビジネス アカウント ID。
wabaId

string

必須。WhatsApp Business のアカウント ID。
conversationProfileId

string

省略可。デプロイに使用する会話プロファイル ID。

InstagramCredentials

Instagram ネイティブ統合用の一時的な Meta 認証情報。

JSON 表現 
{
  "authCode": string,
  "conversationProfileId": string
}
フィールド
authCode

string

必須。埋め込み登録フローで提供される Meta 認証コード。
conversationProfileId

string

省略可。デプロイに使用する会話プロファイル ID。

Deployment.Modality

デプロイのモダリティ。

列挙型
MODALITY_UNSPECIFIED 不明なモダリティ。
MODALITY_TEXT テキスト モダリティ。
MODALITY_VOICE 音声モダリティ。
MODALITY_VIDEO 動画モダリティ。

AgentRegistryDeployment

Agent Registry のデプロイの構成とステータス。

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

string

省略可。出力専用。デプロイされた Agent Registry サービスのリソース名。形式: projects/{project}/locations/{location}/services/{service}

メソッド

create

 指定されたアプリに新しいデプロイを作成します。

delete

 指定されたデプロイを削除します。

get

 指定されたデプロイの詳細を取得します。

getExtendedAgentCard

 認証されたエージェントの拡張エージェント カードを取得します。

list

 指定されたアプリのデプロイを一覧表示します。

patch

 指定されたデプロイを更新します。