Référence du connecteur Google Search Console

info

Bêta

Cette fonctionnalité est en version bêta. Les administrateurs de Workspace peuvent contrôler l’accès à cette fonctionnalité depuis la page Aperçus . Consultez Gérer les aperçus Databricks.

Cette page contient des informations de référence pour le connecteur géré Google Search Console, y compris les tables sources prises en charge et les schémas de table de destination.

Tables sources prises en charge

Le connecteur Google Search Console prend en charge 14 tables sources sous le schéma source default, organisées en deux catégories :

• Tables de site : métadonnées concernant vos propriétés Google Search Console vérifiées et leurs sitemaps. Entièrement actualisé à chaque exécution du pipeline.
• Tables de rapport de performance de recherche : métriques de clic, d’impression, de CTR et de position provenant de l’API Google Search Console Search Analytics. Chaque table représente une tranche de dimension différente des mêmes données sous-jacentes. Synchronisé de manière incrémentielle par date ou par heure.

remarque

Le connecteur Google Search Console ne prend pas encore en charge les tables de rapport d’analytique de recherche personnalisées. Si vous avez besoin d’une combinaison de dimensions non couverte par les tables prédéfinies, contactez votre équipe Databricks.

Tables du site

Ces tables contiennent des métadonnées sur vos propriétés Google Search Console vérifiées. Elles ne contiennent pas de métriques de performance de recherche et sont entièrement actualisées à chaque exécution du pipeline.

Table source	Clé primaire	Description	Mode de synchronisation
sites	site_url	Propriétés de site vérifiées enregistrées dans Google Search Console, y compris le niveau d'autorisation.	Full refresh uniquement
sitemaps	site_url, path	Sitemaps soumis à la Google Search Console pour chaque propriété vérifiée.	Full refresh uniquement

Table source	Clé primaire	Description	Mode de synchronisation
sites	site_url	Propriétés de site vérifiées enregistrées dans Google Search Console, y compris le niveau d'autorisation.	Full refresh uniquement
sitemaps	site_url, path	Sitemaps soumis à la Google Search Console pour chaque propriété vérifiée.	Full refresh uniquement

Tables de rapport de performance de recherche

Ces tables contiennent des données de clic, d'impression, de CTR et de position provenant de l'API Google Search Console Search analytique. Toutes les tables sont synchronisées de manière incrémentielle.

Chaque table renvoie les quatre mêmes métriques (clicks, impressions, ctr et position), mais diffère selon les dimensions sur lesquelles les données sont agrégées et le aggregationType que Google applique avant de renvoyer les résultats.

Comprendre le type d’agrégation

Le aggregationType contrôle la manière dont Google déduplique les clics lorsqu’une URL apparaît dans plusieurs types de résultats de recherche. Comme chaque type déduplique différemment, les totaux de clics dans les tables avec des types d’agrégation différents ne correspondent pas entre eux ni à l’interface utilisateur de Google Search Console pour la même plage de dates. Pour plus de détails, consultez la documentation de l’API Google Search Console.

Tables de performance de recherche quotidienne

Ces tables agrègent les données de performance de recherche par jour calendaire. Le champ du curseur est date.

Table source	Dimensions	Type d'agrégation	Types de recherche	Clé primaire	Champ de curseur
search_analytics_all_fields	date, pays, appareil, page, query	auto	web, actualités, image, vidéo	site_url, date, country, device, page, query, search_type	date
search_analytics_by_country	date, pays	auto	web, news, image, video, discover, googleNews	site_url, date, country, search_type	date
search_analytics_by_date	Date	auto	web, news, image, video, discover, googleNews	site_url, date, search_type	date
search_analytics_by_device	date, appareil	auto	web, actualités, image, vidéo, googleNews	site_url, date, device, search_type	date
search_analytics_by_page	date, page	auto	web, news, image, video, discover, googleNews	site_url, date, page, search_type	date
search_analytics_by_query	date, query	auto	web, actualités, image, vidéo	site_url, date, query, search_type	date
search_analytics_page_report	date, pays, appareil, page	auto	web, actualités, image, vidéo, googleNews	site_url, date, country, device, page, search_type	date
search_analytics_site_report_by_page	date, pays, appareil	parPage	web, actualités, image, vidéo, googleNews	site_url, date, country, device, search_type	date
search_analytics_site_report_by_site	date, pays, appareil	byProperty	web, actualités, image, vidéo	site_url, date, country, device, search_type	date

