Prévisualiser des liens Google Livres avec les chips intelligents

Niveau de codage: intermédiaire
Durée: 30 minutes
Type de projet: module complémentaire Google Workspace

Objectifs

• Découvrez à quoi sert le module complémentaire.
• Découvrez comment créer un module complémentaire à l'aide de et comprendre ce que sont les scripts les services Google.
• configurer votre environnement ;
• Configurez le script.
• Exécutez le script.

À propos de ce module complémentaire Google Workspace

Dans cet exemple, vous créez un module complémentaire Google Workspace qui affiche un aperçu des liens depuis Google Livres Document Google Docs. Lorsque vous saisissez ou collez une URL Google Livres dans un , le module complémentaire reconnaît et déclenche un aperçu du lien. Pour prévisualiser le lien, vous pouvez convertir le dans un chip intelligent et pointez sur le lien pour afficher une fiche affiche plus d'informations sur le livre.

Ce module complémentaire utilise Service UrlFetch d'Apps Script pour connectez-vous à Google Livres API et obtenez des informations sur Google Livres à afficher dans Google Docs.

Fonctionnement

Dans le fichier manifeste du module complémentaire Google Workspace fichier, le script configure le module complémentaire pour étendre Google Docs et déclencher un lien Aperçus des URL correspondant à certains formats à partir du site Web de Google Livres (https://books.google.com).

Dans le fichier de code, le script se connecte à l'API Google Books et utilise l'URL pour obtenir des informations sur le livre (une instance de la classe Volume ressource). La utilise ces informations pour générer un chip intelligent qui affiche le code un titre et une fiche d'aperçu affichant un récapitulatif, le nombre de pages vues et une image la couverture du livre et le nombre de notes.

Services Apps Script

Ce module complémentaire utilise les services suivants:

• Service URLFetch : se connecte à Google Livres API permettant d'obtenir des informations sur des livres (qui sont des instances des API) ressource Volume).
• Service de cartes : crée l'utilisateur du module complémentaire.

Prérequis

Pour utiliser cet exemple, vous devez remplir les conditions préalables suivantes:

• Un compte Google (les comptes Google Workspace peuvent nécessitent l'approbation d'un administrateur).

• Un navigateur Web ayant accès à Internet

• Un projet Google Cloud associée à un compte de facturation. Reportez-vous à la section Activer la facturation pour une projet.

Configurer votre environnement

Les sections suivantes expliquent comment configurer votre environnement pour créer un module complémentaire.

Ouvrir votre projet Cloud dans la console Google Cloud

S'il n'est pas déjà ouvert, ouvrez le projet Cloud que vous prévoyez d'utiliser. pour cet exemple:

1. Dans la console Google Cloud, accédez à la page Sélectionner un projet.

   Sélectionner un projet Cloud

2. Sélectionnez le projet Google Cloud que vous souhaitez utiliser. Vous pouvez également cliquer sur Créer un projet et suivre les instructions à l'écran. Si vous créez un projet Google Cloud, vous devrez peut-être activer la facturation pour le projet.

Activer l'API Google Books

Ce module complémentaire se connecte à l'API Google Books. Avant d'utiliser les API Google, vous devez les activer dans un projet Google Cloud. Vous pouvez activer une ou plusieurs API dans un même projet Google Cloud.

• Dans votre projet Cloud, activez l'API Livres.

  Activer l'API

Configurer l'écran de consentement OAuth

Ce module complémentaire nécessite un projet Cloud avec un configuré l'écran de consentement. La configuration de l'écran de consentement OAuth définit Google présente votre application aux utilisateurs et l'enregistre pour que vous puissiez la publier plus tard.

1. Dans la console Google Cloud, accédez au menu menu. > API et Services > Écran de consentement OAuth.

   Accéder à l'écran de consentement OAuth

2. Pour Type d'utilisateur, sélectionnez Interne, puis cliquez sur Créer.
3. Remplissez le formulaire d'inscription de l'application, puis cliquez sur Enregistrer et continuer.

4. Pour l'instant, vous pouvez ignorer l'ajout de champs d'application et cliquer sur Enregistrer et continuer. Par la suite, lorsque vous créerez une application à utiliser en dehors de votre d'une organisation Google Workspace, vous devez remplacer le Type d'utilisateur par Externe, puis : ajouter les niveaux d'autorisation requis par votre application.

5. Consultez le récapitulatif d'enregistrement de votre application. Pour apporter des modifications, cliquez sur Modifier. Si l'application l'inscription vous semble correcte, cliquez sur Retour au tableau de bord.

Obtenir une clé API pour l'API Google Books

1. Accédez à Google Cloud Console. Assurez-vous que votre projet pour lequel la facturation est activée est ouvert.

2. Dans la console Google Cloud, accédez au menu menu. > API et Services > Identifiants.

   Accéder à "Identifiants"

3. Cliquez sur Créer des identifiants > Clé API.

4. Notez votre clé API. Vous en aurez besoin lors d'une prochaine étape.

Configurer le script

Les sections suivantes configurent le script de création du un module complémentaire.

Créer le projet Apps Script

1. Cliquez sur le bouton suivant pour ouvrir les liens d'aperçu de Google Livres. Projet Apps Script.
   Ouvrir le projet
2. Cliquez sur info_outline Vue d'ensemble.
3. Sur la page "Vue d'ensemble", cliquez sur Créer une copie .
4. Dans votre copie du projet Apps Script, accédez à Code.gs et remplacez YOUR_API_KEY par la clé API que vous avez générée dans le dans la section précédente.

Copier le numéro du projet Cloud

1. Dans la console Google Cloud, accédez au menu menu. > IAM et Administrateur > Paramètres.

   Accéder à la page Paramètres de la section IAM et administration

2. Dans le champ Numéro du projet, copiez la valeur.

Définir le projet Cloud du projet Apps Script

1. Dans votre projet Apps Script, cliquer sur Paramètres du projet.
2. Sous Projet Google Cloud Platform (GCP), cliquez sur Changer de projet.
3. Dans Numéro de projet GCP, collez le numéro de projet Google Cloud.
4. Cliquez sur Définir un projet.

Tester le module complémentaire

Les sections suivantes testent le module complémentaire que vous avez créé.

Installer un déploiement test

1. Dans votre projet Apps Script, cliquez sur code Éditeur.
2. Remplacez YOUR_API_KEY par la clé API de l'API Google Books, créée dans dans une section précédente.
3. Cliquez sur Déployer > Tester les déploiements.
4. Cliquez sur Installer > OK.

Prévisualiser un lien dans Google Docs

1. Créez un document Google Docs sur docs.new.
2. Collez l'URL suivante dans le document, puis appuyez sur la touche Tabulation pour convertissez l'URL en chip intelligent: https://www.google.com/books/edition/Software_Engineering_at_Google/V3TTDwAAQBAJ
3. Maintenez le pointeur sur le chip intelligent et, lorsque vous y êtes invité, autorisez l'accès à exécuter le module complémentaire. La fiche d'aperçu s'affiche des informations sur le livre.

L'image suivante illustre l'aperçu du lien:

Examiner le code

Pour examiner le code Apps Script pour cette cliquez sur Afficher le code source pour développer le :

{
  "timeZone": "America/Los_Angeles",
  "exceptionLogging": "STACKDRIVER",
  "runtimeVersion": "V8",
  "oauthScopes": [
    "https://www.googleapis.com/auth/workspace.linkpreview",
    "https://www.googleapis.com/auth/script.external_request"
  ],
  "urlFetchWhitelist": [
    "https://www.googleapis.com/books/v1/volumes/"
  ],
  "addOns": {
    "common": {
      "name": "Preview Books Add-on",
      "logoUrl": "https://developers.google.com/workspace/add-ons/images/library-icon.png",
      "layoutProperties": {
        "primaryColor": "#dd4b39"
      }
    },
    "docs": {
      "linkPreviewTriggers": [
        {
          "runFunction": "bookLinkPreview",
          "patterns": [
            {
              "hostPattern": "*.google.*",
              "pathPrefix": "books"
            },
            {
              "hostPattern": "*.google.*",
              "pathPrefix": "books/edition"
            }
          ],
          "labelText": "Book",
          "logoUrl": "https://developers.google.com/workspace/add-ons/images/book-icon.png",
          "localizedLabelText": {
            "es": "Libros"
          }
        }
      ]
    }
  }
}

function getBook(id) {
  const apiKey = 'YOUR_API_KEY'; // Replace with your API key
  const apiEndpoint = `https://www.googleapis.com/books/v1/volumes/${id}?key=${apiKey}&country=US`;
  const response = UrlFetchApp.fetch(apiEndpoint);
  return JSON.parse(response);
}

function bookLinkPreview(event) {
 if (event.docs.matchedUrl.url) {
    const segments = event.docs.matchedUrl.url.split('/');
    const volumeID = segments[segments.length - 1];

    const bookData = getBook(volumeID);
    const bookTitle = bookData.volumeInfo.title;
    const bookDescription = bookData.volumeInfo.description;
    const bookImage = bookData.volumeInfo.imageLinks.small;
    const bookAuthors = bookData.volumeInfo.authors;
    const bookPageCount = bookData.volumeInfo.pageCount;

    const previewHeader = CardService.newCardHeader()
      .setSubtitle('By ' + bookAuthors)
      .setTitle(bookTitle);

    const previewPages = CardService.newDecoratedText()
      .setTopLabel('Page count')
      .setText(bookPageCount);

    const previewDescription = CardService.newDecoratedText()
      .setTopLabel('About this book')
      .setText(bookDescription).setWrapText(true);

    const previewImage = CardService.newImage()
      .setAltText('Image of book cover')
      .setImageUrl(bookImage);

    const buttonBook = CardService.newTextButton()
      .setText('View book')
      .setOpenLink(CardService.newOpenLink()
        .setUrl(event.docs.matchedUrl.url));

    const cardSectionBook = CardService.newCardSection()
      .addWidget(previewImage)
      .addWidget(previewPages)
      .addWidget(CardService.newDivider())
      .addWidget(previewDescription)
      .addWidget(buttonBook);

    return CardService.newCardBuilder()
    .setHeader(previewHeader)
    .addSection(cardSectionBook)
    .build();
  }
}

Articles associés

• Prévisualiser les liens avec des chips intelligents
• Documentation de référence de l'API Google Books