Method: advertisers.adAssets.upload

광고 확장 소재를 업로드하고 만듭니다.

성공하면 새로 생성된 광고 확장 소재의 ID를 반환합니다.

AdAssetType AD_ASSET_TYPE_IMAGE이 있는 애셋의 업로드만 지원합니다.

HTTP 요청

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

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

경로 매개변수

매개변수
advertiserId

string (int64 format)

필수 항목입니다. 이 광고 확장 소재가 속한 광고주의 ID입니다.

요청 본문

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

JSON 표현 
{
  "filename": string,
  "adAssetType": enum (AdAssetType),
  "syntheticContentAttestationStatus": enum (SyntheticContentAttestationStatus)
}
필드
filename

string

필수 항목입니다. 파일 확장자를 포함한 광고 확장 소재의 파일 이름입니다.

파일 이름은 최대 크기가 240바이트인 UTF-8로 인코딩되어야 합니다.
adAssetType

enum (AdAssetType)

필수 항목입니다. 광고 확장 소재의 유형입니다.

AD_ASSET_TYPE_IMAGE만 지원됩니다.
syntheticContentAttestationStatus

enum (SyntheticContentAttestationStatus)

선택사항입니다. 현지 AI 라벨 지정 규정이 있는 지역에서 게재될 때 확장 소재에 AI를 사용하여 생성 또는 수정되었다는 라벨을 추가할지 여부입니다.

응답 본문

adAssets.upload의 응답 메시지입니다.

성공한 경우 응답 본문은 다음과 같은 구조의 데이터를 포함합니다.

JSON 표현 
{
  "adAsset": {
    object (AdAsset)
  }
}
필드
adAsset

object (AdAsset)

생성된 광고 확장 소재입니다.

승인 범위

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

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

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