Method: advertisers.sdfuploadtasks.upload

SDF 업로드 태스크를 만듭니다. Operation를 반환합니다.

SDF 업로드 작업은 장기 실행 비동기 작업입니다. 이 작업의 metadata 유형은 SdfUploadTaskMetadata입니다. 요청이 성공하면 작업의 response 유형이 SdfUploadTask입니다. 응답에는 결과 파일이 포함되지 않으며, 이 파일은 media.download를 사용하여 검색할 수 있습니다.

작업 상태는 sdfuploadtask.operations.get를 사용하여 검색할 수 있습니다.

오류는 error.message에서 확인할 수 있습니다. error.details는 비어 있어야 합니다.

HTTP 요청

  • 업로드 URI, 미디어 업로드 요청:
    POST https://displayvideo.googleapis.com/upload/v4/advertisers/{advertiserId}/sdfuploadtasks
  • 메타데이터 URI, 메타데이터 전용 요청:
    POST https://displayvideo.googleapis.com/v4/advertisers/{advertiserId}/sdfuploadtasks

URL은 gRPC 트랜스코딩 문법을 사용합니다.

경로 매개변수

매개변수
advertiserId

string (int64 format)

필수 항목입니다. SDF를 업로드할 광고주의 ID입니다.

요청 본문

요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.

JSON 표현 
{
  "filename": string,
  "sdfVersion": enum (SdfVersion)
}
필드
filename

string

필수 항목입니다. 파일 확장자를 포함한 저작물의 파일 이름입니다. 파일 이름은 UTF-8로 인코딩되어야 하며 최대 크기는 240바이트여야 합니다.
sdfVersion

enum (SdfVersion)

필수 항목입니다. 업로드된 파일의 SDF 버전입니다. SDF_VERSION_UNSPECIFIED로 설정하면 기본적으로 식별된 광고주가 지정한 버전으로 설정됩니다. 광고주는 달리 구성하지 않는 한 파트너로부터 SDF 버전을 상속합니다.

응답 본문

성공한 경우 응답 본문에 Operation의 인스턴스가 포함됩니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/display-video

자세한 내용은 OAuth 2.0 Overview를 참고하세요.