REST Resource: exchanges.orders.products

المورد: المنتج

المنتج

تمثيل JSON 
{
  "name": string,
  "displayName": string,
  "externalDealId": string,
  "transactionType": enum (TransactionType),
  "pricingType": enum (PricingType),
  "updateTime": string,
  "startTime": string,
  "endTime": string,
  "rateDetails": {
    object (RateDetails)
  },
  "creativeConfig": [
    {
      object (CreativeConfig)
    }
  ],
  "makegood": boolean,
  "makegoodDetails": {
    object (MakegoodDetails)
  },
  "creativeSource": enum (CreativeSource),
  "mediumType": enum (MediumType),
  "audienceTargetingConfig": {
    object (AudienceTargetingConfig)
  },
  "targetingCriteria": {
    object (TargetingCriteria)
  },
  "forecastResult": {
    object (ForecastResult)
  },
  "errorDetails": {
    object (ErrorDetails)
  },
  "frequencyCap": {
    object (FrequencyCap)
  },
  "program": string,
  "buyerCustomParameters": {
    string: string,
    ...
  },
  "etag": string
}
الحقول
name

string

اسم المورد النسبي للمنتج تم إنشاؤه بواسطة الخادم. مثال: "exchanges/1234/orders/5678/products/abc". للعرض فقط.
displayName

string

الاسم المعروض للمنتج

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

string

المعرّف الخارجي هذا هو رقم تعريف الصفقة في نظام التبادل. ‫100 حرف كحدّ أقصى الأحرف المسموح بها هي الأحرف الأبجدية الرقمية والشرطة السفلية والواصلة والنقطة. يجب أن تكون فريدة في جميع المنتجات. الحقل مطلوب.
transactionType

enum (TransactionType)

نوع معاملة المنتج الحقل مطلوب.
pricingType

enum (PricingType)

نوع السعر للمنتج الحقل مطلوب.
updateTime
(deprecated)

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

string (Timestamp format)

الوقت الذي يصبح فيه هذا المنتج نشطًا. يجب أن يكون قبل endTime. لا يمكن أن يكون وقت البدء بعد أكثر من عام واحد في المستقبل. الحقل مطلوب.

يستخدم المعيار 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"
endTime

string (Timestamp format)

الوقت الذي يصبح فيه هذا المنتج غير نشط. لا يمكن أن يكون التاريخ بعد عام 2036. الحقل مطلوب.

يستخدم المعيار 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)

تفاصيل السعر الحقل مطلوب.
creativeConfig[]

object (CreativeConfig)

متطلبات تصميم الإعلانات لمنتج معيّن مطلوبة لنوع المنتج "معاملة محجوزة".
makegood
(deprecated)

boolean

تشير إلى ما إذا كان المنتج هو منتج تعويضي.
makegoodDetails
(deprecated)

object (MakegoodDetails)

تفاصيل التعويض لمنتج معيّن مطلوبة عندما يكون المنتج تعويضًا.
creativeSource

enum (CreativeSource)

مصدر تصميم الإعلان لمنتج معيّن اختيارية، وتكون القيمة التلقائية CREATIVE_SOURCE_ADVERTISER. لا يمكن تغييرها بعد إنشاء المنتج.
mediumType

enum (MediumType)

تمثّل هذه السمة نوع الوسيط لمنتج معيّن. يتم ضبط القيمة تلقائيًا على DIGITAL في حال عدم تحديدها للتوافق مع الأنظمة القديمة. لا يمكن تغييرها بعد إنشاء المنتج.
audienceTargetingConfig

object (AudienceTargetingConfig)

اختيارية: إعدادات استهداف الجمهور المطبَّقة على مستوى الصفقة في السوق الإعلانية
targetingCriteria

object (TargetingCriteria)

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

object (ForecastResult)

نتائج توقعات المنتجات هذه السمة مطلوبة عندما لا تكون معايير الاستهداف فارغة ولا يتم تقديم التوقّعات. ينطبق ذلك على سيناريوهات الصفقات الفورية فقط.
errorDetails

object (ErrorDetails)

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

object (FrequencyCap)

للعرض فقط. عدد مرّات الظهور المحدَّد الذي اختاره المشتري ينطبق ذلك على سيناريوهات الصفقات الفورية فقط.
program

