REST Resource: 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)

النتائج فقط. الطابع الزمني لآخر تعديل لمصدر المستودع. تمّ تعيينه من قِبل النظام.

يجب أن يكون طابعًا زمنيًا بالتنسيق RFC3339 UTC "Zulu"‎ وبدقة تصل إلى نانوثانية وما يصل إلى تسعة أرقام كسور. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z"
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)

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

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

InventorySourceType

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

عمليات التعداد
INVENTORY_SOURCE_TYPE_UNSPECIFIED نوع مصدر المستودع غير محدّد أو غير معروف في هذا الإصدار.
INVENTORY_SOURCE_TYPE_PRIVATE مصدر المستودع الخاص
INVENTORY_SOURCE_TYPE_AUCTION_PACKAGE حزمة المزاد:

InventorySourceProductType

أنواع المنتجات المحتملة لمصدر مستودع.

عمليات التعداد
INVENTORY_SOURCE_PRODUCT_TYPE_UNSPECIFIED نوع المنتج غير محدّد أو غير معروف في هذا الإصدار. لا يمكن تعديل مصادر المستودع الخاصة بنوع المنتج هذا عبر واجهة برمجة التطبيقات.
PREFERRED_DEAL يبيع مصدر المستودع المستودع من خلال "الصفقة المفضَّلة".
PRIVATE_AUCTION يبيع مصدر المستودع المستودع من خلال مزاد خاص.
PROGRAMMATIC_GUARANTEED يبيع مصدر المستودع الإعلاني من خلال "الوصول المضمون آليًا".
TAG_GUARANTEED يبيع مصدر المستودع الإعلاني المستودع الإعلاني من خلال ميزة "العلامة المضمونة".
YOUTUBE_RESERVE يبيع مصدر المستودع الإعلاني المساحة المتوفّرة للإعلانات من خلال YouTube Reserve.
INSTANT_RESERVE يبيع مصدر المستودع المستودع من خلال "الحجز الفوري". لا يمكن تعديل مصادر المستودع الخاصة بنوع المنتج هذا عبر واجهة برمجة التطبيقات.
GUARANTEED_PACKAGE يبيع مصدر المستودع المستودع من خلال "حزمة مضمونة". لا يمكن تعديل مصادر المستودع لنوع المنتجات هذا من خلال واجهة برمجة التطبيقات.
PROGRAMMATIC_TV يبيع مصدر المستودع المستودع من خلال التلفزيون الآلي. لا يمكن تعديل مصادر المستودع الخاصة بنوع المنتج هذا عبر واجهة برمجة التطبيقات.
AUCTION_PACKAGE يبيع مصدر المستودع الإعلاني المستودع الإعلاني من خلال "حزمة المزاد". لا يمكن تعديل مصادر المستودع لنوع المنتجات هذا من خلال واجهة برمجة التطبيقات.

InventorySourceCommitment

أنواع الالتزام المحتملة لمصدر مستودع إعلاني.

عمليات التعداد
INVENTORY_SOURCE_COMMITMENT_UNSPECIFIED لم يتم تحديد مدة الاشتراك أو أنّها غير معروفة في هذا الإصدار.
INVENTORY_SOURCE_COMMITMENT_GUARANTEED الالتزام مضمون تسليم المهام.
INVENTORY_SOURCE_COMMITMENT_NON_GUARANTEED لا يضمن هذا الالتزام تسليم الرسائل.

InventorySourceDeliveryMethod

طرق العرض المحتملة لمصدر المستودع.

عمليات التعداد
INVENTORY_SOURCE_DELIVERY_METHOD_UNSPECIFIED طريقة العرض غير محددة أو غير معروفة في هذا الإصدار.
INVENTORY_SOURCE_DELIVERY_METHOD_PROGRAMMATIC تكون طريقة العرض آلية.
INVENTORY_SOURCE_DELIVERY_METHOD_TAG تكون طريقة العرض هي العلامة.

InventorySourceStatus

الإعدادات المتعلّقة بالحالة لمصدر المستودع.

تمثيل JSON 
{
  "entityStatus": enum (EntityStatus),
  "entityPauseReason": string,
  "sellerStatus": enum (EntityStatus),
  "sellerPauseReason": string,
  "configStatus": enum (InventorySourceConfigStatus)
}
الحقول
entityStatus

enum (EntityStatus)

ما إذا كان مصدر المستودع قابلاً للعرض أم لا

القيم المقبولة هي ENTITY_STATUS_ACTIVE وENTITY_STATUS_ARCHIVED وENTITY_STATUS_PAUSED. القيمة التلقائية هي ENTITY_STATUS_ACTIVE.
entityPauseReason

string

السبب الذي يقدّمه المستخدم لإيقاف مصدر المستودع هذا مؤقتًا.

