Aller au contenu
FR
Obtenir une clé API
Parcourir la documentation

Référence API

Batch et Bulk

Choisissez Batch pour des requêtes indépendantes avec des entrées différentes. Choisissez Bulk pour un fichier d’identifiants vidéo nécessitant tous la même opération.

Sur cette page

Choisir selon la tâche à accomplir

Le choix dépend de la structure des données d’entrée, pas d’un nombre fixe d’éléments. Les deux modes s’exécutent en arrière-plan. Pour une seule requête, utilisez directement realtime ou async.

Votre tâcheChoix
Rechercher plusieurs sujets pour une synthèse quotidienneBatch: Chaque requête a ses propres termes de recherche, sa localisation ou sa langue.
Combiner résultats Google et métadonnées YouTube dans une rechercheBatch: Combinez les sources et collectez un résultat distinct pour chaque requête.
Actualiser les métadonnées ou collecter les transcriptions d’un catalogue vidéoBulk: Un fichier d’identifiants vidéo, une source et les mêmes options pour chaque vidéo.
Livrer une liste de vidéos dans un bucket, au même formatBulk: Utilisez youtube_download avec des paramètres média et un stockage de destination communs.
Utiliser des paramètres de sortie différents pour chaque vidéoBatch: Les paramètres peuvent varier selon la requête ; Bulk applique les mêmes options à tout le fichier.

Batch : requêtes indépendantes

Envoyez un objet JSON contenant queries. Chaque élément a sa propre source, ses données d’entrée et ses params. Utilisez Batch pour les recherches Google ou YouTube, les sources mixtes ou les vidéos nécessitant des options différentes.

Entrée Batch · deux tâches différentes
{
  "queries": [
    {
      "source": "google_search",
      "query": "open source speech recognition",
      "params": {
        "num": 5
      }
    },
    {
      "source": "youtube_metadata",
      "video_id": "dQw4w9WgXcQ",
      "params": {}
    }
  ]
}

Bulk : une opération sur un fichier

Importez un fichier UTF-8 contenant un identifiant vidéo YouTube par ligne. Sélectionnez une source prise en charge et un ensemble d’options pour tout le fichier. Bulk analyse le fichier, soumet les tâches selon la capacité du compte et regroupe les résultats en fichiers téléchargeables.

  1. Choisissez les métadonnées, les transcriptions, les sous-titres, la classification des licences ou le téléchargement. Bulk prend des identifiants vidéo ; utilisez Batch pour les recherches par mots-clés.
  2. Créez une tâche distincte lorsque la source ou les options changent. Par exemple, obtenir les métadonnées et les transcriptions d’un même fichier nécessite deux tâches Bulk.
  3. Pour les téléchargements, fournissez un stockage de destination et un accès propriétaire avec la permission youtube_download. Les lignes de résultat décrivent les médias livrés ; les fichiers média sont stockés dans votre bucket.
video-ids.txt
dQw4w9WgXcQ
jNQXAC9IVRw

Prévoir la collecte des résultats

ÉtapeBatchBulk
Enregistrer après la soumissionChaque queries[].id, associé à son entrée d’origine. Il n’existe pas d’identifiant de tâche unique pour tout le Batch.Un identifiant de tâche Bulk et le fichier d’entrée inchangé.
Suivre la fin du traitementChaque tâche se termine indépendamment ; un échec ne décrit pas tout le batch.Une tâche expose des compteurs de progression. completed signifie que les résultats sont regroupés, pas que chaque vidéo a été traitée avec succès.
Collecter les résultatsRécupérez le résultat de chaque tâche terminée et conservez la correspondance entre son entrée et son identifiant.Récupérez le manifeste et toutes les parties NDJSON compressées. Associez les lignes par index et video_id, pas par leur ordre.
Reprendre après une interruptionLisez les identifiants de tâche enregistrés avant d’envisager de nouvelles soumissions.Vérifiez l’identifiant Bulk enregistré. Résolvez la cause indiquée par pauseReason, puis reprenez cette même tâche si elle est en pause.

Vérifier la capacité et le coût avant de commencer

VérificationÀ prendre en compte
BatchmaxBatchSize limite le nombre de requêtes par soumission selon votre forfait. Divisez les ensembles plus grands en petits groupes et respectez la capacité de tâches en attente.
BulkJusqu’à 2 GiB par fichier d’identifiants. Les tâches sont soumises progressivement selon la capacité partagée du compte ; supprimez les doublons avant l’import.
CréditsRegrouper les requêtes ne donne pas un tarif forfaitaire unique. Chaque requête suit le tarif de sa source ; les téléchargements sont facturés selon le volume de données livré.
AccèsLa clé doit autoriser toutes les sources demandées. Vérifiez les limites du compte actif ; un compte d’essai ne dispose pas de la capacité complète.