본문으로 건너뛰기
KO
API 키 받기
문서 둘러보기

API 참조

Batch와 대량

다른 입력을 가진 독립적인 쿼리를 위한 Batch를 선택하십시오. Bulk를 선택하여 모든 작업이 동일한 작업을 필요로하는 비디오 IDs의 파일을 선택하십시오.

이 페이지의 내용

당신이해야 할 작업에 의해 선택

선택은 입력의 모양에 따라 달라집니다, 고정 항목의 수. 두 모드 모두 배경에서 실행합니다. 1개의 쿼리를 위해, realtime 또는 async를 직접 사용하십시오.

당신의 작업제품 정보
일상의 간결에 대한 몇 가지 주제를 검색Batch: 각 쿼리는 자체 검색 조건, 위치 또는 언어가 있습니다.
Google 결과와 연구 작업에 YouTube 메타데이터를 결합Batch: 혼합 소스 및 각 쿼리에 대한 별도의 결과를 수집합니다.
metadata를 새로 고침하거나 비디오 카탈로그에 transcripts를 수집Bulk: 한 비디오-ID 파일, 하나의 소스 및 모든 비디오에 대한 같은 옵션.
같은 형식으로 비디오의 목록을 버킷에 전달Bulk: youtube_download를 사용하여 공유 미디어 설정 및 목적지 저장.
각 영상을 위한 다른 산출 조정을 사용하십시오Batch: Per-query 모수는 다를 수 있습니다; Bulk는 전체 파일에 1 세트를 적용합니다.

Batch: 독립적인 쿼리

쿼리를 포함하는 JSON 개체를 전송합니다. 각 품목에는 그것의 자신의 근원, 입력 및 params가 있습니다. Google 검색, YouTube 검색, 혼합 소스, 또는 다른 옵션이 필요한 비디오에 Batch를 사용하십시오.

Batch 입력 · 두 가지 다른 작업
{
  "queries": [
    {
      "source": "google_search",
      "query": "open source speech recognition",
      "params": {
        "num": 5
      }
    },
    {
      "source": "youtube_metadata",
      "video_id": "dQw4w9WgXcQ",
      "params": {}
    }
  ]
}

Bulk: 파일에 1개의 가동

UTF-8 파일을 하나의 YouTube 비디오 ID로 업로드하십시오. 지원된 소스를 선택 하 고 전체 파일에 대 한 옵션의 한 세트. Bulk는 파일을 검사하고, 계정 용량 및 패키지 결과 내의 작업을 다운로드 가능한 부품으로 제출합니다.

  1. metadata, transcript, captions, license 분류 또는 다운로드를 선택하십시오. Bulk 비디오 IDs; 키워드 검색에 Batch를 사용합니다.
  2. 소스 또는 옵션 변경시 별도의 작업을 사용합니다. 예를 들어, 같은 파일에 대한 메타 데이터 및 성적표는 Bulk 작업입니다.
  3. 다운로드를 위해, youtube_download 권한을 가진 목적지 저장 및 소유자 접근을 제공합니다. 결과 행은 매체를 설명합니다; 매체 파일은 당신의 물통에서 저장됩니다.
video-ids.txt
dQw4w9WgXcQ
jNQXAC9IVRw

결과를 수집하는 방법 계획

책임BatchBulk
제출 후 저장모든 queries[].id는 원본 입력에 연결했습니다. Batch 작업은 없습니다. ID.1 Bulk 작업 ID 및 변하지 않은 입력 파일.
트랙 완료각 일은 자주적으로 끝납니다; 1개의 실패는 전체적인 배치를 설명하지 않습니다.한 작업 노출 진행 수. 완료된 결과 패키지, 하지 그 모든 비디오 성공.
수집 산출각 완료된 작업의 결과를 Fetch하고 입력-to-ID 매핑을 유지합니다.나타날과 모든 압축 NDJSON 부분을 잡아라. 인덱스 및 video_id에 의해 가입, 줄 순서.
중단 후에 Resume새 제출을 고려하기 전에 저장된 작업 IDs를 읽으십시오.저장된 Bulk ID를 검사하십시오. pauseReason를 해결하고 일시 중지하는 경우 작업을 재개합니다.

시작하기 전에 수용량과 비용을 검사하십시오

확인계정 정보
Batch플랜의 maxBatchSize는 제출 당 쿼리를 제한합니다. 더 큰 세트를 더 작은 그룹으로 분할하고 pending-job 수용량을 존중하십시오.
Bulk최대 2 GiB 당 ID 파일. 작업은 공유 계정 용량 내에서 점차 제출됩니다. 업로드하기 전에 중복 제거하십시오.
크레딧Grouping는 1개의 편평한 책임이 없습니다. 쿼리 사용 per-source 가격; 다운로드는 전달된 데이터 크기에 의해 미터.
오시는 길열쇠는 각 요구한 근원을 허용해야 합니다. 활성 계정의 제한을 확인; 체험은 전체 용량 계정이 아닙니다.