string

للعرض فقط. البرنامج الذي أنشأ المشتري الصفقة الفورية بموجبه يُترك فارغًا في حال التبادل العادي. ينطبق ذلك على سيناريوهات الصفقات الفورية فقط.
buyerCustomParameters

map (key: string, value: string)

للعرض فقط. مَعلمات مخصّصة للمفاتيح/القيم يضبطها المشتري في طلب الصفقة الفورية ينطبق ذلك على سيناريوهات الصفقات الفورية فقط.

عنصر يحتوي على قائمة بأزواج "key": value. مثال: { "name": "wrench", "mass": "1.3kg", "count": "3" }
etag

string

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

CreativeConfig

إعدادات متطلبات تصميم الإعلان لمنتج معيّن

تمثيل JSON 
{
  "creativeType": enum (CreativeType),
  "dimensionCreativeConfig": {
    object (DimensionCreativeConfig)
  },
  "durationCreativeConfig": {
    object (DurationCreativeConfig)
  }
}
الحقول
creativeType

enum (CreativeType)

نوع تصميم الإعلان الحقل مطلوب.
dimensionCreativeConfig

object (DimensionCreativeConfig)

إعدادات تصاميم الإعلانات الصورية هذا الحقل غير متاح لأنواع التصاميم المدمجة مع المحتوى (CREATIVE_TYPE_NATIVE).
durationCreativeConfig

object (DurationCreativeConfig)

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

CreativeType

أنواع تصاميم الإعلانات المحتمَلة

عمليات التعداد
CREATIVE_TYPE_UNSPECIFIED لم يتم تحديد نوع تصميم الإعلان. قيمة الإدخال غير صالحة.
CREATIVE_TYPE_DISPLAY نوع تصميم الإعلان على الشبكة الإعلانية
CREATIVE_TYPE_VIDEO نوع تصميم إعلان الفيديو
CREATIVE_TYPE_AUDIO نوع الصوت في تصميم الإعلان
CREATIVE_TYPE_NATIVE نوع تصميم الإعلان المدمج مع المحتوى هذا الإجراء غير متاح للمنتجات من نوع المعاملة "RESERVED".

DimensionCreativeConfig

سمة تصميم الإعلان على الشبكة الإعلانية بالبكسل

تمثيل JSON 
{
  "width": integer,
  "height": integer
}
الحقول
width

integer

عرض تصميم الإعلان على الشبكة الإعلانية الحقل مطلوب.
height

integer

ارتفاع تصميم الإعلان على الشبكة الإعلانية الحقل مطلوب.

DurationCreativeConfig

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

تمثيل JSON 
{
  "duration": string,
  "durationMatchType": enum (DurationMatchType),
  "skippableMatchType": enum (SkippableMatchType)
}
الحقول
duration

string (Duration format)

مدة تصميم إعلان الفيديو بالثواني مطلوب

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

enum (DurationMatchType)

معايير مطابقة المدة
skippableMatchType

enum (SkippableMatchType)

نوع تصميم إعلان الفيديو القابل للتخطّي

DurationMatchType

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

عمليات التعداد
DURATION_MATCH_TYPE_UNSPECIFIED لم يتم تحديد معيار مطابقة المدة أو أنّه غير معروف في هذا الإصدار. قيمة الإدخال غير صالحة.
DURATION_MATCH_TYPE_EQUAL_TO يجب أن تكون مدة تصميم الإعلان مماثلة للمدة المطلوبة.
DURATION_MATCH_TYPE_LESS_THAN_OR_EQUAL_TO يجب أن تكون مدة تصميم الإعلان مساوية للمدة المطلوبة أو أقل منها.

SkippableMatchType

تطابق معايير ما إذا كان تصميم إعلان الفيديو قابلاً للتخطّي

عمليات التعداد
SKIPPABLE_MATCH_TYPE_UNSPECIFIED لم يتم تحديد نوع الإعلان القابل للتخطّي أو أنّه غير معروف في هذا الإصدار. قيمة الإدخال غير صالحة.
SKIPPABLE_MATCH_TYPE_SKIPPABLE يجب أن يكون تصميم الإعلان قابلاً للتخطّي.
SKIPPABLE_MATCH_TYPE_NOT_SKIPPABLE يجب أن يكون تصميم الإعلان غير قابل للتخطّي.
SKIPPABLE_MATCH_TYPE_ANY يمكن أن يكون تصميم الإعلان قابلاً للتخطّي أو غير قابل للتخطّي.

