Connecteurs → Google Sheets (lecture)

Google Sheets (lecture)

OAuth 2.0Données

Lit une plage d'une feuille Google Sheets via OAuth2 (lecture seule). Chaque ligne de la plage est mappée par position de colonne vers la forme de données de l'app.

Invariant : un descripteur ne porte que des clés de champ (fields[].key). Les valeurs de secrets sont résolues à l'exécution par vault.get(appId, connectorId, key) — jamais committées.

Authentification

Champs déclarés — saisis au runtime, jamais stockés ici.

Champ	Type	Requis	Exemple
Jeton de rafraîchissement	secret	oui	résolu via le coffre au runtime
Identifiant de la feuille	texte	oui	1AbC…xyz

OAuth 2.0 (déclaré)

Portéeshttps://www.googleapis.com/auth/spreadsheets.readonly

Rafraîchissementoui

URL d'autorisationhttps://accounts.google.com/o/oauth2/v2/auth

URL de jetonhttps://oauth2.googleapis.com/token

Hôtes autorisés (egress)

Un connecteur ne peut appeler que ces hôtes (allow-list).

sheets.googleapis.comoauth2.googleapis.com

Opérations

GET/v4/spreadsheets/{spreadsheetId}/values/{range}

Entrées : spreadsheetId (requis), range (requis)

Mapping de la réponse

Source (API)	Cible (Ω)	Transformation
0	site	—
1	status	—
2	count	toNumber

Invariant : un descripteur ne porte que des clés de champ (fields[].key). Les valeurs de secrets sont résolues à l'exécution par vault.get(appId, connectorId, key) — jamais committées.