使用授權 view

您可以透過授權檢視畫面擷取對話資料、執行分析或編輯意見回饋標籤。 您無法使用授權檢視畫面編輯或匯入對話資料、訓練主題模型，或建立評量表。

選取授權檢視表，即可存取該檢視表提供的特定資料範圍。每個檢視畫面可以定義不同的範圍。您只會看到所選檢視畫面允許的資料。

選擇「無檢視權限」，即可使用您獲派的 Identity and Access Management (IAM) 權限。這是預設狀態。

所需權限和角色

如要使用授權 view，您需要下列 IAM 權限：

專案存取權的權限

管理員和服務專員必須具備專案的檢視權限 resourcemanager.projects.get，才能與主控台互動。

使用 roles/browser 授予管理員和服務專員基本存取層級。詳情請參閱專案層級存取控管說明文件。

授權檢視權限

使用 SetIamPolicy 方法，在特定授權檢視區上授予下列權限。詳情請參閱授權 view 資源。

授權檢視使用者只需要 contactcenterinsights.authorizedViews.get 權限，以及可存取資源的相應 authorized 權限。

授權對話的權限

權限 說明
contactcenterinsights.authorizedConversations.get 使用授權 view 取得對話。
contactcenterinsights.authorizedConversations.list 使用授權 view 列出對話。

授權作業的權限

權限 說明
contactcenterinsights.authorizedOperations.get 使用授權 view 取得作業。
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：授權 view 集或萬用字元「-」的使用者定義 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"
}

授權的對話

授權對話是指透過授權 view 存取的對話。

如需支援方法的完整清單，請參閱授權對話方法參考文件。

取得授權對話

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
    }
  ]
}

後續步驟