Criar e gerenciar visualizações autorizadas

É possível realizar as seguintes operações administrativas em visualizações e conjuntos de visualizações autorizadas.

Permissões e papéis obrigatórios

Para criar e gerenciar conjuntos e visualizações autorizadas, você precisa das seguintes permissões do IAM.

Conjuntos de visualizações autorizadas:

Permissão Descrição
contactcenterinsights.authorizedViewSet.create Crie um conjunto de visualizações autorizadas.
contactcenterinsights.authorizedViewSet.get Recebe detalhes sobre um conjunto de visualizações autorizadas.
contactcenterinsights.authorizedViewSet.update Atualize um conjunto de visualizações autorizadas.
contactcenterinsights.authorizedViewSet.delete Exclui um conjunto de visualizações autorizadas.
contactcenterinsights.authorizedViewSet.list Lista conjuntos de visualizações autorizadas em um projeto.

Visualizações autorizadas:

Permissão Descrição
contactcenterinsights.authorizedView.create Crie uma visualização autorizada.
contactcenterinsights.authorizedView.get Recebe detalhes sobre uma visualização autorizada.
contactcenterinsights.authorizedView.update Atualiza uma visualização autorizada.
contactcenterinsights.authorizedView.delete Exclua uma visualização autorizada.

Para conceder acesso a visualizações autorizadas, você precisa das seguintes permissões:

Permissão Descrição
contactcenterinsights.authorizedView.setIamPolicy Defina a política do IAM em uma visualização autorizada.
contactcenterinsights.authorizedView.getIamPolicy Recebe a política do IAM em uma visualização autorizada.

Papéis predefinidos

Os seguintes papéis predefinidos do IAM fornecem as permissões necessárias:

Papel Descrição
roles/contactcenterinsights.editor Dá acesso de leitura e gravação a todos os recursos do Customer Experience Insights.
roles/contactcenterinsights.admin Dá acesso de leitura e gravação a todos os recursos do Customer Experience Insights.

Conjuntos de visualizações autorizadas

Os conjuntos de visualizações autorizadas agrupam e simplificam a concessão de permissões a várias visualizações autorizadas.

Criar um conjunto de visualizações autorizadas

REST

Para criar um conjunto de visualizações autorizadas, é preciso ter a permissão contactcenterinsights.authorizedViewSet.create.

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

  • PROJECT_ID: o ID do projeto do Google Cloud .
  • LOCATION: o local dos seus dados do Customer Experience Insights.
  • AUTHORIZED_VIEW_SET_ID: um identificador opcional definido pelo usuário para a visualização autorizada a ser criada. Esse valor precisa ter de 1 a 63 caracteres, começar e terminar com [a-z0-9] e pode conter traços (-) entre os caracteres.
  • DISPLAY_NAME: um nome descritivo para o conjunto de visualizações autorizadas.

Método HTTP e URL: 

POST https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/authorizedViewSets?authorized_view_set_id=AUTHORIZED_VIEW_SET_ID

Corpo JSON da solicitação:

{
  "displayName": "DISPLAY_NAME"
}

Para enviar a solicitação, expanda uma destas opções:

Você receberá uma resposta JSON semelhante a esta:

{
  "name": "projects/PROJECT_ID/locations/LOCATION/authorizedViewSets/AUTHORIZED_VIEW_SET_ID",
  "displayName": "DISPLAY_NAME",
  "createTime": "2022-01-01T00:00:00.000000Z",
  "updateTime": "2022-01-01T00:00:00.000000Z"
}

Ler um conjunto de visualizações autorizadas

REST

Para ler um conjunto de visualizações autorizadas, é necessário ter a permissão contactcenterinsights.authorizedViewSet.get.

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

  • PROJECT_ID: o ID do projeto do Google Cloud .
  • LOCATION: o local dos seus dados do Customer Experience Insights.
  • AUTHORIZED_VIEW_SET_ID: o identificador do conjunto de visualizações autorizadas.

Método HTTP e URL: 

