承認済みビューを使用する

承認済みビューを使用して、会話データの取得、分析の実行、フィードバック ラベルの編集を行うことができます。 承認済みビューを使用して、会話データの編集やインポート、トピックモデルのトレーニング、スコアカードの作成を行うことはできません。

承認済みビューを選択して、そのビューが提供する特定のデータスコープにアクセスします。各ビューで異なるスコープを定義できます。選択したビューで許可されているデータのみが表示されます。

[ビューなし] を選択すると、割り当てられた 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: Customer Experience Insights データのロケーション。
  • 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` の各フィールドでフィルタできます。任意の AND 式または OR 式を使用できます。文字列フィールドに正規表現を使用することもできます。
    • 例: 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 メソッドと URL: 

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 メソッドと URL: 

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 メソッドと URL: 

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 メソッドと URL: 

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 メソッドと URL: 

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

次のステップ