/
/

Como detectar falhas na cobertura de backup no Google Workspace usando o Admin Console e APIs

por Team Ninja
How to Detect Backup Coverage Gaps in Google Workspace Using Admin Console and APIs blog banner image

Resumo instantâneo

Esta postagem do blog NinjaOne oferece uma lista abrangente de comandos CMD básicos e um mergulho profundo nos comandos do Windows, com +70 comandos CMD essenciais para usuários iniciantes e avançados. Explicamos sobre comandos práticos de prompt de comando para gerenciamento de arquivos, navegação em diretórios, solução de problemas de rede, operações de disco e automação, tudo com exemplos reais para maximizar a produtividade. Seja para aprender comandos básicos CMD ou dominar ferramentas avançadas de CLI do Windows, este guia ajuda você a usar o prompt de comando com mais eficiência.

Pontos principais

  • Identifique as causas mais comuns de falhas: entre elas estão onboarding e offboarding de usuários, mudanças de UO ou grupo e políticas de backup mal configuradas.
  • Crie uma referência de usuários: exporte o diretório completo de usuários do Google Workspace e compare com o inventário do backup SaaS.
  • Audite políticas de UO e de grupo: elas costumam criar pontos cegos de backup, principalmente quando novos usuários ou grupos entram sem atualização das atribuições de backup.
  • Entenda os limites do Vault: o Google Vault oferece retenção de dados e retenção legal, mas não é uma solução de backup.
  • Automatize a detecção de falhas: use a Admin SDK Directory API e a Reports API do Google para identificar automaticamente usuários sem cobertura e atividades de exclusão arriscadas em escala.
  • Documente e governe a correção: registre as falhas de backup em um registro centralizado para manter a correção consistente nos ambientes Google Workspace.

Um processo estruturado e abrangente para detectar falhas na cobertura de backup do Google traz muitos benefícios para MSPs. Antes de tudo, garante que cada usuário licenciado e cada conjunto de dados esteja protegido. Fica mais fácil para os administradores

  • identificar configurações incorretas ou pontos cegos de cobertura logo no início,
  • documentar resultados para auditorias e QBRs e
  • justificar etapas de correção ou novos investimentos em backup SaaS.

Proteja cada usuário e cada carga de trabalho com uma solução confiável de backup SaaS.

Comece agora seu teste grátis do NinjaOne SaaS Backup

Como verificar os dados de backup do Google

📌 Pré-requisitos:

  • É preciso ter a função de Super Admin ou ser um admin delegado com acesso ao Google Admin Console e ao Vault.
  • Para usar APIs, você precisa de um projeto do Google Cloud com as APIs Admin SDK Directory e Reports ativadas.
  • São necessárias credenciais OAuth 2.0 para acesso delegado.
  • Tenha um inventário de referência de usuários, UOs e grupos para a verificação cruzada.
  • Tenha uma planilha ou plataforma de documentação pronta para registrar as descobertas.

📌 Estratégias de implantação recomendadas:

Clique para escolher um método💻
Melhor para usuários individuais
💻💻💻
Melhor para empresas
Método 1: validar a cobertura de usuários pelo Admin Console✓
Método 2: verificar exceções por unidade organizacional (UO) e por grupo✓
Método 3: revisar as políticas de retenção do Vault✓
Método 4: usar a Admin SDK Directory API para detectar contas sem cobertura✓
Método 5: usar a Reports API para identificar riscos de exclusão✓
Método 6: documentar as descobertas e montar um registro de falhas✓

Para uma visão geral rápida, assista ao nosso guia em vídeo Como detectar falhas na cobertura de backup no Google Workspace usando o Admin Console e APIs

Método 1: validar a cobertura de usuários pelo Admin Console

  1. Acesse o Google Admin Console.
  2. Vá em Menu > Diretório > Usuários.
  3. Clique no ícone Download no canto superior direito.
  4. Selecione Todos os usuários.
  5. Você poderá baixar os dados como arquivo CSV ou enviar as informações para o Planilhas Google. Escolha a opção que melhor atende às suas preferências e às políticas da organização.
  6. Compare os dados do Google Console com a lista do seu backup SaaS.
  7. Marque qualquer entrada divergente ou ausente. Se não estiver no arquivo do backup SaaS, significa que o usuário não está devidamente vinculado a uma política de backup.

