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 pocos minutos, tendrás un Google Apps Script simple que realiza solicitudes a la API de YouTube Data.

La aplicación de ejemplo muestra cómo agregar datos de canales 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 el script

  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 .
  2. A la izquierda, junto a "Servicios", haz clic en Agregar un servicio .
  3. Haz clic en YouTube Data API y, luego, en Agregar.

Paso 3: Ejecuta la muestra

  1. Vuelve a cargar la 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 se debe completar con los encabezados ID, Título y Recuento de vistas.

  2. En la barra de menú, haz clic en Datos de YouTube > Agregar datos de GoogleDevelopers para agregar información sobre el canal de GoogleDevelopers a tu hoja de cálculo. (El menú de Datos de YouTube debería aparecer junto a los menús estándar: Archivo, Editar, Ver, etcétera).

    La primera vez que ejecutes la muestra, se te solicitará 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 Datos de YouTube > 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 OK. La secuencia de comandos recupera los datos de ese canal y los agrega a la hoja de cálculo.

Lecturas adicionales

Solución de problemas

ReferenceError: No se definió "[API NAME]"

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