Referência do conector do Google Search Console

info

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 contém informações de referência para o conector gerenciado do Google Search Console, incluindo tabelas de origem compatíveis e esquemas de tabela de destino.

Tabelas de origem compatíveis

O conector do Google Search Console oferece suporte a 14 tabelas de origem no esquema de origem default, organizadas em duas categorias:

Tabelas de site : metadados sobre suas propriedades verificadas do Google Search Console e seus sitemaps. Completamente atualizado a cada execução do pipeline.
Tabelas de relatório de desempenho de pesquisa : métricas de clique, impressão, CTR e posição da API de analítica de pesquisa do Google Search Console. Cada tabela representa uma fatia de dimensão diferente dos mesmos dados subjacentes. Sincronizado incrementalmente por data ou hora.

nota

O conector do Google Search Console ainda não é compatível com tabelas de relatório de analítica de pesquisa personalizadas. Se o senhor precisar de uma combinação de dimensões não coberta pelas tabelas pré-criadas, entre em contato com a equipe da sua conta da Databricks.

Tabelas do site

Estas tabelas contêm metadados sobre suas propriedades verificadas do Google Search Console. Elas não contêm métricas de desempenho de pesquisa e são totalmente atualizadas a cada execução do pipeline.

Tabela de origem	Chave primária	Descrição	Modo de sincronização
`sites`	`site_url`	Propriedades de site verificadas registradas no Google Search Console, incluindo o nível de permissão.	Apenas refresh completo
`sitemaps`	`site_url`, `path`	Sitemaps enviados ao Google Search Console para cada propriedade verificada.	Apenas refresh completo

Tabela de origem	Chave primária	Descrição	Modo de sincronização
`sites`	`site_url`	Propriedades de site verificadas registradas no Google Search Console, incluindo o nível de permissão.	Apenas refresh completo
`sitemaps`	`site_url`, `path`	Sitemaps enviados ao Google Search Console para cada propriedade verificada.	Apenas refresh completo

Pesquisar tabelas de relatório de desempenho

Estas tabelas contêm dados de cliques, impressões, CTR e posição da API de analítica de pesquisa do Google Search Console. Todas as tabelas são sincronizadas de forma incremental.

Cada tabela retorna as mesmas quatro métricas (clicks, impressions, ctr e position), mas difere em quais dimensões os dados são agregados e qual aggregationType o Google aplica antes de retornar os resultados.

Entendendo o tipo de agregação

O aggregationType controla como o Google desduplica cliques quando um URL aparece em vários tipos de resultados de pesquisa. Como cada tipo desduplica de forma diferente, os totais de cliques em tabelas com diferentes tipos de agregação não correspondem entre si ou à interface do Google Search Console para o mesmo intervalo de datas. Para detalhes, consulte a documentação da API do Google Search Console.

Tabelas de desempenho de pesquisa diária

Estas tabelas agregam dados de desempenho de pesquisa por dia civil. O campo do cursor é date.

Tabela de origem	Dimensões	Tipo de agregação	Tipos de pesquisa	Chave primária	Campo do cursor
`search_analytics_all_fields`	data, país, dispositivo, página, query	Automático	web, notícias, imagem, vídeo	`site_url`, `date`, `country`, `device`, `page`, `query`, `search_type`	`date`
`search_analytics_by_country`	data, país	Automático	web, notícias, imagem, vídeo, descobrir, googleNews	`site_url`, `date`, `country`, `search_type`	`date`
`search_analytics_by_date`	Data	Automático	web, notícias, imagem, vídeo, descobrir, googleNews	`site_url`, `date`, `search_type`	`date`
`search_analytics_by_device`	data, dispositivo	Automático	web, notícias, imagem, vídeo, googleNews	`site_url`, `date`, `device`, `search_type`	`date`
`search_analytics_by_page`	data, página	Automático	web, notícias, imagem, vídeo, descobrir, googleNews	`site_url`, `date`, `page`, `search_type`	`date`
`search_analytics_by_query`	data, query	Automático	web, notícias, imagem, vídeo	`site_url`, `date`, `query`, `search_type`	`date`
`search_analytics_page_report`	data, país, dispositivo, página	Automático	web, notícias, imagem, vídeo, googleNews	`site_url`, `date`, `country`, `device`, `page`, `search_type`	`date`
`search_analytics_site_report_by_page`	data, país, dispositivo	porPágina	web, notícias, imagem, vídeo, googleNews	`site_url`, `date`, `country`, `device`, `search_type`	`date`
`search_analytics_site_report_by_site`	data, país, dispositivo	byProperty	web, notícias, imagem, vídeo	`site_url`, `date`, `country`, `device`, `search_type`	`date`

