DV360 Out of Home Seller API

تتيح واجهة "مساحة العرض والفيديو 360 خارج المنزل للبائع" إدارة المستودع وحجز الطلبات والحصول على تصميمات الإعلانات وإرسال أحداث تشغيل الإعلانات.

الخدمة: dv360outofhomeseller.googleapis.com

للاتصال بهذه الخدمة، ننصحك باستخدام مكتبات العملاء التي توفّرها Google. إذا كان تطبيقك يحتاج إلى استخدام مكتباتك الخاصة لاستدعاء هذه الخدمة، فاستخدم المعلومات التالية عند تقديم طلبات واجهة برمجة التطبيقات.

مستند "اقتراحات"

مستند الاستكشاف هو مواصفات يمكن للآلة قراءتها لوصف واجهات برمجة تطبيقات REST واستخدامها. ويتم استخدامه لإنشاء مكتبات للعملاء ومكوّنات IDE وأدوات أخرى تتفاعل مع Google APIs. قد توفّر خدمة واحدة مستندات اكتشاف متعددة. توفّر هذه الخدمة مستندات الاكتشاف التالية:

نقطة نهاية الخدمة

نقطة نهاية الخدمة هي عنوان URL أساسي يحدد عنوان الشبكة لخدمة واجهة برمجة التطبيقات. قد تتضمن خدمة واحدة نقاط نهاية متعددة للخدمة. تحتوي هذه الخدمة على نقطة نهاية الخدمة التالية وجميع معرّفات الموارد المنتظمة (URI) التالية مرتبطة بنقطة نهاية الخدمة هذه:

  • https://dv360outofhomeseller.googleapis.com

مورد REST: v1beta1

الطُرق
lookupByExternalId POST /v1beta1:lookupByExternalId
استرداد جميع الكيانات حسب المعرّف الخارجي المُدرَج في الطلب.

مورد REST: v1beta1.adPlays

الطُرق
create POST /v1beta1/adPlays
يتم إنشاء تشغيل للإعلان.
createWithExternalIds POST /v1beta1/adPlays:createWithExternalIds
تُنشئ عملية تشغيل إعلان باستخدام أرقام تعريف خارجية.

مورد REST: v1beta1.adUnits