MakegoodDetails

إعدادات تفاصيل التعويض

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

string

رقم تعريف الصفقة الخارجية الأصلي الذي يطلب التعويض ‫100 حرف كحدّ أقصى الأحرف المسموح بها هي الأحرف الأبجدية الرقمية والشرطة السفلية والواصلة والنقطة. الحقل مطلوب.
reason

string

سبب التعويض الذي بدأه البائع ‫250 حرفًا كحدّ أقصى الحقل مطلوب.

CreativeSource

مصدر تصميم الإعلان، أي المكان الذي سيتم عرض تصميمات الإعلانات منه

عمليات التعداد
CREATIVE_SOURCE_UNSPECIFIED لم يتم تحديد مصدر تصميم الإعلان أو أنّه غير معروف في هذا الإصدار. قيمة الإدخال غير صالحة.
CREATIVE_SOURCE_ADVERTISER سيتم عرض تصاميم الإعلانات من خلال "مساحة العرض والفيديو 360".
CREATIVE_SOURCE_PUBLISHER سيعرض الناشر تصاميم الإعلانات. لا تتوفّر حاليًا تصاميم الإعلانات التي يستضيفها الناشر، وسيتعذّر تنفيذ أي طلب يحاول ضبط مصدر تصميم الإعلان على CREATIVE_SOURCE_PUBLISHER.

AudienceTargetingConfig

إعدادات استهداف الجمهور

تمثيل JSON 
{
  "audienceType": enum (AudienceType)
}
الحقول
audienceType

enum (AudienceType)

نوع الجمهور الحقل مطلوب.

AudienceType

نوع الجمهور

عمليات التعداد
AUDIENCE_TYPE_UNSPECIFIED نوع الجمهور غير محدّد. غير صالح للإدخال.
AUDIENCE_TYPE_COMMERCE نوع جمهور التجارة

TargetingCriteria

تم تحديد معايير الاستهداف.

تمثيل JSON 
{
  "selectedTargetingOptions": [
    {
      object (SelectedTargetingOption)
    }
  ]
}
الحقول
selectedTargetingOptions[]

object (SelectedTargetingOption)

الخيارات المحدّدة

SelectedTargetingOption

خيارات الاستهداف المحدّدة لنوع استهداف واحد

تمثيل JSON 
{
  "type": enum (TargetingType),

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "audienceSelection": {
    object (AudienceSelection)
  },
  "targetingSelection": {
    object (TargetingSelection)
  }
  // End of mutually exclusive fields.
}
الحقول
type

enum (TargetingType)

نوع الاستهداف المرتبط بالخيارات المحدّدة
يمكن تضمين نوع واحد فقط من الاختيارات. يجب أن يتوافق الاختيار المحدّد مع TargetingType الذي تم اختياره لحقل type. في ما يلي قائمة بالحقول التي يستبعد بعضها بعضًا. سيتم ضبط حقل واحد على الأكثر في الرد:
audienceSelection

object (AudienceSelection)

الجمهور المحدّد
targetingSelection

object (TargetingSelection)

مجموعة عامة من معرّفات الخيارات المحدّدة
نهاية الحقول التي يستبعد كلّ منها الآخر

TargetingType

أنواع الاستهداف

