애셋을 업로드합니다. 성공하면 새로 업로드된 저작물의 ID를 반환합니다. 저작물 파일 크기는 이미지의 경우 10MB, ZIP 파일의 경우 200MB, 동영상의 경우 1GB 이하여야 합니다.
멀티파트 미디어 업로드 프로세스 내에서 사용해야 합니다. 제공된 클라이언트 라이브러리를 사용하는 예시는 광고 소재 만들기 가이드에서 확인할 수 있습니다.
HTTP 요청
- 업로드 URI, 미디어 업로드 요청:
POST https://displayvideo.googleapis.com/upload/v3/advertisers/{advertiserId}/assets
URL은 gRPC 트랜스코딩 문법을 사용합니다.
경로 매개변수
매개변수 | |
---|---|
advertiser |
필수 항목입니다. 이 확장 소재가 속한 광고주의 ID입니다. |
요청 본문
요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.
JSON 표현 |
---|
{ "filename": string } |
필드 | |
---|---|
filename |
필수 항목입니다. 파일 확장자를 포함한 저작물의 파일 이름입니다. 파일 이름은 UTF-8로 인코딩되어야 하며 최대 크기는 240바이트여야 합니다. |
응답 본문
assets.upload
의 응답 메시지입니다.
성공한 경우 응답 본문은 다음과 같은 구조의 데이터를 포함합니다.
JSON 표현 |
---|
{
"asset": {
object ( |
필드 | |
---|---|
asset |
업로드된 저작물(업로드에 성공한 경우) |
승인 범위
다음 OAuth 범위가 필요합니다.
https://www.googleapis.com/auth/display-video
자세한 내용은 OAuth 2.0 개요를 참고하세요.