Table source	Dimensions	Type d'agrégation	Types de recherche	Clé primaire	Champ de curseur
search_analytics_all_fields	date, pays, appareil, page, query	auto	web, actualités, image, vidéo	site_url, date, country, device, page, query, search_type	date
search_analytics_by_country	date, pays	auto	web, news, image, video, discover, googleNews	site_url, date, country, search_type	date
search_analytics_by_date	Date	auto	web, news, image, video, discover, googleNews	site_url, date, search_type	date
search_analytics_by_device	date, appareil	auto	web, actualités, image, vidéo, googleNews	site_url, date, device, search_type	date
search_analytics_by_page	date, page	auto	web, news, image, video, discover, googleNews	site_url, date, page, search_type	date
search_analytics_by_query	date, query	auto	web, actualités, image, vidéo	site_url, date, query, search_type	date
search_analytics_page_report	date, pays, appareil, page	auto	web, actualités, image, vidéo, googleNews	site_url, date, country, device, page, search_type	date
search_analytics_site_report_by_page	date, pays, appareil	parPage	web, actualités, image, vidéo, googleNews	site_url, date, country, device, search_type	date
search_analytics_site_report_by_site	date, pays, appareil	byProperty	web, actualités, image, vidéo	site_url, date, country, device, search_type	date

Tableaux des performances de recherche horaires

Ces tables agrègent les données de performance de recherche par heure. Ils utilisent toujours l'état de données hourly_all et ne sont pas affectés par l'option de connecteur data_state. Le champ de curseur est hour. Les types de recherche disponibles sont limités à web et googleNews.

Table source	Dimensions	Type d'agrégation	Types de recherche	Clé primaire	Champ de curseur
hourly_search_analytics_page_report	heure, pays, appareil, page	auto	web, googleNews	site_url, hour, country, device, page, search_type	hour
hourly_search_analytics_site_report_by_page	heure, pays, appareil	parPage	web, googleNews	site_url, hour, country, device, search_type	hour
hourly_search_analytics_site_report_by_site	heure, pays, appareil	byProperty	web, googleNews	site_url, hour, country, device, search_type	hour

Table source	Dimensions	Type d'agrégation	Types de recherche	Clé primaire	Champ de curseur
hourly_search_analytics_page_report	heure, pays, appareil, page	auto	web, googleNews	site_url, hour, country, device, page, search_type	hour
hourly_search_analytics_site_report_by_page	heure, pays, appareil	parPage	web, googleNews	site_url, hour, country, device, search_type	hour
hourly_search_analytics_site_report_by_site	heure, pays, appareil	byProperty	web, googleNews	site_url, hour, country, device, search_type	hour

Options du connecteur

Le connecteur Google Search Console prend en charge les options de configuration suivantes. Voir les exemples pour l’utilisation.

