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} Example: "exchanges/1234/publishers/5678".
externalPublisherId

string

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

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

string

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

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

string

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

enum (DiscoveryObjectStatus)

الحقل مطلوب. حالة هذا الناشر. لا يظهر الناشرون الذين تكون حالتهم PAUSED أو REMOVED للمعلنين على DV3.
mediumCapability

enum (MediumCapability)

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

string

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

string

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

enum (CommitmentCapability)

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

object (SellerProvidedInventoryAvailabilityEstimate)

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

string

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

object (Money)

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

object (Money)

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

string

اختياريّ. وصف عام بتنسيق نصّي حر. يجب أن يكون بترميز UTF-8 وبحجم 200 حرف كحد أقصى. يمكن أن يكون هذا الوصف من نوع SOV(حصة الظهور) أو CPD أو ضمان الحجم. مثال على الوصف: "CPD، تأثير كبير، 69% متوسط نسبة الظهور"
tvMetadata

object (TVMetadata)

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

enum (UnderRepresentedGroup)

اختياريّ. الفئات الممثَّلة تمثيلاً ناقصًا التي ينتمي إليها المالك، إن وُجدت.

MediumCapability

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

عمليات التعداد
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

 يؤدي هذا الإجراء إلى تعديل ناشر.
يؤدي هذا الإجراء إلى تحميل شعار الناشر.