Skip to main content

YouTube Data API v3 — Metadata de vídeos

Què és i per a què serveix​

La YouTube Data API v3 permet obtenir metadata de vídeos YouTube (títol, descripció, canal, data de publicació). A LDP s'utilitza per:

  • Importació de balls: Quan un admin introdueix una URL de YouTube, el sistema obté automàticament la metadata del vídeo
  • Estimació d'any: Usa la data de publicació com a any estimat del ball quan no n'hi ha d'altre
  • ETL bulk: L'importador massiu de YouTube (youtube-importer/) usa la mateixa API

Crear compte​

  1. Entra a Google Cloud Console
  2. Crea un projecte nou (o usa un existent)
  3. Ves a APIs & Services → Library
  4. Cerca "YouTube Data API v3" i clica Enable

Crear API Key​

  1. Ves a APIs & Services → Credentials
  2. Clica Create Credentials → API Key
  3. Copia la clau generada
  4. Recomanat: Clica Restrict Key i limita-la a:
    • API restrictions: Només "YouTube Data API v3"
    • Això evita ús no autoritzat si la clau es filtra

Variables d'entorn​

Al fitxer .env:

YOUTUBE_API_KEY=<la teva API key>
YOUTUBE_API_ENABLED=true

YOUTUBE_API_ENABLED permet desactivar les crides a YouTube sense eliminar la clau (útil per tests).

Verificació​

  1. Arrenca el backend amb el perfil local
  2. Importa un ball des d'una URL YouTube (/admin/imports/youtube)
  3. El sistema hauria d'obtenir automàticament: títol, descripció, canal, data de publicació

Sense la clau configurada, la importació YouTube segueix funcionant però l'admin ha d'introduir les dades manualment.

Limitacions i quotes​

RecursQuota diària (gratuïta)
Unitats totals10.000/dia
videos.list1 unitat per vídeo
search.list100 unitats per cerca

Amb 10.000 unitats/dia pots obtenir metadata de ~10.000 vídeos individuals o fer ~100 cerques. Per l'ús normal de LDP (importacions individuals), la quota gratuïta és més que suficient.

Resolució de problemes​

Error 403 (Forbidden / quotaExceeded)​

  • Has superat la quota diària de 10.000 unitats
  • Les quotes es reinicien a mitjanit hora del Pacífic (PST)

Error 400 (API key not valid)​

  • Verifica que la clau és correcta al .env
  • Verifica que la YouTube Data API v3 està habilitada al projecte de Google Cloud

La importació funciona però no obté metadata​

  • Verifica que YOUTUBE_API_ENABLED=true
  • Comprova els logs del backend per errors de connexió