미디어 업로드 기능을 사용하면 Display & Video 360에서 사용할 수 있는 데이터를 저장할 수 있습니다. 업로드할 수 있는 데이터 종류에는 사진, 동영상, ZIP 파일 등이 있습니다.
업로드 옵션
Display & Video 360 API를 사용하면 특정 유형의 바이너리 데이터 또는 미디어를 업로드할 수 있습니다. 업로드할 수 있는 데이터의 특성은 미디어 업로드가 필요한 작업의 개발자 가이드에 자세히 설명되어 있습니다.
- 최대 업로드 파일 크기: 이 메서드로 저장할 수 있는 최대 데이터 양입니다.
- 허용되는 미디어 MIME 유형: 이 메서드로 저장할 수 있는 바이너리 데이터 유형입니다.
업로드 요청은 다음과 같은 방법으로 실행할 수 있습니다. uploadType 매개변수와 함께 사용할 메서드를 지정합니다.
- 간단한 업로드:
uploadType=media. 약 5MB 이하의 파일을 빠르게 전송합니다. - 멀티파트 업로드:
uploadType=multipart. 파일 및 관련 메타데이터를 빠르게 전송합니다. 단일 요청으로 파일과 메타데이터를 모두 전송합니다.
미디어를 업로드할 때는 /upload URI를 사용합니다. 미디어 데이터 자체를 전송할 때는 이 URI를 사용합니다.
예:
POST /upload/media/resource-name
간단한 업로드
간단한 업로드 요청은 파일을 업로드하는 가장 쉬운 방법입니다. 다음과 같은 경우에 적합합니다.
- 필요한 경우 파일을 다시 업로드할 수 있을 정도로 파일이 작습니다.
- 전송할 메타데이터가 없습니다. 메타데이터가 필요하지 않거나 요청의 다른 곳에 포함된 경우에 해당될 수 있습니다.
간단한 업로드를 사용하려면 메서드의 /upload URI에 POST 또는 PUT 요청을 실행하고 쿼리 매개변수 uploadType=media를 추가합니다. 예를 들면 다음과 같습니다.
POST https://displayvideo.googleapis.com/upload/media/resource-name?uploadType=media
간단한 업로드를 실행할 때 사용하는 HTTP 헤더에는 다음이 포함됩니다.
Content-Type: 메서드에서 허용되는 미디어 데이터 유형 중 하나로 설정합니다.Content-Length: 업로드하는 바이트 수로 설정합니다. 단위 분할된 전송 인코딩을 사용하는 경우에는 설정할 필요가 없습니다.
멀티파트 업로드
업로드할 데이터와 함께 전송할 메타데이터가 있는 경우 multipart/related 요청을 실행하면 됩니다. 이 옵션은 전송할 데이터가 필요한 경우 다시 업로드해도 될 만큼 작은 경우에 효과적입니다.
멀티파트 업로드를 사용하려면 메서드의 /upload URI에 POST 또는 PUT 요청을 실행하고 쿼리 매개변수 uploadType=multipart를 추가합니다. 예를 들면 다음과 같습니다.
POST https://displayvideo.googleapis.com/upload/v4/advertisers/advertiser-id/assets?uploadType=multipart
멀티파트 업로드 요청을 실행할 때 사용하는 최상위 HTTP 헤더에는 다음 항목이 포함됩니다.
Content-Type:multipart/related로 설정하고 요청에서 관련 파트를 식별하는 데 사용되는 경계 문자열을 포함합니다.Content-Length: 요청 본문의 총 바이트 수로 설정합니다. 요청의 미디어 부분이 이 메서드에 지정된 최대 파일 크기보다 작아야 합니다.
요청 본문 형식은 multipart/related 콘텐츠 유형 [RFC2387] 이며 정확히 두 파트로 구성됩니다. 파트는 경계 문자열로 식별되며 최종 경계 문자열 뒤에는 하이픈 2개가 나옵니다.
멀티파트 요청의 각 파트에는 추가 Content-Type 헤더가 필요합니다.
- 메타데이터 파트: 첫 번째 위치에 있어야 하며
Content-Type은 허용되는 메타데이터 형식 중 하나와 일치해야 합니다. - 미디어 파트: 두 번째 위치에 있어야 하며
Content-Type은 메서드에서 허용하는 미디어 MIME 유형 중 하나와 일치해야 합니다.
예
Display & Video 360 API를 사용하여 미디어를 업로드하여 다양한 작업을 실행합니다. 이 섹션에서는 curl 요청으로 예를 제공합니다.
광고 애셋 업로드
광고 애셋을 업로드하는 방법은 다음과 같습니다.
curl --request POST \
'https://displayvideo.googleapis.com/upload/v4/advertisers/advertiser-id/assets?uploadType=multipart' \
--header 'Authorization: Bearer access-token' \
-F "data={\"filename\": \"asset-filename\"};type=application/json;charset=UTF-8" \
-F "file=@asset-path;type=asset-mime-type"자세한 내용과 코드 예시는 광고 소재 애셋 업로드 가이드를 참고하세요.
맞춤 입찰 스크립트 파일 업로드
스크립트 파일을 업로드하는 방법은 다음과 같습니다.
curl --request POST \
'https://displayvideo.googleapis.com/upload/media/resource-name?uploadType=media' \
-H 'authorization: Bearer access-token' \
-H 'Content-Type: text/plain' \
--data-binary @script-path자세한 내용과 코드 예시는 업로드 스크립트 가이드를 참고하세요.