يجب ألا تتجاوز 100 حرف.

لا يسري هذا الإجراء إلّا عند ضبط السمة entityStatus على ENTITY_STATUS_PAUSED.
sellerStatus

enum (EntityStatus)

النتائج فقط. الحالة التي يحدّدها البائع لمصدر المستودع.

لا ينطبق ذلك إلا على مصادر المستودع التي تتم مزامنتها مباشرةً من الناشرين. القيمتان المقبولتان هما ENTITY_STATUS_ACTIVE وENTITY_STATUS_PAUSED.
sellerPauseReason

string

النتائج فقط. السبب الذي قدّمه البائع لإيقاف هذا مصدر المستودع مؤقتًا

ينطبق فقط على مصادر المستودعات التي تتم مزامنتها مباشرةً من الناشرين وعند ضبط sellerStatus على ENTITY_STATUS_PAUSED.
configStatus

enum (InventorySourceConfigStatus)

النتائج فقط. حالة ضبط مصدر المستودع

لا ينطبق ذلك إلا على مصادر المستودع الإعلاني المضمون. القيمتان المقبولتان هما INVENTORY_SOURCE_CONFIG_STATUS_PENDING وINVENTORY_SOURCE_CONFIG_STATUS_COMPLETED.

يجب ضبط مصدر المستودع (عليك ملء الحقول المطلوبة واختيار تصميمات الإعلانات واختيار حملة تلقائية) قبل أن يتم عرض إعلاناته.

InventorySourceConfigStatus

حالات الضبط المحتملة لمصدر مستودع مضمون.

عمليات التعداد
INVENTORY_SOURCE_CONFIG_STATUS_UNSPECIFIED حالة الموافقة غير محدّدة أو غير معروفة في هذا الإصدار.
INVENTORY_SOURCE_CONFIG_STATUS_PENDING حالة البداية لمصدر المستودع المضمون. يجب إعداد مصدر المستودع في هذه الحالة.
INVENTORY_SOURCE_CONFIG_STATUS_COMPLETED الحالة بعد ضبط المشتري لمصدر مستودع مضمون.

RateDetails

الإعدادات المتعلّقة بالسعر في مصدر المستودع.

تمثيل JSON 
{
  "inventorySourceRateType": enum (InventorySourceRateType),
  "rate": {
    object (Money)
  },
  "unitsPurchased": string,
  "minimumSpend": {
    object (Money)
  }
}
الحقول
inventorySourceRateType

enum (InventorySourceRateType)

نوع السعر

القيم المقبولة هي INVENTORY_SOURCE_RATE_TYPE_CPM_FIXED وINVENTORY_SOURCE_RATE_TYPE_CPM_FLOOR وINVENTORY_SOURCE_RATE_TYPE_CPD.
rate

object (Money)

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

string (int64 format)

مطلوب لمصادر المستودع الإعلاني المضمون. عدد مرات الظهور المضمونة من قِبل البائع
minimumSpend

object (Money)

النتائج فقط. المبلغ الذي التزم المشتري بإنفاقه على مصدر المستودع مقدمًا.

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

InventorySourceRateType

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

عمليات التعداد
INVENTORY_SOURCE_RATE_TYPE_UNSPECIFIED لم يتم تحديد نوع السعر أو هو غير معروف في هذا الإصدار.
INVENTORY_SOURCE_RATE_TYPE_CPM_FIXED نوع السعر هو التكلفة لكل ألف ظهور (ثابتة).
INVENTORY_SOURCE_RATE_TYPE_CPM_FLOOR ونوع السعر هو الحد الأدنى للتكلفة لكل ألف ظهور.
INVENTORY_SOURCE_RATE_TYPE_CPD نوع السعر هو "التكلفة اليومية".
INVENTORY_SOURCE_RATE_TYPE_FLAT نوع السعر ثابت.

المال

يمثل مبلغًا من المال مع نوع العملة.

تمثيل JSON 
{
  "currencyCode": string,
  "units": string,
  "nanos": integer
}
الحقول
currencyCode

string

رمز العملة المكوّن من ثلاثة أحرف والمحدّد في معيار ISO 4217.
units

string (int64 format)

الوحدات الكاملة للمبلغ. على سبيل المثال، إذا كانت قيمة currencyCode هي "USD"، تكون قيمة الوحدة الواحدة دولار أمريكي واحد.
nanos

integer

عدد وحدات النانو (10^-9) للمبلغ يجب أن تتراوح القيمة بين -999,999,999 و‎+999,999,999. إذا كانت units موجبة، يجب أن تكون nanos موجبة أو صفرًا. إذا كانت قيمة units هي صفر، يمكن أن تكون قيمة nanos موجبة أو صفرًا أو سالبة. إذا كانت قيمة units سالبة، يجب أن تكون قيمة nanos سالبة أو صفرًا. على سبيل المثال، يتم تمثيل $1.75 على النحو التالي: units=-1 وnanos=-750,000,000.

