Package google.ads.dai.v1

الفهرس

PartnerDiscoveryService

إدارة نقل الإعلانات أثناء عرض الفيديو وتحميل المواد الإبداعية إلى 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

معلومات عن تصميم الإعلان الديناميكي مطلوبة إذا كان تصميم الإعلان الذي سيتم نقله ديناميكيًا.

تصميم الإعلان

مرجع تصميم إعلان يُرجى تقديم طلبك كمقدّم response عند إكمال PartnerDiscoveryService.CreateCreative.

الحقول
name

string

النتائج فقط. الاسم الفريد (معرّف فيديو Google) لمورد تصميم الإعلان، بالتنسيق 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" للناشر المخصّص له تصميم الإعلان. مطلوبة إذا كان تصميم الإعلان ديناميكيًا وتمّت تعبئة DynamicCreativeInfo في CreateCreativeRequest.

DeleteCreativeRequest

طلب PartnerDiscoveryService.DeleteCreative

الحقول
name

string

معرّف فيديو Google لتصميم الإعلان المطلوب حذفه

DynamicCreativeInfo

المعلومات اللازمة لتصميم إعلان ديناميكي لتنفيذ معالجة VCL

الحقول
dynamic_group_id

string

معرّف يمثّل إعلان الفيديو الأساسي لتصميم الإعلان. يمكن اعتبار أنّ جميع المواد الإبداعية الديناميكية ضمن معرّف المجموعة الديناميكية نفسه تتضمّن المحتوى نفسه ولكن مع جوانب ديناميكية مختلفة للمواد الإبداعية.
active_duration

Duration

المدة التي يُعتبَر فيها تصميم الإعلان هذا نشطًا وقيد الاستخدام. وبعد هذه الفترة، سيتم تحديد موعد لحذف تصميم الإعلان في مستودع تصميمات إعلانات الفيديو. وسيتم تحديد الحد الأقصى لمدة الاشتراك في 180 يومًا. في حال ترك هذا الحقل بدون تحديد، سيتم تطبيق مدة تلقائية مدتها 30 يومًا.

FailureReason

سبب تعذُّر نقل تصميم الإعلان

الحقول
reason

Reason

وصف لعملية نقل تصميم الإعلان التي تعذّر إكمالها
code

int32

رمز حالة HTTP للتعذّر إذا كان السبب هو DOWNLOAD_ERROR

السبب

الأسباب المحتمَلة لفشل نقل تصميم الإعلان

عمليات التعداد
REASON_UNSPECIFIED القيمة التلقائية
DOWNLOAD_ERROR تعذّر تنزيل HTTP.
INTERNAL_ERROR حدث خطأ داخلي.
INVALID_MEDIA الوسائط غير صالحة.

GetCreativeRequest

طلب PartnerDiscoveryService.GetCreative

الحقول
name

string

رقم تعريف فيديو Google لتصميم الإعلان

IngestionStatus

حالة نقل بيانات طلب "إنشاء تصميم إعلان".

الحقول
state

State

حالة نقل بيانات تصميم إعلان الفيديو الحالية
failure_reason

FailureReason

سبب تعذُّر نقل تصميم الإعلان، في حال تعذُّر نقله
update_time

Timestamp

وقت آخر تعديل تم إجراؤه على مهمة نقل البيانات

الحالة

حالة نقل البيانات

عمليات التعداد
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/mp4" لتنسيق MP4.
min_bitrate

int32

الحد الأدنى لمعدّل نقل البيانات لملف الوسائط بالنسبة إلى الفيديوهات التي يتم تحميلها تدريجيًا، يجب أن تكون هذه القيمة هي متوسط معدل نقل البيانات.
max_bitrate

int32

الحد الأقصى لمعدل نقل البيانات في ملف الوسائط بالنسبة إلى الفيديوهات التي يتم تحميلها تدريجيًا، يجب أن تكون هذه القيمة هي متوسط معدل نقل البيانات.

خدمة توصيل

أنواع العرض

عمليات التعداد
DELIVERY_UNSPECIFIED قيمة التسليم التلقائية
DELIVERY_PROGRESSIVE تسليم الفيديوهات بشكل تدريجي
DELIVERY_STREAMING بث الفيديوهات