GET https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/authorizedViewSets/AUTHORIZED_VIEW_SET_ID

Para enviar a solicitação, expanda uma destas opções:

Você receberá uma resposta JSON semelhante a esta:

{
  "name": "projects/PROJECT_ID/locations/LOCATION/authorizedViewSets/AUTHORIZED_VIEW_SET_ID",
  "displayName": "DISPLAY_NAME",
  "createTime": "2022-01-01T00:00:00.000000Z",
  "updateTime": "2022-01-01T00:00:00.000000Z"
}

Atualizar um conjunto de visualizações autorizadas

REST

Para atualizar um conjunto de visualizações autorizadas, é necessário ter a permissão contactcenterinsights.authorizedViewSet.update.

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

  • PROJECT_ID: o ID do projeto do Google Cloud .
  • LOCATION: o local dos seus dados do Customer Experience Insights.
  • AUTHORIZED_VIEW_SET_ID: o identificador do conjunto de visualizações autorizadas.
  • DISPLAY_NAME: um nome descritivo para o conjunto de visualizações autorizadas.
  • UPDATE_MASK: os campos a serem atualizados. Esse valor é uma lista de campos separada por vírgulas.
    • display_name

Método HTTP e URL: 

PATCH https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/authorizedViewSets/AUTHORIZED_VIEW_SET_ID?update_mask=display_name

Corpo JSON da solicitação:

{
  "displayName": "DISPLAY_NAME"
}

Para enviar a solicitação, expanda uma destas opções:

Você receberá uma resposta JSON semelhante a esta:

{
  "name": "projects/PROJECT_ID/locations/LOCATION/authorizedViewSets/AUTHORIZED_VIEW_SET_ID",
  "displayName": "DISPLAY_NAME",
  "createTime": "2022-01-01T00:00:00.000000Z",
  "updateTime": "2022-01-01T00:00:00.000000Z"
}

Excluir um conjunto de visualizações autorizadas

REST

A exclusão de um conjunto de visualizações autorizadas requer a permissão contactcenterinsights.authorizedViewSet.delete.

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

  • PROJECT_ID: o ID do projeto do Google Cloud .
  • LOCATION: o local dos seus dados do Customer Experience Insights.
  • AUTHORIZED_VIEW_SET_ID: o identificador do conjunto de visualizações autorizadas.

Método HTTP e URL: 

DELETE https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/authorizedViewSets/AUTHORIZED_VIEW_SET_ID

Para enviar a solicitação, expanda uma destas opções:

Você receberá uma resposta JSON semelhante a esta:

{}

Listar conjuntos de visualizações autorizadas

REST

Para listar conjuntos de visualizações autorizadas, é necessário ter a permissão contactcenterinsights.authorizedViewSet.list.

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

  • PROJECT_ID: o ID do projeto do Google Cloud .
  • LOCATION: o local dos seus dados do Customer Experience Insights.
  • PAGE_SIZE: o número máximo de conjuntos de visualizações autorizadas a serem retornados na resposta. Se o valor for zero, o serviço vai selecionar um tamanho padrão. Uma chamada pode retornar menos objetos do que o solicitado. Um `next_page_token` não vazio na resposta indica que há mais dados disponíveis.
  • PAGE_TOKEN: o valor retornado pela última "ListAuthorizedViewSetsResponse". Esse valor indica que esta é uma continuação de uma chamada "ListAuthorizedViewSets" anterior e que o sistema deve retornar a próxima página de dados.
  • FILTER: uma expressão para filtrar conjuntos de visualizações autorizadas. Por exemplo:
    • create_time > "2022-01-01T00:00:00Z"
    • update_time < "2022-01-02T00:00:00Z"
    • display_name = "My Authorized View Set"
    • display_name =~ "My.*"
    • create_time > "2022-01-01T00:00:00Z" AND display_name = "My Authorized View Set"
    • create_time > "2022-01-01T00:00:00Z" OR display_name = "My Authorized View Set"
  • ORDER_BY: uma expressão para ordenar os conjuntos de visualizações autorizadas listados na resposta. Por exemplo:
    • create_time
    • create_time desc
    • update_time
    • update_time desc
    • display_name
    • display_name desc

