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) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "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) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "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

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