Lien rapide Feuilles connectées

Preview : cette fonctionnalité est soumise aux "Conditions des offres pré-DG" de la section Conditions générales du service des conditions spécifiques au service. Les produits et fonctionnalités pré-DG sont disponibles "en l'état" et peuvent avoir une compatibilité limitée. Pour en savoir plus, consultez les descriptions des étapes de lancement.

Si vous rencontrez un problème lors de la version Preview publique de l'option Explorer les actions du menu en forme de roue dentée des feuilles connectées, signalez-le à l'adresse [e-mail].

Cette page explique comment activer et utiliser l'option de lien rapide Feuilles connectées dans le menu en forme de roue dentée Actions d'exploration de Looker. L'option Feuilles connectées ouvre Google Sheets et établit une connexion entre Google Sheets et l'exploration Looker. Vous pouvez ensuite créer des rapports, des tableaux croisés dynamiques ou des graphiques dans la Google Sheet que vous venez de créer, à l'aide des champs de l'exploration Looker sélectionnée.

Avant de commencer

Pour utiliser le lien rapide Feuilles connectées, vous devez disposer des éléments suivants :

• Une instance Looker activée et configurée pour la fonctionnalité par un administrateur, comme décrit dans la section Activer et configurer le lien rapide "Feuilles connectées" de cette page
• Un compte utilisateur Looker disposant de l'autorisation explore pour les modèles LookML que vous souhaitez connecter à Sheets
• Un compte Google avec la même adresse e-mail que celle associée à votre compte Looker

Remarque : Cette fonctionnalité n'est pas disponible pour les utilisateurs de Looker Embed.

Utiliser le lien rapide Feuilles connectées depuis une exploration

Si votre administrateur Looker a activé la fonctionnalité, vous pouvez établir une connexion entre Google Sheets et n'importe quelle exploration à laquelle vous avez accès :

1. Connectez-vous à Looker avec l'adresse e-mail associée à votre compte Google.

2. Dans Looker, accédez à l'exploration que vous souhaitez utiliser comme source de données.

   Conseil : Vous n'avez pas besoin de créer une requête dans l'exploration. Vous pouvez la laisser vide.

3. Cliquez sur l'icône en forme de roue dentée Actions sur les explorations, puis sélectionnez Feuilles connectées.

4. La première fois que vous utilisez cette fonctionnalité, vous êtes invité à autoriser Looker à accéder à votre compte Google. Choisissez le compte Google que vous souhaitez utiliser. L'adresse e-mail du compte Google doit correspondre à celle associée à votre compte utilisateur Looker.

5. Examinez les autorisations demandées sur l'écran de consentement, puis cliquez sur Autoriser.

6. Un nouvel onglet de navigateur s'ouvre dans Google Sheets et affiche une boîte de dialogue vous demandant si vous souhaitez associer votre compte Google à votre compte Looker. Cliquez sur Associer le compte.

La feuille de calcul Google Sheets est désormais connectée à l'exploration Looker d'origine. Dans la Google Sheet, vous pouvez ajouter des champs de l'exploration, créer des tableaux croisés dynamiques, créer des graphiques et appliquer des formules pour analyser les données de votre exploration Looker.

Pour en savoir plus sur la création de requêtes dans les feuilles connectées, consultez la page de documentation Utiliser des feuilles connectées pour Looker.

Activer et configurer le lien rapide Feuilles connectées

Pour activer le lien rapide Feuilles connectées dans le menu en forme de roue dentée Actions d'exploration, votre instance Looker doit remplir les conditions suivantes :