Método HTTP e URL:

GET https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/authorizedViewSets?page_size=PAGE_SIZE&page_token=PAGE_TOKEN&filter=FILTER&order_by=ORDER_BY

Para enviar a solicitação, expanda uma destas opções:

Você receberá uma resposta JSON semelhante a esta:

{
  "authorizedViewSets": [
    {
      "name": "projects/PROJECT_ID/locations/LOCATION/authorizedViewSets/AUTHORIZED_VIEW_SET_ID",
      "displayName": "My Authorized View Set",
      "createTime": "2022-01-01T00:00:00.000000Z",
      "updateTime": "2022-01-01T00:00:00.000000Z"
    },
    {
      "name": "projects/PROJECT_ID/locations/LOCATION/authorizedViewSets/AUTHORIZED_VIEW_SET_ID_2",
      "displayName": "Another Authorized View Set",
      "createTime": "2022-01-02T00:00:00.000000Z",
      "updateTime": "2022-01-02T00:00:00.000000Z"
    },
  ],
  "nextPageToken": "NEXT_PAGE_TOKEN"
}

Visualizações autorizadas

As visualizações autorizadas definem um número restrito de conversas e a função de um agente ou gerente nelas.

Criar uma visualização autorizada

REST

Para criar uma visualização autorizada, é preciso ter a permissão contactcenterinsights.authorizedView.create.

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

  • PROJECT_ID: o ID do projeto do Google Cloud .
  • LOCATION: o local dos seus dados do Customer Experience Insights.
  • AUTHORIZED_VIEW_SET_ID: o identificador do conjunto de visualizações autorizadas a que esta visualização autorizada pertence.
  • AUTHORIZED_VIEW_ID: um identificador opcional definido pelo usuário para a criação da visualização autorizada. Esse valor precisa ter de 1 a 63 caracteres, começar e terminar com [a-z0-9] e pode conter traços (-) entre os caracteres.
  • DISPLAY_NAME: um nome descritivo para o conjunto de visualizações autorizadas.
  • CONVERSATION_FILTER: o filtro a ser aplicado aos dados. Você pode usar os seguintes campos: "agent_id".
    • agent_id = "agent_123"
    • agent_id = "agent_123" OR agent_id = "agent_456"
    • quality_metadata.agent_info.agent_id: "agent_456"
    • quality_metadata.agent_info.teams: "team_123"

Método HTTP e URL: 

POST https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/authorizedViewSets/AUTHORIZED_VIEW_SET_ID/authorizedViews?authorized_view_id=AUTHORIZED_VIEW_ID

Corpo JSON da solicitação:

{
  "displayName": "DISPLAY_NAME",
  "conversation_filter": "CONVERSATION_FILTER"
}

Para enviar a solicitação, expanda uma destas opções:

Você receberá uma resposta JSON semelhante a esta:

{
  "name": "projects/PROJECT_ID/locations/LOCATION/authorizedViewSets/AUTHORIZED_VIEW_SET_ID/authorizedViews/AUTHORIZED_VIEW_ID",
  "displayName": "DISPLAY_NAME",
  "conversationFilter": "CONVERSATION_FILTER",
  "createTime": "2022-01-01T00:00:00.000000Z",
  "updateTime": "2022-01-01T00:00:00.000000Z"
}

Ler uma visualização autorizada

REST

Para ler uma visualização autorizada, é necessário ter a permissão contactcenterinsights.authorizedView.get.

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

  • PROJECT_ID: o ID do projeto do Google Cloud .
  • LOCATION: o local dos seus dados do Customer Experience Insights.
  • AUTHORIZED_VIEW_SET_ID: o identificador do conjunto de visualizações autorizadas.
  • AUTHORIZED_VIEW_ID: o identificador da visualização autorizada.

Método HTTP e URL: 

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

Para enviar a solicitação, expanda uma destas opções:

Você receberá uma resposta JSON semelhante a esta:

{
  "name": "projects/PROJECT_ID/locations/LOCATION/authorizedViewSets/AUTHORIZED_VIEW_SET_ID/authorizedViews/AUTHORIZED_VIEW_ID",
  "displayName": "DISPLAY_NAME",
  "conversationFilter": "CONVERSATION_FILTER",
  "createTime": "2022-01-01T00:00:00.000000Z",
  "updateTime": "2022-01-01T00:00:00.000000Z"
}

Atualizar uma visualização autorizada

REST

Para atualizar uma visualização autorizada, é preciso ter a permissão contactcenterinsights.authorizedView.update.

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

  • PROJECT_ID: o ID do projeto do Google Cloud .
  • LOCATION: o local dos seus dados do Customer Experience Insights.
  • AUTHORIZED_VIEW_SET_ID: o identificador do conjunto de visualizações autorizadas a que esta visualização autorizada pertence.
  • AUTHORIZED_VIEW_ID: o identificador da visualização autorizada a ser atualizada.
  • DISPLAY_NAME: um nome descritivo para o conjunto de visualizações autorizadas.
  • CONVERSATION_FILTER: o filtro a ser aplicado aos dados. Você pode usar os seguintes campos: "agent_id".
    • agent_id = "agent_123"
    • agent_id = "agent_123" OR agent_id = "agent_456"
    • quality_metadata.agent_info.agent_id: "agent_456"
    • quality_metadata.agent_info.teams: "team_123"
  • UPDATE_MASK: os campos a serem atualizados. Esse valor é uma lista de campos separada por vírgulas.
    • display_name
    • conversation_filter

Método HTTP e URL: 

PATCH https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/authorizedViewSets/AUTHORIZED_VIEW_SET_ID/authorizedViews/AUTHORIZED_VIEW_ID?update_mask=display_name,conversation_filter

Corpo JSON da solicitação:

{
  "displayName": "DISPLAY_NAME",
  "conversation_filter": "CONVERSATION_FILTER"
}

Para enviar a solicitação, expanda uma destas opções:

Você receberá uma resposta JSON semelhante a esta:

{
  "name": "projects/PROJECT_ID/locations/LOCATION/authorizedViewSets/AUTHORIZED_VIEW_SET_ID/authorizedViews/AUTHORIZED_VIEW_ID",
  "displayName": "DISPLAY_NAME",
  "conversationFilter": "CONVERSATION_FILTER",
  "createTime": "2022-01-01T00:00:00.000000Z",
  "updateTime": "2022-01-01T00:00:00.000000Z"
}

Excluir uma visualização autorizada

REST

Para excluir uma visualização autorizada, é necessário ter a permissão contactcenterinsights.authorizedView.delete.

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

  • PROJECT_ID: o ID do projeto do Google Cloud .
  • LOCATION: o local dos seus dados do Customer Experience Insights.
  • AUTHORIZED_VIEW_SET_ID: o identificador do conjunto de visualizações autorizadas.
  • AUTHORIZED_VIEW_ID: o identificador da visualização autorizada.

Método HTTP e URL: 

DELETE https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/authorizedViewSets/AUTHORIZED_VIEW_SET_ID/authorizedViews/AUTHORIZED_VIEW_ID

Para enviar a solicitação, expanda uma destas opções:

Você receberá uma resposta JSON semelhante a esta:

{}

Listar visualizações autorizadas

REST