Option	Type	Périmètre	Obligatoire	S'applique à	Description
site_urls	Tableau de chaînes JSON	Pipeline	Oui	Toutes les tables	Une ou plusieurs URL de propriété Google Search Console vérifiées à ingérer. Chaque URL doit être une propriété que vous avez vérifiée dans Google Search Console (par exemple, https://example.com/ ou sc-domain:example.com).
start_date	Chaîne (yyyy-MM-dd)	Pipeline	Non	Toutes les tables incrémentielles (search_analytics_*, hourly_search_analytics_*)	Date la plus ancienne à partir de laquelle ingérer des données, au format yyyy-MM-dd. Default à 500 jours avant la première synchronisation. N’a aucun effet sur sites ou sitemaps (full refresh).
data_state	Chaîne	Table	Non	Tables de performance de recherche quotidienne uniquement (search_analytics_*)	Récence des données pour les tables de performances de recherche quotidiennes. all (default) inclut des données finalisées et récentes. final inclut uniquement des données finalisées. Définissez-le uniquement sur les objets search_analytics_*. Les tables sites, sitemaps et hourly_search_analytics_* n'acceptent pas cette option.

Option	Type	Périmètre	Obligatoire	S'applique à	Description
site_urls	Tableau de chaînes JSON	Pipeline	Oui	Toutes les tables	Une ou plusieurs URL de propriété Google Search Console vérifiées à ingérer. Chaque URL doit être une propriété que vous avez vérifiée dans Google Search Console (par exemple, https://example.com/ ou sc-domain:example.com).
start_date	Chaîne (yyyy-MM-dd)	Pipeline	Non	Toutes les tables incrémentielles (search_analytics_*, hourly_search_analytics_*)	Date la plus ancienne à partir de laquelle ingérer des données, au format yyyy-MM-dd. Default à 500 jours avant la première synchronisation. N’a aucun effet sur sites ou sitemaps (full refresh).
data_state	Chaîne	Table	Non	Tables de performance de recherche quotidienne uniquement (search_analytics_*)	Récence des données pour les tables de performances de recherche quotidiennes. all (default) inclut des données finalisées et récentes. final inclut uniquement des données finalisées. Définissez-le uniquement sur les objets search_analytics_*. Les tables sites, sitemaps et hourly_search_analytics_* n'acceptent pas cette option.

Schémas de table de destination

sites

Clé principale : site_url Mode de synchronisation : Full refresh uniquement

Champ	Type de données
site_url	STRING
permission_level	STRING

Champ	Type de données
site_url	STRING
permission_level	STRING

sitemaps

Clé primaire : site_url, path Mode de synchronisation : Full refresh only

Champ	Type de données
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>>

Champ	Type de données
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

Dimensions : date, country, device, page, query Type d’agrégation : auto Types de recherche : web, news, image, video Clé primaire : site_url, date, country, device, page, query, search_type Champ de curseur : date

Champ	Type de données
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

Champ	Type de données
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

Dimensions : date, country Type d’agrégation : auto Types de recherche : web, news, image, video, discover, googleNews Clé primaire : site_url, date, country, search_type Champ de curseur : date

Champ	Type de données
site_url	STRING
search_type	STRING
date	STRING
country	STRING
clicks	DOUBLE
impressions	DOUBLE
ctr	DOUBLE
position	DOUBLE
ingestion_timestamp	TIMESTAMP

Champ	Type de données
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

Dimensions : date Type d'agrégation : auto Types de recherche : web, news, image, video, discover, googleNews Clé primaire : site_url, date, search_type Champ de curseur : date

Champ	Type de données
site_url	STRING
search_type	STRING
date	STRING
clicks	DOUBLE
impressions	DOUBLE
ctr	DOUBLE
position	DOUBLE
ingestion_timestamp	TIMESTAMP

Champ	Type de données
site_url	STRING
search_type	STRING
date	STRING
clicks	DOUBLE
impressions	DOUBLE
ctr	DOUBLE
position	DOUBLE
ingestion_timestamp	TIMESTAMP

search_analytics_by_device

Dimensions : date, device Type d'agrégation : auto Types de recherche : web, news, image, video, googleNews Clé primaire : site_url, date, device, search_type Champ de curseur : date

Champ	Type de données
site_url	STRING
search_type	STRING
date	STRING
device	STRING
clicks	DOUBLE
impressions	DOUBLE
ctr	DOUBLE
position	DOUBLE
ingestion_timestamp	TIMESTAMP

Champ	Type de données
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

Dimensions : date, page Type d’agrégation : auto Types de recherche : web, news, image, video, discover, googleNews Clé primaire : site_url, date, page, search_type Champ de curseur : date

Champ	Type de données
site_url	STRING
search_type	STRING
date	STRING
page	STRING
clicks	DOUBLE
impressions	DOUBLE
ctr	DOUBLE
position	DOUBLE
ingestion_timestamp	TIMESTAMP

Champ	Type de données
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

Dimensions : date, query Type d'agrégat : auto Types de recherche : web, news, image, video Clé primaire : site_url, date, query, search_type Champ de curseur : date

Champ	Type de données
site_url	STRING
search_type	STRING
date	STRING
query	STRING
clicks	DOUBLE
impressions	DOUBLE
ctr	DOUBLE
position	DOUBLE
ingestion_timestamp	TIMESTAMP

Champ	Type de données
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

Dimensions : date, country, device, page Type d’agrégat : auto Types de recherche : web, news, image, video, googleNews Clé primaire : site_url, date, country, device, page, search_type Champ de curseur : date

Champ	Type de données
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

Champ	Type de données
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

Dimensions : date, country, device Type d'agrégat : byPage Types de recherche : web, news, image, video, googleNews Clé primaire : site_url, date, country, device, search_type Champ de curseur : date

Champ	Type de données
site_url	STRING
search_type	STRING
date	STRING
country	STRING
device	STRING
clicks	DOUBLE
impressions	DOUBLE
ctr	DOUBLE
position	DOUBLE
ingestion_timestamp	TIMESTAMP

Champ	Type de données
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

Dimensions : date, country, device Type d'agrégat : byProperty Types de recherche : web, news, image, video Clé primaire : site_url, date, country, device, search_type Champ de curseur : date

Champ	Type de données
site_url	STRING
search_type	STRING
date	STRING
country	STRING
device	STRING
clicks	DOUBLE
impressions	DOUBLE
ctr	DOUBLE
position	DOUBLE
ingestion_timestamp	TIMESTAMP

Champ	Type de données
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

Dimensions : hour, country, device, page Type d’agrégat : auto Types de recherche : web, googleNews Clé primaire : site_url, hour, country, device, page, search_type Champ de curseur : hour

Champ	Type de données
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

Champ	Type de données
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

Dimensions : hour, country, device Type d'agrégation : byPage Types de recherche : web, googleNews Clé primaire : site_url, hour, country, device, search_type Champ de curseur : hour

Champ	Type de données
site_url	STRING
search_type	STRING
hour	STRING
country	STRING
device	STRING
clicks	DOUBLE
impressions	DOUBLE
ctr	DOUBLE
position	DOUBLE
ingestion_timestamp	TIMESTAMP

Champ	Type de données
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

Dimensions : hour, country, device Type d'agrégation : byProperty Types de recherche : web, googleNews Clé primaire : site_url, hour, country, device, search_type Champ de curseur : hour

Champ	Type de données
site_url	STRING
search_type	STRING
hour	STRING
country	STRING
device	STRING
clicks	DOUBLE
impressions	DOUBLE
ctr	DOUBLE
position	DOUBLE
ingestion_timestamp	TIMESTAMP

Champ	Type de données
site_url	STRING
search_type	STRING
hour	STRING
country	STRING
device	STRING
clicks	DOUBLE
impressions	DOUBLE
ctr	DOUBLE
position	DOUBLE
ingestion_timestamp	TIMESTAMP

Autorisations OAuth requises

Le connecteur Google Search Console demande la portée https://www.googleapis.com/auth/webmasters.readonly. Cette portée accorde un accès en lecture seule à toutes les données Google Search Console pour les propriétés auxquelles l’identité authentifiée a accès.

Autorisation	Requis pour
https://www.googleapis.com/auth/webmasters.readonly	Toutes les tables

Autorisation	Requis pour
https://www.googleapis.com/auth/webmasters.readonly	Toutes les tables