您可以使用授权视图来检索对话数据、执行分析或修改反馈标签。 您无法使用授权视图来修改或导入对话数据、训练主题模型或创建统计信息摘要。
选择授权视图以访问其提供的特定数据范围。每个视图都可以定义不同的范围。您只会看到所选视图允许的数据。
选择无视图以使用您获分配的 Identity and Access Management (IAM) 权限。这是默认状态。
必需的权限和角色
如需使用授权视图，您需要拥有以下 IAM 权限：
项目访问权限
经理和客服人员需要对项目 resourcemanager.projects.get 具有查看权限，才能与控制台互动。
使用 roles/browser 为经理和代理提供基本访问权限。如需了解详情，请参阅项目级访问权限控制文档。
授权视图权限
使用 SetIamPolicy 方法授予对特定授权视图的以下权限。如需了解详情，请参阅授权视图资源。
授权视图用户只需要 contactcenterinsights.authorizedViews.get 权限以及他们可以访问的资源的相应 authorized 权限。
授权对话的权限
| 权限 | 说明 |
|---|---|
contactcenterinsights.authorizedConversations.get |
使用授权视图获取对话。 |
contactcenterinsights.authorizedConversations.list |
使用授权视图列出对话。 |
授权操作的权限
| 权限 | 说明 |
|---|---|
contactcenterinsights.authorizedOperations.get |
使用授权视图获取操作。 |
contactcenterinsights.authorizedOperations.list |
使用已获授权的视图列出操作。 |
预定义角色
以下预定义的 IAM 角色提供了必需的权限：
| 角色 | 说明 |
|---|---|
roles/contactcenterinsights.authorizeEditor |
提供对所有已获授权的 Customer Experience Insights 资源的读写权限。 |
roles/contactcenterinsights.authorizedViewer |
提供对所有 Customer Experience Insights 授权资源的完整访问权限。 |
搜索授权视图
REST
检索您有权访问的所有授权视图。
在使用任何请求数据之前，请先进行以下替换：
- PROJECT_ID：您的 Google Cloud 项目 ID。
- LOCATION：客户体验数据分析数据的位置。
- AUTHORIZED_VIEW_SET_ID：授权视图集或通配符“-”的用户定义标识符。
- PAGE_SIZE：响应中要返回的视图数量上限。如果值为零，则服务会选择默认大小。调用返回的对象数量可能少于请求的数量。如果响应中包含非空的 `next_page_token`，则表示还有更多数据。
- PAGE_TOKEN：上一个 `SearchAuthorizedViewsResponse` 返回的值。此值表示这是之前的 `SearchAuthorizedViews` 调用的延续，并且系统应返回下一页的数据。
- FILTER：用于过滤响应中列出的已获授权视图的过滤条件表达式。您可以按以下字段进行过滤：`authorized_view_id`、`display_name`、`conversation_filter`、`create_time` 和 `update_time`。您可以使用任意和/或表达式。您还可以对字符串字段使用正则表达式。
- 示例：
display_name = "My View" - 示例：
conversation_filter =~ ".*agent-1.*" - 示例：
create_time > "2022-01-01T00:00:00Z" - 示例：
display_name =~ ".*View.*" - 示例：
create_time > "2022-01-01T00:00:00Z" AND create_time <= "2022-01-02T00:00:00Z" - ORDER_BY：用于对响应中列出的授权视图进行排序的排序依据表达式。
- 示例：
create_time - 示例：
update_time desc
HTTP 方法和网址：
GET https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/authorizedViewSets/AUTHORIZED_VIEW_SET_ID/authorizedViews:search?page_size=PAGE_SIZE&page_token=PAGE_TOKEN&filter=FILTER&order_by=ORDER_BY
如需发送您的请求，请展开以下选项之一：
您应该收到类似以下内容的 JSON 响应：
{
"authorizedViews": [
{
"name": "projects/my-project/locations/us-central1/authorizedViewSets/my-view-set/authorizedViews/my-view-1",
"displayName": "My First View",
"conversationFilter": "agent_id = \"agent-1\"",
"createTime": "2022-01-01T00:00:00.000000Z",
"updateTime": "2022-01-01T00:00:00.000000Z"
},
{
"name": "projects/my-project/locations/us-central1/authorizedViewSets/my-view-set/authorizedViews/my-view-2",
"displayName": "My Second View",
"conversationFilter": "agent_id = \"agent-2\"",
"createTime": "2022-01-01T00:00:00.000000Z",
"updateTime": "2022-01-01T00:00:00.000000Z"
}
],
"nextPageToken": "next-page-token"
}
已获授权的对话
授权对话是指使用授权视图访问的对话。
如需查看受支持方法的完整列表，请参阅授权对话方法参考文档。
获取已获授权的对话
REST
获取已获授权的对话需要 contactcenterinsights.authorizedConversations.get 权限。
在使用任何请求数据之前，请先进行以下替换：
- PROJECT_ID：您的 Google Cloud 项目 ID。
- LOCATION_ID：项目的位置
- AUTHORIZED_VIEW_SET_ID：授权视图集的 ID。
- AUTHORIZED_VIEW_ID：已获授权的视图的 ID。
- CONVERSATION_ID：对话的 ID。
HTTP 方法和网址：
GET https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/authorizedViewSets/AUTHORIZED_VIEW_SET_ID/authorizedViews/AUTHORIZED_VIEW_ID/conversations/CONVERSATION_ID
如需发送您的请求，请展开以下选项之一：
您应该收到类似以下内容的 JSON 响应：
{
"name": "projects/PROJECT_ID/locations/LOCATION_ID/authorizedViewSets/AUTHORIZED_VIEW_SET_ID/authorizedViews/AUTHORIZED_VIEW_ID/conversations/CONVERSATION_ID",
"createTime": "2025-03-03T11:23:17.823813113Z",
"updateTime": "2025-03-03T11:23:17.987216Z",
"agentId": "AGENT_ID",
"callMetadata": {
"customerChannel": 1,
"agentChannel": 2
},
"medium": "CHAT",
"duration": "0s",
"turnCount": 2,
"languageCode": "en",
"startTime": "2025-03-03T11:23:16.903361174Z",
"qualityMetadata": {
"agentInfo": [
{
"agentId": "AGENT_ID",
"agentType": "HUMAN_AGENT"
}
]
}
}
列出已获授权的对话
REST
列出已获授权的对话需要 contactcenterinsights.authorizedConversations.list 权限。
在使用任何请求数据之前，请先进行以下替换：
- PROJECT_ID：您的 Google Cloud 项目 ID。
- LOCATION_ID：项目的位置。
- AUTHORIZED_VIEW_SET_ID：授权视图集的 ID。
- AUTHORIZED_VIEW_ID：已获授权的视图的 ID。
- PAGE_SIZE：每页返回的对话数量。
HTTP 方法和网址：
GET https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/authorizedViewSets/AUTHORIZED_VIEW_SET_ID/authorizedViews/AUTHORIZED_VIEW_ID/conversations?pageSize=PAGE_SIZE
如需发送您的请求，请展开以下选项之一：
您应该收到类似以下内容的 JSON 响应：
{
"conversations": [
{
"name": "projects/PROJECT_ID/locations/LOCATION_ID/authorizedViewSets/AUTHORIZED_VIEW_SET_ID/authorizedViews/AUTHORIZED_VIEW_ID/conversations/4315d72e3d-c75-94d-2d5-1ae05b4222352",
"createTime": "2025-03-03T11:23:17.823813113Z",
"updateTime": "2025-03-03T11:23:17.987216Z",
"agentId": "AGENT_ID",
"callMetadata": {
"customerChannel": 1,
"agentChannel": 2
},
"medium": "CHAT",
"duration": "0s",
"turnCount": 2,
"languageCode": "en",
"startTime": "2025-03-03T11:23:16.903361174Z",
"qualityMetadata": {
"agentInfo": [
{
"agentId": "AGENT_ID",
"agentType": "AUTOMATED_AGENT"
}
]
}
},
{
"name": "projects/PROJECT_ID/locations/LOCATION_ID/authorizedViewSets/AUTHORIZED_VIEW_SET_ID/authorizedViews/AUTHORIZED_VIEW_ID/conversations/8d3b61-bd4-f2c-364-b5a794f76",
"createTime": "2025-03-03T11:19:58.605217527Z",
"updateTime": "2025-03-03T11:19:58.901962Z",
"agentId": "AGENT_ID",
"callMetadata": {
"customerChannel": 1,
"agentChannel": 2
},
"medium": "CHAT",
"duration": "0s",
"turnCount": 2,
"runtimeAnnotations": [
{
"createTime": "2025-03-03T11:19:56.164686195Z",
"startBoundary": {
"transcriptIndex": 1
},
"endBoundary": {
"transcriptIndex": 2
},
"answerFeedback": {},
}
],
"languageCode": "en",
"startTime": "2025-03-03T11:19:56.164686195Z",
"qualityMetadata": {
"agentInfo": [
{
"agentId": "AGENT_ID",
"agentType": "HUMAN_AGENT"
}
]
}
}
],
"nextPageToken": "NEXT_PAGE_TOKEN"
}
已获授权的操作
如需查看受支持方法的完整列表，请参阅授权操作方法参考文档
获取授权操作
REST
获取授权操作需要 contactcenterinsights.authorizedOperations.get 权限。
在使用任何请求数据之前，请先进行以下替换：
- PROJECT_ID：您的 Google Cloud 项目 ID。
- LOCATION：客户体验数据分析数据的位置。
- OPERATION_ID：您要分析的对话的 ID。此值是在您创建分析时返回的。
HTTP 方法和网址：
GET https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/operations/OPERATION_ID
如需发送您的请求，请展开以下选项之一：
您应该收到类似以下内容的 JSON 响应：
{
"name": "projects/PROJECT_ID/locations/LOCATION/operations/OPERATION_ID",
"metadata": {
"@type": "type.googleapis.com/google.cloud.contactcenterinsights.v1.QueryMetricsMetadata"
},
"done": true
}
列出已获授权的操作
REST
列出已获授权的操作需要 contactcenterinsights.authorizedOperations.list 权限。
在使用任何请求数据之前，请先进行以下替换：
- PROJECT_ID：您的 Google Cloud 项目 ID。
- LOCATION：客户体验数据分析数据的位置。
- AUTHORIZED_VIEW_SET_ID：授权视图集的 ID。
- AUTHORIZED_VIEW_ID：已获授权的视图的 ID。
HTTP 方法和网址：
GET https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/authorizedViewSets/AUTHORIZED_VIEW_SET_ID/authorizedViews/AUTHORIZED_VIEW_ID/operations/
如需发送您的请求，请展开以下选项之一：
您应该收到类似以下内容的 JSON 响应：
{
"operations": [
{
"name": "projects/PROJECT_ID/locations/LOCATION_ID/authorizedViewSets/AUTHORIZED_VIEW_SET_ID/authorizedViews/AUTHORIZED_VIEW_ID/operations/OPERATION_ID",
"metadata": {
"@type": "type.googleapis.com/google.cloud.contactcenterinsights.v1.QueryMetricsMetadata"
},
"done": true
},
{
"name": "projects/PROJECT_ID/locations/LOCATION/authorizedViewSets/AUTHORIZED_VIEW_SET_ID/authorizedViews/AUTHORIZED_VIEW_ID/operations/OPERATION_ID_2",
"metadata": {
"@type": "type.googleapis.com/google.cloud.contactcenterinsights.v1.QueryMetricsMetadata"
},
"done": true
}
]
}