Para listar conjuntos de visualizações autorizadas, é necessário ter a permissão contactcenterinsights.authorizedViews.list.

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

  • PROJECT_ID: o ID do projeto do Google Cloud .
  • LOCATION: o local dos seus dados do Customer Experience Insights.
  • AUTHORIZED_VIEW_SET_ID: um identificador definido pelo usuário para o conjunto de visualizações autorizadas.
  • PAGE_SIZE: o número máximo de visualizações a serem retornadas na resposta. Se o valor for zero, o serviço vai selecionar um tamanho padrão. Uma chamada pode retornar menos objetos do que o solicitado. Um `next_page_token` não vazio na resposta indica que há mais dados disponíveis.
  • PAGE_TOKEN: o valor retornado pela última "ListAuthorizedViewsResponse". Esse valor indica que esta é uma continuação de uma chamada "ListAuthorizedViews" anterior e que o sistema deve retornar a próxima página de dados.
  • FILTER: a expressão de filtro para filtrar as visualizações autorizadas listadas na resposta. É possível filtrar os seguintes campos: "authorized_view_id", "display_name", "conversation_filter", "create_time" e "update_time". Você pode usar expressões e/ou arbitrárias. Também é possível usar expressões regulares para campos de string.
    • Exemplo: display_name = "My View"
    • Exemplo: conversation_filter =~ ".*agent-1.*"
    • Exemplo: create_time > "2022-01-01T00:00:00Z"
    • Exemplo: display_name =~ ".*View.*"
    • Exemplo: create_time > "2022-01-01T00:00:00Z" AND create_time <= "2022-01-02T00:00:00Z"
  • ORDER_BY: a expressão de ordenação para ordenar as visualizações autorizadas listadas na resposta.
    • Exemplo: create_time
    • Exemplo: update_time desc

Método HTTP e URL: 

GET https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/authorizedViewSets/AUTHORIZED_VIEW_SET_ID/authorizedViews?page_size=PAGE_SIZE&page_token=PAGE_TOKEN&filter=FILTER&order_by=ORDER_BY

Para enviar a solicitação, expanda uma destas opções:

Você receberá uma resposta JSON semelhante a esta:

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

Definir política de IAM em uma visualização autorizada

REST

Para definir a política do IAM em uma visualização autorizada, é preciso ter a permissão contactcenterinsights.authorizedView.setIamPolicy.

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

  • PROJECT_ID: o ID do projeto do Google Cloud .
  • LOCATION: o local dos seus dados do Customer Experience Insights.
  • AUTHORIZED_VIEW_SET_ID: o identificador do conjunto de visualizações autorizadas.
  • AUTHORIZED_VIEW_ID: o identificador da visualização autorizada.
  • PRINCIPAL: o principal (usuário) a quem você quer conceder acesso.
  • ROLE: o papel a ser concedido ao usuário.

Método HTTP e URL: 

POST https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/authorizedViewSets/AUTHORIZED_VIEW_SET_ID/authorizedViews/AUTHORIZED_VIEW_ID:setIamPolicy

Corpo JSON da solicitação:

{
  "policy": {
    "bindings": [
      {
        "role": "roles/ROLE",
        "members": [
          "PRINCIPAL"
        ]
      }
    ]
  }
}

Para enviar a solicitação, expanda uma destas opções:

Você receberá uma resposta JSON semelhante a esta:

{
  "version": 1,
  "etag": "BwW...",
  "bindings": [
    {
      "role": "roles/ROLE",
      "members": [
        "PRINCIPAL"
      ]
    }
  ]
}

Ler a política do IAM em uma visualização autorizada

REST

Para ler a política do IAM em uma visualização autorizada, é preciso ter a permissão contactcenterinsights.authorizedView.getIamPolicy.

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

  • PROJECT_ID: o ID do projeto do Google Cloud .
  • LOCATION: o local dos seus dados do Customer Experience Insights.
  • AUTHORIZED_VIEW_SET_ID: o identificador do conjunto de visualizações autorizadas.
  • AUTHORIZED_VIEW_ID: o identificador da visualização autorizada.

Método HTTP e URL: 

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

Para enviar a solicitação, expanda uma destas opções:

Você receberá uma resposta JSON semelhante a esta:

{
  "version": 1,
  "etag": "BwW...",
  "bindings": [
    {
      "role": "roles/ROLE",
      "members": [
        "PRINCIPAL"
      ]
    }
  ]
}

Exemplo de configuração de organização

