Référence du connecteur Google Search Console

info

Bêta

Cette fonctionnalité est en version bêta. Pour l’utiliser, un administrateur du workspace doit activer Lakeflow Connect for Google Search Console depuis la page Previews . Consultez Gérer les aperçus Databricks.

Le connecteur Google Search Console géré dans Lakeflow Connect prend en charge 15 tables source dans le schéma default : 2 tables de site, 12 tables de rapport préconstruites et une table custom_report. Les tables de site se synchronisent avec un refresh complet et les tables de rapport se synchronisent de manière incrémentielle. Le champ de curseur est date pour les tables de rapport quotidiennes et custom_report, ainsi que hour pour les tables de rapport horaires.

Tables sources prises en charge

Le connecteur Google Search Console prend en charge les tables sources suivantes, toutes sous le schéma source default. Les tables de site contiennent des métadonnées sur vos propriétés Google Search Console vérifiées. Chaque table de rapport exécute un rapport de performance de recherche via l’ API analytique et regroupe les résultats par un ensemble fixe de dimensions. Les tables de rapports préconstruites sont organisées par granularité temporelle :

• Tables du site
• Tables de rapport quotidiennes
• Tables de rapport horaire
• Table de rapport personnalisée

Pour connaître la définition de chaque dimension et métrique, consultez Analytique de recherche : query dans la documentation Google.

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 prédéfinies

Les tables de rapport préconstruites contiennent des données de clic, d’impression, de taux de clics (CTR) et de position provenant de l’API Google Search Console Search analytique. Toutes les tables de rapport préconstruites se synchronisent de façon 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 type d'agrégation appliqué par Google avant de renvoyer les résultats. Voir Type d'agrégation.

Tables de rapport quotidiennes

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

Tables de rapport horaires

Ces tables regroupent les données de performance de recherche par heure. Elles n'utilisent que l'état de données hourly_all et ne sont pas affectées 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

Table de rapport personnalisée

La table custom_report exécute un rapport quotidien avec les dimensions, les types de recherche et le type d’agrégation que vous spécifiez dans ses options de connecteur. Voir Rapports personnalisés.

Table source	Dimensions	Type d'agrégation	Types de recherche	Clé primaire	Champ de curseur
custom_report	date, ainsi que les valeurs de dimensions	La valeur de aggregation_type	Les valeurs de search_types	site_url, date, les valeurs de dimensions, et search_type	date

Table source	Dimensions	Type d'agrégation	Types de recherche	Clé primaire	Champ de curseur
custom_report	date, ainsi que les valeurs de dimensions	La valeur de aggregation_type	Les valeurs de search_types	site_url, date, les valeurs de dimensions, et search_type	date

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_*, custom_report)	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 performances de recherche quotidiennes (search_analytics_*) et custom_report	Fraîcheur des données des tables quotidiennes de performances de recherche et custom_report. all (default) comprend des données finalisées et fraîches. final comprend uniquement des données finalisées. Définissez cette option uniquement sur les objets search_analytics_* et custom_report. Les tables sites, sitemaps et hourly_search_analytics_* n’acceptent pas cette option.
dimensions	Tableau de chaînes JSON	Table	Oui	custom_report seulement	Les dimensions par lesquelles regrouper le rapport, par exemple '["country", "device"]'. Les valeurs autorisées sont date, country, device, page et query. Le connecteur inclut date même si vous ne le listez pas.
search_types	Tableau de chaînes JSON	Table	Oui	custom_report seulement	Types de recherche pour lesquels exécuter le rapport, par exemple '["web", "image"]'. Les valeurs autorisées sont web, image, video, news, discover et googleNews. Le connecteur exécute le rapport une fois pour chaque type de recherche et écrit le type de recherche dans la colonne search_type.
aggregation_type	Chaîne	Table	Non	custom_report seulement	Comment Google Search Console agrège les métriques. L'une des valeurs auto (default), byPage ou byProperty. Voir Type d'agrégation.

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_*, custom_report)	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 performances de recherche quotidiennes (search_analytics_*) et custom_report	Fraîcheur des données des tables quotidiennes de performances de recherche et custom_report. all (default) comprend des données finalisées et fraîches. final comprend uniquement des données finalisées. Définissez cette option uniquement sur les objets search_analytics_* et custom_report. Les tables sites, sitemaps et hourly_search_analytics_* n’acceptent pas cette option.
dimensions	Tableau de chaînes JSON	Table	Oui	custom_report seulement	Les dimensions par lesquelles regrouper le rapport, par exemple '["country", "device"]'. Les valeurs autorisées sont date, country, device, page et query. Le connecteur inclut date même si vous ne le listez pas.
search_types	Tableau de chaînes JSON	Table	Oui	custom_report seulement	Types de recherche pour lesquels exécuter le rapport, par exemple '["web", "image"]'. Les valeurs autorisées sont web, image, video, news, discover et googleNews. Le connecteur exécute le rapport une fois pour chaque type de recherche et écrit le type de recherche dans la colonne search_type.
aggregation_type	Chaîne	Table	Non	custom_report seulement	Comment Google Search Console agrège les métriques. L'une des valeurs auto (default), byPage ou byProperty. Voir Type d'agrégation.

