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

可选。代理的徽标的公开网址。大小上限为 50 KB。

代理验证后便无法修改。
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

仅限输出。用于测试代理的对话体验的网址。

由平台定义。
testUrls[]

object (TestUrl)

仅限输出。用于测试代理的对话体验的网址。

由平台定义。
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

一周内每天提供消息功能的时间。您可以将多天的营业时间归为一组。例如：*美国太平洋夏令时周一至周五上午 8:00–16:00 * 美国太平洋夏令时周四 10:00–14:00 * 美国太平洋夏令时周四至周五 15:00–18:00 * 星期六至星期六 10:00–14:00

如果存在有空时间（例如周日未指明空闲时间），则消息功能会在这些间隙不可用。

聊天机器人的工作时间对可用性没有影响。仅聊天机器人代理始终会显示欢迎消息，同时采用人工和聊天机器人代表设置的代理在定义可用性时仅考虑人工代表。

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 允许闰秒，则 API 可以允许 60 一值。
nanos

integer

秒数的小数部分（以纳秒为单位）。值必须是介于 0 和 999999999 之间的数字。

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

用户登录的端点网址。

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

必需。提供联系选项的网址。
options[]

enum (Option)

必需。适用于指定网址的联系人选项列表。

选项

联系方式。

枚举
OPTION_UNSPECIFIED 未指定
WEB_CHAT 网络聊天选项。
PHONE 电话选项。
EMAIL 电子邮件选项。
FAQS 常见问题解答选项。
TWITTER 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

 更新代理的验证状态。