REST Resource: partners.inventorySources

المورد: InventorySource

مصدر مساحات إعلانية

تمثيل JSON 
{
  "name": string,
  "inventorySourceId": string,
  "displayName": string,
  "inventorySourceType": enum (InventorySourceType),
  "inventorySourceProductType": enum (InventorySourceProductType),
  "commitment": enum (InventorySourceCommitment),
  "deliveryMethod": enum (InventorySourceDeliveryMethod),
  "dealId": string,
  "status": {
    object (InventorySourceStatus)
  },
  "exchange": enum (Exchange),
  "updateTime": string,
  "rateDetails": {
    object (RateDetails)
  },
  "publisherName": string,
  "timeRange": {
    object (TimeRange)
  },
  "creativeConfigs": [
    {
      object (CreativeConfig)
    }
  ],
  "guaranteedOrderId": string,
  "readWriteAccessors": {
    object (InventorySourceAccessors)
  },
  "readAdvertiserIds": [
    string
  ],
  "readPartnerIds": [
    string
  ]
}
الحقول
name

string

للعرض فقط. اسم المورد لمصدر المساحة الإعلانية
inventorySourceId

string (int64 format)

للعرض فقط. المعرّف الفريد لمصدر المساحة الإعلانية يتم تخصيصه من قِبل النظام.
displayName

string

الاسم المعروض لمصدر المستودع الإعلاني

يجب أن يكون بترميز UTF-8 وبحدّ أقصى 240 بايت.
inventorySourceType

enum (InventorySourceType)

تشير إلى نوع مصدر المساحة الإعلانية.
inventorySourceProductType

enum (InventorySourceProductType)

للعرض فقط. نوع المنتج لمصدر المساحة الإعلانية، والذي يشير إلى الطريقة التي يبيع بها المساحة الإعلانية.
commitment

enum (InventorySourceCommitment)

ما إذا كان مصدر المساحة الإعلانية يتضمّن عرضًا مضمونًا أو غير مضمون
deliveryMethod

enum (InventorySourceDeliveryMethod)

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

  • بالنسبة إلى مصادر المساحات الإعلانية غير المضمونة، القيمة الوحيدة المقبولة هي INVENTORY_SOURCE_DELIVERY_METHOD_PROGRAMMATIC.
  • بالنسبة إلى مصادر المساحات الإعلانية المضمونة، القيم المقبولة هي INVENTORY_SOURCE_DELIVERY_METHOD_TAG وINVENTORY_SOURCE_DELIVERY_METHOD_PROGRAMMATIC.
dealId

string

رقم التعريف في مساحة التبادل الذي يحدّد مصدر المستودع بشكلٍ فريد.

يجب أن يكون فريدًا لكل مشترٍ ضمن كلّ منصّة تبادل إعلاني، ولكن ليس بالضرورة أن يكون فريدًا على مستوى منصّات التبادل الإعلاني.
status

object (InventorySourceStatus)

إعدادات حالة مصدر المستودع الإعلاني
exchange

enum (Exchange)

سوق الإعلانات التي ينتمي إليها مصدر المساحة الإعلانية المتاحة
updateTime

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"
rateDetails

object (RateDetails)

الحقل مطلوب. تفاصيل أسعار مصدر المساحة الإعلانية المتاحة
publisherName

string

اسم الناشر/البائع لمصدر المستودع الإعلاني
timeRange

object (TimeRange)

النطاق الزمني الذي يبدأ فيه مصدر المستودع هذا عرض الإعلانات ويتوقف عن ذلك
creativeConfigs[]

object (CreativeConfig)

متطلبات تصميم الإعلان لمصدر المستودع

لا ينطبق ذلك على حزم المزادات.
guaranteedOrderId

string

غير قابل للتغيير رقم تعريف الطلب المضمون الذي ينتمي إليه مصدر المساحة الإعلانية هذا

ينطبق ذلك فقط عندما تكون قيمة commitment هي INVENTORY_SOURCE_COMMITMENT_GUARANTEED.
readWriteAccessors

object (InventorySourceAccessors)

الشريك أو المعلنون الذين لديهم الإذن بالقراءة والتعديل لمصدر المساحة الإعلانية

لا يتم عرض هذه السمة إلا عندما تكون قيمة commitment هي INVENTORY_SOURCE_COMMITMENT_GUARANTEED، وفي هذه الحالة يتم اكتساب دوال استرداد القيمة للقراءة/الكتابة من الطلب المضمون الرئيسي.

مطلوبة عندما تكون قيمة commitment هي INVENTORY_SOURCE_COMMITMENT_NON_GUARANTEED.

إذا كانت قيمة commitment هي INVENTORY_SOURCE_COMMITMENT_NON_GUARANTEED وتم ضبط شريك في هذا الحقل، سيحصل جميع المعلنين التابعين لهذا الشريك تلقائيًا على إذن بالقراءة فقط لمصدر المساحة الإعلانية. لن يتم تضمين هؤلاء المعلنين في readAdvertiserIds.
readAdvertiserIds[]

string (int64 format)

للعرض فقط. أرقام تعريف المعلِنين الذين لديهم إذن بالقراءة فقط للوصول إلى مصدر المساحة الإعلانية
readPartnerIds[]

string (int64 format)

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

يحصل جميع المعلِنين التابعين للشركاء في هذا الحقل على إذن بالقراءة فقط لمصدر المساحة الإعلانية.

الطُرق

get

 يستردّ صفقة مصدر مستودع.

list

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