Solucionar problemas do conector do Google Search Console
Beta
Esse recurso está em Beta. Os administradores do workspace podem controlar o acesso a esse recurso na página Pré-visualizações . Consulte Gerenciar prévias do Databricks.
Esta página descreve erros comuns que você pode encontrar com o conector gerenciado do Google Search Console e como resolvê-los.
Para obter orientações gerais de solução de problemas aplicáveis a todos os pipelines de ingestão gerenciados, consulte Solucionar problemas de pipelines de ingestão gerenciados.
Cota de QPS da Search analítica excedida
Mensagem de erro:
Google Search Console Search Analytics QPS quota exceeded. Retrying with backoff.
Causa: O pipeline enviou solicitações em excesso para a API de Search Analytics do Google Search Console dentro de um curto intervalo de tempo e atingiu o limite de cota por usuário e por segundo do Google.
soluções:
O conector tenta novamente de forma automática com recuo quando esse erro ocorre. Se o pipeline continuar a falhar, reduza o número de URLs de site ou tabelas ingeridas em um único pipeline, ou adicione um intervalo de agendamento maior entre as execuções do pipeline para reduzir o volume geral de solicitações de API.
Permissão negada (403)
Mensagem de erro:
O pipeline falha com uma resposta HTTP 403 e o erro é classificado como um erro de configuração.
Causa: A identidade autenticada (service account ou usuário OAuth) não tem permissões suficientes em uma ou mais propriedades do Google Search Console. Isso acontece quando a identidade não é um proprietário verificado ou um usuário com permissão total na propriedade, ou quando a delegação em todo o domínio está configurada incorretamente.
soluções:
Verifique se o email da account de serviço ou o usuário OAuth tem permissão total em cada URL do site especificado em site_urls. Consulte Configurar a autenticação no Google Search Console para obter os passos sobre como conceder acesso no Google Search Console.
Se você utilizar uma conta de serviço com delegação em todo o domínio, confirme que:
- O campo User Email to Impersonate na conexão usa uma conta que possui ou tem acesso total às propriedades.
- O escopo
https://www.googleapis.com/auth/webmasters.readonlyestá autorizado no Console de Administração do Google Workspace para a ID do cliente da account de serviço.
Para atualizar as credenciais, edite a conexão no Explorador de Catálogos. Consulte Criar uma conexão com o Google Search Console.
Access token expirado (401)
Mensagem de erro:
O pipeline falha com uma resposta HTTP 401.
Causa: O access token usado pela conexão expirou ou foi revogado.
soluções:
O conector automaticamente refresh os tokens OAuth quando recebe uma resposta 401. Se o erro persistir, o token de refresh pode ter sido revogado. Autentique-se novamente editando a conexão no Explorador de Catálogo e concluindo o fluxo de login mais uma vez. Consulte Criar uma conexão com o Google Search Console.
Para conexões de account de serviço, verifique se o JSON da key da account de serviço na conexão é válido e não foi excluído no Google Cloud Console. Faça o download de uma nova key, se necessário, e atualize a conexão.
Erros transitórios de servidor (500, 502, 503, 504)
Mensagem de erro:
O pipeline falha com uma resposta HTTP 500, 502, 503 ou 504.
Causa: A API do Google Search Console retornou um erro de servidor transitório. Esses erros são temporários e não estão relacionados às suas credenciais ou à configuração do pipeline.
soluções:
O conector tenta automaticamente repetir erros transitórios com backoff exponencial. Se o pipeline continuar a falhar após as tentativas, verifique o Google Workspace Status Dashboard para quaisquer incidentes em curso no Google Search Console. Se nenhum incidente for relatado, execute o pipeline manualmente novamente.