Rapports personnalisés

Utilisez la table custom_report pour ingérer une combinaison de dimensions, de types de recherche et de type d'agrégation que les tables préconstruites ne couvrent pas. Chaque objet custom_report dans un pipeline exécute un rapport par rapport à chaque URL de site dans site_urls.

Le connecteur demande les dimensions dans dimensions, plus date si dimensions ne l'inclut pas déjà. Le rapport est agrégé par jour, donc la table custom_report ne prend pas en charge la dimension hour. Pour ingérer des données horaires, utilisez les tables de rapport horaire.

Pour ingérer plus d'un rapport personnalisé, ajoutez un objet custom_report pour chaque rapport, chacun avec un destination_table différent. Voir Ingérer un rapport personnalisé.

Type d’agrégation

L'option aggregation_type définit la façon dont Google Search Console agrège les métriques du rapport personnalisé. Chaque table de rapport préconstruite utilise un type d'agrégation fixe, listé dans sa ligne de table.

aggregation_type	Agrégation
auto	Google Search Console choisit l'agrégation. Il s'agit de la valeur default.
byPage	Agrège les métriques par page.
byProperty	Agrège les métriques par propriété. Ne prend pas en charge la dimension page ou les types de recherche discover et googleNews.

aggregation_type	Agrégation
auto	Google Search Console choisit l'agrégation. Il s'agit de la valeur default.
byPage	Agrège les métriques par page.
byProperty	Agrège les métriques par propriété. Ne prend pas en charge la dimension page ou les types de recherche discover et googleNews.

Étant donné que chaque type d'agrégation compte les clics différemment, les totaux de clics dans les tables avec des types d'agrégation différents ne correspondent pas les uns aux autres ni à l'interface utilisateur de Google Search Console pour la même plage de dates. Pour plus de détails, consultez aggregationType dans la documentation Google.

Schémas de table de destination

Chaque tableau de rapport, y compris custom_report, inclut les colonnes suivantes que le connecteur ajoute :

• site_url (STRING) : L’URL de la propriété Google Search Console d’où provient la ligne.
• search_type (STRING) : le type de recherche d'où provient la ligne.
• ingestion_timestamp (TIMESTAMP) : L'heure à laquelle le connecteur a ingéré la ligne.

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

custom_report

Dimensions : date, plus les valeurs de dimensions Type d’agrégation : La valeur de aggregation_type Types de recherche : Les valeurs de search_types Clé primaire : site_url, date, les valeurs de dimensions et search_type Champ curseur : date

Le tableau comprend les colonnes suivantes. Il comprend également une colonne STRING pour chacun des éléments country, device, page et query que vous répertoriez dans dimensions.

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

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