REST Resource: exchanges.inventorySources

المورد: InventorySource

نموذج التنفيذ لمصدر مستودع إعلاني في "مساحة العرض والفيديو 360"

تمثيل JSON 
{
  "name": string,
  "buyerStatus": enum (BuyerStatus),
  "sellerStatus": enum (SellerStatus),
  "transactionType": enum (TransactionType),
  "pricingType": enum (PricingType),
  "rateDetails": {
    object (RateDetails)
  },
  "startTime": string,
  "endTime": string,
  "exchangeVolumeForecast": {
    object (InventorySourceVolumeForecast)
  },
  "audienceMatchRate": number,
  "makegoodRequested": boolean,
  "makegoodRequestedReason": string,
  "percentFrequencyCapExcludedTraffic": string,
  "dv360WseatId": [
    string
  ],
  "lastModifiedTime": string,
  "creativeApprovalConfig": {
    object (CreativeApprovalConfig)
  }
}
الحقول
name

string

النتائج فقط. اسم المورد النسبي للطلب تم إنشاؤه بواسطة الخادم. مثال: "exchanges/1234/inventorySources/5678".
buyerStatus

enum (BuyerStatus)

النتائج فقط. حالة المشتري
sellerStatus

enum (SellerStatus)

حالة البائع
transactionType

enum (TransactionType)

النتائج فقط. نوع معاملة المنتج
pricingType

enum (PricingType)

النتائج فقط. تمثّل هذه السمة نوع السعر الخاص بالمنتج.
rateDetails

object (RateDetails)

النتائج فقط. تفاصيل السعر
startTime

string (Timestamp format)

النتائج فقط. الوقت الذي يصبح فيه هذا المنتج نشطًا. يجب أن يكون قبل endTime. لا يمكن أن يكون وقت البدء بعد أكثر من عام واحد في المستقبل.

يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 0 أو 3 أو 6 أو 9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف Z. أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30".
endTime

string (Timestamp format)

النتائج فقط. الوقت الذي يصبح فيه هذا المنتج غير نشط.

يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 0 أو 3 أو 6 أو 9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف Z. أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30".
exchangeVolumeForecast
(deprecated)

object (InventorySourceVolumeForecast)

توقّعات الحجم اليومي المقدَّمة من البورصة تُستخدَم لتحديد وتيرة العرض وتمكين خيار المشتري. تم إيقاف هذا الحقل نهائيًا.
audienceMatchRate

number

النتائج فقط. معدّل مطابقة الجمهور المتوقّع لصفقات "البرنامج المضمون" التي تستهدف الجمهور، ويستخدمه Ad Exchange لتحديد عدد الطلبات الإضافية التي يجب إرسالها. هذا الرقم هو عدد عشري بين 0 و1، ويجب استخدام معكوسه كمضاعف لمرّات الظهور. يشير الرقم 0 إلى أنّ الحقل غير مضبوط، وبالتالي لا يتضمّن استهدافًا للجمهور. مثال: "0.125". يشير ذلك إلى أنّ% 12.5 من الطلبات تتطابق مع استهداف الجمهور، ويجب أن يكون عدد الطلبات المُرسَلة 8 أضعاف مرّات الظهور المتفق عليها.
makegoodRequested

boolean

النتائج فقط. تشير هذه السمة إلى ما إذا تم طلب تعويض من المشتري.
makegoodRequestedReason

string

النتائج فقط. سبب طلب التعويض المقدَّم من المشتري
percentFrequencyCapExcludedTraffic

string (int64 format)

نسبة الزيارات المستبعَدة من تحديد عدد مرات الظهور في صفقة "الوصول المضمون آليًا" هذا العدد الصحيح يتراوح بين 0 و100. تشير القيمة 0 (وهي أيضًا القيمة التلقائية) إلى عدم وجود استبعاد، وبالتالي تكون جميع الزيارات مؤهَّلة لحدّ التكرار. وتشير القيمة 100 إلى الاستبعاد الكامل، وبالتالي لن يتم تطبيق أي حدّ للتكرار. ستؤدي القيم بين 0 و100 إلى استبعاد جزئي. على سبيل المثال، ستؤدي القيمة 20 إلى استبعاد% 20 من عدد الزيارات من الحدّ الأقصى لعدد مرات الظهور.
dv360WseatId[]

string (int64 format)

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

string (Timestamp format)

النتائج فقط. آخر مرة تم فيها تعديل مصدر المستودع يُرجى العِلم أنّ بعض التعديلات الداخلية في "مساحة العرض والفيديو 360" ستؤدي إلى تغيير وقت آخر تعديل.

يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 0 أو 3 أو 6 أو 9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف Z. أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30".
creativeApprovalConfig

object (CreativeApprovalConfig)

اختياريّ. إعدادات الموافقة على تصميم الإعلان قد تكون الموافقة مطلوبة على مستوى شبكة التبادل أو على مستوى الناشر.

BuyerStatus

حالة المشتري

عمليات التعداد
BUYER_STATUS_UNSPECIFIED لم يتم تحديد حالة المشتري. قيمة الإدخال غير صالحة.
BUYER_STATUS_ACTIVE حالة المشتري نشطة. تمّ تعيين بند إعلاني، وتمّ تعيين تصميم إعلان صالح.
BUYER_STATUS_PENDING حالة المشتري معلّقة. تعني هذه الحالة أنّ الصفقة غير نشطة وأنّ على المشتري اتّخاذ إجراءات معيّنة.
BUYER_STATUS_PAUSED حالة المشتري هي "أوقفه المشتري مؤقتًا".

SellerStatus

حالة البائع

عمليات التعداد
SELLER_STATUS_UNSPECIFIED لم يتم تحديد حالة البائع. غير متوقّع، يشير إلى أنّ حالة التفاوض غير معروفة. قيمة الإدخال غير صالحة.
SELLER_STATUS_ACTIVE حالة البائع نشطة. مصدر المستودع الإعلاني نشط من جهة التبادل.
SELLER_STATUS_PAUSED تم إيقاف حالة البائع مؤقتًا.

InventorySourceVolumeForecast

توقّع حجم الطلبات اليومية لمصدر مستودع إعلاني تنطبق قواعد التحقّق التالية: - يجب تقديم إدخال لكل يوم من أيام الأسبوع - يجب أن يكون مستوى الصوت غير سالب - يجب توفير timeZoneId ويجب أن يكون صالحًا

تمثيل JSON 
{
  "dailyVolumes": [
    {
      object (DailyVolume)
    }
  ],
  "timeZoneId": string
}
الحقول
dailyVolumes[]

object (DailyVolume)

توقّعات أحجام التداول اليومية
timeZoneId

string

المنطقة الزمنية في قاعدة بيانات المناطق الزمنية الصادرة عن هيئة أرقام الإنترنت المخصّصة (IANA)، مثل "America/New_York"، والمستخدَمة في الحجوم اليومية.

DailyVolume

حجم الطلبات لمصدر مستودع إعلاني في يوم معيّن

تمثيل JSON 
{
  "day": enum (DayOfWeek),
  "volume": string
}
الحقول
day

enum (DayOfWeek)

يوم الأسبوع الذي ينطبق عليه حجم الطلبات.
volume

string (int64 format)

حجم الطلبات المتوقّع ليوم معيّن من الأسبوع

DayOfWeek

تمثّل هذه السمة يومًا من أيام الأسبوع.

عمليات التعداد
DAY_OF_WEEK_UNSPECIFIED لم يتم تحديد يوم الأسبوع.
MONDAY الاثنين
TUESDAY الثلاثاء
WEDNESDAY الأربعاء
THURSDAY الخميس
FRIDAY الجمعة
SATURDAY السبت
SUNDAY الأحد

CreativeApprovalConfig

إعدادات الموافقة على تصميم الإعلان

تمثيل JSON 
{
  "requiresExchangeApproval": boolean,
  "publisherConfigs": [
    {
      object (PublisherConfig)
    }
  ]
}
الحقول
requiresExchangeApproval

boolean

الحقل مطلوب. تحدّد هذه السمة ما إذا كان تصميم الإعلان يتطلّب موافقة مسبقة على مستوى Exchange.
publisherConfigs[]

object (PublisherConfig)

اختياريّ. تمثّل هذه السمة إعدادات الناشر.

PublisherConfig

إعدادات الناشر (publisher_config) في حال ضبط publisher_config، تتطلّب مادة العرض الإبداعية موافقة مسبقة على مستوى الناشر.

تمثيل JSON 
{
  "publisherId": string,
  "publisherDisplayName": string
}
الحقول
publisherId

string

الحقل مطلوب. تمثّل هذه السمة رقم تعريف الناشر.
publisherDisplayName

string

الحقل مطلوب. تمثّل هذه السمة اسم الناشر.

الطُرق

get

 تعرض هذه الطريقة مصدر مساحة إعلانية.

list

 تعرض هذه السمة مصادر المساحات الإعلانية.

patch

 تعدِّل هذه الطريقة مصدر مستودع.