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)
}
필드
name

string

식별자. 배포의 리소스 이름입니다. 형식: 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)

출력 전용입니다. 이 배포가 생성된 타임스탬프입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.

updateTime

string (Timestamp format)

출력 전용입니다. 이 배포가 마지막으로 업데이트된 타임스탬프입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. '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팀에 문의하세요.

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 동영상 모달입니다.

메서드

create

지정된 앱에 새 배포를 만듭니다.

delete

지정된 배포를 삭제합니다.

get

지정된 배포의 세부정보를 가져옵니다.

getExtendedAgentCard

인증된 에이전트의 확장된 에이전트 카드를 가져옵니다.

list

지정된 앱의 배포를 나열합니다.

patch

지정된 배포를 업데이트합니다.