Tabela de origem	Dimensões	Tipo de agregação	Tipos de pesquisa	Chave primária	Campo do cursor
`search_analytics_all_fields`	data, país, dispositivo, página, query	Automático	web, notícias, imagem, vídeo	`site_url`, `date`, `country`, `device`, `page`, `query`, `search_type`	`date`
`search_analytics_by_country`	data, país	Automático	web, notícias, imagem, vídeo, descobrir, googleNews	`site_url`, `date`, `country`, `search_type`	`date`
`search_analytics_by_date`	Data	Automático	web, notícias, imagem, vídeo, descobrir, googleNews	`site_url`, `date`, `search_type`	`date`
`search_analytics_by_device`	data, dispositivo	Automático	web, notícias, imagem, vídeo, googleNews	`site_url`, `date`, `device`, `search_type`	`date`
`search_analytics_by_page`	data, página	Automático	web, notícias, imagem, vídeo, descobrir, googleNews	`site_url`, `date`, `page`, `search_type`	`date`
`search_analytics_by_query`	data, query	Automático	web, notícias, imagem, vídeo	`site_url`, `date`, `query`, `search_type`	`date`
`search_analytics_page_report`	data, país, dispositivo, página	Automático	web, notícias, imagem, vídeo, googleNews	`site_url`, `date`, `country`, `device`, `page`, `search_type`	`date`
`search_analytics_site_report_by_page`	data, país, dispositivo	porPágina	web, notícias, imagem, vídeo, googleNews	`site_url`, `date`, `country`, `device`, `search_type`	`date`
`search_analytics_site_report_by_site`	data, país, dispositivo	byProperty	web, notícias, imagem, vídeo	`site_url`, `date`, `country`, `device`, `search_type`	`date`

Tabelas de desempenho de pesquisa por hora

Estas tabelas agregam dados de desempenho de pesquisa por hora. Eles sempre usam o estado de dados hourly_all e não são afetados pela opção de conector data_state. O campo do cursor é hour. Os tipos de pesquisa disponíveis estão limitados a web e googleNews.

Tabela de origem	Dimensões	Tipo de agregação	Tipos de pesquisa	Chave primária	Campo do cursor
`hourly_search_analytics_page_report`	hora, país, dispositivo, página	Automático	web, googleNews	`site_url`, `hour`, `country`, `device`, `page`, `search_type`	`hour`
`hourly_search_analytics_site_report_by_page`	hora, país, dispositivo	porPágina	web, googleNews	`site_url`, `hour`, `country`, `device`, `search_type`	`hour`
`hourly_search_analytics_site_report_by_site`	hora, país, dispositivo	byProperty	web, googleNews	`site_url`, `hour`, `country`, `device`, `search_type`	`hour`

Tabela de origem	Dimensões	Tipo de agregação	Tipos de pesquisa	Chave primária	Campo do cursor
`hourly_search_analytics_page_report`	hora, país, dispositivo, página	Automático	web, googleNews	`site_url`, `hour`, `country`, `device`, `page`, `search_type`	`hour`
`hourly_search_analytics_site_report_by_page`	hora, país, dispositivo	porPágina	web, googleNews	`site_url`, `hour`, `country`, `device`, `search_type`	`hour`
`hourly_search_analytics_site_report_by_site`	hora, país, dispositivo	byProperty	web, googleNews	`site_url`, `hour`, `country`, `device`, `search_type`	`hour`

