- المورد: 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[] |
أرقام تعريف المعلنين. |
الطُرق |
|
---|---|
|
تنشئ مصدر مستودع إعلاني جديدًا. |
|
تعدِّل موصّلات القراءة/الكتابة لمصدر المستودع. |
|
الحصول على مصدر مستودع |
|
يسرد مصادر المستودع التي يمكن للمستخدم الحالي الوصول إليها. |
|
تعديل مصدر مستودع حالي |