REST Resource: exchanges.publishers

المرجع: الناشر

تُحاط الناشر الفردي.

تمثيل JSON 
{
  "name": string,
  "externalPublisherId": string,
  "externalPublisherIds": [
    string
  ],
  "displayName": string,
  "status": enum (DiscoveryObjectStatus),
  "mediumCapability": enum (MediumCapability),
  "description": string,
  "contactInfo": [
    string
  ],
  "commitmentCapability": [
    enum (CommitmentCapability)
  ],
  "forecast": {
    object (SellerProvidedInventoryAvailabilityEstimate)
  },
  "logoUrl": string,
  "floorPrice": {
    object (Money)
  },
  "ceilingPrice": {
    object (Money)
  },
  "generalCapability": string,
  "tvMetadata": {
    object (TVMetadata)
  },
  "urgOwners": [
    enum (UnderRepresentedGroup)
  ]
}
الحقول
name

string

النتائج فقط. اسم المسار النسبي لهذا الناشر. يجب أن يكون بالشكل التالي: "exchanges/{seller_id}/publishers/{publisherId}". مثال: "exchanges/1234/publishers/5678".
externalPublisherId

string

مطلوب. [تم إيقاف هذا الحقل نهائيًا] سيتم قريبًا استبدال هذا الحقل بحقل externalPublisherIds[]. استبدال المعرّف الفريد للناشر المقدَّم من Exchange يجب أن يتطابق مع معرّف الناشر المُرسَل في طلبات عروض الأسعار.

يمكن استخدام 100 حرف كحدّ أقصى. الأحرف المسموح بها هي الأحرف الأبجدية الرقمية والشرطة السفلية والشرطة والنقطة.
externalPublisherIds[]

string

اختياريّ. أرقام تعريف الناشرين المقدَّمة من Exchange يجب أن يكون كل معرّف فريدًا وأن يتطابق مع معرّف الناشر الذي تم إرساله في طلبات عروض الأسعار.

10 مرات كحد أقصى الحد الأقصى لعدد الأحرف هو 100 حرف لكل معرّف. الأحرف المسموح بها هي الأحرف الأبجدية الرقمية والشرطة السفلية والشرطة والنقطة.
displayName

string

مطلوب. الاسم المعروض لهذا الناشر. يجب أن يكون الترميز UTF-8 بحد أقصى 30 حرفًا.
status

enum (DiscoveryObjectStatus)

مطلوب. حالة هذا الناشر. لا يتم عرض الناشرين الذين لديهم الحالة "متوقف مؤقتًا" أو "تمت إزالته" لمعلِني DV3.
mediumCapability

enum (MediumCapability)

مطلوب. الوسائط التي ينوي هذا الناشر عرض إعلاناته عليها.
description

string

مطلوب. نص الوصف لهذا الناشر يجب أن يكون بترميز UTF-8 بحد أقصى 1000 حرف. مطلوب.
contactInfo[]

string

مطلوب. عناوين البريد الإلكتروني لجهات التواصل التي يمكن للمعلنين التواصل من خلالها مع الناشر 10 جهات اتصال بحد أقصى يجب أن تتألّف كل جهة اتصال من 100 حرف كحد أقصى. مثال: [جهة اتصال في الولايات المتحدة - شريف كمال: شريف.كمال@abc.com] مطلوب.
commitmentCapability[]

enum (CommitmentCapability)

اختياريّ. أنواع التعهدات التي يتيحها الناشر
forecast

object (SellerProvidedInventoryAvailabilityEstimate)

مطلوب. تفاصيل التوقّعات لمستودع هذا الناشر الإعلاني يمكن للمعلِنين في "الحملات على شبكة البحث" من الجيل الثالث الاطّلاع على هذه التصنيفات وفلترتها. يجب إدخال تفاصيل توقّعات النطاق.
logoUrl

string

النتائج فقط. عنوان URL لشعار هذا الناشر
floorPrice

object (Money)

اختياريّ. السعر الأدنى لهذا الناشر. يجب أن يكون رمز العملة هو نفسه رمز السعر الأقصى.
ceilingPrice

object (Money)

اختياريّ. الحد الأقصى للسعر الذي يحدّده هذا الناشر. يجب أن يكون رمز العملة هو نفسه رمز السعر الأدنى.
generalCapability

string

اختياريّ.
tvMetadata

object (TVMetadata)

اختياريّ. البيانات الوصفية للناشر الذي يقدّم عروضًا تلفزيونية مطلوبة عندما تتضمّن إمكانات الوسيط التلفزيون. لا ينطبق ذلك عندما لا تتضمّن إمكانات الوسيط التلفزيون.
urgOwners[]

enum (UnderRepresentedGroup)

اختياريّ. ضمن المجموعات المعنيّة، يشير ذلك إلى المجموعات التي يكون المالك عضوًا فيها، إن توفّرت.

