Usar as páginas conectadas na sua organização

Você pode acessar, analisar, visualizar e compartilhar bilhões de linhas de dados da sua planilha com as páginas conectadas, o conector de dados das Planilhas. Também é possível usar esse recurso para:

Colabore com parceiros, analistas ou outras partes interessadas em uma interface de planilha que você já conhece.
permitir que os usuários deleguem o acesso aos colaboradores;
garantir uma única fonte de análise de dados confiável sem exportações extras de CSV.
Analise dados em um perímetro que restringe o acesso com base em atributos, como o endereço IP do usuário e as informações do dispositivo.

Você pode fazer consultas nas páginas conectadas no BigQuery ou no Looker manualmente ou seguindo uma programação. As páginas salvam os resultados dessas consultas na sua planilha para que você os analise e compartilhe. Assista a estes tutoriais em vídeo para saber mais sobre como usar páginas conectadas com o BigQuery.

Você pode conferir os eventos de consulta das páginas conectadas em Eventos de registro do Drive.

Configurar o BigQuery para analisar dados

Abrir seção | Recolher tudo

Etapa 1: ativar o Google Cloud

Etapa 2: analisar as funções do IAM

Ações no Planilhas	Papel de IAM obrigatório no BigQuery	Permissões necessárias no Planilhas
Criar gráficos, tabelas dinâmicas, fórmulas ou extrações usando tabelas ou visualizações do BigQuery	bigquery.user ou bigquery.jobUser e bigquery.dataViewer	Editor
Ver gráficos, tabelas dinâmicas, fórmulas, extrações ou visualizações criadas com base nos dados do BigQuery	Nenhum	Editor ou leitor
Criar ou editar uma consulta personalizada do BigQuery	bigquery.user ou bigquery.jobUser e bigquery.dataViewer	Editor
Ver uma consulta personalizada do BigQuery	Nenhum	Editor ou leitor
Atualizar dados do BigQuery	bigquery.user ou bigquery.jobUser e bigquery.dataViewer	Editor

Etapa 3: atribuir funções do IAM

Etapa 4: (opcional) configurar o VPC Service Controls para permitir páginas conectadas

Permitir que os usuários deleguem o acesso às páginas conectadas para o BigQuery

Edições que oferecem suporte a este recurso: Enterprise Standard e Enterprise Plus; Education Standard e Education Plus; Enterprise Essentials e Enterprise Essentials Plus. Comparar sua edição

Você pode permitir que os usuários deleguem o acesso ao recurso páginas conectadas para o BigQuery para fazer colaborações com outros usuários para analisar dados e fazer consultas.

Para delegar o acesso, os usuários precisam compartilhar a página com o outro usuário. No entanto, não é possível delegar o acesso a uma página compartilhada publicamente com um link. É possível analisar o usuário que delega o acesso e o usuário que executa uma consulta em Eventos de registro do Drive ou Registros de auditoria do Cloud.

Ativar ou desativar o acesso delegado

Faça login com uma conta de administrador no Google Admin Console.
Se você não estiver usando uma conta de administrador, não vai conseguir acessar o Admin Console.
Acesse Menu Apps > Google Workspace > Drive e Documentos > Recursos e aplicativos.
Exige o privilégio de administrador Configurações do serviço.
Em Acesso delegado às páginas conectadas, clique em Editar .
(Opcional) Para aplicar a configuração apenas a alguns usuários, na lateral, selecione uma unidade organizacional (geralmente usada para departamentos) ou um grupo de configuração (avançado). Mostrar como
As configurações do grupo substituem as unidades organizacionais. Saiba mais
Em Configurações de delegação, marque ou desmarque Permitir que os usuários com acesso para editar uma planilha ativem a delegação para acessar o recurso páginas conectadas.
Se você estiver configurando uma unidade organizacional ou um grupo, selecione Somente usuários em uma unidade organizacional ou um grupo específico podem usar a delegação.
Se você quiser permitir que qualquer usuário com acesso à planilha delegue o acesso, selecione Qualquer usuário pode usar a delegação.
Essa opção inclui usuários fora da sua organização se eles tiverem acesso à página.
Clique em Salvar. Ou clique em Substituir em unidade organizacional.
Para restaurar depois o valor herdado, clique em Herdar (ou Cancelar configuração para um grupo).

Se você ativar a delegação, diga aos usuários que eles podem seguir estas etapas para delegar acesso a uma página.

Acessar os eventos de registro das páginas conectadas

Quando as páginas conectadas acessam dados do BigQuery e do Looker, as entradas são gravadas nos eventos de registro do Drive. As entradas também são gravadas em Registros de auditoria do Cloud para acesso ao BigQuery e em Explorar o histórico de atividades do sistema para acesso ao Looker. Eles mostram quem acessou os dados e quando.

Abrir seção | Recolher tudo

Analisar eventos de registro do Drive usando a API Reports

Saiba como analisar eventos de registro do Drive no Google Admin Console em Acessar dados de eventos de registro do Drive.

Com a API Reports, você pode conferir os eventos de consulta das páginas conectadas. O exemplo a seguir recupera todos os eventos do Drive pelo tipo de evento de consulta das páginas conectadas:

Acesse https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/drive?eventName=connected_sheets_query

A resposta JSON completa para esta chamada de API é mostrada na seção "Resposta JSON completa" abaixo, nesta página.

O usuário que iniciou a consulta é exibido como o ator.

"actor": { "email": "collaborator@example.com", "profileId": "ID de perfil exclusivo do Google Workspace do usuário" }

O app Planilhas oferece mais informações sobre a consulta executada como parâmetros.

