Saltar al contenido
ES
Obtener clave API
Explorar documentación

Referencia de la API

Batch y Bulk

Usa Batch para consultas independientes con entradas distintas. Usa Bulk para un archivo de identificadores de vídeo que requieran la misma operación.

En esta página

Elija por el trabajo que necesita hacer

La elección depende de la forma de su entrada, no de un número fijo de elementos. Ambos modos funcionan en el fondo. Para una consulta, use en tiempo real o asinc directamente.

Su tareaElija
Buscar varios temas para una sesión informativa diariaBatch: Cada consulta tiene sus propios términos de búsqueda, ubicación o idioma.
Combine los resultados de Google y metadatos YouTube en un trabajo de investigaciónBatch: Mezcle las fuentes y recoja un resultado separado para cada consulta.
Metadatos refrescos o recogen transcripciones para un catálogo de vídeoBulk: Un archivo video-ID, una fuente y las mismas opciones para cada vídeo.
Entrega una lista de vídeos a un cubo en el mismo formatoBulk: Utilice youtube_download con configuraciones de medios compartidos y almacenamiento de destino.
Utilice diferentes configuraciones de salida para cada vídeoBatch: Los parámetros de la consulta pueden diferir; Bulk aplica un conjunto a todo el archivo.

Batch: consultas independientes

Enviar un objeto JSON que contiene consultas. Cada artículo tiene su propia fuente, entrada y params. Utilice Batch para búsquedas Google, búsquedas YouTube, fuentes mixtas o videos que necesitan diferentes opciones.

Entrada Batch · dos tareas diferentes
{
  "queries": [
    {
      "source": "google_search",
      "query": "open source speech recognition",
      "params": {
        "num": 5
      }
    },
    {
      "source": "youtube_metadata",
      "video_id": "dQw4w9WgXcQ",
      "params": {}
    }
  ]
}

Bulk: una operación sobre un archivo

Sube un UTF-8 archivo con uno YouTube video ID por línea. Seleccione una fuente soportada y un conjunto de opciones para todo el archivo. Bulk escanea el archivo, presenta trabajo dentro de la capacidad de cuenta y los paquetes resultados en partes descargables.

  1. Elija metadatos, transcripción, subtítulos, clasificación de licencias o descarga. Bulk toma el vídeo IDs; use Batch para búsquedas de palabras clave.
  2. Use un trabajo separado cuando la fuente o las opciones cambien. Por ejemplo, los metadatos y las transcripciones para el mismo archivo son dos trabajos de Bulk.
  3. Para descargas, proporciona almacenamiento de destino y acceso de propietario con permiso youtube_download. Las filas de resultados describen los medios entregados; los archivos multimedia se almacenan en su cubo.
video-ids.txt
dQw4w9WgXcQ
jNQXAC9IVRw

Planifica cómo recopilarás los resultados

ResponsabilidadBatchBulk
Ahorro después de la presentaciónCada queries[].id, vinculado a su entrada original. No hay un solo trabajo Batch ID.Un trabajo Bulk ID y el archivo de entrada sin cambios.
Finalización de las actividadesCada trabajo termina independientemente; un fallo no describe todo el lote.Un trabajo expone los recuentos de progreso. los resultados completos se empaquetan, no es que cada vídeo haya tenido éxito.
Reunir la producciónObtenga el resultado de cada trabajo completado y mantenga su cartografía de entrada a ID.Tome el manifiesto y cada parte NDJSON comprimido. Únete por índice y video_id, no orden de fila.
Reanúcese después de la interrupciónLea el trabajo guardado IDs antes de considerar nuevas presentaciones.Compruebe el Bulk ID. Resolver pauseReason y reanudar ese trabajo si se detuvo.

Verificación de la capacidad y el costo antes de comenzar

Check¿Qué explicar para
BatchEl maxBatchSize de su plan limita las consultas por sumisión. Dividir conjuntos más grandes en grupos más pequeños y respetar la capacidad de trabajo pendiente.
BulkHasta 2 GiB por archivo ID. El trabajo se presenta gradualmente dentro de la capacidad de cuenta compartida; eliminar duplicados antes de subir.
CréditosLa agrupación no es una carga plana. Las consultas usan los precios por fuente; las descargas se miden por el tamaño de los datos entregados.
AccesoLa clave debe permitir todas las fuentes solicitadas. Revisa los límites de la cuenta activa; una prueba tiene capacidad restringida.