# FlashData o la YouTube Data API ufficiale

Scegli per l'attività, confronta una risposta di metadati e controlla l'autorizzazione didascalia e i costi di utilizzo.

Riferimento canonico: https://flashdata.dev/it/docs/guides/flashdata-vs-youtube-data-api
Recensito: 2026-11-04 da FlashData

<a id="choose"></a>

## Scegli per l'attività

FlashData è un servizio separato da Google YouTube Data API. Le credenziali, i campi di risposta e i modelli di fatturazione sono diversi.


<a id="comparison"></a>

### A colpo d'occhio

| Compiti | YouTube Data ufficiale API | FlashData |
| --- | --- | --- |
| Metadati dei video | videos.list | youtube_metadata |
| Ricerca e scoperta | Domande e impaginazione delle risorse di YouTube. | Ricerca, canali e suggerimenti standard / estesa. |
| Tracce di cattura | Operazioni di didascalia autorizzate; i download richiedono il permesso di modifica per il video. | Recuperare le tracce esistenti per la lingua richiesta e la fonte didascalia. |
| Modifiche dell'account | Caricamenti documentati e altri scritti autorizzati. | Recupero e consegna; nessuna modificazione di account YouTube. |
| File multimediali | Una risposta video-risorse è metadati. | Download di sfondo al tuo storage. |

- [Panoramica Google della API](https://developers.google.com/youtube/data/getting-started)

<a id="metadata"></a>

## Confronta una richiesta di metadati

Utilizzare Bash, cURL e jq. Per Google, abilitare YouTube Data API v3 nel vostro progetto e impostare GOOGLE_API_KEY. Per FlashData, impostare FLASHDATA_API_KEY con il permesso youtube_metadata. Ogni scheda fa una richiesta e salva la sua risposta; eseguire il provider che si desidera valutare.

### FlashData

#### Bash · flashdata-metadata.json

```bash
(
set -euC
: "${FLASHDATA_API_KEY:?Set FLASHDATA_API_KEY first}"
curl --fail-with-body --silent --show-error --max-time 120 \
  'https://data.flashdata.dev/v1/queries/realtime' \
  --header "X-API-Key: $FLASHDATA_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "source": "youtube_metadata",
  "video_id": "jNQXAC9IVRw",
  "params": {
    "include_formats": false,
    "include_chapters": false
  }
}' > flashdata-metadata.json
jq -e '.status == "done"' flashdata-metadata.json >/dev/null
jq '.results | map({video_id: .videoId, title, channel, duration_seconds: .duration})' \
  flashdata-metadata.json
)
```


### Ufficiale YouTube API

#### Bash · official-metadata.json

```bash
(
set -euC
: "${GOOGLE_API_KEY:?Set GOOGLE_API_KEY first}"
curl --fail-with-body --silent --show-error --max-time 30 --get \
  'https://www.googleapis.com/youtube/v3/videos' \
  --data-urlencode "key=$GOOGLE_API_KEY" \
  --data-urlencode 'part=snippet,contentDetails' \
  --data-urlencode 'id=jNQXAC9IVRw' > official-metadata.json
jq '.items | map({video_id: .id, title: .snippet.title,
  channel: .snippet.channelTitle, duration_iso8601: .contentDetails.duration})' \
  official-metadata.json
)
```


- [Impostare il tasto FlashData](https://flashdata.dev/it/docs/guides/http-quickstart/reference.md#prepare)
- [videos.list](https://developers.google.com/youtube/data/reference/rest/v3/videos/list)
- [Schema dei metadati FlashData](https://flashdata.dev/it/docs/sources/youtube_metadata/reference.md#response)

<a id="fields"></a>

### Mappa dei campi di risultato

Una risposta di successo contiene il video richiesto. Un array items/results vuoto significa che nessun record di corrispondenza è stato restituito. Mantenere i campi di risposta e mappa originali esplicitamente nella vostra applicazione.

| Valore | Risposta ufficiale | Risposta FlashData |
| --- | --- | --- |
| ID del video | items[0].id | results[0].videoId |
| Titolo | items[0].snippet.title | results[0].title |
| Nome del canale | items[0].snippet.channelTitle | results[0].channel |
| Durata | contentDetails.duration · ISO 8601 | durata · secondi |


<a id="captions"></a>

## Controllare l'accesso didascalia separatamente

Google captions.download richiede l'autorizzazione OAuth e il permesso di modificare il video. FlashData recupera le tracce esistenti: Transcript defaults to automatic captions; I valori predefiniti per le tracce fornite da uploader. Specificare la lingua e l'auto esplicitamente quando si confrontano gli output.

FlashData non genera una trascrizione o una traduzione. La sua fonte di licenza riporta i metadati Creative Commons; non concede diritti di formazione o legge l'impostazione separata della formazione-permissione del creatore.

- [Requisiti di captazione Google](https://developers.google.com/youtube/data/reference/rest/v3/captions/download)
- [Scegli una lingua e una traccia](https://flashdata.dev/it/docs/guides/youtube-data-guide/reference.md#captions)
- [Campi di licenza-etichetta](https://flashdata.dev/it/docs/sources/youtube_trainability/reference.md)

<a id="workflows"></a>

## Spostarsi da un video a una collezione

Scegli il flusso di lavoro FlashData che corrisponde al tuo ingresso. Standard Search accetta fino a 20 risultati richiesti; Ricerca estesa accetta fino a 700 ad un tasso separato.

| Input | Flusso di lavoro |
| --- | --- |
| Un argomento o una domanda di ricerca | Ricerca standard o estesa → salvare video IDs → metadati. |
| Una piccola lista di richieste | Invio di lotti regolare con risultati per-job. |
| Un file di video IDs | Bulk metadati, trascrizione, didascalie, etichette di licenza o download. |

- [Arricchire una lista di video](https://flashdata.dev/it/docs/guides/enrich-youtube-videos/reference.md)
- [Ricetta dei metadati Bulk](https://flashdata.dev/it/docs/guides/bulk-metadata-recipe/reference.md)

<a id="billing"></a>

## Confrontare quote e Crediti

Google applica quote di progetto e costi specifici per i metodi. FlashData utilizza i Crediti e i tassi specifici per le fonti; l'utilizzo del download si basa su byte multimediali consegnate. Controllare i metodi, la tassa di piano e il carico di lavoro che si utilizzerà in realtà.

- [Google](https://developers.google.com/youtube/data/determine_quota_cost)
- [FlashData Credits e prezzi](https://flashdata.dev/it/docs/guides/credits-and-billing/reference.md)