TimeRange

نطاق زمني

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

string (Timestamp format)

مطلوب. الحد الأدنى للنطاق الزمني، بشكل شامل

طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z".
endTime

string (Timestamp format)

مطلوب. الحد الأعلى للنطاق الزمني، بشكل شامل

يجب أن يكون طابعًا زمنيًا بالتنسيق RFC3339 UTC "Zulu"‎ وبدقة تصل إلى نانوثانية وما يصل إلى تسعة أرقام كسور. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z"

CreativeConfig

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

تمثيل JSON 
{
  "creativeType": enum (CreativeType),

  // Union field creative_config_scheme can be only one of the following:
  "displayCreativeConfig": {
    object (InventorySourceDisplayCreativeConfig)
  },
  "videoCreativeConfig": {
    object (InventorySourceVideoCreativeConfig)
  }
  // End of list of possible types for union field creative_config_scheme.
}
الحقول
creativeType

enum (CreativeType)

نوع تصميم الإعلان الذي يمكن تعيينه لمصدر المستودع. لا يمكن قبول سوى الأنواع التالية:

  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_VIDEO

حقل الربط creative_config_scheme سارٍ عندما تكون السمة creative_type واحدة مما يلي:

  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_VIDEO

إعدادات تصاميم الإعلانات التي يمكن تخصيصها لمصدر المستودع. يمكن أن يكون creative_config_scheme واحدًا فقط مما يلي:
displayCreativeConfig

object (InventorySourceDisplayCreativeConfig)

إعدادات تصميمات الإعلانات على الشبكة الإعلانية يسري العرض عندما تكون قيمة الحقل "creativeType" هي CREATIVE_TYPE_STANDARD.
videoCreativeConfig

object (InventorySourceVideoCreativeConfig)

إعدادات تصميمات إعلانات الفيديو. يسري العرض عندما تكون قيمة الحقل "creativeType" هي CREATIVE_TYPE_VIDEO.

InventorySourceDisplayCreativeConfig

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

تمثيل JSON 
{
  "creativeSize": {
    object (Dimensions)
  }
}
الحقول
creativeSize

object (Dimensions)

متطلبات الحجم لتصميمات الإعلانات الصورية التي يمكن تخصيصها لمصدر المستودع.

InventorySourceVideoCreativeConfig

إعدادات تصميمات إعلانات الفيديو.

تمثيل JSON 
{
  "duration": string
}
الحقول
duration

string (Duration format)

متطلبات المدة لتصاميم إعلانات الفيديو التي يمكن تعيينها لمصدر المستودع الإعلاني

المدة بالثواني مع ما يصل إلى تسعة أرقام كسور، وتنتهي بـ "s". مثال: "3.5s".

InventorySourceAccessors

الشريك أو المعلِنون الذين يمكنهم الوصول إلى مصدر المستودع

تمثيل JSON 
{

  // Union field accessors can be only one of the following:
  "partner": {
    object (PartnerAccessor)
  },
  "advertisers": {
    object (AdvertiserAccessors)
  }
  // End of list of possible types for union field accessors.
}
الحقول
حقل الاتحاد accessors. الشريك أو المعلِنين الذين لديهم إذن الوصول إلى مصدر المستودع الإعلاني يمكن أن يكون accessors واحدًا فقط مما يلي:
partner

object (PartnerAccessor)

الشريك الذي لديه إذن الوصول إلى مصدر المستودع
advertisers

object (AdvertiserAccessors)

المعلِنون الذين يمكنهم الوصول إلى مصدر المستودع يجب أن يكون جميع المعلِنين تابعين للشريك نفسه.

PartnerAccessor

الشريك الذي لديه إذن بالوصول إلى مصدر المستودع

تمثيل JSON 
{
  "partnerId": string
}
الحقول
partnerId

string (int64 format)

رقم تعريف الشريك

AdvertiserAccessors

المعلِنون الذين لديهم إذن بالوصول إلى مصدر المستودع الإعلاني

تمثيل JSON 
{
  "advertiserIds": [
    string
  ]
}
الحقول
advertiserIds[]

string (int64 format)

أرقام تعريف المعلنين.

الطُرق

create

 لإنشاء مصدر مستودع جديد

editInventorySourceReadWriteAccessors

 تعديل أدوات الوصول للقراءة/الكتابة لمصدر مستودع

get

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

list

 يسرد مصادر المستودع التي يمكن للمستخدم الحالي الوصول إليها.

patch

 تعمل هذه السياسة على تعديل مصدر مستودع حالي.