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

Completa los pasos descritos en el resto de esta página y, en solo unos minutos, tendrás una simple secuencia de comandos de Google Apps, que realiza solicitudes a la API de datos de YouTube.

En la aplicación de muestra, se indica 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: Cree 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 Extensions > Apps Script.
  4. Reemplaza el contenido del editor de secuencias de comandos con 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 Guía de inicio rápido y haz clic en Cambiar nombre.

Paso 2: Activa la API de datos de YouTube

  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, a continuación, haz clic 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 propagar 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 la hoja de cálculo. (El menú de datos de YouTube debe aparecer junto a los menús estándar: Archivo, Editar, Ver, etc.).

    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. Haga clic en Permitir.

  3. En la barra de menú, haz clic en Datos de YouTube > Agregar datos del canal para agregar los datos para el canal que elijas. 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

Solución de problemas

Error de referencia: No se definió "[NOMBRE DE LA API]"

Este error se produce cuando no se activa la API en el editor de código de Apps Script. Vuelve al paso 2.b y asegúrate de que la opción correspondiente esté activada.