عمليات التعداد
TARGETING_TYPE_UNSPECIFIED نوع استهداف غير محدّد، وغير صالح للإدخال.
TARGETING_TYPE_AUDIENCE نوع الاستهداف: الجمهور
TARGETING_TYPE_COUNTRY نوع الاستهداف: البلد
TARGETING_TYPE_DMA نوع الاستهداف: منطقة السوق المحدّدة (DMA)
TARGETING_TYPE_PROGRAMMER مبرمج نوع الاستهداف
TARGETING_TYPE_BRAND نوع الاستهداف: العلامة التجارية
TARGETING_TYPE_CONTENT_GENRE نوع المحتوى المستهدَف
TARGETING_TYPE_DEVICE نوع الاستهداف: الجهاز
TARGETING_TYPE_OPERATING_SYSTEM نوع الاستهداف: نظام التشغيل
TARGETING_TYPE_RATING تقييم نوع الاستهداف
TARGETING_TYPE_ENVIRONMENT بيئة نوع الاستهداف
TARGETING_TYPE_LANGUAGE نوع الاستهداف: اللغة
TARGETING_TYPE_GEO نوع الاستهداف حسب الموقع الجغرافي
TARGETING_TYPE_AGE نوع الاستهداف حسب العمر
TARGETING_TYPE_GENDER نوع الاستهداف حسب الجنس
TARGETING_TYPE_CONTEXTUAL_SEGMENT شريحة سياقية لنوع الاستهداف
TARGETING_TYPE_REQUEST_FORMAT تنسيق طلب نوع الاستهداف
TARGETING_TYPE_PUBLISHER نوع الاستهداف: الناشر
TARGETING_TYPE_INVENTORY_SIZE حجم نوع الاستهداف
TARGETING_TYPE_NETWORK شبكة نوع الاستهداف
TARGETING_TYPE_PLATFORM نوع الاستهداف: المنصة
TARGETING_TYPE_VIDEO_DELIVERY_TYPE نوع الاستهداف حسب نوع عرض الفيديو
TARGETING_TYPE_VIDEO_MINIMUM_PLAYER_SIZE الحد الأدنى لحجم مشغّل الفيديو حسب نوع الاستهداف
TARGETING_TYPE_VIDEO_COMPLETION نوع الاستهداف هو موضع الفيديو.
TARGETING_TYPE_VIEWABILITY إمكانية عرض نوع الاستهداف
TARGETING_TYPE_REWARDED نوع الاستهداف هو "إعلانات مقابل مكافأة".
TARGETING_TYPE_VIDEO_AD_DURATION_THRESHOLD_SEC الحدّ الأدنى لمدة إعلان الفيديو حسب نوع الاستهداف بالثواني
TARGETING_TYPE_VIDEO_PLACEMENT نوع الاستهداف هو موضع الفيديو.
TARGETING_TYPE_VIDEO_PLAYBACK_METHOD طريقة تشغيل الفيديو حسب نوع الاستهداف
TARGETING_TYPE_APP_ID رقم تعريف التطبيق لنوع الاستهداف
TARGETING_TYPE_DOMAIN_URL عنوان URL لنطاق نوع الاستهداف
TARGETING_TYPE_CTR نسبة النقر إلى الظهور لنوع الاستهداف
TARGETING_TYPE_DEMOGRAPHICS نوع الاستهداف حسب الفئات الديمغرافية
TARGETING_TYPE_RESTRICTED_CATEGORY فئة خاضعة لقيود نوع الاستهداف
TARGETING_TYPE_AD_POSITION نوع الاستهداف: موضع عرض الإعلان
TARGETING_TYPE_DAY_AND_TIME نوع الاستهداف: اليوم والوقت
TARGETING_TYPE_RETAIL_MEDIA_AUDIENCE نوع الاستهداف هو جمهور وسائل التسويق للبيع بالتجزئة.

AudienceSelection

خيارات استهداف الجمهور المحدّدة

تمثيل JSON 
{
  "includedOrGroups": [
    {
      object (OrGroup)
    }
  ],
  "excludedOptionIds": [
    string
  ]
}
الحقول
includedOrGroups[]

object (OrGroup)

يتم ربط الخيارات المضمّنة باستخدام عامل التشغيل المنطقي "و"، ويمكن أن يكون كل خيار مضمّن خيارًا فرديًا أو مجموعة من الخيارات المرتبطة باستخدام عامل التشغيل المنطقي "أو".
excludedOptionIds[]

string (int64 format)

يتم دمج الخيارات المستبعَدة باستخدام عامل التشغيل OR.

OrGroup

مجموعة من الخيارات المحدّدة المرتبطة بـ "أو".

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

string (int64 format)

أرقام تعريف الخيارات المحدّدة

TargetingSelection

خيارات الاستهداف المحدّدة والمستبعَدة، والتي تنطبق على معظم أنواع الاستهداف

