Guía de inicio rápido de Google Apps Script

Completa los pasos que se describen en el resto de esta página y, en unos minutos, tendrás un sencillo Google Apps Script que realiza solicitudes a la API de YouTube Data.

La aplicación de muestra muestra cómo agregar datos del canal de YouTube a una hoja de cálculo.

Requisitos previos

Para ejecutar esta guía de inicio rápido, necesitarás lo siguiente:

• Acceso a Internet y un navegador web
• Una Cuenta de Google
• Acceso a Google Drive

Paso 1: Crea la secuencia de comandos

1. Abre Google Drive en tu navegador web.
2. Haz clic en Nuevo > Hojas de cálculo de Google.
3. En la nueva hoja de cálculo, haz clic en Extensiones > Apps Script.
4. Reemplaza el contenido del editor de secuencias de comandos por el siguiente código:

   // 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. Haz clic en Guardar .
6. Haz clic en Proyecto sin título en la parte superior izquierda, escribe Quickstart y haz clic en Cambiar nombre.

Paso 2: Activa la API de YouTube Data

1. A la izquierda, haz clic en Editor code.
2. A la izquierda, junto a "Servicios", haz clic en Agregar un servicio add.
3. Haz clic en API de YouTube Data y, luego, en Agregar.

Paso 3: Ejecuta la muestra

1. Vuelve a cargar tu hoja de cálculo. Si es la primera vez que cargas la hoja de cálculo después de agregar el código, la primera fila debe completarse con ID, Título y Cantidad de vistas encabezados.

2. En la barra de menú, haz clic en YouTube Data > Agregar datos de GoogleDevelopers para agregar información sobre el canal de GoogleDevelopers a tu hoja de cálculo. (El menú de YouTube Data debería aparecer junto a los menús estándar: Archivo, Editar, Ver, etcétera).
   
   La primera vez que ejecutes la muestra, se te pedirá que autorices el acceso:

   1. Haz clic en Revisar permisos.
   2. Elige una cuenta.
   3. Haz clic en Permitir.

3. En la barra de menú, haz clic en YouTube Data > Agregar datos del canal para agregar datos de un canal de tu elección. Cuando se te solicite, ingresa el nombre del canal (p.ej., "GoogleDevelopers" o "SaturdayNightLive") y haz clic en Aceptar. La secuencia de comandos recupera los datos de ese canal y los agrega a la hoja de cálculo.

Lecturas adicionales

• Documentación de los servicios avanzados de Google Apps Script
• Documentación de referencia de la API de YouTube Data

Solución de problemas

ReferenceError: "[API NAME]" no está definido

Este error ocurre cuando la API no se activó en el editor de código de Apps Script. Vuelve al paso 2.b y asegúrate de que el botón de activación correspondiente esté configurado como activado.