HomeBlogTranscribePlansAPI Keys

Trascrizione YouTube in Google Sheets Con Una Funzione Personalizzata

Foglio di calcolo Google Sheets con URL YouTube in una colonna e trascrizioni recuperate che appaiono nella successiva

Ottenere una trascrizione YouTube in Google Sheets richiede una funzione Apps Script. Incollalo una volta, e =YT_TRANSCRIPT(A2) funziona come qualsiasi formula incorporata: URL in una colonna, trascrizione nella successiva. Ecco lo script completo, più due seccature specifiche di Sheets che ti morderanno se nessuno ti avverte.

Lo script

Apri il tuo foglio di calcolo, vai a Estensioni > Apps Script, e incolla questo:

const API_KEY = 'yt_YOUR_KEY';

/**
 * Fetches the transcript of a YouTube video.
 * @param {string} url Any YouTube URL or a bare 11-char video id.
 * @param {number} maxChars Optional length cap (default 5000).
 * @return {string} The transcript text.
 * @customfunction
 */
function YT_TRANSCRIPT(url, maxChars) {
  if (!url) return '';
  const endpoint = 'https://youtube2text.org/api/transcribe'
    + '?url=' + encodeURIComponent(url)
    + '&maxChars=' + (maxChars || 5000);
  const response = UrlFetchApp.fetch(endpoint, {
    headers: { 'x-api-key': API_KEY },
    muteHttpExceptions: true
  });
  const body = JSON.parse(response.getContentText());
  if (body.error) return 'ERROR: ' + body.error.code;
  return body.result.content;
}

Salva, e la funzione è attiva nel tuo foglio. Il tag @customfunction è quello che lo registra con l'autocompletamento; muteHttpExceptions evita che un 404 esploda in una cella rossa con una traceback che nessuno ha chiesto.

Per la chiave: richiedi https://youtube2text.org/api/demo-key nel tuo browser e ti restituisce {"success": true, "apiKey": "yt_..."} — una chiave condivisa gratuita, nessun account, limitata a 5 video al mese per IP. Va bene per provare questo; ottieni la tua per un uso reale.

Usarla

  1. Metti URL video nella colonna A — link completi, link corti youtu.be, o ID nudi di 11 caratteri funzionano tutti.
  2. In B2, digita =YT_TRANSCRIPT(A2).
  3. Hai bisogno di più o meno testo? =YT_TRANSCRIPT(A2, 20000) imposta il limite esplicitamente.
  4. Trascina la formula giù per la colonna e guarda le celle riempirsi.

Le trascrizioni provengono dalle didascalie di YouTube — manuali quando il creatore le ha caricate, generate automaticamente altrimenti, inglese preferito con un fallback a qualsiasi lingua esista.

Perché maxChars è più importante qui che in qualsiasi altro luogo

Una cella di Google Sheets contiene al massimo 50.000 caratteri. È un limite della piattaforma duro, e il limite predefinito dell'API di 150.000 caratteri lo supera di gran lunga — un lungo episodio di podcast non riuscirebbe a raggiungere la cella. Quindi in Sheets, passa sempre maxChars di 50.000 o meno. Imposto il valore predefinito dello script a 5000, che copre riassunti, controlli di parole chiave e alimentazione di una formula AI, senza trasformare il tuo foglio di calcolo in un romanzo.

Il pasticcio della ricalcolazione

Ecco l'onesta limitazione dell'approccio della funzione personalizzata: Sheets riesegue le funzioni personalizzate ogni volta che ricalcola — incluso ogni volta che il file viene riaperto. Ogni riesecuzione è una vera chiamata API, quindi un foglio con 40 formule di trascrizione recupera silenziosamente 40 video all'apertura e consuma la tua quota a colazione. La soluzione è semplice: una volta arrivata una trascrizione, seleziona le celle e incollale di nuovo come valori (Copia, quindi Incolla speciale > Solo valori). Il testo rimane; la formula e il suo appetito, se ne vanno.

Quando una cella dice ERROR

La funzione restituisce codici leggibili invece di bloccarsi. ERROR: TRANSCRIPT_UNAVAILABLE significa che il video non ha didascalie affatto — nulla da recuperare. ERROR: RATE_LIMIT_EXCEEDED significa che la quota mensile della chiave è esaurita, che sulla chiave demo condivisa accade velocemente. ERROR: INVALID_URL significa che la cella non contiene nulla che assomigli a un video YouTube.

Dove portarlo

Un foglio pieno di trascrizioni è uno strumento di ricerca sorprendentemente buono — mi muovo in quel flusso di lavoro nel post sulla ricerca di contenuti. E quando superi le formule e desideri trascrizioni recuperate automaticamente durante la pubblicazione dei video, il flusso di lavoro n8n lo fa a mani libere.

Per la tua chiave — nessuna quota condivisa, nessun telefono, nessuna carta — accedi con Google su youtube2text.org/app/keys. Il livello gratuito copre 5 video al mese; $ 5,99 ottiene 50, $ 9,99 ottiene 500, $ 19,99 è illimitato. Incollalo in API_KEY e il foglio fa il resto.