Method: adBreak.networks.assets.adBreaks.list

واجهة برمجة التطبيقات لعرض "فواصل إعلانية" ضمن البث المباشر

طلب HTTP

GET https://admanagervideo.googleapis.com/v1/adBreak/{parent=networks/*/assets/*}/adBreaks

يستخدم عنوان URL بنية تحويل الترميز إلى gRPC.

مَعلمات المسار

المعلمات
parent

string

اختياريّ. يحدّد هذا الحقل LiveStreamEvent الذي يجب ربط فاصل الإعلان به باستخدام مفتاح مادة عرض البث المباشر. يجب أن يكون بالتنسيق "networks/{network_code}/assets/{asset_key}"

مَعلمات طلب البحث

المعلمات
customParent

string

اختياريّ. يحدّد هذا الحقل حدث LiveStreamEvent الذي يجب ربط فاصل الإعلانات به باستخدام مفتاح مادة العرض المخصّص. يجب أن يكون بالتنسيق "networks/{network_code}/customAssets/{asset_key}"

content

string

اختياريّ. هذه طريقة بديلة لتحديد LiveStreamEvent، إذا كانت مرتبطة بقطعة محتوى ضمن GAM. يجب أن يكون بالتنسيق "networks/{network_code}/sources/{content_source_id}/content/{cms_content_id}"

pageSize

integer

اختياريّ. الحدّ الأقصى لعدد فواصل الإعلانات التي سيتم عرضها. قد تعرض الخدمة عددًا أقل من هذه القيمة. إذا لم يتم تحديدها، سيتم عرض 10 فواصل إعلانية على الأكثر. الحد الأقصى للقيمة هو 100، وسيتم فرض القيمة 100 على القيم الأكبر من 100.

pageToken

string

اختياريّ. رمز مميز للصفحة تم تلقّيه من طلب adBreaks.list سابق. يجب تقديم هذا الرمز لاسترداد الصفحة التالية.

عند تقسيم النتائج إلى صفحات، يجب أن تتطابق جميع المَعلمات الأخرى المقدَّمة إلى adBreaks.list مع الطلب الذي قدّم رمز الصفحة المميز.

نص الطلب

يجب أن يكون نص الطلب فارغًا.

نص الاستجابة

إذا كانت الاستجابة ناجحة، سيحتوي نصها على مثال ListAdBreaksResponse.

نطاقات الأذونات

يجب توفير أحد نطاقات OAuth التالية:

  • https://www.googleapis.com/auth/contentingestion
  • https://www.googleapis.com/auth/video-ads

لمزيد من المعلومات، يُرجى الاطّلاع على OAuth 2.0 Overview.