Este exemplo demonstra como configurar visualizações autorizadas para uma organização simplificada. Este exemplo usa a API REST para criar e gerenciar recursos em um projeto fictício chamado acme-corp.

A Acme tem a seguinte estrutura:

  • Alice:Alice é a administradora do projeto.
    • Beto:Beto é o gerente.
    • Carol:Carol é uma agente.
    • Dave:Dave é um agente.

Cada usuário tem um identificador principal associado ao endereço de e-mail.

  • O de Alice é user:admin.alice@acme.com.
  • O Bob's é user:manager.bob@acme.com.
  • O de Carol é user:agent.carol@acme.com.
  • O de Dave é user:agent.dave@acme.com.

Cada agente tem um agent_id que corresponde ao campo Conversation.agent_id das conversas.

  • O de Carol é agent-carol.
  • O de Dave é agent-dave.

Requisitos

Cada usuário precisa dos seguintes níveis de acesso:

  • Acesso de administrador:como administradora, Alice tem acesso total a todos os dados e recursos.
  • Acesso de gerente:como gerente, Bob pode criar, editar e ver conversas e análises das respectivas equipes.
  • Acesso do agente:como agentes, Carol e Dave só podem ver as conversas e análises de que participaram.

Etapa 1: conceder acesso ao projeto

Adicione todos os usuários ao projeto e conceda a eles roles/browser. Com essa função, eles podem ver o projeto e os recursos dele.

Conceder o papel de navegador do projeto aos usuários

O código a seguir ilustra como conceder a função de navegador a cada membro da Acme.

gcloud projects add-iam-policy-binding acme-corp \
    --member="user:admin.alice@acme.com" \
    --role="roles/browser"

gcloud projects add-iam-policy-binding acme-corp \
    --member="user:manager.bob@acme.com" \
    --role="roles/browser"

gcloud projects add-iam-policy-binding acme-corp \
    --member="user:agent.carol@acme.com" \
    --role="roles/browser"

gcloud projects add-iam-policy-binding acme-corp \
    --member="user:agent.dave@acme.com" \
    --role="roles/browser"

Para mais informações, consulte Conceder um único papel.

Também é possível usar os Grupos do Google para gerenciar o acesso ao projeto. Em vez de conceder permissões a usuários individuais, você pode conceder roles/browser a um grupo. Por exemplo, você pode criar um grupo chamado project-browsers@acme.com e adicionar Bob a ele. Em seguida, você pode conceder a função roles/browser a esse grupo. Para mais informações, consulte Grupos do Google.

Etapa 2: conceder permissões no nível do projeto a um administrador

Conceda o papel de administrador roles/contactcenterinsights.admin no nível do projeto. Por exemplo, Alice é a administradora da Acme, então ela teria acesso total a todos os recursos com essa função.

Conceder a função de administrador

O código a seguir ilustra como conceder a Alice a função de administrador:

gcloud projects add-iam-policy-binding acme-corp \
    --member="user:admin.alice@acme.com" \
    --role="roles/contactcenterinsights.admin"

Etapa 3: criar conjuntos de visualizações autorizadas

Crie dois conjuntos de visualizações autorizadas para agrupar as visualizações autorizadas de gerentes e agentes.

Criar um conjunto de visualizações autorizadas do editor

REST

Este exemplo cria um conjunto de visualizações autorizadas chamado editor-view-set para agrupar visualizações com permissões de administrador.

Método HTTP e URL: 

POST https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/authorizedViewSets?authorized_view_set_id=editor-view-set

Corpo JSON da solicitação:

{
  "displayName": "Editor View Set"
}

Para enviar a solicitação, expanda uma destas opções:

Você receberá uma resposta JSON semelhante a esta:

{
  "name": "projects/PROJECT_ID/locations/LOCATION/authorizedViewSets/editor-view-set",
  "displayName": "Editor View Set",
  "createTime": "2022-01-01T00:00:00.000000Z",
  "updateTime": "2022-01-01T00:00:00.000000Z"
}

Criar um conjunto de visualizações autorizadas do leitor

REST

