REST Resource: brands.agents

리소스: 에이전트

브랜드를 나타내는 대화식 개체입니다.

JSON 표현 
{
  "name": string,
  "displayName": string,

  // Union field detail_info can be only one of the following:
  "businessMessagesAgent": {
    object (BusinessMessagesAgent)
  }
  // End of list of possible types for union field detail_info.
}
필드
name

string

에이전트의 고유 식별자입니다.

읽기 전용입니다. 플랫폼에 의해 정의됩니다.
displayName

string

필수 항목입니다. 에이전트가 사용자에게 표시하는 이름입니다. 최대 100자(영문 기준)까지 허용됩니다.

에이전트 인증 후에는 수정할 수 없습니다.

통합 필드 detail_info. 특정 제품에 필요한 필드가 포함되어 있습니다.

필수 항목입니다. detail_info는 다음 중 하나여야 합니다.
businessMessagesAgent

object (BusinessMessagesAgent)

Business Messages의 자세한 에이전트 정보입니다.

BusinessMessagesAgent

Business Messages와 관련된 에이전트 정보입니다.

JSON 표현 
{
  "logoUrl": string,
  "entryPointConfigs": [
    {
      object (BusinessMessagesEntryPointConfig)
    }
  ],
  "conversationalSettings": {
    string: {
      object (ConversationalSetting)
    },
    ...
  },
  "defaultLocale": string,
  "primaryAgentInteraction": {
    object (SupportedAgentInteraction)
  },
  "additionalAgentInteractions": [
    {
      object (SupportedAgentInteraction)
    }
  ],
  "customAgentId": string,
  "agentTestUrl": string,
  "testUrls": [
    {
      object (TestUrl)
    }
  ],
  "phone": {
    object (Phone)
  },
  "authorizationConfig": {
    object (AuthorizationConfig)
  },
  "nonLocalConfig": {
    object (NonLocalConfig)
  },
  "surveyConfig": {
    object (SurveyConfig)
  }
}
필드
logoUrl

string

선택사항입니다. 공개적으로 사용 가능한 에이전트 로고 URL입니다. 최대 50KB

에이전트 인증 후에는 수정할 수 없습니다.
entryPointConfigs[]

object (BusinessMessagesEntryPointConfig)

선택사항입니다. 진입점 구성 목록입니다.

에이전트 인증 후에는 수정할 수 없습니다.
conversationalSettings

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

필수 항목입니다. 언어에 매핑된 에이전트의 대화 설정입니다. 언어는 올바른 형식의 IETF BCP 47 언어 태그로 표현됩니다.

"key": value 쌍 목록을 포함하는 객체입니다. 예: { "name": "wrench", "mass": "1.3kg", "count": "3" }
defaultLocale

string

필수 항목입니다. 에이전트의 기본 언어입니다. conversationalSettings에 정의된 언어와 일치해야 합니다.
primaryAgentInteraction

object (SupportedAgentInteraction)

필수 항목입니다. 기본 상담사 상호작용 정보입니다. 사용자가 대화를 시작할 때 사용됩니다.
additionalAgentInteractions[]

object (SupportedAgentInteraction)

선택사항입니다. 추가 상담사 상호작용 정보입니다. 에이전트가 여러 상호작용 유형을 지원할 수 있게 합니다.
customAgentId

string

선택사항입니다. 파트너가 지정한 에이전트 식별자입니다. 식별자는 에이전트에 전송되는 모든 메시지와 함께 전달됩니다.
agentTestUrl
(deprecated)

string

출력 전용입니다. 에이전트의 대화 환경을 테스트하기 위한 URL입니다.

플랫폼에 의해 정의됩니다.
testUrls[]

object (TestUrl)

출력 전용입니다. 에이전트의 대화 환경을 테스트하기 위한 URL입니다.

플랫폼에 의해 정의됩니다.
phone

object (Phone)

선택사항입니다. 상담사가 표시할 전화번호입니다. 지정하지 않으면 에이전트는 Google 지식 그래프에서 찾은 브랜드의 전화번호를 표시합니다(있는 경우).
authorizationConfig