Método 2: verificar exceções por unidade organizacional (UO) e por grupo

  1. Revise as diferentes unidades organizacionais e os grupos usados para aplicar backup na sua organização.
  2. Confirme que todas as organizações estão cobertas e que todos os usuários estão vinculados a uma política de backup adequada.
  3. Se houver usuários ou grupos sem cobertura, marque-os imediatamente. Isso acontece quando a UO é nova ou quando os usuários foram movidos para um grupo recentemente.
  4. Garanta que as políticas de backup sejam aplicadas de forma consistente a todos os usuários, grupos e unidades organizacionais.

Método 3: revisar as políticas de retenção do Vault

  1. Abra o Google Vault.
  2. Vá em Retenção.
  3. Confirme que as regras de retenção do Gmail, Drive, Chat e Meet são aplicadas de forma consistente a todas as unidades organizacionais.
  4. Se as regras não estiverem consistentes, documente as falhas.
  5. Revise a documentação e ajuste cada configuração para que as regras valham igualmente em todas as unidades organizacionais.

Mais importante: lembre-se de que o Google Vault ajuda a reter dados para fins de conformidade e retenção legal, mas não substitui um backup SaaS de terceiros. O Vault não garante

  • restaurações de um momento específico,
  • recuperação granular nem
  • proteção contra configurações incorretas feitas por administradores.

Método 4: usar a Admin SDK Directory API para detectar contas sem cobertura

Também dá para usar o Windows PowerShell para consultar a SDK Directory API e encontrar falhas de cobertura. (Lembre-se: os tokens precisam ser gerados com OAuth 2.0 ou contas de serviço com delegação em todo o domínio.)

Veja um exemplo de script:

# Example PowerShell snippet using Google Admin SDK Directory API
$uri = "https://admin.googleapis.com/admin/directory/v1/users?customer=my_customer&maxResults=500"
$headers = @{ Authorization = "Bearer $AccessToken" }
$response = Invoke-RestMethod -Uri $uri -Headers $headers
$response.users | Select-Object primaryEmail, suspended, orgUnitPath

Substitua "Bearer $AccessToken" por um token de API válido.

Esse script conecta você ao Google Workspace pela Admin SDK API e mostra

  • uma lista de 500 usuários com os respectivos endereços de e-mail,
  • se estão suspensos e
  • a que unidades organizacionais pertencem.

Exporte os dados como arquivo CSV e compare com os dados das suas ferramentas de backup. Marque contas divergentes ou ausentes para ver se há usuários sem cobertura.

Método 5: usar a Reports API para identificar riscos de exclusão

Exclusões frequentes e ações de “Esvaziar lixeira” podem comprometer a capacidade de recuperação. Use a Reports API para identificar ações como essas com este script:

# === CONFIGURATION ===
$AccessToken = "<YOUR_ACCESS_TOKEN>" # Paste your OAuth token here
$Application = "admin" # 'admin' = Admin Console events
$EventName = "DELETE_USER" # Type of deletion event
$StartTime = (Get-Date).AddDays(-30).ToString("yyyy-MM-ddTHH:mm:ssZ") # Last 30 days
$OutputCsv = "C:\Reports\UserDeletions.csv"# === INITIALIZE ===
$uri = "https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/$Application?eventName=$EventName&startTime=$StartTime"
$headers = @{ Authorization = "Bearer $AccessToken" }$allEvents = @()
$pageToken = $nullWrite-Host "Fetching deletion events from Reports API..."do {
$fullUri = if ($pageToken) { "$uri&pageToken=$pageToken" } else { $uri }
try {
$response = Invoke-RestMethod -Uri $fullUri -Headers $headers -Method Get
} catch {
Write-Error "API call failed: $_"
break
}if ($response.items) {
foreach ($item in $response.items) {
$eventDetails = [PSCustomObject]@{
EventId = $item.id.uniqueQualifier
Time = $item.id.time
ActorEmail = $item.actor.email
ActorType = $item.actor.type
EventName = $item.events[0].name
TargetUser = ($item.events[0].parameters | Where-Object { $_.name -eq "USER_EMAIL" }).value
}
$allEvents += $eventDetails
}
}$pageToken = $response.nextPageToken
} while ($pageToken)# === EXPORT ===
if ($allEvents.Count -gt 0) {
$allEvents | Export-Csv -Path $OutputCsv -NoTypeInformation -Encoding UTF8
Write-Host "Export complete. $($allEvents.Count) deletion events saved to $OutputCsv"
} else {
Write-Host "No deletion events found."
}

