您可以透過授權檢視畫面擷取對話資料、執行分析或編輯意見回饋標籤。 您無法使用授權檢視區編輯或匯入對話資料、訓練主題模型，或建立評量表。
選取授權檢視表，即可存取該檢視表提供的特定資料範圍。每個檢視畫面可以定義不同的範圍。您只會看到所選檢視畫面允許的資料。
選擇「無檢視權限」，即可使用您獲派的 Identity and Access Management (IAM) 權限。這是預設狀態。
所需權限和角色
如要使用授權 view，您需要下列 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 授權資源的完整存取權。 |
搜尋授權 view
REST
擷取您有權存取的所有授權檢視區塊。
使用任何要求資料之前，請先修改下列項目的值：
- PROJECT_ID： Google Cloud 專案 ID。
- LOCATION：Customer Experience Insights 資料的位置。
- AUTHORIZED_VIEW_SET_ID：授權檢視畫面集或萬用字元「-」的使用者定義 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：Customer Experience Insights 資料的位置。
- 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：Customer Experience Insights 資料的位置。
- 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
}
]
}