object (AuthorizationConfig)

선택사항입니다. OAuth 지원을 위한 승인 구성입니다.
nonLocalConfig

object (NonLocalConfig)

선택사항입니다. 비로컬 진입점의 구성입니다.
surveyConfig

object (SurveyConfig)

선택사항입니다. 맞춤 설문조사를 사용 설정하기 위한 구성입니다.

BusinessMessagesEntryPointConfig

에이전트의 진입점 구성입니다.

JSON 표현 
{
  "allowedEntryPoint": enum (EntryPoint)
}
필드
allowedEntryPoint

enum (EntryPoint)

필수 항목입니다. 에이전트가 표시되도록 사용 설정한 Google 표시 경로

EntryPoint

에이전트가 표시되도록 사용 설정한 Google 표시 경로

열거형
ENTRY_POINT_UNSPECIFIED 진입점이 지정되지 않았습니다.
LOCATION 이 에이전트의 위치를 사용 설정합니다.
NON_LOCAL 비로컬 진입점에 대해 Business Messages를 사용 설정합니다.

SupportedAgentInteraction

에이전트가 지원하는 상호작용입니다.

JSON 표현 
{
  "interactionType": enum (InteractionType),

  // Union field representative can be only one of the following:
  "botRepresentative": {
    object (BotRepresentative)
  },
  "humanRepresentative": {
    object (HumanRepresentative)
  }
  // End of list of possible types for union field representative.
}
필드
interactionType

enum (InteractionType)

필수 항목입니다. 에이전트가 지원하는 상호작용 유형입니다.
통합 필드 representative. 구성 유형의 세부정보입니다. 필수 항목입니다. representative은 다음 중 하나여야 합니다.
botRepresentative

object (BotRepresentative)

봇 담당자 세부정보
humanRepresentative

object (HumanRepresentative)

사람 대표 세부정보입니다.

InteractionType

에이전트에 지원되는 상호작용 유형입니다.

열거형
INTERACTION_TYPE_UNSPECIFIED 지정되지 않은 상호작용입니다.
BOT 봇 상호작용
HUMAN 사람의 개입

BotRepresentative

봇 담당자를 위한 세부정보입니다.

JSON 표현 
{
  "botMessagingAvailability": {
    object (MessagingAvailability)
  }
}
필드
botMessagingAvailability

object (MessagingAvailability)

필수 항목입니다. 봇 메시지 사용 가능 여부

MessagingAvailability

메시지를 사용할 수 있는 각 요일의 시간입니다. 여러 날짜의 시간을 그룹화할 수 있습니다. 예: * 08:00~16:00(PDT)(월~수요일) * 10:00~14:00(PDT) * 목요일~금요일 10:00~14:00(PDT) * 15:00~18:00(PDT) * 목요일~금요일(PDT) * 토요일 10:00~14:00(PDT)

가용성에 차이가 있는 경우(예: 일요일에 이용 가능 여부가 지정되지 않은 경우) 해당 시간 동안 메시지를 사용할 수 없습니다.

봇 시간은 참석 여부에 영향을 미치지 않습니다. 봇 전용 상담사는 항상 환영 메시지를 표시하지만, 사람 및 봇 담당자 설정을 모두 사용하는 상담사는 상담 가능 여부를 정의할 때 상담사만 고려합니다.

JSON 표현 
{
  "hours": [
    {
      object (Hours)
    }
  ]
}
필드
hours[]

object (Hours)

필수 항목입니다. 메시지 사용 가능 시간입니다.

시간

메시지를 사용할 수 있는 시간 범위입니다.

JSON 표현 
{
  "startTime": {
    object (TimeOfDay)
  },
  "endTime": {
    object (TimeOfDay)
  },
  "timeZone": string,
  "startDay": enum (DayOfWeek),
  "endDay": enum (DayOfWeek)
}
필드
startTime

object (TimeOfDay)

필수 항목입니다. 요일 범위 내에서 각 날짜의 시작 시간입니다.
endTime

