Utilizzare le visualizzazioni autorizzate

Puoi utilizzare le visualizzazioni autorizzate per recuperare i dati delle conversazioni, eseguire analisi o modificare le etichette di feedback. Non puoi utilizzare le visualizzazioni autorizzate per modificare o importare dati delle conversazioni, addestrare modelli di argomenti o creare prospetti.

Seleziona una vista autorizzata per accedere all'ambito specifico dei dati che fornisce. Ogni vista può definire un ambito diverso. Visualizzerai solo i dati consentiti dalla visualizzazione selezionata.

Scegli Nessuna visualizzazione per utilizzare le autorizzazioni Identity and Access Management (IAM) assegnate. Questo è lo stato predefinito.

Autorizzazioni e ruoli obbligatori

Per utilizzare le viste autorizzate, devi disporre delle seguenti autorizzazioni IAM:

Autorizzazioni per l'accesso al progetto

I gestori e gli agenti richiedono l'accesso in visualizzazione al progetto resourcemanager.projects.get per interagire con la console.

Utilizza roles/browser per concedere a manager e agenti un livello di accesso di base. Per ulteriori dettagli, consulta la documentazione sul controllo dell'accesso a livello di progetto.

Autorizzazioni di visualizzazione autorizzate

Concedi le seguenti autorizzazioni per viste autorizzate specifiche con i metodi SetIamPolicy. Per maggiori dettagli, consulta le risorse della visualizzazione autorizzata.

Gli utenti autorizzati alla visualizzazione hanno bisogno solo dell'autorizzazione contactcenterinsights.authorizedViews.get e delle autorizzazioni authorized corrispondenti per le risorse a cui possono accedere.

Autorizzazioni per le conversazioni autorizzate

Autorizzazione Descrizione
contactcenterinsights.authorizedConversations.get Utilizza una visualizzazione autorizzata per ottenere una conversazione.
contactcenterinsights.authorizedConversations.list Utilizza una vista autorizzata per elencare le conversazioni.

Autorizzazioni per le operazioni autorizzate

Autorizzazione Descrizione
contactcenterinsights.authorizedOperations.get Utilizza una visualizzazione autorizzata per ottenere un'operazione.
contactcenterinsights.authorizedOperations.list Utilizza una visualizzazione autorizzata per elencare le operazioni.

Ruoli predefiniti

I seguenti ruoli IAM predefiniti forniscono le autorizzazioni necessarie:

Ruolo Descrizione
roles/contactcenterinsights.authorizeEditor Fornisce l'accesso in lettura/scrittura a tutte le risorse Customer Experience Insights autorizzate.
roles/contactcenterinsights.authorizedViewer Fornisce l'accesso completo a tutte le risorse autorizzate di Customer Experience Insights.

Cercare le visualizzazioni autorizzate

REST

Recupera tutte le visualizzazioni autorizzate a cui hai accesso.

Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:

  • PROJECT_ID: l'ID progetto Google Cloud .
  • LOCATION: la posizione dei dati di Customer Experience Insights.
  • AUTHORIZED_VIEW_SET_ID: un identificatore definito dall'utente per il set di visualizzazioni autorizzate o il carattere jolly "-".
  • PAGE_SIZE: il numero massimo di visualizzazioni da restituire nella risposta. Se il valore è zero, il servizio selezionerà una dimensione predefinita. Una chiamata potrebbe restituire meno oggetti di quelli richiesti. Un valore `next_page_token` non vuoto nella risposta indica che sono disponibili altri dati.
  • PAGE_TOKEN: il valore restituito dall'ultima `SearchAuthorizedViewsResponse`. Questo valore indica che si tratta della continuazione di una chiamata `SearchAuthorizedViews` precedente e che il sistema deve restituire la pagina di dati successiva.
  • FILTER: l'espressione di filtro per filtrare le visualizzazioni autorizzate elencate nella risposta. Puoi filtrare in base ai seguenti campi: `authorized_view_id`, `display_name`, `conversation_filter`, `create_time` e `update_time`. Puoi utilizzare espressioni e/o arbitrarie. Puoi utilizzare le espressioni regolari anche per i campi stringa.
    • Esempio: display_name = "My View"
    • Esempio: conversation_filter =~ ".*agent-1.*"
    • Esempio: create_time > "2022-01-01T00:00:00Z"
    • Esempio: display_name =~ ".*View.*"
    • Esempio: create_time > "2022-01-01T00:00:00Z" AND create_time <= "2022-01-02T00:00:00Z"
  • ORDER_BY: L'espressione di ordinamento per ordinare le viste autorizzate elencate nella risposta.
    • Esempio: create_time
    • Esempio: update_time desc

Metodo HTTP e 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

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

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

Conversazione autorizzata

Una conversazione autorizzata rappresenta una conversazione a cui si accede utilizzando una vista autorizzata.

Per un elenco completo dei metodi supportati, consulta la documentazione di riferimento sui metodi di conversazione autorizzati.

Ottenere una conversazione autorizzata

REST

Per ottenere una conversazione autorizzata è necessaria l'autorizzazione contactcenterinsights.authorizedConversations.get.

Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:

  • PROJECT_ID: l'ID progetto Google Cloud .
  • LOCATION_ID: la posizione del progetto
  • AUTHORIZED_VIEW_SET_ID: l'ID del set di viste autorizzate.
  • AUTHORIZED_VIEW_ID: l'ID della vista autorizzata.
  • CONVERSATION_ID: l'ID della conversazione.

Metodo HTTP e 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

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

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

Elencare le conversazioni autorizzate

REST

Per elencare le conversazioni autorizzate è necessaria l'autorizzazione contactcenterinsights.authorizedConversations.list.

Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:

  • PROJECT_ID: l'ID progetto Google Cloud .
  • LOCATION_ID: la posizione del progetto.
  • AUTHORIZED_VIEW_SET_ID: l'ID del set di viste autorizzate.
  • AUTHORIZED_VIEW_ID: l'ID della vista autorizzata.
  • PAGE_SIZE: il numero di conversazioni da restituire per pagina.

Metodo HTTP e 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

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

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

Operazioni autorizzate

Per un elenco completo dei metodi supportati, consulta la documentazione di riferimento sui metodi delle operazioni autorizzate.

Recuperare un'operazione autorizzata

REST

Per ottenere un'operazione autorizzata è necessaria l'autorizzazione contactcenterinsights.authorizedOperations.get.

Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:

  • PROJECT_ID: l'ID progetto Google Cloud .
  • LOCATION: la posizione dei dati di Customer Experience Insights.
  • OPERATION_ID: l'ID della conversazione che vuoi analizzare. Questo valore è stato restituito quando hai creato l'analisi.

Metodo HTTP e URL: 

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

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

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

Elenca operazioni autorizzate

REST

Per elencare le operazioni autorizzate è necessaria l'autorizzazione contactcenterinsights.authorizedOperations.list.

Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:

  • PROJECT_ID: l'ID progetto Google Cloud .
  • LOCATION: la posizione dei dati di Customer Experience Insights.
  • AUTHORIZED_VIEW_SET_ID: l'ID del set di viste autorizzate.
  • AUTHORIZED_VIEW_ID: l'ID della vista autorizzata.

Metodo HTTP e URL: 

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

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

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

Passaggi successivi