# FlashData ou l’API YouTube Data officielle

Choisissez selon votre tâche, comparez une réponse de métadonnées et vérifiez les autorisations de sous-titres ainsi que les coûts.

Référence canonique : https://flashdata.dev/fr/docs/guides/flashdata-vs-youtube-data-api
Vérifié le 2026-11-04 par FlashData

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

## Choisir selon la tâche

FlashData est un service distinct de l’API YouTube Data de Google. Les identifiants d’accès, les champs de réponse et les modes de facturation diffèrent.


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

### En un coup d’œil

| Tâche | API YouTube Data officielle | FlashData |
| --- | --- | --- |
| Métadonnées vidéo | videos.list | youtube_metadata |
| Recherche et découverte | Requêtes sur les ressources YouTube et pagination. | Recherche standard ou étendue, chaînes et suggestions. |
| Pistes de sous-titres | Opérations autorisées sur les sous-titres ; leur téléchargement nécessite le droit de modifier la vidéo. | Récupérer les pistes existantes pour la langue et la source de sous-titres demandées. |
| Modifications du compte | Envoi de vidéos et autres écritures autorisées, selon la documentation. | Récupération de données et livraison de médias ; aucune modification du compte YouTube. |
| Fichiers multimédias | La réponse d’une ressource vidéo contient des métadonnées. | Téléchargements en arrière-plan vers votre stockage. |

- [Présentation de l’API Google](https://developers.google.com/youtube/data/getting-started)

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

## Comparer une requête de métadonnées

Utilisez Bash, cURL et jq. Pour Google, activez YouTube Data API v3 dans votre projet et définissez GOOGLE_API_KEY. Pour FlashData, définissez FLASHDATA_API_KEY avec l’autorisation youtube_metadata. Chaque onglet contient une commande qui envoie une requête et enregistre sa réponse ; exécutez celle du fournisseur que vous souhaitez évaluer.

### 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
)
```


### API YouTube officielle

#### 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
)
```


- [Définir votre clé FlashData](https://flashdata.dev/fr/docs/guides/http-quickstart/reference.md#prepare)
- [videos.list](https://developers.google.com/youtube/data/reference/rest/v3/videos/list)
- [Schéma des métadonnées FlashData](https://flashdata.dev/fr/docs/sources/youtube_metadata/reference.md#response)

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

### Établir la correspondance des champs

Une réponse réussie contient la vidéo demandée. Un tableau items ou results vide indique qu’aucun enregistrement correspondant n’a été renvoyé. Conservez la réponse d’origine et définissez explicitement la correspondance des champs dans votre application.

| Valeur | Réponse officielle | Réponse FlashData |
| --- | --- | --- |
| Identifiant vidéo | items[0].id | results[0].videoId |
| Titre | items[0].snippet.title | results[0].title |
| Nom de la chaîne | items[0].snippet.channelTitle | results[0].channel |
| Durée | contentDetails.duration · ISO 8601 | duration · secondes |


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

## Vérifier séparément l’accès aux sous-titres

La méthode captions.download de Google nécessite une autorisation OAuth et le droit de modifier la vidéo. FlashData récupère les pistes existantes : Transcript utilise les sous-titres automatiques par défaut ; Captions utilise ceux fournis par l’auteur de la vidéo. Précisez language et auto lorsque vous comparez les résultats.

FlashData ne génère ni transcription ni traduction. Sa source d’étiquettes de licence rapporte les métadonnées Creative Commons ; elle n’accorde aucun droit d’entraînement et ne lit pas le réglage distinct du créateur relatif à l’autorisation d’entraînement.

- [Conditions d’accès aux sous-titres Google](https://developers.google.com/youtube/data/reference/rest/v3/captions/download)
- [Choisir une langue et une piste](https://flashdata.dev/fr/docs/guides/youtube-data-guide/reference.md#captions)
- [Champs des étiquettes de licence](https://flashdata.dev/fr/docs/sources/youtube_trainability/reference.md)

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

## Passer d’une vidéo à une collection

Choisissez le mode de traitement FlashData adapté à votre entrée. La recherche standard permet de demander jusqu’à 20 résultats ; la recherche étendue permet d’en demander jusqu’à 700, à un tarif distinct.

| Entrée | Workflow |
| --- | --- |
| Un sujet ou une requête de recherche | Recherche standard ou étendue → enregistrer les identifiants vidéo → récupérer les métadonnées. |
| Une courte liste de requêtes | Soumission Batch classique, avec des résultats par tâche. |
| Un fichier d’identifiants vidéo | Traitement Bulk de métadonnées, de transcriptions, de sous-titres, d’étiquettes de licence ou de téléchargements. |

- [Enrichir une liste de vidéos](https://flashdata.dev/fr/docs/guides/enrich-youtube-videos/reference.md)
- [Exemple de métadonnées Bulk](https://flashdata.dev/fr/docs/guides/bulk-metadata-recipe/reference.md)

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

## Comparer les quotas et les crédits

Google applique des quotas par projet et des coûts propres à chaque méthode. FlashData utilise le solde de crédits partagé du compte et des tarifs par source ; les téléchargements sont facturés sur les octets de médias livrés. Vérifiez les méthodes, les frais d’abonnement et le volume de travail que vous utiliserez réellement.

- [Coûts en quota de l’API Google](https://developers.google.com/youtube/data/determine_quota_cost)
- [Crédits et tarifs FlashData](https://flashdata.dev/fr/docs/guides/credits-and-billing/reference.md)