object (TimeOfDay)

필수 항목입니다. 요일 범위 내에서 각 날짜의 종료 시간입니다.
timeZone

string

필수 항목입니다. 시간의 IANA 시간대입니다. 예: 'America/Los_Angeles'
startDay

enum (DayOfWeek)

필수 항목입니다. 시작일.
endDay

enum (DayOfWeek)

필수 항목입니다. 종료일 지정된 날짜가 포함됩니다.

TimeOfDay

하루 중 특정 시간을 나타냅니다. 날짜와 시간대가 중요하지 않거나 아무 곳으로 지정됩니다. API는 윤초를 허용하도록 선택할 수 있습니다. 관련된 유형은 google.type.Date 및 google.protobuf.Timestamp입니다.

JSON 표현 
{
  "hours": integer,
  "minutes": integer,
  "seconds": integer,
  "nanos": integer
}
필드
hours

integer

24시간 형식의 시간입니다. 0~23 사이의 값이어야 합니다. API는 비즈니스 종료 시간과 같은 시나리오에서 '24:00:00' 값을 허용하도록 선택할 수 있습니다.
minutes

integer

특정 시간의 분입니다. 0~59 사이의 값이어야 합니다.
seconds

integer

특정 분의 초입니다. 일반적으로 0~59 사이의 값이어야 합니다. API가 윤초를 허용하는 경우 값에 60을 사용할 수 있습니다.
nanos

integer

나노초 단위의 초수입니다. 0~999,999,999 사이의 값이어야 합니다.

DayOfWeek

요일을 나타냅니다.

열거형
DAY_OF_WEEK_UNSPECIFIED 요일이 지정되지 않습니다.
MONDAY 월요일
TUESDAY 화요일
WEDNESDAY 수요일
THURSDAY 목요일
FRIDAY 금요일
SATURDAY 토요일
SUNDAY 일요일

HumanRepresentative

담당자에 대한 세부정보입니다.

JSON 표현 
{
  "humanMessagingAvailability": {
    object (MessagingAvailability)
  }
}
필드
humanMessagingAvailability

object (MessagingAvailability)

필수 항목입니다. 사람의 메시지 사용 가능 여부

AuthorizationConfig

Business Messages에서 OAuth 지원을 위한 구성 세부정보입니다.

JSON 표현 
{
  "endpointUrl": string
}
필드
endpointUrl

string

사용자가 로그인하는 엔드포인트 URL입니다.

NonLocalConfig

비로컬 진입점을 사용 설정하기 위한 구성입니다.

JSON 표현 
{
  "contactOption": {
    object (ContactOption)
  },
  "enabledDomains": [
    string
  ],
  "phoneNumber": {
    object (Phone)
  },
  "callDeflectionPhoneNumbers": [
    {
      object (Phone)
    }
  ],
  "regionCodes": [
    string
  ]
}
필드
contactOption

object (ContactOption)

필수 항목입니다. 메시지 버튼과 함께 표시되는 에이전트에 대한 연락처 정보입니다.
enabledDomains[]

string

필수 항목입니다. 사이트링크 진입점에 사용할 도메인입니다.
phoneNumber

object (Phone)

필수 항목입니다. 상담사의 전화번호입니다. 로컬이 아닌 진입점에서 시작된 대화의 phone 필드를 재정의합니다. 이 전화번호는 구성된 모든 지역에서 사용됩니다.
callDeflectionPhoneNumbers[]

object (Phone)

필수 항목입니다. 통화 전환을 위한 전화번호 목록입니다.
regionCodes[]

string

필수 항목입니다. 상담사가 NON_LOCAL 진입점을 실행할 수 있는 국가의 CLDR 지역 코드 목록입니다. 진입점 NON_LOCAL개에 필요합니다.

ContactOption

메시지 버튼 외에 연락처 세부정보가 표시됩니다.

JSON 표현 
{
  "url": string,
  "options": [
    enum (Option)
  ]
}
필드
url

string