Opções de conector

O conector do Google Search Console é compatível com as seguintes opções de configuração. Consulte Exemplos para obter informações sobre o uso.

Opção	Tipo	Escopo	Obrigatório	Aplica-se a	Descrição
`site_urls`	array de strings JSON	Pipeline	Sim	Todas as tabelas	Um ou mais URLs de propriedade do Google Search Console verificados para ingerir. Cada URL deve ser uma propriedade que você verificou no Google Search Console (por exemplo, `https://example.com/` ou `sc-domain:example.com`).
`start_date`	String (`yyyy-MM-dd`)	Pipeline	Não	Todas as tabelas incrementais (`search_analytics_`, `hourly_search_analytics_`)	Data mais antiga a partir da qual ingerir dados, no formato `yyyy-MM-dd`. O default é de 500 dias antes da primeira sincronização. Não tem efeito em `sites` ou `sitemaps` (refresh completo).
`data_state`	String	Tabela	Não	Somente tabelas de desempenho de pesquisa diária (`search_analytics_*`)	Atualização dos dados para tabelas diárias de desempenho de pesquisa. `all` (default) inclui dados finalizados e recentes. `final` inclui apenas dados finalizados. Defina-o apenas em objetos `search_analytics_`. As tabelas `sites`, `sitemaps` e `hourly_search_analytics_` não aceitam esta opção.

Opção	Tipo	Escopo	Obrigatório	Aplica-se a	Descrição
`site_urls`	array de strings JSON	Pipeline	Sim	Todas as tabelas	Um ou mais URLs de propriedade do Google Search Console verificados para ingerir. Cada URL deve ser uma propriedade que você verificou no Google Search Console (por exemplo, `https://example.com/` ou `sc-domain:example.com`).
`start_date`	String (`yyyy-MM-dd`)	Pipeline	Não	Todas as tabelas incrementais (`search_analytics_`, `hourly_search_analytics_`)	Data mais antiga a partir da qual ingerir dados, no formato `yyyy-MM-dd`. O default é de 500 dias antes da primeira sincronização. Não tem efeito em `sites` ou `sitemaps` (refresh completo).
`data_state`	String	Tabela	Não	Somente tabelas de desempenho de pesquisa diária (`search_analytics_*`)	Atualização dos dados para tabelas diárias de desempenho de pesquisa. `all` (default) inclui dados finalizados e recentes. `final` inclui apenas dados finalizados. Defina-o apenas em objetos `search_analytics_`. As tabelas `sites`, `sitemaps` e `hourly_search_analytics_` não aceitam esta opção.

Esquemas de tabela de destino

`sites`

Chave primária: site_url Modo de sincronização: Apenas refresh completo

campo	Tipo de dados
`site_url`	`STRING`
`permission_level`	`STRING`

`sitemaps`

Key primária: site_url, path Modo de sincronização: Apenas refresh completo

campo	Tipo de dados
`site_url`	`STRING`
`path`	`STRING`
`last_submitted`	`STRING`
`is_pending`	`BOOLEAN`
`is_sitemaps_index`	`BOOLEAN`
`type`	`STRING`
`last_downloaded`	`STRING`
`warnings`	`BIGINT`
`errors`	`BIGINT`
`contents`	`ARRAY<STRUCT<type: STRING, submitted: BIGINT, indexed: BIGINT>>`

campo	Tipo de dados
`site_url`	`STRING`
`path`	`STRING`
`last_submitted`	`STRING`
`is_pending`	`BOOLEAN`
`is_sitemaps_index`	`BOOLEAN`
`type`	`STRING`
`last_downloaded`	`STRING`
`warnings`	`BIGINT`
`errors`	`BIGINT`
`contents`	`ARRAY<STRUCT<type: STRING, submitted: BIGINT, indexed: BIGINT>>`

`search_analytics_all_fields`

Dimensões: date, country, device, page, query Tipo de agregação: auto Tipos de pesquisa: web, news, image, video Chave primária: site_url, date, country, device, page, query, search_type Campo de cursor: date

