Package google.ads.dai.v1

شاخص

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

نشانی اینترنتی خلاقیتی که برای جذب استفاده شده است. این نشانی وب تعیین‌شده یا نشانی اینترنتی نمایش رسانه انتخابی است که بر اساس ویژگی‌های ارائه شده در درخواست انتخاب شده است.

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) منبع خلاق، در قالب Creatives/ id .

advertiser

string

نام تبلیغ کننده در این خلاقیت نشان داده شده است.

ad_system

string

مورد نیاز. نام سیستم تبلیغاتی که درخواست ورودی را ایجاد می کند.

ad_title

string

عنوان آگهی.

ad_description

string

شرح آگهی.

mezzanines[]

MediaFile

آدرس فایل های میزانسن آگهی و ویژگی های آنها. حداقل یکی از mezannines یا media_files مورد نیاز است.

media_files[]

MediaFile

نشانی‌های اینترنتی فایل رسانه‌ای آگهی و ویژگی‌های آن‌ها. حداقل یکی از mezannines یا media_files مورد نیاز است.

network_code

string

اختیاری. کد شبکه Google Ad Manager ناشر که خلاقیت برای آن در نظر گرفته شده است. اگر خلاقیت پویا باشد و DynamicCreativeInfo در CreateCreativeRequest پر شده باشد، ضروری است.

DeleteCreativeRequest

درخواست PartnerDiscoveryService.DeleteCreative .

فیلدها
name

string

شناسه ویدیوی خلاق Google حذف می شود.

DynamicCreativeInfo

اطلاعات لازم برای خلاقیت پویا برای انجام پردازش VCL.

فیلدها
dynamic_group_id

string

شناسه‌ای که نشان‌دهنده اصلی آگهی ویدیویی خلاق است. همه خلاقیت‌های پویا تحت شناسه گروه پویا یکسان را می‌توان دارای محتوای یکسان اما با جنبه‌های پویا متفاوت برای خلاق در نظر گرفت.

active_duration

Duration

مدت زمانی که این خلاقیت فعال و در حال استفاده در نظر گرفته می شود. پس از این زمان، خلاقیت برای حذف در مخزن خلاقیت ویدیو برنامه ریزی می شود. مدت زمان حداکثر 180 روز خواهد بود. اگر این قسمت نامشخص باقی بماند، مدت زمان پیش‌فرض 30 روز اعمال می‌شود.

دلیل شکست

دلیل شکست خوردن خلاقانه

فیلدها
reason

Reason

شرح شکست خوردن خلاق.

code

int32

اگر دلیل DOWNLOAD_ERROR باشد، کد وضعیت HTTP خراب می شود.

دلیل

دلایل احتمالی برای عدم موفقیت در مصرف خلاق.

Enums
REASON_UNSPECIFIED مقدار پیش فرض
DOWNLOAD_ERROR دانلود HTTP ناموفق بود.
INTERNAL_ERROR خطای داخلی
INVALID_MEDIA رسانه نامعتبر

GetCreativeRequest

درخواست PartnerDiscoveryService.GetCreative .

فیلدها
name

string

شناسه ویدیوی خلاق گوگل.

وضعیت بلع

وضعیت دریافت درخواست Create Creative.

فیلدها
state

State

وضعیت فعلی جذب یک خلاقیت ویدیویی.

failure_reason

FailureReason

دلیل شکست خوردن خلاقیت، در صورت شکست خوردن.

update_time

Timestamp

زمانی که کار جذب آخرین به‌روزرسانی شد.

ایالت

حالت بلعیدن.

Enums
STATE_UNSPECIFIED مقدار پیش فرض
PROCESSING ویدیوی خلاقانه هنوز در حال پردازش است.
SUCCESS پردازش خلاقیت ویدیو با موفقیت به پایان رسید.
FAILURE خلاقیت ویدیو جذب نشد، FailureReason را ببینید.

MediaFile

ویژگی های مربوط به یک فایل رسانه ای معین.

فیلدها
uri

string

مورد نیاز. URL منحصر به فرد فایل رسانه ای خلاق.

delivery

Delivery

مورد نیاز. نوع تحویل خلاقیت

height

int32

ارتفاع اصلی فایل ویدیویی، بر حسب پیکسل.

width

int32

عرض اصلی فایل ویدیویی، بر حسب پیکسل.

mime_type

string

مورد نیاز. نوع MIME برای محفظه فایل. انواع محبوب MIME عبارتند از "video/x-flv" برای Flash Video و "video/mp4" برای MP4.

min_bitrate

int32

حداقل میزان بیت فایل رسانه ای. برای ویدیوی بارگذاری پیش رونده، این مقدار باید نرخ بیت متوسط ​​باشد.

max_bitrate

int32

حداکثر نرخ بیت فایل رسانه ای. برای ویدیوی بارگذاری پیش رونده، این مقدار باید نرخ بیت متوسط ​​باشد.

تحویل

انواع تحویل

Enums
DELIVERY_UNSPECIFIED مقدار تحویل پیش‌فرض
DELIVERY_PROGRESSIVE تحویل ویدئویی پیشرفته
DELIVERY_STREAMING پخش جریانی ویدیو.