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

النتائج فقط. معدّل المطابقة المتوقّع للجمهور في الصفقات المضمونة الآلية التي تستهدِف شرائح الجمهور، ويستخدمه التبادل لتحديد عدد الطلبات الإضافية التي يجب إرسالها. هذه قيمة عشرية تتراوح بين 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)

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

يستخدم معيار 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، مثل "أمريكا/نيويورك"، والتي تُستخدَم للكميات اليومية.

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

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

publisherConfigs[]

object (PublisherConfig)

اختياريّ. الإعدادات الخاصة بالناشر

PublisherConfig

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

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

string

مطلوب. الرقم التعريفي للناشر

publisherDisplayName

string

مطلوب. اسم الناشر

الطُرق

get

الحصول على مصدر مستودع

list

يسرد مصادر المستودع.

patch

تعديل مصدر مستودع