Package google.ads.dai.v1

색인

• PartnerDiscoveryService(인터페이스)
• CreateCreativeOperationMetadata(메시지)
• CreateCreativeRequest(메시지)
• Creative(메시지)
• DeleteCreativeRequest(메시지)
• DynamicCreativeInfo(메시지)
• FailureReason(메시지)
• FailureReason.Reason(열거형)
• GetCreativeRequest(메시지)
• IngestionStatus(메시지)
• IngestionStatus.State(열거형)
• MediaFile(메시지)
• MediaFile.Delivery(열거형)

PartnerDiscoveryService

광고 소재의 DAI 처리 및 YouTube 업로드를 관리합니다.

CreateCreative
rpc CreateCreative(CreateCreativeRequest) returns (Operation) 광고 소재를 만듭니다. 성공적으로 완료되면 response 필드에 광고 소재를 반환하고 실패하면 google.rpc.Code를 반환합니다. 처리 상태를 포함하는 CreateCreativeOperationMetadata를 metadata 필드에 반환합니다.

DeleteCreative
rpc DeleteCreative(DeleteCreativeRequest) returns (Empty) 광고 소재를 삭제합니다.

GetCreative
rpc GetCreative(GetCreativeRequest) returns (Creative) 광고 소재를 가져옵니다.

CreateCreativeOperationMetadata

CreateCreative에서 반환된 장기 실행 작업의 메타데이터입니다. metadata로 표시합니다.

필드
creative_url	string 처리에 사용된 광고 소재의 URL입니다. 선택된 미드젠인 URL 또는 미디어 렌더링 URL로, 요청에 제공된 속성을 기반으로 선택됩니다.
gv_registry_id	string 처리가 성공한 경우 동영상 광고 소재의 고유 식별자입니다. 광고 소재 리소스의 이름은 creatives/gv_registry_id입니다.
create_time	Timestamp 처리 요청이 생성된 시간입니다.
youtube_status	IngestionStatus 현재 YouTube 처리 상태입니다.

CreateCreativeRequest

PartnerDiscoveryService.CreateCreative를 요청합니다.

필드
creative	Creative 처리할 광고 소재입니다.
dynamic_creative_info	DynamicCreativeInfo 동적 광고 소재에 대한 정보입니다. 처리할 광고 소재가 동적인 경우 필요합니다.

광고 소재

광고 소재 리소스 PartnerDiscoveryService.CreateCreative가 완료되면 response로 표시합니다.

필드
name	string 출력 전용입니다. 광고 소재 리소스의 고유한 이름 (Google 동영상 ID)으로, creatives/id 형식입니다.
advertiser	string 이 광고 소재에 등장하는 광고주의 이름입니다.
ad_system	string 필수입니다. 처리 요청을 생성하는 광고 시스템의 이름입니다.
ad_title	string 광고 제목입니다.
ad_description	string 광고에 대한 설명입니다.
mezzanines[]	MediaFile 광고의 미드제인 파일 URL 및 속성입니다. mezannines 또는 media_files 중 하나 이상이 필요합니다.
media_files[]	MediaFile 광고의 미디어 파일 URL 및 속성입니다. mezannines 또는 media_files 중 하나 이상이 필요합니다.
network_code	string 선택사항입니다. 광고 소재가 게재될 게시자의 Google Ad Manager 네트워크 코드입니다. 광고 소재가 동적이며 CreateCreativeRequest에 DynamicCreativeInfo가 채워져 있는 경우 필요합니다.

DeleteCreativeRequest

PartnerDiscoveryService.DeleteCreative를 요청합니다.

필드
name	string 삭제할 광고 소재의 Google 동영상 ID입니다.

DynamicCreativeInfo

동적 광고 소재가 VCL 처리를 실행하는 데 필요한 정보입니다.

필드
dynamic_group_id	string 광고 소재의 핵심 동영상 광고를 나타내는 ID입니다. 동일한 동적 그룹 ID 아래의 모든 동적 광고 소재는 콘텐츠는 동일하지만 광고 소재의 동적 측면은 다르다고 간주할 수 있습니다.
active_duration	Duration 이 광고 소재가 활성 상태로 간주되어 사용되는 기간입니다. 이 기간이 지나면 동영상 광고 소재 저장소에서 광고 소재가 삭제될 예정입니다. 기간은 최대 180일로 제한됩니다. 이 필드를 지정하지 않으면 기본 기간인 30일이 적용됩니다.

FailureReason

광고 소재 처리 실패 이유입니다.

필드
reason	Reason 광고 소재 처리 실패에 대한 설명입니다.
code	int32 이유가 DOWNLOAD_ERROR인 경우 실패의 HTTP 상태 코드입니다.

이유

광고 소재 처리 실패의 원인

열거형
REASON_UNSPECIFIED	기본값
DOWNLOAD_ERROR	HTTP 다운로드에 실패했습니다.
INTERNAL_ERROR	내부 오류입니다.
INVALID_MEDIA	잘못된 미디어입니다.

GetCreativeRequest

PartnerDiscoveryService.GetCreative를 요청합니다.

필드
name	string 광고 소재의 Google 동영상 ID입니다.

IngestionStatus

광고 소재 만들기 요청의 처리 상태입니다.

필드
state	State 동영상 광고 소재의 현재 처리 상태입니다.
failure_reason	FailureReason 처리가 실패한 경우 광고 소재가 처리되지 못한 이유입니다.
update_time	Timestamp 처리 작업이 마지막으로 업데이트된 시간입니다.

주

처리 상태입니다.

열거형
STATE_UNSPECIFIED	기본값
PROCESSING	동영상 광고 소재가 아직 처리 중입니다.
SUCCESS	동영상 광고 소재 처리가 완료되었습니다.
FAILURE	동영상 광고 소재를 처리하지 못했습니다. FailureReason을 참고하세요.

미디어 파일

지정된 미디어 파일과 관련된 속성입니다.

필드
uri	string 필수입니다. 광고 소재의 미디어 파일로 연결되는 고유한 URL입니다.
delivery	Delivery 필수입니다. 광고 소재의 게재 유형입니다.
height	int32 동영상 파일의 기본 높이(단위: 픽셀)입니다.
width	int32 동영상 파일의 기본 너비(단위: 픽셀)입니다.
mime_type	string 필수입니다. 파일 컨테이너의 MIME 유형입니다. 일반적인 MIME 유형에는 Flash 동영상의 경우 'video/x-flv', MP4의 경우 'video/mp4'가 있습니다.
min_bitrate	int32 미디어 파일의 최소 비트 전송률입니다. 프로그레시브 로드 동영상의 경우 이 값은 평균 비트 전송률이어야 합니다.
max_bitrate	int32 미디어 파일의 최대 비트 전송률입니다. 프로그레시브 로드 동영상의 경우 이 값은 평균 비트 전송률이어야 합니다.

배달

전송 유형

열거형
DELIVERY_UNSPECIFIED	기본 전송 값입니다.
DELIVERY_PROGRESSIVE	프로그레시브 동영상 전송
DELIVERY_STREAMING	스트리밍 동영상 전송