الطُرق
create POST /v1beta1/adUnits
تُنشئ وحدة إعلانية جديدة.
delete DELETE /v1beta1/{name=adUnits/*}
يؤدي هذا الخيار إلى حذف وحدة إعلانية حالية.
get GET /v1beta1/{name=adUnits/*}
يسترد هذا الإعداد وحدة إعلانية فردية.
list GET /v1beta1/adUnits
يسرد الوحدات الإعلانية.
patch PATCH /v1beta1/{adUnit.name=adUnits/*}
لتعديل وحدة إعلانية حالية.

مورد REST: v1beta1.availabilityOrders

الطُرق
complete POST /v1beta1/{name=availabilityOrders/*}:complete
وضع علامة "مكتمل" على طلب مدى التوفّر الحالي.
get GET /v1beta1/{name=availabilityOrders/*}
استرداد طلب مدى توفّر فردي.
list GET /v1beta1/availabilityOrders
يتم عرض طلبات مدى التوفّر.

مورد REST: v1beta1.availabilityOrders.availabilityLines

الطُرق
complete POST /v1beta1/{name=availabilityOrders/*/availabilityLines/*}:complete
وضع علامة "مكتمل" على سطر مدى التوفّر الحالي.
get GET /v1beta1/{name=availabilityOrders/*/availabilityLines/*}
يسترد سطرًا فرديًا لطلب مدى التوفّر.
list GET /v1beta1/{parent=availabilityOrders/*}/availabilityLines
يسرد أسطرًا لطلب مدى التوفّر.
reject POST /v1beta1/{name=availabilityOrders/*/availabilityLines/*}:reject
يؤدي هذا الخيار إلى وضع علامة على سطر مدى التوفّر الحالي بأنّه مرفوض.

مورد REST: v1beta1.creativeAssets

الطُرق
get GET /v1beta1/{name=creativeAssets/*}
يسترد مادة عرض تصميم الإعلان الفردية.
list GET /v1beta1/creativeAssets
يسرد ملفات أصول المواد الإبداعية.
patch PATCH /v1beta1/{creativeAsset.name=creativeAssets/*}
تعديل مادة عرض حالية لتصميم الإعلان.

مورد REST: v1beta1.orders

الطُرق
get GET /v1beta1/{name=orders/*}
استرداد طلب فردي.
list GET /v1beta1/orders
يتم عرض الطلبات.
patch PATCH /v1beta1/{order.name=orders/*}
تعديل طلب حالي

مورد REST: v1beta1.orders.lines

الطُرق
book POST /v1beta1/{name=orders/*/lines/*}:book
حجز سطر حالي
get GET /v1beta1/{name=orders/*/lines/*}
يسترد سطرًا فرديًا لأحد الطلبات.
list GET /v1beta1/{parent=orders/*}/lines
يسرد سطور الطلب.
patch PATCH /v1beta1/{line.name=orders/*/lines/*}
يعدّل سطرًا حاليًا.
reject POST /v1beta1/{name=orders/*/lines/*}:reject
لرفض سطر حالي.
reserve POST /v1beta1/{name=orders/*/lines/*}:reserve
لحجز خط حالي.

مورد REST: v1beta1.orders.lines.assignments

الطُرق
approve POST /v1beta1/{name=orders/*/lines/*/assignments/*}:approve
تتم الموافقة على مهمة حالية.
disapprove POST /v1beta1/{name=orders/*/lines/*/assignments/*}:disapprove
يتم رفض مهمة حالية.
get GET /v1beta1/{name=orders/*/lines/*/assignments/*}
لاسترداد مهمة فردية لسطر.
list GET /v1beta1/{parent=orders/*/lines/*}/assignments
يتم عرض المهام لسطر معيّن.
patch PATCH /v1beta1/{assignment.name=orders/*/lines/*/assignments/*}
لتعديل مهمة دراسية حالية

مورد REST: v1beta1.products

الطُرق
create POST /v1beta1/products
ينشئ منتجًا جديدًا.
get GET /v1beta1/{name=products/*}
استرداد منتج فردي.
list GET /v1beta1/products
يتم عرض المنتجات.
patch PATCH /v1beta1/{product.name=products/*}
تعديل منتج حالي

مورد REST: v1.sellers.adPlays

الطُرق
batchCreate POST /v1/{parent=sellers/*}/adPlays:batchCreate
إنشاء عمليات تشغيل جديدة للإعلانات بشكلٍ مجمّع.
create POST /v1/{parent=sellers/*}/adPlays
يتم إنشاء تشغيل للإعلان.

مورد REST: v1.sellers.adUnits

الطُرق
create POST /v1/{parent=sellers/*}/adUnits
تُنشئ وحدة إعلانية جديدة.
delete DELETE /v1/{name=sellers/*/adUnits/*}
يؤدي هذا الخيار إلى حذف وحدة إعلانية حالية.
get GET /v1/{name=sellers/*/adUnits/*}
يسترد هذا الإعداد وحدة إعلانية فردية.
list GET /v1/{parent=sellers/*}/adUnits
يسرد الوحدات الإعلانية.
patch PATCH /v1/{adUnit.name=sellers/*/adUnits/*}
لتعديل وحدة إعلانية حالية.

مورد REST: v1.sellers.adUnits.impressionSchedules

الطُرق
batchUpdate POST /v1/{parent=sellers/*/adUnits/*}/impressionSchedules:batchUpdate
يتم تعديل الجداول الزمنية لمرّات الظهور بشكل مجمّع.
create POST /v1/{parent=sellers/*/adUnits/*}/impressionSchedules
يتم إنشاء جدول زمني جديد لمرات الظهور.
get GET /v1/{name=sellers/*/adUnits/*/impressionSchedules/*}
يسترد الجدول الزمني لمرات الظهور الفردية.
list GET /v1/{parent=sellers/*/adUnits/*}/impressionSchedules
يسرد الجداول الزمنية لمرات الظهور.
patch PATCH /v1/{impressionSchedule.name=sellers/*/adUnits/*/impressionSchedules/*}
تعديل جدول زمني حالي لمرات الظهور

مورد REST: v1.sellers.availabilityOrders

الطُرق
complete POST /v1/{name=sellers/*/availabilityOrders/*}:complete
وضع علامة "مكتمل" على طلب مدى التوفّر الحالي.
get GET /v1/{name=sellers/*/availabilityOrders/*}
استرداد طلب مدى توفّر فردي.
list GET /v1/{parent=sellers/*}/availabilityOrders
يتم عرض طلبات مدى التوفّر.

مورد REST: v1.sellers.availabilityOrders.availabilityLines

الطُرق
complete POST /v1/{name=sellers/*/availabilityOrders/*/availabilityLines/*}:complete
وضع علامة "مكتمل" على سطر مدى التوفّر الحالي.
get GET /v1/{name=sellers/*/availabilityOrders/*/availabilityLines/*}
يسترد سطرًا فرديًا لطلب مدى التوفّر.
list GET /v1/{parent=sellers/*/availabilityOrders/*}/availabilityLines
يسرد أسطرًا لطلب مدى التوفّر.
reject POST /v1/{name=sellers/*/availabilityOrders/*/availabilityLines/*}:reject
يؤدي هذا الخيار إلى وضع علامة على سطر مدى التوفّر الحالي بأنّه مرفوض.

مورد REST: v1.sellers.creativeAssets

الطُرق
get GET /v1/{name=sellers/*/creativeAssets/*}
يسترد مادة عرض تصميم الإعلان الفردية.
list GET /v1/{parent=sellers/*}/creativeAssets
يسرد ملفات أصول المواد الإبداعية.
patch PATCH /v1/{creativeAsset.name=sellers/*/creativeAssets/*}
تعديل مادة عرض حالية لتصميم الإعلان.

مورد REST: v1.sellers.orders

الطُرق
completeOrderBooking POST /v1/{order=sellers/*/orders/*}:completeOrderBooking
يكمل حجز الطلب.
completeOrderReservation POST /v1/{order=sellers/*/orders/*}:completeOrderReservation
لاستكمال حجز الطلب.
create POST /v1/{parent=sellers/*}/orders
يتم إنشاء طلب جديد.
get GET /v1/{name=sellers/*/orders/*}
استرداد طلب فردي.
list GET /v1/{parent=sellers/*}/orders
يتم عرض الطلبات.
patch PATCH /v1/{order.name=sellers/*/orders/*}
تعديل طلب حالي

مورد REST: v1.sellers.orders.lines

الطُرق
book POST /v1/{name=sellers/*/orders/*/lines/*}:book
حجز سطر حالي
create POST /v1/{parent=sellers/*/orders/*}/lines
يتم إنشاء سطر جديد.
get GET /v1/{name=sellers/*/orders/*/lines/*}
يسترد سطرًا فرديًا لأحد الطلبات.
list GET /v1/{parent=sellers/*/orders/*}/lines
يسرد سطور الطلب.
patch PATCH /v1/{line.name=sellers/*/orders/*/lines/*}
يعدّل سطرًا حاليًا.
reject POST /v1/{name=sellers/*/orders/*/lines/*}:reject
لرفض سطر حالي.
reserve POST /v1/{name=sellers/*/orders/*/lines/*}:reserve
لحجز خط حالي.

مورد REST: v1.sellers.orders.lines.assignments

الطُرق
approve POST /v1/{name=sellers/*/orders/*/lines/*/assignments/*}:approve
تتم الموافقة على مهمة حالية.
disapprove POST /v1/{name=sellers/*/orders/*/lines/*/assignments/*}:disapprove
يتم رفض مهمة حالية.
get GET /v1/{name=sellers/*/orders/*/lines/*/assignments/*}
لاسترداد مهمة فردية لسطر.
list GET /v1/{parent=sellers/*/orders/*/lines/*}/assignments
يتم عرض المهام لسطر معيّن.
patch PATCH /v1/{assignment.name=sellers/*/orders/*/lines/*/assignments/*}
لتعديل مهمة دراسية حالية

مورد REST: v1.sellers.products

الطُرق
create POST /v1/{parent=sellers/*}/products
ينشئ منتجًا جديدًا.
delete DELETE /v1/{name=sellers/*/products/*}
يؤدي هذا الخيار إلى حذف منتج حالي.
get GET /v1/{name=sellers/*/products/*}
استرداد منتج فردي.
list GET /v1/{parent=sellers/*}/products
يتم عرض المنتجات.
patch PATCH /v1/{product.name=sellers/*/products/*}
تعديل منتج حالي