Menggunakan tampilan yang diotorisasi

Anda dapat menggunakan tampilan yang diizinkan untuk mengambil data percakapan, melakukan analisis, atau mengedit label masukan. Anda tidak dapat menggunakan tampilan yang diotorisasi untuk mengedit atau mengimpor data percakapan, melatih model topik, atau membuat kartu skor.

Pilih tampilan yang diotorisasi untuk mengakses cakupan data tertentu yang diberikannya. Setiap tampilan dapat menentukan cakupan yang berbeda. Anda hanya akan melihat data yang diizinkan melalui tampilan yang dipilih.

Pilih Tidak ada tampilan untuk menggunakan izin Identity and Access Management (IAM) yang ditetapkan kepada Anda. Ini adalah status default.

Izin dan peran yang diperlukan

Untuk menggunakan tampilan yang diotorisasi, Anda memerlukan izin IAM berikut:

Izin untuk akses project

Pengelola dan agen memerlukan akses lihat pada project resourcemanager.projects.get untuk berinteraksi dengan konsol.

Gunakan roles/browser untuk memberi pengelola dan agen tingkat akses dasar. Lihat dokumentasi kontrol akses tingkat project untuk mengetahui detail selengkapnya.

Izin tampilan yang diberi otorisasi

Berikan izin berikut pada tampilan resmi tertentu dengan metode SetIamPolicy. Lihat resource tampilan yang diberi otorisasi untuk mengetahui detail selengkapnya.

Pengguna tampilan yang diotorisasi hanya memerlukan izin contactcenterinsights.authorizedViews.get dan izin authorized yang sesuai untuk resource yang dapat mereka akses.

Izin untuk percakapan resmi

Izin Deskripsi
contactcenterinsights.authorizedConversations.get Menggunakan tampilan yang diotorisasi untuk mendapatkan percakapan.
contactcenterinsights.authorizedConversations.list Gunakan tampilan yang diotorisasi untuk mencantumkan percakapan.

Izin untuk operasi yang diizinkan

Izin Deskripsi
contactcenterinsights.authorizedOperations.get Menggunakan tampilan yang diotorisasi untuk mendapatkan operasi.
contactcenterinsights.authorizedOperations.list Gunakan tampilan yang diberi otorisasi untuk mencantumkan operasi.

Peran yang telah ditetapkan

Peran IAM bawaan berikut memberikan izin yang diperlukan:

Peran Deskripsi
roles/contactcenterinsights.authorizeEditor Memberikan akses baca/tulis ke semua resource Customer Experience Insights yang sah.
roles/contactcenterinsights.authorizedViewer Memberikan akses penuh ke semua resource resmi Customer Experience Insights.

Menelusuri tampilan yang diotorisasi

REST

Mengambil semua tampilan resmi yang aksesnya Anda miliki.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • PROJECT_ID: Project ID Google Cloud Anda.
  • LOCATION: Lokasi data Customer Experience Insights Anda.
  • AUTHORIZED_VIEW_SET_ID: ID yang ditentukan pengguna untuk set tampilan yang diberi otorisasi atau karakter pengganti `-`.
  • PAGE_SIZE: Jumlah maksimum tampilan yang akan ditampilkan dalam respons. Jika nilainya nol, layanan akan memilih ukuran default. Panggilan mungkin menampilkan lebih sedikit objek daripada yang diminta. `next_page_token` yang tidak kosong dalam respons menunjukkan bahwa ada lebih banyak data yang tersedia.
  • PAGE_TOKEN: Nilai yang ditampilkan oleh `SearchAuthorizedViewsResponse` terakhir. Nilai ini menunjukkan bahwa ini adalah kelanjutan dari panggilan `SearchAuthorizedViews` sebelumnya dan sistem harus menampilkan halaman data berikutnya.
  • FILTER: Ekspresi filter untuk memfilter tampilan resmi yang tercantum dalam respons. Anda dapat memfilter kolom berikut: `authorized_view_id`, `display_name`, `conversation_filter`, `create_time`, dan `update_time`. Anda dapat menggunakan ekspresi arbitrer dan/atau. Anda juga dapat menggunakan ekspresi reguler untuk kolom string.
    • Contoh: display_name = "My View"
    • Contoh: conversation_filter =~ ".*agent-1.*"
    • Contoh: create_time > "2022-01-01T00:00:00Z"
    • Contoh: display_name =~ ".*View.*"
    • Contoh: create_time > "2022-01-01T00:00:00Z" AND create_time <= "2022-01-02T00:00:00Z"
  • ORDER_BY: Ekspresi pengurutan untuk mengurutkan tabel virtual yang diotorisasi yang tercantum dalam respons.
    • Contoh: create_time
    • Contoh: update_time desc

