Lien rapide Feuilles connectées

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'onglet "Explorer" de Looker. Vous pouvez ensuite créer des rapports, des tableaux croisés dynamiques ou des graphiques dans la feuille de calcul Google Sheet nouvellement créée, en utilisant les 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 qui a été 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

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.

  3. Cliquez sur l'icône en forme de roue dentée Actions d'exploration, 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 d'autorisation, 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 à partir de laquelle vous avez commencé. Dans la Google Sheet, vous pouvez ajouter des champs à partir de l'exploration, créer des tableaux croisés dynamiques et 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 répondre aux exigences suivantes :

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 :

Activer l'API Google Sheets dans la console Google Cloud

Le lien rapide Feuilles connectées utilise l'API Google Sheets. Vous devez donc activer cette API dans le même projet que celui 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 :

  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 la console Google Cloud , ouvrez le sélecteur de projet, puis 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 console Google Cloud tout au long de la procédure de configuration du lien rapide Sheets connecté afin que l'API Google Sheets soit activée sur le même projet que celui dans lequel 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 le projet Google Cloud de votre choix. Toutefois, l'API Google Sheets doit être activée dans ce même projet.

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 même 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, tel que 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 elles seront nécessaires lorsque vous configurerez l'option de lien rapide "Activer les feuilles connectées".

Configurer l'option de lien rapide "Activer les 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 Administration.
  2. Si ce n'est pas déjà fait, activez l'option Google Sheets.
  3. Activez le bouton à bascule imbriqué 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 Outils 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 et fourni par Looker. Cette configuration est abandonnée 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 continuer à bénéficier de la fonctionnalité.

Pour migrer vers la nouvelle version, un administrateur doit configurer le propre client OAuth de votre organisation dans la console Google Cloud , puis configurer les identifiants sur la page d'administration des connecteurs Looker BI. Les étapes sont les mêmes que celles de la configuration initiale, décrites dans les sections suivantes de cette page :

Une fois qu'un administrateur a effectué ces étapes, votre instance utilise automatiquement le nouveau flux OAuth géré par le client. L'ancienne fonctionnalité pilote et sa dépendance au client OAuth géré par Looker ne seront plus actives.

Dépannage

  • Erreur d'adresse e-mail incorrecte : 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 n'apparaît 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 à looker-connected-sheets-external@google.com.