"parameters": [ { "name": "execution_trigger", "value": "sheets_ui" }, { "name": "query_type", "value": "big_query" }, { "name": "data_connection_id", "value": "The Cloud project ID" }, { "name": "execution_id", "multiValue": [ "jobs/big_query_job_id" ] }, { "name": "delegating_principal", "value": "trix01@scary.docsplustesting.com" },

O campo execution_trigger é definido com base na forma como a consulta é invocada nas Planilhas:

Rótulo	Como a consulta é executada
sheets_ui	Manualmente: na IU do Planilhas
schedule	No recurso de atualização programada do Planilhas
api	Na API Sheets
apps-script	Com o Apps Script

O campo query_type é definido com base no conector de dados.

Rótulo	Conector de dados
big_query	BigQuery
looker	Looker

O campo data_connection_id é definido com base no ID da conexão de dados. No BigQuery, esse é o ID do projeto de faturamento. No Looker, esse é o URL da instância.

O execution_id é definido com base no ID da consulta executada.

Estrutura de valor	Entidade de consulta
jobs/<JOB_ID>	Job do BigQuery
datasets/<DATASET_NAME>/tables/<TABLE_NAME>	Tabela do BigQuery
query_tasks/<QUERY_TASK_ID>	Consulta do Looker

O endereço de e-mail do usuário com as credenciais usadas está disponível nos registros como o campo delegating_principal.

Resposta JSON completa

{ "kind": "admin#reports#activity", "id": { "time": "2022-10-26T17:33:51.929Z", "uniqueQualifier": "report’s unique ID", "applicationName": "drive", "customerId": "ABC123xyz" }, "actor": { "email": "collaborator@example.com", "profileId": "user’s unique Google Workspace profile ID" }, "events": [ { "type": "access", "name": "connected_sheets_query", "parameters": [ { "name": "execution_trigger", "value": "sheets_ui" }, { "name": "query_type", "value": "big_query" }, { "name": "data_connection_id", "value": "The Cloud project ID" }, { "name": "execution_id", "multiValue": [ "jobs/big_query_job_id" ] }, { "name": "doc_id", "value": "aBC-123-xYz" }, { "name": "doc_type", "value": "spreadsheet" }, { "name": "is_encrypted", "boolValue": false }, { "name": "doc_title", "value": "Document title" }, { "name": "visibility", "value": "shared_internally" }, { "name": "actor_is_collaborator_account", "boolValue": false }, { "name": "delegating_principal", "value": "owner@example.com" }, { "name": "owner", "value": "owner@example.com" }, { "name": "owner_is_shared_drive", "boolValue": false }, { "name": "owner_is_team_drive", "boolValue": false } ] } ] }

Analise os Registros de auditoria do Cloud usando o Explorador de registros para conexões do BigQuery

Cada planilha tem um ID exclusivo encontrado no URL da planilha. As entradas de registro no formato BigQueryAuditMetadata contêm o ID da planilha da qual a solicitação de acesso aos dados do BigQuery foi enviada.

É possível criar consultas para recuperar e analisar registros usando o Explorador de registros no console do Google Cloud. No Explorador de registros, digite o seguinte:

protoPayload.metadata.firstPartyAppMetadata.sheetsMetadata.docId != NULL_VALUE

Isso mostra as entradas com um ID de planilha não vazio, como neste exemplo:

metadata: {

@type: "type.googleapis.com/google.cloud.audit.BigQueryAuditMetadata"

firstPartyAppMetadata: {

sheetsMetadata: {

docId: "aBC-123_xYz"

}

As Planilhas adicionam informações aos jobs de consulta usando marcadores de job. Eles podem fornecer mais dados para você analisar, como mostrado neste exemplo:

jobInsertion: {

job: {

jobConfig: {

labels: {

sheets_access_type: "normal"

sheets_connector: "connected_sheets"

sheets_trigger: "user"

}

O valor do campo "sheets_trigger" é definido com base na forma como a consulta é invocada do Planilhas:

Rótulo	Como a consulta é executada
user	Manualmente: na IU do Planilhas
schedule	No recurso de atualização programada do Planilhas
api	Na API Sheets
apps-script	Com o Apps Script

Por exemplo, para encontrar entradas correspondentes a atualizações programadas das páginas conectadas, use a seguinte consulta no Explorador de registros:

protoPayload.metadata.firstPartyAppMetadata.sheetsMetadata.docId != NULL_VALUE

protoPayload.metadata.jobInsertion.job.jobConfig.labels.sheets_trigger = "schedule"

Se o acesso delegado tiver sido ativado, você encontrará o endereço de e-mail do usuário com as credenciais que foram usadas para executar a consulta nos registros. Também é possível encontrar o endereço de e-mail do usuário que acionou a consulta, conforme mostrado neste exemplo:

"authenticationInfo": {

"principalEmail": "proprietário@exemplo.com",

"serviceAccountDelegationInfo": [

{

"firstPartyPrincipal": {

"principalEmail": "colaborador@exemplo.com",

"serviceMetadata": {

"service": "sheets"

}

]

}

Observação: o campo serviceAccountDelegationInfo só estará presente se o acesso delegado tiver sido usado para a consulta. Nesse caso, a pessoa listada em principalEmail é a que delegou acesso.

Confira informações mais detalhadas em Como usar o Explorador de registros e Criar consultas no Explorador de registros.

Saiba mais sobre os registros de auditoria do BigQuery, os IDs de planilha, o formato BigQueryAuditMetadata, o SheetsMetadata, o compartilhamento de planilhas e a API Google Sheets.

Analisar a atividade do sistema do Looker