campo	Tipo de dados
`site_url`	`STRING`
`search_type`	`STRING`
`date`	`STRING`
`country`	`STRING`
`device`	`STRING`
`page`	`STRING`
`query`	`STRING`
`clicks`	`DOUBLE`
`impressions`	`DOUBLE`
`ctr`	`DOUBLE`
`position`	`DOUBLE`
`ingestion_timestamp`	`TIMESTAMP`

`search_analytics_by_country`

Dimensões: date, country Tipo de agregação: auto Tipos de pesquisa: web, news, image, video, discover, googleNews Chave primária: site_url, date, country, search_type Campo de cursor: date

campo	Tipo de dados
`site_url`	`STRING`
`search_type`	`STRING`
`date`	`STRING`
`country`	`STRING`
`clicks`	`DOUBLE`
`impressions`	`DOUBLE`
`ctr`	`DOUBLE`
`position`	`DOUBLE`
`ingestion_timestamp`	`TIMESTAMP`

`search_analytics_by_date`

Dimensões: date Tipo de agregação: auto Tipos de pesquisa: web, news, image, video, discover, googleNews Chave primária: site_url, date, search_type Campo de cursor: date

campo	Tipo de dados
`site_url`	`STRING`
`search_type`	`STRING`
`date`	`STRING`
`clicks`	`DOUBLE`
`impressions`	`DOUBLE`
`ctr`	`DOUBLE`
`position`	`DOUBLE`
`ingestion_timestamp`	`TIMESTAMP`

`search_analytics_by_device`

Dimensões: date, device Tipo de agregação: auto Tipos de pesquisa: web, news, image, video, googleNews Primary key: site_url, date, device, search_type Campo de cursor: date

campo	Tipo de dados
`site_url`	`STRING`
`search_type`	`STRING`
`date`	`STRING`
`device`	`STRING`
`clicks`	`DOUBLE`
`impressions`	`DOUBLE`
`ctr`	`DOUBLE`
`position`	`DOUBLE`
`ingestion_timestamp`	`TIMESTAMP`

`search_analytics_by_page`

Dimensões: date, page Tipo de agregação: auto Tipos de pesquisa: web, news, image, video, discover, googleNews Chave primária: site_url, date, page, search_type Campo de cursor: date

campo	Tipo de dados
`site_url`	`STRING`
`search_type`	`STRING`
`date`	`STRING`
`page`	`STRING`
`clicks`	`DOUBLE`
`impressions`	`DOUBLE`
`ctr`	`DOUBLE`
`position`	`DOUBLE`
`ingestion_timestamp`	`TIMESTAMP`

`search_analytics_by_query`

Dimensões: date, query Tipo de agregação: auto Tipos de pesquisa: web, news, image, video Chave primária: site_url, date, query, search_type Campo de cursor: date

campo	Tipo de dados
`site_url`	`STRING`
`search_type`	`STRING`
`date`	`STRING`
`query`	`STRING`
`clicks`	`DOUBLE`
`impressions`	`DOUBLE`
`ctr`	`DOUBLE`
`position`	`DOUBLE`
`ingestion_timestamp`	`TIMESTAMP`

`search_analytics_page_report`

Dimensões: date, country, device, page Tipo de agregação: auto Tipos de pesquisa: web, news, image, video, googleNews Primary key: site_url, date, country, device, page, search_type Campo de cursor: date

campo	Tipo de dados
`site_url`	`STRING`
`search_type`	`STRING`
`date`	`STRING`
`country`	`STRING`
`device`	`STRING`
`page`	`STRING`
`clicks`	`DOUBLE`
`impressions`	`DOUBLE`
`ctr`	`DOUBLE`
`position`	`DOUBLE`
`ingestion_timestamp`	`TIMESTAMP`

`search_analytics_site_report_by_page`

Dimensões: date, country, device Tipo de agregação: byPage Tipos de pesquisa: web, news, image, video, googleNews Chave primária: site_url, date, country, device, search_type Campo do cursor: date