• Votre instance doit exécuter Looker 25.20 ou une version ultérieure.
• Pour les instances Looker (Google Cloud Core), le lien rapide Feuilles connectées n'est compatible qu'avec les connexions sécurisées publiques ou les connexions hybrides. Les instances Looker (Google Cloud Core) avec connexions privées (accès aux services privés) ne sont pas compatibles.
• Pour les instances Looker (version d'origine), le lien rapide Feuilles connectées n'est compatible qu'avec les instances hébergées par Looker. Les instances Looker hébergées par le client ne sont pas compatibles.

Pour activer l'option Feuilles connectées dans le menu en forme de roue dentée Actions d'exploration d'une instance Looker, un administrateur doit effectuer les tâches générales suivantes, décrites dans les sections ci-dessous :

• Activez l'API Google Sheets dans la console Google Cloud .
• Créez un client OAuth dans la console Google Cloud , dans le même projet de la console Google Cloud que celui où l'API Google Sheets a été activée.
• Activez et configurez l'option Activer le lien rapide Feuilles connectées sur la page "Connecteurs d'informatique décisionnelle Looker".

Activer l'API Google Sheets dans la console Google Cloud

Le lien rapide Feuilles connectées utilise l'API Google Sheets. Cette API doit donc être activée dans le projet que vous utiliserez pour créer le client OAuth. L'API Google Sheets peut être activée par un utilisateur IAM disposant de l'autorisation IAM roles/serviceusage.serviceUsageAdmin.

Pour activer l'API Google Sheets, procédez comme suit :

1. Dans le menu de navigation de la console Google Cloud , accédez à API et services > Bibliothèque, puis ouvrez l'API Google Sheets.

   Accéder à l'API Google Sheets

2. Dans le sélecteur de projet de la console Google Cloud , sélectionnez le projet que vous souhaitez utiliser pour vous connecter à Google Sheets depuis vos explorations Looker. Vous devez utiliser le même projet de la console Google Cloud tout au long de la procédure de configuration du lien rapide vers les feuilles connectées, afin que l'API Google Sheets soit activée sur le même projet que celui où vous configurez OAuth.

3. Sur la page de l'API Google Sheets, cliquez sur Activer si l'API n'est pas déjà activée.

Créer le client OAuth

Un utilisateur IAM disposant des rôles requis doit créer un client OAuth.

Vous pouvez configurer le client OAuth dans n'importe quel projet Google Cloud de votre choix. Toutefois, l'API Google Sheets doit être activée dans ce même projet.

Remarque : Avant de pouvoir générer vos identifiants OAuth, Google vous demande de configurer un écran de consentement OAuth, qui permet à vos utilisateurs de choisir comment accorder l'accès à leurs données privées. Si vous n'avez pas encore configuré d'écran de consentement OAuth pour le projet de console Google Cloud sélectionné, la console Google Cloud affiche une notification avec un bouton Configurer l'écran de consentement. Cliquez sur le bouton et suivez la procédure décrite sur la page de documentation Workspace Configurer l'écran de consentement OAuth et choisir des habilitations, puis revenez à cette procédure.

Pour créer le client et ses identifiants, procédez comme suit :

1. Dans la console Google Cloud , utilisez le sélecteur de projet de la console Google Cloud pour ouvrir le projet dans lequel vous avez activé l'API Google Sheets.

   Accéder à la console Google Cloud

2. Dans le menu principal de la console Google Cloud , accédez à API et services > Identifiants.

3. Sur la page Identifiants, cliquez sur le menu déroulant Créer des identifiants, puis sélectionnez ID client OAuth.

4. Dans le menu déroulant Type d'application, sélectionnez Application Web.

5. Dans le champ Nom, saisissez un nom pour votre client OAuth, par exemple Looker to Connected Sheets.

6. Dans la section URI de redirection autorisés, cliquez sur le bouton Ajouter un URI. Ajoutez l'URI suivant :

   https://LOOKER_INSTANCE_URL/oauth2callback
   

7. Cliquez sur le bouton Ajouter un URI pour ajouter également l'URI suivant :

   https://LOOKER_INSTANCE_URL/external_oauth/redirect
   

8. Cliquez sur Créer.

9. Après avoir cliqué sur Créer, une fenêtre Client OAuth créé s'affiche. Cette fenêtre affiche l'ID client et le code secret du client que la console Google Cloud a créés pour votre client OAuth. Copiez et notez ces valeurs, car vous en aurez besoin pour configurer l'option de lien rapide "Activer les feuilles connectées".

Configurer l'option "Activer le lien rapide Feuilles connectées"

Après avoir activé l'API Google Sheets dans la console Google Cloud et créé le client OAuth dans la console Google Cloud , vous pouvez activer le lien rapide Feuilles connectées sur votre instance Looker en procédant comme suit :

1. Dans votre instance Looker, sélectionnez Connecteurs d'informatique décisionnelle dans la section Plate-forme du panneau Admin.
2. Activez l'option Google Sheets si elle ne l'est pas déjà (vous pouvez également activer le client Feuilles connectées préconfiguré sur la page Gérer les clients OAuth ; les paramètres des deux pages sont synchronisés).
3. Activez l'option Activer le lien rapide Feuilles connectées.
4. Dans les champs ID client et Code secret du client, collez les valeurs que vous avez copiées depuis la console Google Cloud lorsque vous avez créé le client OAuth dans la console Google Cloud .
5. Cliquez sur Enregistrer.

L'option Feuilles connectées du menu en forme de roue dentée Actions d'exploration est désormais configurée pour votre instance Looker.

Migrer depuis le programme pilote

Si votre organisation a participé au programme pilote précédent pour la fonctionnalité Ouvrir dans Sheets, votre instance Looker utilisait un client OAuth géré de manière centralisée fourni par Looker. Cette configuration est en cours d'abandon au profit d'une méthode plus sécurisée et évolutive, dans laquelle chaque administrateur Looker configure son propre client OAuth pour son instance Looker. Les clients pilotes existants doivent passer à cette nouvelle configuration pour garantir le bon fonctionnement de la fonctionnalité.

Pour migrer vers la nouvelle version, un administrateur doit configurer le client OAuth de votre organisation dans la console Google Cloud , puis configurer les identifiants sur la page d'administration des connecteurs Looker BI. La procédure est la même que pour la configuration initiale, décrite dans les sections suivantes de cette page :

• Activez l'API Google Sheets dans la console Google Cloud .
• Créez un client OAuth dans la console Google Cloud , dans le même projet de la console Google Cloud que celui où l'API Google Sheets a été activée.
• Activez et configurez l'option Activer le lien rapide Feuilles connectées sur la page "Connecteurs d'informatique décisionnelle Looker".

Une fois ces étapes effectuées par un administrateur, votre instance utilisera automatiquement le nouveau flux OAuth géré par le client. La fonctionnalité pilote précédente et sa dépendance au client OAuth géré par Looker ne seront plus actives.

Dépannage

• Erreur de non-concordance d'adresse e-mail : si vous rencontrez une erreur lors de l'étape d'authentification Google, assurez-vous que le compte Google que vous sélectionnez possède exactement la même adresse e-mail que votre compte utilisateur Looker.
• L'option "Feuilles connectées" n'est pas visible : cette option ne s'affiche dans le menu en forme de roue dentée Actions d'exploration que si votre administrateur Looker a activé la fonctionnalité dans les paramètres des connecteurs BI. Contactez votre administrateur Looker pour obtenir de l'aide.
• Autorisations de la consoleGoogle Cloud  : l'administrateur qui configure le client OAuth et l'écran de consentement doit disposer des autorisations roles/oauthconfig.editor et roles/serviceusage.serviceUsageAdmin dans le projet Google Cloud .
• Pour tout autre problème ou commentaire pendant la période de version Preview publique, envoyez un e-mail à [e-mail].