تمثيل JSON 
{
  "optionIds": [
    string
  ],
  "externalIds": [
    string
  ],
  "excludedOptionIds": [
    string
  ],
  "excludedExternalIds": [
    string
  ]
}
الحقول
optionIds[]

string (int64 format)

للعرض فقط. أرقام تعريف خيارات الاستهداف المحدّدة في "مساحة العرض والفيديو 360" التي تمت مشاركتها مع منصة تبادل الإعلانات قد يتم عرضها مع excludedOptionIds طالما أنّ القائمتَين لا تتداخلان.
externalIds[]

string

للعرض فقط. معرّفات خيارات الاستهداف المحدّدة التي يوفّرها مركز التبادل الإعلاني قد يتم عرضها مع excludedExternalIds طالما أنّ القائمتَين لا تتداخلان.
excludedOptionIds[]

string (int64 format)

للعرض فقط. معرّفات خيارات الاستهداف المستبعَدة في "مساحة العرض والفيديو 360" التي تمت مشاركتها مع منصة تبادل الإعلانات قد يتم عرضها مع optionIds طالما أنّ القائمتَين لا تتداخلان.
excludedExternalIds[]

string

للعرض فقط. معرّفات خيارات الاستهداف المستبعَدة التي يوفّرها Exchange قد يتم عرضها مع externalIds طالما أنّ القائمتَين لا تتداخلان.

ForecastResult

تم تحديد نتيجة التوقّعات.

تمثيل JSON 
{
  "forecasts": [
    {
      object (Forecast)
    }
  ]
}
الحقول
forecasts[]

object (Forecast)

التوقّعات: يجب أن تكون السمة forecastCategory فريدة لكل عنصر محدّد.

التوقعات

توقّعات فئة التوقّعات المحدّدة

تمثيل JSON 
{
  "forecastCategory": enum (ForecastCategory),

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "number": string,
  "percentage": integer,
  "cpmPrice": {
    object (Money)
  },
  "cpmRange": {
    object (CpmRange)
  },
  "forecastBreakdownData": {
    object (ForecastBreakdownData)
  }
  // End of mutually exclusive fields.
}
الحقول
forecastCategory

enum (ForecastCategory)

فئة التوقّعات المحدّدة التي تمثّلها إحصاءات التوقّعات.
يمكن تضمين نوع واحد فقط من بيانات الإحصاءات. يجب أن تتوافق البيانات التي تم ملؤها مع الحقل forecastCategory. في ما يلي قائمة بالحقول التي يستبعد بعضها بعضًا. سيتم ضبط حقل واحد على الأكثر في الرد:
number

string (int64 format)

بيانات الأرقام
percentage

integer

بيانات النسبة المئوية
cpmPrice

object (Money)

بيانات أسعار التكلفة لكل ألف ظهور
cpmRange

object (CpmRange)

بيانات نطاق السعر لكل ألف ظهور
forecastBreakdownData

object (ForecastBreakdownData)

بيانات تفاصيل التوقّعات
نهاية الحقول التي يستبعد كلّ منها الآخر

ForecastCategory

فئة التوقّعات

عمليات التعداد
FORECAST_CATEGORY_UNSPECIFIED فئة غير محدَّدة غير صالح للإدخال.
FORECAST_CATEGORY_TOTAL_OPPORTUNITIES إجمالي الفرص بيانات الأرقام
FORECAST_CATEGORY_TOTAL_AUDIENCE إجمالي الجمهور: بيانات الأرقام
FORECAST_CATEGORY_DIGITAL_TRP نقاط تقييم الاستهداف الرقمي بيانات النسبة المئوية
FORECAST_CATEGORY_SUGGESTED_CPM السعر المقترَح للتكلفة لكل ألف ظهور نطاق التكلفة لكل ألف ظهور أو بيانات سعر التكلفة لكل ألف ظهور
FORECAST_CATEGORY_UNIQUE_REACH توقُّع مدى الوصول الفريد بيانات الأرقام
FORECAST_CATEGORY_FORECAST_BREAKDOWN تفاصيل التوقعات بيانات تفاصيل التوقّعات

CpmRange

يحتوي نطاق التكلفة لكل ألف ظهور على الحدّ الأدنى والحدّ الأقصى للتكلفة لكل ألف ظهور.