campo	Tipo de dados
`site_url`	`STRING`
`search_type`	`STRING`
`date`	`STRING`
`country`	`STRING`
`device`	`STRING`
`clicks`	`DOUBLE`
`impressions`	`DOUBLE`
`ctr`	`DOUBLE`
`position`	`DOUBLE`
`ingestion_timestamp`	`TIMESTAMP`

`search_analytics_site_report_by_site`

Dimensões: date, country, device Tipo de agregação: byProperty Tipos de pesquisa: web, news, image, video Primary key: site_url, date, country, device, search_type Campo de cursor: date

campo	Tipo de dados
`site_url`	`STRING`
`search_type`	`STRING`
`date`	`STRING`
`country`	`STRING`
`device`	`STRING`
`clicks`	`DOUBLE`
`impressions`	`DOUBLE`
`ctr`	`DOUBLE`
`position`	`DOUBLE`
`ingestion_timestamp`	`TIMESTAMP`

`hourly_search_analytics_page_report`

Dimensões: hour, country, device, page Tipo de agregação: auto Tipos de pesquisa: web, googleNews Primary key: site_url, hour, country, device, page, search_type Campo de cursor: hour

campo	Tipo de dados
`site_url`	`STRING`
`search_type`	`STRING`
`hour`	`STRING`
`country`	`STRING`
`device`	`STRING`
`page`	`STRING`
`clicks`	`DOUBLE`
`impressions`	`DOUBLE`
`ctr`	`DOUBLE`
`position`	`DOUBLE`
`ingestion_timestamp`	`TIMESTAMP`

`hourly_search_analytics_site_report_by_page`

Dimensões: hour, country, device Tipo de agregação: byPage Tipos de pesquisa: web, googleNews Chave primária: site_url, hour, country, device, search_type Campo do cursor: hour

campo	Tipo de dados
`site_url`	`STRING`
`search_type`	`STRING`
`hour`	`STRING`
`country`	`STRING`
`device`	`STRING`
`clicks`	`DOUBLE`
`impressions`	`DOUBLE`
`ctr`	`DOUBLE`
`position`	`DOUBLE`
`ingestion_timestamp`	`TIMESTAMP`

`hourly_search_analytics_site_report_by_site`

Dimensões: hour, country, device Tipo de agregação: byProperty Tipos de pesquisa: web, googleNews Primary key: site_url, hour, country, device, search_type Campo de cursor: hour

campo	Tipo de dados
`site_url`	`STRING`
`search_type`	`STRING`
`hour`	`STRING`
`country`	`STRING`
`device`	`STRING`
`clicks`	`DOUBLE`
`impressions`	`DOUBLE`
`ctr`	`DOUBLE`
`position`	`DOUBLE`
`ingestion_timestamp`	`TIMESTAMP`

Permissões OAuth necessárias

O conector do Google Search Console solicita o escopo https://www.googleapis.com/auth/webmasters.readonly. Este escopo concede acesso somente leitura a todos os dados do Google Search Console para propriedades às quais a identidade autenticada tem acesso.

Permissão	Obrigatório para
`https://www.googleapis.com/auth/webmasters.readonly`	Todas as tabelas

Tabelas de origem compatíveis​

Tabelas do site​

Pesquisar tabelas de relatório de desempenho​

Entendendo o tipo de agregação​

Tabelas de desempenho de pesquisa diária​

Tabelas de desempenho de pesquisa por hora​

Opções de conector​

Esquemas de tabela de destino​

sites​

sitemaps​

search_analytics_all_fields​

search_analytics_by_country​

search_analytics_by_date​

search_analytics_by_device​

search_analytics_by_page​

search_analytics_by_query​

search_analytics_page_report​

search_analytics_site_report_by_page​

search_analytics_site_report_by_site​

hourly_search_analytics_page_report​

hourly_search_analytics_site_report_by_page​

hourly_search_analytics_site_report_by_site​

Permissões OAuth necessárias​