Este exemplo cria um conjunto de visualizações autorizadas chamado viewer-view-set para agrupar visualizações com permissões de agente.

Método HTTP e URL: 

POST https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/authorizedViewSets?authorized_view_set_id=viewer-view-set

Corpo JSON da solicitação:

{
  "displayName": "Viewer View Set"
}

Para enviar a solicitação, expanda uma destas opções:

Você receberá uma resposta JSON semelhante a esta:

{
  "name": "projects/PROJECT_ID/locations/LOCATION/authorizedViewSets/viewer-view-set",
  "displayName": "Viewer View Set",
  "createTime": "2022-01-01T00:00:00.000000Z",
  "updateTime": "2022-01-01T00:00:00.000000Z"
}

Etapa 4: conceder permissões no nível do projeto aos conjuntos de visualizações autorizados

As visualizações autorizadas são recursos com identidades integradas e exigem permissões para acessar os dados do {product_name}. Para permitir que as visualizações autorizadas acessem conversas e operações, conceda a elas os seguintes papéis:

  • roles/contactcenterinsights.editor para todas as visualizações autorizadas no editor-view-set
  • roles/contactcenterinsights.viewer para todas as visualizações autorizadas no viewer-view-set

Para mais informações, consulte conceder ou revogar um papel.

Conceda o papel de editor a editor-view-set

Este exemplo concede roles/contactcenterinsights.editor a editor-view-set.

gcloud

gcloud projects add-iam-policy-binding PROJECT_ID \
    --member="principalSet://contactcenterinsights.googleapis.com/projects/PROJECT_NUMBER/type/AuthorizedView/ancestor.name/authorizedViewSets/editor-view-set" \
    --role="roles/contactcenterinsights.editor"

Conceda o papel de leitor a viewer-view-set

Este exemplo concede o papel roles/contactcenterinsights.viewer ao conjunto de visualizações autorizadas viewer-view-set.

gcloud

gcloud projects add-iam-policy-binding PROJECT_ID \
    --member="principalSet://contactcenterinsights.googleapis.com/projects/PROJECT_NUMBER/type/AuthorizedView/ancestor.name/authorizedViewSets/viewer-view-set" \
    --role="roles/contactcenterinsights.viewer"

Etapa 5: criar visualizações autorizadas

Crie uma visualização autorizada para cada gerente e agente e aplique os filtros adequados.

Criar uma visualização autorizada do gerente

REST

Este exemplo cria uma visualização autorizada com o ID bobs-editor-view que filtra conversas em agent_id = carol OR agent_id = dave.

Método HTTP e URL: 

POST https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/authorizedViews?authorized_view_id=bobsEditorView

Corpo JSON da solicitação:

{
  "displayName": "Bob's Editor View",
  "value": {
    "filter": "agent_id = \"agent-carol\" OR agent_id = \"agent-dave\""
  }
}

Para enviar a solicitação, expanda uma destas opções:

Você receberá uma resposta JSON semelhante a esta:

{
  "name": "projects/PROJECT_ID/locations/LOCATION/authorizedViews/bobs-editor-view",
  "displayName": "Bob's Editor View",
  "createTime": "2022-01-01T00:00:00.000000Z",
  "updateTime": "2022-01-01T00:00:00.000000Z",
  "conversationFilter":"agent_id = \"agent-carol\" OR agent_id = \"agent-dave\""
}

Conceder o papel de editor autorizado a um gerente

REST

Este exemplo concede roles/contactcenterinsights.authorizedEditor ao gerente da Acme, Bob, em bobs-editor-view.

Método HTTP e URL: 

POST https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/authorizedViewSets/editor-view-set/authorizedViews/bobs-editor-view:setIamPolicy

Corpo JSON da solicitação:

{
  "policy": {
    "bindings": [
      {
        "role": "roles/contactcenterinsights.editor",
        "members": [
          "user:manager.bob@acme.com"
        ]
      }
    ]
  }
}

Para enviar a solicitação, expanda uma destas opções:

Você receberá uma resposta JSON semelhante a esta:

{
  "version": 1,
  "etag": "BwW...",
  "bindings": [
    {
      "role": "roles/contactcenterinsights.editor",
      "members": [
        "user:manager.bob@acme.com"
      ]
    }
  ]
}

Criar uma visualização autorizada de um agente

REST

Este exemplo cria uma visualização autorizada para a agente da Acme chamada Carol. Essa visualização autorizada tem o ID carols-viewer-view, que filtra conversas para agent_id = agent-carol.

Método HTTP e URL: 

POST https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/authorizedViews?authorized_view_id=carols-viewer-view

Corpo JSON da solicitação:

{
  "displayName": "Carol's Viewer View",
  "value": {
    "filter": "agent_id = \"agent-carol\""
  }
}

Para enviar a solicitação, expanda uma destas opções:

Você receberá uma resposta JSON semelhante a esta:

{
  "name": "projects/PROJECT_ID/locations/LOCATION/authorizedViews/carols-viewer-view",
  "displayName": "Carol's Viewer View",
  "createTime": "2022-01-01T00:00:00.000000Z",
  "updateTime": "2022-01-01T00:00:00.000000Z",
  "conversationFilter": "agent_id = \"agent-carol\""
}

Conceder o papel de leitor autorizado a um agente

REST

Este exemplo concede roles/contactcenterinsights.authorizedViewer à Carol em carols-viewer-view.

Método HTTP e URL: 

POST https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/authorizedViewSets/viewer-view-set/authorizedViews/carols-viewer-view:setIamPolicy

Corpo JSON da solicitação:

{
  "policy": {
    "bindings": [
      {
        "role": "roles/contactcenterinsights.viewer",
        "members": [
          "user:agent.carol@acme.com"
        ]
      }
    ]
  }
}

Para enviar a solicitação, expanda uma destas opções:

Você receberá uma resposta JSON semelhante a esta:

{
  "version": 1,
  "etag": "BwW...",
  "bindings": [
    {
      "role": "roles/contactcenterinsights.viewer",
      "members": [
        "user:agent.carol@acme.com"
      ]
    }
  ]
}

Criar a visualização autorizada de outro agente

REST

Este exemplo cria uma visualização autorizada para o agente da Acme chamado Dave. Essa visualização autorizada tem o ID daves-viewer-view, que filtra conversas para agent_id = agent-dave.

Método HTTP e URL: 

POST https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/authorizedViews?authorized_view_id=daves-viewer-view

Corpo JSON da solicitação:

{
  "displayName": "Dave's Viewer View",
  "value": {
    "filter": "agent_id = \"agent-dave\""
  }
}

Para enviar a solicitação, expanda uma destas opções:

Você receberá uma resposta JSON semelhante a esta:

{
  "name": "projects/PROJECT_ID/locations/LOCATION/authorizedViews/daves-viewer-view",
  "displayName": "Dave's Viewer View",
  "createTime": "2022-01-01T00:00:00.000000Z",
  "updateTime": "2022-01-01T00:00:00.000000Z",
  "conversationFilter": "agent_id = \"agent-dave\""
}

Conceder o papel de leitor autorizado a outro agente

REST

Este exemplo concede roles/contactcenterinsights.authorizedViewer para Dave em daves-viewer-view.

Método HTTP e URL: 

POST https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/authorizedViewSets/viewer-view-set/authorizedViews/daves-viewer-view:setIamPolicy

Corpo JSON da solicitação:

{
  "policy": {
    "bindings": [
      {
        "role": "roles/contactcenterinsights.viewer",
        "members": [
          "user:agent.dave@acme.com"
        ]
      }
    ]
  }
}

Para enviar a solicitação, expanda uma destas opções:

Você receberá uma resposta JSON semelhante a esta:

{
  "version": 1,
  "etag": "BwW...",
  "bindings": [
    {
      "role": "roles/contactcenterinsights.viewer",
      "members": [
        "user:agent.dave@acme.com"
      ]
    }
  ]
}

A seguir