Usa vistas autorizadas

Puedes usar las vistas autorizadas para recuperar datos de conversaciones, realizar análisis o editar etiquetas de comentarios. No puedes usar vistas autorizadas para editar o importar datos de conversaciones, entrenar modelos de temas ni crear cuadros de evaluación.

Selecciona una vista autorizada para acceder al alcance de datos específico que proporciona. Cada vista puede definir un alcance diferente. Solo verás los datos permitidos a través de la vista seleccionada.

Elige Sin vista para usar los permisos de Identity and Access Management (IAM) que se te asignaron. Este es el estado predeterminado.

Roles y permisos obligatorios

Para usar vistas autorizadas, necesitas los siguientes permisos de IAM:

Permisos para acceder al proyecto

Los administradores y los agentes requieren acceso de lectura al proyecto resourcemanager.projects.get para interactuar con la consola.

Usa roles/browser para otorgar a los administradores y agentes un nivel de acceso básico. Consulta la documentación sobre el control de acceso a nivel del proyecto para obtener más detalles.

Permisos de vista autorizada

Otorga los siguientes permisos en vistas autorizadas específicas con los métodos SetIamPolicy. Consulta los recursos de vistas autorizadas para obtener más detalles.

Los usuarios autorizados de la vista solo necesitan el permiso contactcenterinsights.authorizedViews.get y los permisos authorized correspondientes para los recursos a los que pueden acceder.

Permisos para conversaciones autorizadas

Permiso Descripción
contactcenterinsights.authorizedConversations.get Usa una vista autorizada para obtener una conversación.
contactcenterinsights.authorizedConversations.list Usa una vista autorizada para enumerar conversaciones.

Permisos para operaciones autorizadas

Permiso Descripción
contactcenterinsights.authorizedOperations.get Usa una vista autorizada para obtener una operación.
contactcenterinsights.authorizedOperations.list Usa una vista autorizada para enumerar las operaciones.

Funciones predefinidas

Los siguientes roles predefinidos de IAM proporcionan los permisos necesarios:

Rol Descripción
roles/contactcenterinsights.authorizeEditor Proporciona acceso de lectura y escritura a todos los recursos autorizados de Customer Experience Insights.
roles/contactcenterinsights.authorizedViewer Proporciona acceso completo a todos los recursos autorizados de Customer Experience Insights.

Cómo buscar tus vistas autorizadas

REST

Recupera todas las vistas autorizadas a las que tienes acceso.

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

  • PROJECT_ID: Es el ID del proyecto de Google Cloud .
  • LOCATION: Es la ubicación de tus datos de Customer Experience Insights.
  • AUTHORIZED_VIEW_SET_ID: Es un identificador definido por el usuario para el conjunto de vistas autorizado o el comodín "-".
  • PAGE_SIZE: Es la cantidad máxima de vistas que se devolverán en la respuesta. Si el valor es cero, el servicio seleccionará un tamaño predeterminado. Es posible que una llamada devuelva menos objetos de los que se solicitaron. Un valor de `next_page_token` no vacío en la respuesta indica que hay más datos disponibles.
  • PAGE_TOKEN: Es el valor que devolvió la última `SearchAuthorizedViewsResponse`. Este valor indica que se trata de una continuación de una llamada anterior a `SearchAuthorizedViews` y que el sistema debe devolver la siguiente página de datos.
  • FILTER: Es la expresión de filtro para filtrar las vistas autorizadas que se enumeran en la respuesta. Puedes filtrar por los siguientes campos: "authorized_view_id", "display_name", "conversation_filter", "create_time" y "update_time". Puedes usar expresiones arbitrarias o AND. También puedes usar expresiones regulares para los campos de cadena.
    • Ejemplo: display_name = "My View"
    • Ejemplo: conversation_filter =~ ".*agent-1.*"
    • Ejemplo: create_time > "2022-01-01T00:00:00Z"
    • Ejemplo: display_name =~ ".*View.*"
    • Ejemplo: create_time > "2022-01-01T00:00:00Z" AND create_time <= "2022-01-02T00:00:00Z"
  • ORDER_BY: Es la expresión de ordenamiento para ordenar las vistas autorizadas que se enumeran en la respuesta.
    • Ejemplo: create_time
    • Ejemplo: update_time desc

Método HTTP y 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

Para enviar tu solicitud, expande una de estas opciones:

Deberías recibir una respuesta JSON similar a la que se muestra a continuación:

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

Conversación autorizada

Una conversación autorizada representa una conversación cuando se accede a ella a través de una vista autorizada.

Para obtener una lista completa de los métodos admitidos, consulta la documentación de referencia de los métodos de conversación autorizados.

Obtén una conversación autorizada

REST

Para obtener una conversación autorizada, se requiere el permiso contactcenterinsights.authorizedConversations.get.

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

  • PROJECT_ID: Es el ID del proyecto de Google Cloud .
  • LOCATION_ID: La ubicación de tu proyecto
  • AUTHORIZED_VIEW_SET_ID: Es el ID del conjunto de vistas autorizado.
  • AUTHORIZED_VIEW_ID: Es el ID de la vista autorizada.
  • CONVERSATION_ID: Es el ID de la conversación.

Método HTTP y 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

Para enviar tu solicitud, expande una de estas opciones:

Deberías recibir una respuesta JSON similar a la que se muestra a continuación:

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

Enumera las conversaciones autorizadas

REST

Para mostrar las conversaciones autorizadas, se requiere el permiso contactcenterinsights.authorizedConversations.list.

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

  • PROJECT_ID: Es el ID del proyecto de Google Cloud .
  • LOCATION_ID: Es la ubicación de tu proyecto.
  • AUTHORIZED_VIEW_SET_ID: Es el ID del conjunto de vistas autorizado.
  • AUTHORIZED_VIEW_ID: Es el ID de la vista autorizada.
  • PAGE_SIZE: Es la cantidad de conversaciones que se mostrarán por página.

Método HTTP y 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

Para enviar tu solicitud, expande una de estas opciones:

Deberías recibir una respuesta JSON similar a la que se muestra a continuación:

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

Operaciones autorizadas

Para obtener una lista completa de los métodos admitidos, consulta la documentación de referencia de los métodos de operaciones autorizadas.

Obtén una operación autorizada

REST

Para obtener una operación autorizada, se requiere el permiso contactcenterinsights.authorizedOperations.get.

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

  • PROJECT_ID: Es el ID del proyecto de Google Cloud .
  • LOCATION: Es la ubicación de tus datos de Customer Experience Insights.
  • OPERATION_ID: Es el ID de la conversación que deseas analizar. Este valor se devolvió cuando creaste el análisis.

Método HTTP y URL: 

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

Para enviar tu solicitud, expande una de estas opciones:

Deberías recibir una respuesta JSON similar a la que se muestra a continuación:

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

Enumera las operaciones autorizadas

REST

Para enumerar las operaciones autorizadas, se requiere el permiso contactcenterinsights.authorizedOperations.list.

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

  • PROJECT_ID: Es el ID del proyecto de Google Cloud .
  • LOCATION: Es la ubicación de tus datos de Customer Experience Insights.
  • AUTHORIZED_VIEW_SET_ID: Es el ID del conjunto de vistas autorizado.
  • AUTHORIZED_VIEW_ID: Es el ID de la vista autorizada.

Método HTTP y URL: 

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

Para enviar tu solicitud, expande una de estas opciones:

Deberías recibir una respuesta JSON similar a la que se muestra a continuación:

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

Próximos pasos