Isso mostra todos os eventos de exclusão no seu Google Workspace. Documente os padrões e garanta que as regras do Vault ou a cobertura de backup contemplem essas situações.

Método 6: documentar as descobertas e montar um registro de falhas

Ao identificar uma falha, faça o seguinte:

  • Registre a carga de trabalho/serviço, o usuário ou a UO afetada, o problema a resolver e as etapas de correção.
  • Defina os responsáveis pela solução e estabeleça um prazo.
  • Guarde o registro em um documento compartilhado para discussões de governança e QBR.

Tabela-resumo de boas práticas para a cobertura de backup do Google Workspace

ComponenteValor entregue
Exportação da lista de usuários x lista de backupDetecta contas desprotegidas e permite tratá-las.
Revisão de políticas de UO e de grupoEvita configurações incorretas e garante que cada unidade organizacional e grupo tenha cobertura.
Verificação da retenção no VaultGarante que as regras do Google Vault estejam alinhadas às da organização.
Consultas à Directory APIDetecta automaticamente falhas no seu Google Workspace.
Auditoria com a Reports APIIdentifica tendências de exclusão arriscadas e dá a chance de agir sobre elas.
Registro de falhasAcompanha a correção e reforça a responsabilização.

Exemplo de fluxo de trabalho para detecção diária de falhas

  1. Implante um script que puxe a lista de usuários pela Admin SDK Directory API.
  2. Compare essa lista com a do seu backup SaaS.
  3. Exporte as divergências para um arquivo CSV.
  4. Dispare a criação de tickets no software PSA para contas sem cobertura.
  5. Arquive os resultados semanalmente para auditorias.

Integração com NinjaOne para gerenciar a cobertura de backup

As ferramentas da NinjaOne ajudam a

  • executar scripts agendados para consultar as APIs Directory ou Reports,
  • gerar tickets automaticamente para contas sem cobertura,
  • armazenar registros de falhas no NinjaOne Docs para dar transparência ao cliente,
  • incluir a conformidade de cobertura nos painéis de QBR e
  • automatizar lembretes para auditorias trimestrais de cobertura.

Em especial, o NinjaOne Backup — que agora conta com recursos de backup SaaS para Google Workspace e Microsoft 365 — dá às equipes visibilidade centralizada de possíveis falhas na cobertura de backup, com alertas proativos e uma visão unificada de gerenciamento.

Faça o teste grátis do software ou assista a uma demonstração gratuita hoje mesmo.

Automatize a visibilidade da cobertura e os alertas de falhas no Google Workspace e no MS 365.

Veja como funciona o NinjaOne SaaS Backup

Proteja as contas de usuário com uma governança de SaaS adequada

No fim das contas, detectar falhas na cobertura de backup no Google Workspace da sua organização é essencial para ter certeza de que todas as contas e serviços usados estão protegidos. Para esse tipo de trabalho, você pode recorrer a

  • exportações do Google Admin Console,
  • verificações de retenção no Vault e
  • APIs do Admin SDK

para descobrir pontos cegos de forma sistemática e documentar os resultados para os clientes.

Links relacionados:

FAQs

A maioria das organizações deve revisar a cobertura de backup pelo menos a cada trimestre. Já MSPs e ambientes com muitas mudanças precisam de verificações semanais ou automatizadas para detectar falhas causadas por onboarding, offboarding ou mudanças de UO.

As falhas de backup costumam afetar

  • usuários suspensos ou arquivados,
  • Drives compartilhados,
  • contas criadas recentemente e
  • usuários movidos entre UOs ou grupos sem atualização das regras de backup.

Não. O Google Workspace tem recursos nativos limitados de retenção e recuperação, mas o Google não oferece um backup SaaS completo, com restaurações garantidas de um momento específico ou recuperação de longo prazo de usuários e dados excluídos.

Depois que o usuário é excluído em definitivo e os períodos de retenção se encerram, os dados podem ser irrecuperáveis, a menos que estejam protegidos por uma solução de backup de terceiros para o Google Workspace.

Recomendados para você

Pronto para simplificar as partes mais difíceis da TI?