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

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

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

割り当てられた 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: レスポンスで返すビューの最大数。値が 0 の場合、サービスはデフォルトのサイズを選択します。呼び出しで返されるオブジェクトの数が、リクエストされた数よりも少ないことがあります。レスポンスに空でない `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 メソッドと 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

リクエストを送信するには、次のいずれかのオプションを展開します。

curl（Linux、macOS、Cloud Shell）

注: 次のコマンドは、gcloud init または gcloud auth login を実行して、ユーザーアカウントで gcloud CLI にログインしているか、Cloud Shell を使用して自動的に gcloud CLI にログインしていることを前提としています。gcloud auth list を実行すると、現在アクティブなアカウントを確認できます。

次のコマンドを実行します。

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "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"

PowerShell（Windows）

注: 次のコマンドは、gcloud init または gcloud auth login を実行して、ご自分のユーザーアカウントで gcloud CLI にログインしていることを前提としています。gcloud auth list を実行すると、現在アクティブなアカウントを確認できます。

次のコマンドを実行します。

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "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" | Select-Object -Expand Content

次のような 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

リクエストを送信するには、次のいずれかのオプションを展開します。

curl（Linux、macOS、Cloud Shell）

次のコマンドを実行します。

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/authorizedViewSets/AUTHORIZED_VIEW_SET_ID/authorizedViews/AUTHORIZED_VIEW_ID/conversations/CONVERSATION_ID"

PowerShell（Windows）

次のコマンドを実行します。

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/authorizedViewSets/AUTHORIZED_VIEW_SET_ID/authorizedViews/AUTHORIZED_VIEW_ID/conversations/CONVERSATION_ID" | Select-Object -Expand Content

次のような 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

リクエストを送信するには、次のいずれかのオプションを展開します。

curl（Linux、macOS、Cloud Shell）

次のコマンドを実行します。

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/authorizedViewSets/AUTHORIZED_VIEW_SET_ID/authorizedViews/AUTHORIZED_VIEW_ID/conversations?pageSize=PAGE_SIZE"

PowerShell（Windows）

次のコマンドを実行します。

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/authorizedViewSets/AUTHORIZED_VIEW_SET_ID/authorizedViews/AUTHORIZED_VIEW_ID/conversations?pageSize=PAGE_SIZE" | Select-Object -Expand Content

次のような 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

リクエストを送信するには、次のいずれかのオプションを展開します。

curl（Linux、macOS、Cloud Shell）

次のコマンドを実行します。

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/operations/OPERATION_ID"

PowerShell（Windows）

次のコマンドを実行します。

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/operations/OPERATION_ID" | Select-Object -Expand Content

次のような 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/

リクエストを送信するには、次のいずれかのオプションを展開します。

curl（Linux、macOS、Cloud Shell）

次のコマンドを実行します。

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/authorizedViewSets/AUTHORIZED_VIEW_SET_ID/authorizedViews/AUTHORIZED_VIEW_ID/operations/"

PowerShell（Windows）

次のコマンドを実行します。

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/authorizedViewSets/AUTHORIZED_VIEW_SET_ID/authorizedViews/AUTHORIZED_VIEW_ID/operations/" | Select-Object -Expand Content

次のような 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
    }
  ]
}

次のステップ

承認済みビューのベストプラクティス

承認済みビューを使用する コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

必要な権限とロール

プロジェクト アクセスの権限

承認済みビューの権限

承認済み会話の権限

承認済みオペレーションの権限

事前定義ロール

承認済みビューを検索する

REST

curl（Linux、macOS、Cloud Shell）

PowerShell（Windows）

承認済みの会話

承認済みの会話を取得する

REST

curl（Linux、macOS、Cloud Shell）

PowerShell（Windows）

承認済み会話のリストを取得する

REST

curl（Linux、macOS、Cloud Shell）

PowerShell（Windows）

承認されたオペレーション

承認済みオペレーションを取得する

REST

curl（Linux、macOS、Cloud Shell）

PowerShell（Windows）

承認済みオペレーションを一覧表示する

REST

curl（Linux、macOS、Cloud Shell）

PowerShell（Windows）

次のステップ

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

プロジェクトアクセスの権限