필수 항목입니다. 연락처 옵션을 사용할 수 있는 URL입니다.
options[]

enum (Option)

필수 항목입니다. 지정된 URL에 사용할 수 있는 연락처 옵션의 목록입니다.

옵션

연락처 옵션을 탭합니다.

열거형
OPTION_UNSPECIFIED 미지정
WEB_CHAT 웹 채팅 옵션
PHONE 전화 옵션입니다.
EMAIL 이메일 옵션
FAQS FAQ 옵션을 선택합니다.
TWITTER 트위터 옵션
WHATSAPP WhatsApp 옵션

SurveyConfig

맞춤설정된 설문조사 질문을 지원하기 위한 구성 세부정보입니다.

JSON 표현 
{
  "templateQuestionIds": [
    string
  ],
  "customSurveys": {
    string: {
      object (CustomSurveyConfig)
    },
    ...
  }
}
필드
templateQuestionIds[]

string

설문조사에 포함된 템플릿 질문의 템플릿 질문 ID 목록입니다.
customSurveys

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

언어에 매핑된 상담사용 맞춤 설문조사 질문입니다. 언어는 올바른 형식의 IETF BCP 47 언어 태그로 표현됩니다.

"key": value 쌍 목록을 포함하는 객체입니다. 예: { "name": "wrench", "mass": "1.3kg", "count": "3" }

CustomSurveyConfig

에이전트의 맞춤 설문조사 구성입니다.

JSON 표현 
{
  "customQuestions": [
    {
      object (SurveyQuestion)
    }
  ]
}
필드
customQuestions[]

object (SurveyQuestion)

맞춤 질문 목록입니다.

SurveyQuestion

각 설문조사 질문의 세부정보입니다.

JSON 표현 
{
  "name": string,
  "questionType": enum (Type),
  "questionContent": string,
  "responseOptions": [
    {
      object (SurveyResponse)
    }
  ]
}
필드
name

string

필수 항목입니다. 질문의 고유 식별자입니다.
questionType

enum (Type)

출력 전용입니다. 질문의 유형입니다.
questionContent

string

필수 항목입니다. 질문 콘텐츠입니다. 맞춤 질문은 200자(영문 기준)로 제한됩니다.
responseOptions[]

object (SurveyResponse)

필수 항목입니다. 질문과 함께 표시되는 응답 목록입니다. 최대 12자(영문 기준)입니다.

유형

설문조사 질문 유형입니다.

열거형
TYPE_UNSPECIFIED 알 수 없는 설문조사 질문 유형입니다.
GOOGLE_STANDARD_QUESTION Google 표준 설문조사 질문
GOOGLE_TEMPLATE_QUESTION Google에서 제공하는 설문조사 질문 템플릿입니다.
PARTNER_CUSTOM_QUESTION 파트너 맞춤 설문조사 질문

SurveyResponse

설문조사 질문 응답의 콘텐츠입니다.

JSON 표현 
{
  "content": string,
  "postbackData": string
}
필드
content

string

필수 항목입니다. 설문조사에 표시되고 사용자가 탭하면 상담사에게 다시 전송되는 텍스트입니다. 최대 35자(영문 기준)까지 허용됩니다.
postbackData

string

사용자가 질문 응답을 탭할 때 에이전트가 수신하는 문자열입니다.

메서드

create

 브랜드를 나타내는 새 에이전트를 만듭니다.

delete

 에이전트를 삭제합니다.

get

 에이전트 정보를 가져옵니다.

getLaunch

 에이전트의 출시 정보를 가져옵니다.

getVerification

 에이전트의 인증 정보를 가져옵니다.

list

 브랜드와 연결된 모든 상담사를 나열합니다.

patch

 에이전트 정보를 업데이트합니다.

requestLaunch

 에이전트의 출시 프로세스를 시작합니다.

requestVerification

 에이전트의 비즈니스 정보 인증을 시작합니다.

updateLaunch

 에이전트의 출시 정보를 업데이트합니다.

updateVerification

 상담사의 인증 상태를 업데이트합니다.