- المورد: InventorySource
- InventorySourceType
- InventorySourceProductType
- InventorySourceCommitment
- InventorySourceDeliveryMethod
- InventorySourceStatus
- InventorySourceConfigStatus
- RateDetails
- InventorySourceRateType
- أموال
- TimeRange
- CreativeConfig
- InventorySourceDisplayCreativeConfig
- InventorySourceVideoCreativeConfig
- InventorySourceAccessors
- PartnerAccessor
- AdvertiserAccessors
- الطُرق
المورد: InventorySource
مصدر المستودع.
تمثيل JSON |
---|
{ "name": string, "inventorySourceId": string, "displayName": string, "inventorySourceType": enum ( |
الحقول | |
---|---|
name |
النتائج فقط. اسم المورد لمصدر المستودع. |
inventorySourceId |
النتائج فقط. المعرّف الفريد لمصدر المستودع. تم تعيينه من قِبل النظام. |
displayName |
الاسم المعروض لمصدر المستودع. يجب ترميزها باستخدام UTF-8 بحجم 240 بايت كحد أقصى. |
inventorySourceType |
تشير إلى نوع مصدر المستودع. |
inventorySourceProductType |
النتائج فقط. نوع المنتج لمصدر المستودع، للإشارة إلى الطريقة التي يبيع بها المستودع. |
commitment |
ما إذا كان مصدر المستودع الإعلاني يقدّم عملية تسليم مضمونة أو غير مضمونة |
deliveryMethod |
تمثّل هذه السمة طريقة العرض لمصدر المستودع.
|
dealId |
رقم التعريف في مساحة التبادل الذي يُعرِّف مصدر المستودع بشكلٍ فريد. يجب أن يكون فريدًا على مستوى المشترين في كل عملية تبادل، ولكن ليس بالضرورة أن يكون فريدًا في مختلف المبادلات. |
status |
إعدادات الحالة لمصدر المستودع. |
exchange |
التبادل الذي ينتمي إليه مصدر المستودع. |
updateTime |
النتائج فقط. الطابع الزمني لآخر تعديل لمصدر المستودع. تم تعيينه من قِبل النظام. طابع زمني بتنسيق RFC3339 UTC "Zulu" ، مع دقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: |
rateDetails |
مطلوبة. تعرض هذه السمة تفاصيل السعر لمصدر المستودع. |
publisherName |
اسم الناشر/البائع لمصدر المستودع. |
timeRange |
النطاق الزمني لبدء عرض الإعلانات في مصدر المستودع هذا وتوقّفه |
creativeConfigs[] |
متطلبات تصميم الإعلان لمصدر المستودع الإعلاني. لا تنطبق على حِزم المزادات. |
guaranteedOrderId |
غير قابل للتغيير. رقم تعريف الطلب المضمون الذي ينتمي إليه مصدر المستودع هذا. لا يسري هذا العرض إلا عندما تكون قيمة السمة |
readWriteAccessors |
الشريك أو المعلِنون الذين لديهم إذن الوصول للقراءة/الكتابة إلى مصدر المستودع الإخراج فقط عندما تكون قيمة مطلوبة عندما تكون قيمة إذا كانت قيمة الحقل " |
readAdvertiserIds[] |
النتائج فقط. أرقام تعريف المعلِنين الذين لديهم إذن بالقراءة فقط إلى مصدر المستودع الإعلاني. |
readPartnerIds[] |
النتائج فقط. أرقام تعريف الشركاء الذين لديهم إذن بالقراءة فقط لمصدر المستودع يكتسِب جميع معلِني الشركاء في هذا الحقل إذن الوصول بالقراءة فقط إلى مصدر المستودع. |
InventorySourceType
أنواع مصادر المستودع المحتملة
عمليات التعداد | |
---|---|
INVENTORY_SOURCE_TYPE_UNSPECIFIED |
نوع مصدر المستودع غير محدّد أو غير معروف في هذا الإصدار. |
INVENTORY_SOURCE_TYPE_PRIVATE |
مصدر مستودع خاص |
INVENTORY_SOURCE_TYPE_AUCTION_PACKAGE |
حزمة المزاد |
InventorySourceProductType
أنواع المنتجات المحتمَلة لمصدر المستودع.
عمليات التعداد | |
---|---|
INVENTORY_SOURCE_PRODUCT_TYPE_UNSPECIFIED |
نوع المنتج غير محدّد أو غير معروف في هذا الإصدار. لا تتيح واجهة برمجة التطبيقات إمكانية تعديل مصادر المستودع لنوع المنتج هذا. |
PREFERRED_DEAL |
يبيع مصدر المستودع المستودع من خلال Preferred Deal. |
PRIVATE_AUCTION |
يبيع مصدر المستودع المستودع من خلال مزاد خاص. |
PROGRAMMATIC_GUARANTEED |
يبيع مصدر المستودع المستودع الإعلاني من خلال البيع الآلي المضمون. |
TAG_GUARANTEED |
يبيع مصدر المستودع المستودع من خلال العلامة المضمونة. |
YOUTUBE_RESERVE |
يبيع مصدر المستودع الإعلاني المستودع من خلال YouTube Reserve. |
INSTANT_RESERVE |
يبيع مصدر المستودع المستودع من خلال "الحجز الفوري". لا تتيح واجهة برمجة التطبيقات إمكانية تعديل مصادر المستودع لنوع المنتج هذا. |
GUARANTEED_PACKAGE |
يبيع مصدر المستودع المستودع من خلال "الحزمة المضمونة". لا تتيح واجهة برمجة التطبيقات إمكانية تعديل مصادر المستودع لنوع المنتج هذا. |
PROGRAMMATIC_TV |
يبيع مصدر المستودع المستودع من خلال Programmtic 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 |
تمثّل هذه السمة السبب الذي قدّمه المستخدم لإيقاف مصدر المستودع هذا مؤقتًا. يجب ألا يتجاوز طوله 100 حرف. لا يسري هذا العرض إلا عند ضبط السمة |
sellerStatus |
النتائج فقط. الحالة التي يضبطها البائع لمصدر المستودع. ينطبق فقط على مصادر المستودع التي تمت مزامنتها مباشرةً من الناشرين. القيم المقبولة هي |
sellerPauseReason |
النتائج فقط. السبب الذي قدّمه البائع لإيقاف مصدر المستودع هذا مؤقتًا. لا يسري هذا الإعداد إلا على مصادر المستودع التي تمت مزامنتها مباشرةً من الناشرين وعند ضبط |
configStatus |
النتائج فقط. حالة إعدادات مصدر المستودع. ينطبق هذا الإجراء فقط على مصادر المستودع المضمونة. القيم المقبولة هي يجب إعداد مصدر للمستودع (أي ملء الحقول المطلوبة واختيار تصميمات الإعلانات واختيار حملة تلقائية) قبل أن يمكن عرض الإعلانات. |
InventorySourceConfigStatus
حالات الضبط المحتمَلة لمصدر مستودع مضمون
عمليات التعداد | |
---|---|
INVENTORY_SOURCE_CONFIG_STATUS_UNSPECIFIED |
حالة الموافقة غير محدّدة أو غير معروفة في هذا الإصدار. |
INVENTORY_SOURCE_CONFIG_STATUS_PENDING |
حالة بداية مصدر مستودع مضمون. يجب ضبط مصدر المستودع في هذه الحالة. |
INVENTORY_SOURCE_CONFIG_STATUS_COMPLETED |
الحالة التي تلي إعداد المشتري لمصدر مستودع مضمون. |
RateDetails
الإعدادات ذات الصلة بالمعدّل في مصدر المستودع.
تمثيل JSON |
---|
{ "inventorySourceRateType": enum ( |
الحقول | |
---|---|
inventorySourceRateType |
تمثّل هذه السمة نوع السعر. القيم المقبولة هي |
rate |
معدّل الضريبة لمصدر المستودع. |
unitsPurchased |
مطلوبة لمصادر المستودع المضمونة عدد مرات الظهور التي يضمنها البائع. |
minimumSpend |
النتائج فقط. المبلغ الذي التزم المشتري بإنفاقه على مصدر المستودع مقدمًا. ينطبق هذا الإجراء فقط على مصادر المستودع المضمونة. |
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 |
تمثّل هذه السمة رمز العملة المكوَّن من ثلاثة أحرف والمحدد في ISO 4217. |
units |
الوحدات الكاملة للمبلغ. على سبيل المثال، إذا كانت قيمة السمة |
nanos |
عدد وحدات نانو (10^-9) من المبلغ. يجب أن تتراوح القيمة بين -999,999,999 وأكثر من 999,999,999+. إذا كانت قيمة |
TimeRange
نطاق زمني
تمثيل JSON |
---|
{ "startTime": string, "endTime": string } |
الحقول | |
---|---|
startTime |
مطلوبة. الحد الأدنى لنطاق زمني، شامل. طابع زمني بتنسيق RFC3339 UTC "Zulu" ، مع دقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: |
endTime |
مطلوبة. الحد الأعلى لنطاق زمني شامل. طابع زمني بتنسيق RFC3339 UTC "Zulu" ، مع دقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: |
CreativeConfig
ضبط متطلبات تصميم الإعلان لمصدر المستودع.
تمثيل JSON |
---|
{ "creativeType": enum ( |
الحقول | |
---|---|
creativeType |
نوع تصميم الإعلان الذي يمكن تخصيصه لمصدر المستودع الإعلاني. تتوفّر الأنواع التالية فقط:
|
حقل الاتحاد
إعدادات تصاميم الإعلانات التي يمكن تخصيصها لمصدر المستودع الإعلاني يمكن أن يكون الحقل " |
|
displayCreativeConfig |
إعدادات تصاميم الإعلانات الصورية. يسري هذا العرض عندما تكون قيمة |
videoCreativeConfig |
إعدادات تصاميم إعلانات الفيديو يسري هذا العرض عندما تكون قيمة |
InventorySourceDisplayCreativeConfig
إعدادات تصاميم الإعلانات الصورية.
تمثيل JSON |
---|
{
"creativeSize": {
object ( |
الحقول | |
---|---|
creativeSize |
متطلبات الحجم لتصميمات الإعلانات الصورية التي يمكن تخصيصها لمصدر المستودع الإعلاني. |
InventorySourceVideoCreativeConfig
إعدادات تصاميم إعلانات الفيديو
تمثيل JSON |
---|
{ "duration": string } |
الحقول | |
---|---|
duration |
متطلبات المدة لتصميمات إعلانات الفيديو التي يمكن تخصيصها لمصدر المستودع. مدة بالثواني يصل عددها إلى تسعة أرقام كسرية وتنتهي بـ " |
InventorySourceAccessors
الشريك أو المعلِنون الذين لديهم إذن الوصول إلى مصدر المستودع الإعلاني
تمثيل JSON |
---|
{ // Union field |
الحقول | |
---|---|
حقل الاتحاد accessors الشريك أو المعلِنون الذين لديهم إذن الوصول إلى مصدر المستودع الإعلاني يمكن أن يكون الحقل "accessors " واحدًا فقط مما يلي: |
|
partner |
الشريك الذي لديه إذن الوصول إلى مصدر المستودع |
advertisers |
المعلِنون الذين يمكنهم الوصول إلى مصدر المستودع الإعلاني. يجب أن ينتمي جميع المعلنين إلى الشريك نفسه. |
PartnerAccessor
الشريك الذي لديه إذن الوصول إلى مصدر المستودع
تمثيل JSON |
---|
{ "partnerId": string } |
الحقول | |
---|---|
partnerId |
رقم تعريف الشريك. |
AdvertiserAccessors
المعلِنون الذين يمكنهم الوصول إلى مصدر المستودع الإعلاني.
تمثيل JSON |
---|
{ "advertiserIds": [ string ] } |
الحقول | |
---|---|
advertiserIds[] |
الأرقام التعريفية للمعلنين. |
الطُرق |
|
---|---|
|
تنشئ مصدر مستودع إعلاني جديدًا. |
|
تعدِّل موصّلات القراءة/الكتابة لمصدر المستودع. |
|
الحصول على مصدر مستودع |
|
يسرد مصادر المستودع التي يمكن للمستخدم الحالي الوصول إليها. |
|
لتعديل مصدر مستودع حالي |