تمثيل JSON 
{
  "minCpm": {
    object (Money)
  },
  "maxCpm": {
    object (Money)
  }
}
الحقول
minCpm

object (Money)

الحدّ الأدنى لنطاق التكلفة لكل ألف ظهور
maxCpm

object (Money)

الحدّ الأقصى لنطاق التكلفة لكل ألف ظهور

ForecastBreakdownData

تحتوي بيانات تفاصيل التوقّعات على قائمة بتفاصيل التوقّعات.

تمثيل JSON 
{
  "forecastBreakdowns": [
    {
      object (ForecastBreakdown)
    }
  ]
}
الحقول
forecastBreakdowns[]

object (ForecastBreakdown)

قائمة بتقسيمات التوقعات

ForecastBreakdown

تفاصيل التوقعات لخيار الاستهداف المحدّد

تمثيل JSON 
{
  "selectedTargetingOption": {
    object (SelectedTargetingOption)
  },

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "impressions": string
  // End of mutually exclusive fields.
}
الحقول
selectedTargetingOption

object (SelectedTargetingOption)

خيارات الاستهداف المحدّدة لنوع استهداف واحد
يمكن تضمين نوع واحد فقط من بيانات التقسيم. في ما يلي قائمة بالحقول التي يستبعد بعضها بعضًا. سيتم ضبط حقل واحد على الأكثر في الرد:
impressions

string (int64 format)

توقُّع مرّات الظهور
نهاية الحقول التي يستبعد كلّ منها الآخر

ErrorDetails

تفاصيل الخطأ المحدّدة عندما يتضمّن التعديل أخطاءً

تمثيل JSON 
{
  "message": string,
  "instantDealErrorStatus": enum (InstantDealErrorStatus)
}
الحقول
message

string

الرسالة المحدّدة عند حدوث أخطاء في التعديل
instantDealErrorStatus

enum (InstantDealErrorStatus)

حالة الخطأ المحدّدة عندما يتضمّن التعديل أخطاء في الصفقات الفورية

InstantDealErrorStatus

حالة الخطأ المحدّدة عندما يتضمّن تعديل الصفقة الفورية أخطاءً.

عمليات التعداد
INSTANT_DEAL_ERROR_STATUS_UNSPECIFIED حالة الخطأ غير محدَّدة.
INSTANT_DEAL_ERROR_STATUS_INVENTORY_UNAVAILABLE تشير حالة الخطأ إلى عدم توفّر المساحة الإعلانية.
INSTANT_DEAL_ERROR_STATUS_FORECAST_UNAVAILABLE تشير حالة الخطأ إلى أنّ التوقعات غير متاحة.
INSTANT_DEAL_ERROR_STATUS_INVALID_INPUT تشير حالة الخطأ إلى أنّ هناك حقول إدخال غير صالحة.

FrequencyCap

عدد المرات التي قد يظهر فيها الإعلان نفسه للمستخدم خلال فترة زمنية معيّنة

تمثيل JSON 
{
  "timeUnit": enum (TimeUnit),
  "maxImpressions": string
}
الحقول
timeUnit

enum (TimeUnit)

الوحدة الزمنية التي سيتم تطبيق تحديد عدد مرات الظهور فيها
maxImpressions

string (int64 format)

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

TimeUnit

الوحدة الزمنية التي سيتم تطبيق تحديد عدد مرات الظهور فيها

عمليات التعداد
TIME_UNIT_UNSPECIFIED وحدة زمنية غير محدّدة
TIME_UNIT_LIFETIME سيتم تطبيق تحديد عدد مرات الظهور على مدار مدة العرض بالكامل.
TIME_UNIT_MONTHS سيتم تطبيق تحديد عدد مرات الظهور على عدد من الأشهر.
TIME_UNIT_WEEKS سيتم تطبيق تحديد عدد مرات الظهور على عدد من الأسابيع.
TIME_UNIT_DAYS سيتم تطبيق عدد مرات الظهور المحدَّد على عدد من الأيام.

الطُرق

create

 تنشئ منتجًا.

get

 تستردّ هذه الطريقة منتجًا.

list

 تعرض هذه الطريقة المنتجات.

patch

 تعديل منتج