Metode HTTP dan 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

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

Anda akan melihat respons JSON seperti berikut:

{
  "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"
}

Percakapan resmi

Percakapan yang diizinkan mewakili percakapan saat diakses menggunakan tampilan yang diizinkan.

Untuk mengetahui daftar lengkap metode yang didukung, lihat dokumen referensi metode percakapan resmi.

Mendapatkan percakapan yang sah

REST

Mendapatkan percakapan yang diizinkan memerlukan izin contactcenterinsights.authorizedConversations.get.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • PROJECT_ID: Project ID Google Cloud Anda.
  • LOCATION_ID: Lokasi project Anda
  • AUTHORIZED_VIEW_SET_ID: ID set tampilan yang diizinkan.
  • AUTHORIZED_VIEW_ID: ID tampilan yang diizinkan.
  • CONVERSATION_ID: ID percakapan.

Metode HTTP dan 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

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

Anda akan melihat respons JSON seperti berikut:

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

Mencantumkan percakapan yang diizinkan

REST

Mencantumkan percakapan yang diberi otorisasi memerlukan izin contactcenterinsights.authorizedConversations.list.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • PROJECT_ID: Project ID Google Cloud Anda.
  • LOCATION_ID: Lokasi project Anda.
  • AUTHORIZED_VIEW_SET_ID: ID set tampilan yang diizinkan.
  • AUTHORIZED_VIEW_ID: ID tampilan yang diizinkan.
  • PAGE_SIZE: Jumlah percakapan yang akan ditampilkan per halaman.

Metode HTTP dan 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

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

Anda akan melihat respons JSON seperti berikut:

{
  "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"
}

Operasi yang diizinkan

Untuk mengetahui daftar lengkap metode yang didukung, lihat dokumen referensi metode operasi yang diizinkan

Mendapatkan operasi yang diizinkan

REST

Mendapatkan operasi yang diizinkan memerlukan izin contactcenterinsights.authorizedOperations.get.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • PROJECT_ID: Project ID Google Cloud Anda.
  • LOCATION: Lokasi data Customer Experience Insights Anda.
  • OPERATION_ID: ID percakapan yang ingin Anda analisis. Nilai ini ditampilkan saat Anda membuat analisis.

Metode HTTP dan URL: 

GET https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/operations/OPERATION_ID

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

Anda akan melihat respons JSON seperti berikut:

{
  "name": "projects/PROJECT_ID/locations/LOCATION/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.contactcenterinsights.v1.QueryMetricsMetadata"
  },
  "done": true
}

Mencantumkan operasi yang diizinkan

REST

Mencantumkan operasi yang diizinkan memerlukan izin contactcenterinsights.authorizedOperations.list.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • PROJECT_ID: Project ID Google Cloud Anda.
  • LOCATION: Lokasi data Customer Experience Insights Anda.
  • AUTHORIZED_VIEW_SET_ID: ID set tampilan yang diizinkan.
  • AUTHORIZED_VIEW_ID: ID tampilan yang diizinkan.

Metode HTTP dan URL: 

GET https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/authorizedViewSets/AUTHORIZED_VIEW_SET_ID/authorizedViews/AUTHORIZED_VIEW_ID/operations/

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

Anda akan melihat respons JSON seperti berikut:

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

Apa langkah selanjutnya?