Guide de démarrage rapide de Google Apps Script

Suivez les étapes décrites dans le reste de cette page. En quelques minutes seulement, vous disposerez d'un simple script Google Apps qui enverra des requêtes à l'API YouTube Data.

L'exemple d'application montre comment ajouter des données de chaîne YouTube à une feuille de calcul.

Prérequis

Pour exécuter ce guide de démarrage rapide, vous aurez besoin des éléments suivants:

  • Accès à Internet et à un navigateur Web
  • Un compte Google.
  • Accès à Google Drive.

Étape 1: Créez le script

  1. Ouvrez Google Drive dans votre navigateur Web.
  2. Cliquez sur Nouveau > Google Sheets.
  3. Dans la nouvelle feuille de calcul, cliquez sur Extensions > Apps Script.
  4. Remplacez le contenu de l'éditeur de scripts par le code suivant : 
    // Note: Apps Script automatically requests authorization
    // based on the API's used in the code.

    function channelsListByUsername(part, params) {
          var response = YouTube.Channels.list(part,
                                               params);
          var channel = response.items[0];
          var dataRow = [channel.id, channel.snippet.title, channel.statistics.viewCount];
          SpreadsheetApp.getActiveSpreadsheet().appendRow(dataRow);
    }

    function getChannel() {
          var ui = SpreadsheetApp.getUi();
          var channelName = ui.prompt("Enter the channel name: ").getResponseText();
      channelsListByUsername    ('snippet,contentDetails,statistics',
                                 {'forUsername': channelName});
    }

    function getGoogleDevelopersChannel() {
      channelsListByUsername    ('snippet,contentDetails,statistics',
                                 {'forUsername': 'GoogleDevelopers'});
    }

    function onOpen() {
          var firstCell = SpreadsheetApp.getActiveSheet().getRange(1, 1).getValue();
          if (firstCell != 'ID') {
            var headerRow = ["ID", "Title", "View count"];
            SpreadsheetApp.getActiveSpreadsheet().appendRow(headerRow);
          }
          var ui = SpreadsheetApp.getUi();
      ui    .createMenu('YouTube Data')
          .addItem('Add channel data', 'getChannel')
          .addSeparator()
          .addItem('Add GoogleDevelopers data', 'getGoogleDevelopersChannel')
          .addToUi();
    }
    quickstart.gs
  5. Cliquez sur Enregistrer .
  6. Cliquez sur Projet sans titre en haut à gauche, saisissez Démarrage rapide, puis cliquez sur Renommer.

Étape 2: Activez l'API YouTube Data

  1. À gauche, cliquez sur Montage .
  2. À gauche, à côté de "Services", cliquez sur Ajouter un service .
  3. Cliquez sur API YouTube Data, puis sur Ajouter.

Étape 3: Exécutez l'exemple

  1. Actualisez la feuille de calcul. Si vous chargez la feuille de calcul pour la première fois après avoir ajouté le code, la première ligne doit contenir les en-têtes ID, Title et View count.

  2. Dans la barre de menu, cliquez sur YouTube Data > Add GoogleDevelopers data (Données YouTube > Ajouter des données Google Developers) pour ajouter des informations sur la chaîne GoogleDevelopers à votre feuille de calcul. Le menu "Données YouTube" doit s'afficher à côté des menus standards : "Fichier", "Modifier", "Afficher", etc.

    La première fois que vous exécuterez l'exemple, vous serez invité à autoriser l'accès:

    1. Cliquez sur Examiner les autorisations.
    2. Sélectionnez un compte
    3. Cliquez sur Autoriser.

  3. Dans la barre de menu, cliquez sur Données YouTube > Ajouter des données de chaîne pour ajouter les données de la chaîne de votre choix. Lorsque vous y êtes invité, saisissez le nom du canal (par exemple, "GoogleDevelopers" ou "SaturdayNightLive"), puis cliquez sur OK. Le script récupère les données de ce canal et les ajoute à la feuille de calcul.

Complément d'informations

Dépannage

Erreur de référence : "[API NAME]" n'est pas défini

Cette erreur se produit lorsque l'API n'a pas été activée dans l'éditeur de code Apps Script. Relisez l'étape 2.b et assurez-vous que le bouton correspondant est activé.