MediumCapability

قائمة بأنواع القدرات المتوسطة تتضمّن واجهة Marketplace (ضمن "وحدة المستودع" في "مدير إعلانات الفيديو 360") أقسامًا مختلفة للمستودع. "المساحة المتوفّرة للإعلانات الرقمية: تشمل هذه المساحة المتوفّرة للإعلانات الناشرين وحِزم المزادات التي تغطّي المساحة المتوفّرة للإعلانات الصورية والفيديو (بما في ذلك التلفزيون المتّصل وخدمات البث المباشر على الإنترنت) والصوت". "تلفزيون: هذا هو القسم المخصّص الذي أطلقناه حديثًا لاستكشاف المستودع الإعلاني على أجهزة التلفزيون المتّصلة وخدمات البث المباشر على الإنترنت. يتم تعريف التلفزيون المتّصل وخدمات البث المباشر على النحو التالي: "يشمل التلفزيون المتّصل (CTV) جميع الأجهزة التي تندرج ضمن الأوصاف التالية: - الأجهزة المتّصلة أو أجهزة بث الوسائط: الأجهزة التي يتم ربطها بشاشة التلفزيون لعرض بث الفيديو (Roku وApple TV وما إلى ذلك) ‫- التلفزيون الذكي: أجهزة التلفزيون المزوّدة بإمكانية الاتصال بالإنترنت (تلفزيون Samsung الذكي وما إلى ذلك) - وحدات تحكّم الألعاب: وحدات تحكّم الألعاب المتصلة بالإنترنت (Xbox وPlayStation وWii وما إلى ذلك) ‫- أجهزة الاستقبال الرقمية: هي الأجهزة التي توفّر محتوى تقليديًا عبر الكابل والفيديوهات عند الطلب. ‫"المحتوى عند الطلب (OTT)" هو محتوى فيديو يشبه المحتوى التلفزيوني يقدّمه موفّر فيديو على الإنترنت خارج الشبكات المغلقة لمزوّدي خدمات الاتصالات وخدمات الكابل. يمكن مشاهدة الفيديوهات عند الطلب على أجهزة الكمبيوتر المكتبي والأجهزة الجوّالة والأجهزة اللوحية، بالإضافة إلى أجهزة التلفزيون المتّصل أو أجهزة فك التشفير (ما دام يتم عرض المحتوى عبر بروتوكول الإنترنت على الأجهزة الأخيرة). "الصوت: هذا قسم جديد مخصّص لمستودع الصوت". "OOH: Digital out of home publishers".

عمليات التعداد
MEDIUM_CAPABILITY_UNSPECIFIED لم يتم تحديد إمكانية الوسيط. الإدخال غير صالح.
MEDIUM_CAPABILITY_DIGITAL قدرات رقمية متوسطة
MEDIUM_CAPABILITY_TV تلفزيون متوسط الإمكانات
MEDIUM_CAPABILITY_AUDIO إمكانات الصوت متوسطة
MEDIUM_CAPABILITY_OOH إمكانيات متوسطة خارج المنزل

CommitmentCapability

تعداد إمكانيات التعهد

عمليات التعداد
COMMITMENT_CAPABILITY_UNSPECIFIED لم يتم تحديد إمكانية الالتزام. الإدخال غير صالح.
COMMITMENT_CAPABILITY_GUARANTEED يمتلك الناشر مساحة إعلانية مضمونة.
COMMITMENT_CAPABILITY_NON_GUARANTEED لدى الناشر مساحة إعلانية غير مضمونة.

TVMetadata

البيانات الوصفية للناشرين الذين يوفّرون محتوى تلفزيونيًا

تمثيل JSON 
{
  "tvDeliveryType": enum (TVDeliveryType),
  "topShows": [
    string
  ]
}
الحقول
tvDeliveryType

enum (TVDeliveryType)

مطلوب. نوع عرض الإعلانات التلفزيونية.
topShows[]

string

اختياريّ. قائمة بعناوين أهم البرامج التلفزيونية التي يملكها الناشر الحد الأقصى للحجم هو 10. يجب أن يكون بترميز UTF-8.

TVDeliveryType

قائمة بأنواع عرض الإعلانات على التلفزيون

عمليات التعداد
TV_DELIVERY_TYPE_UNSPECIFIED لم يتم تحديد نوع عرض الإعلانات على التلفزيون. الإدخال غير صالح.
TV_DELIVERY_TYPE_CTV نوع عرض الفيديو على التلفزيون: التلفزيون المتّصل
TV_DELIVERY_TYPE_LINEAR_TV نوع عرض المحتوى التلفزيوني: بث تلفزيوني تقليدي

الطُرق

create

 لإنشاء ناشر جديد

get

 الحصول على ناشر

list

 يعرض الناشرين.

patch

 تعديلات على ناشر
حمِّل شعار الناشر.