REST Resource: monetization.onetimeproducts.purchaseOptions.offers

المورد: OneTimeProductOffer

تمثّل هذه السمة عرضًا واحدًا لمنتج يتم تحصيل سعره مرة واحدة.

تمثيل JSON 
{
  "packageName": string,
  "productId": string,
  "purchaseOptionId": string,
  "offerId": string,
  "state": enum (State),
  "regionalPricingAndAvailabilityConfigs": [
    {
      object (RegionalPricingAndAvailabilityConfig)
    }
  ],
  "offerTags": [
    {
      object (OfferTag)
    }
  ],
  "regionsVersion": {
    object (RegionsVersion)
  },

  // Union field offer_type can be only one of the following:
  "preOrderOffer": {
    object (OneTimeProductPreOrderOffer)
  },
  "discountedOffer": {
    object (OneTimeProductDiscountedOffer)
  }
  // End of list of possible types for union field offer_type.
}
الحقول
packageName

string

الحقل مطلوب. غير قابل للتغيير اسم حزمة التطبيق الذي ينتمي إليه المنتج الرئيسي
productId

string

الحقل مطلوب. غير قابل للتغيير تمثّل معرّف المنتج الرئيسي الذي ينتمي إليه هذا العرض.
purchaseOptionId

string

الحقل مطلوب. غير قابل للتغيير تمثّل هذه السمة معرّف خيار الشراء الذي يمثّل هذا العرض امتدادًا له.
offerId

string

الحقل مطلوب. غير قابل للتغيير معرّف عرض المنتج هذا. يجب أن يكون المعرّف فريدًا ضمن خيار الشراء. ويجب أن يبدأ برقم أو حرف صغير، وألّا يتضمّن سوى أحرف صغيرة (a-z) وأرقام (0-9) وواصلات (-)، ويجب ألّا يزيد عن 63 حرفًا.
state

enum (State)

النتائج فقط. تعرض هذه السمة الحالة الحالية للعرض. لا يمكن تغيير هذا الحقل من خلال تعديل المرجع. استخدِم نقاط النهاية المخصّصة بدلاً من ذلك.
regionalPricingAndAvailabilityConfigs[]

object (RegionalPricingAndAvailabilityConfig)

مجموعة من المعلومات حول السعر ومدى التوفّر على مستوى منطقة معيّنة لهذا العرض يجب ألا تتضمّن إدخالات مكرّرة تحمل regionCode نفسه.
offerTags[]

object (OfferTag)

اختيارية: قائمة تضمّ ما يصل إلى 20 علامة مخصّصة محدّدة لهذا العرض، ويتم إرجاعها إلى التطبيق من خلال مكتبة الفوترة.
regionsVersion

object (RegionsVersion)

النتائج فقط. تشير هذه السمة إلى إصدار إعدادات المناطق الذي تم استخدامه لإنشاء عرض المنتج الذي يتم تحصيل سعره مرة واحدة.
حقل الدمج offer_type نوع هذا العرض يجب ضبط قيمة واحدة بالضبط. يمكن أن تكون offer_type إحدى القيم التالية فقط:
preOrderOffer

object (OneTimeProductPreOrderOffer)

عرض طلب مُسبَق
discountedOffer

object (OneTimeProductDiscountedOffer)

عرض توفيري

الحالة

تمثّل هذه السمة الحالة الحالية للعرض.

عمليات التعداد
STATE_UNSPECIFIED القيمة التلقائية، ويجب عدم استخدامها مطلقًا.
DRAFT العرض الترويجي غير متاح للمستخدمين ولم يكن متاحًا لهم في أي وقت.
ACTIVE يتوفّر العرض للمستخدمين طالما أنّهم يستوفون شروطه.
CANCELLED تتوفّر هذه الحالة للطلبات المُسبَقة فقط. يتم إلغاء العرض الترويجي ولا يكون متاحًا للمستخدمين. تم إلغاء جميع الطلبات المعلّقة المرتبطة بهذا العرض.
INACTIVE تتعلّق هذه الحالة بالعروض المخفَّضة. لم يعُد العرض الترويجي متاحًا للمستخدمين.

OneTimeProductPreOrderOffer

إعدادات خاصة بعروض الطلب المُسبَق

تمثيل JSON 
{
  "startTime": string,
  "endTime": string,
  "releaseTime": string,
  "priceChangeBehavior": enum (PreOrderPriceChangeBehavior)
}
الحقول
startTime

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".
endTime

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".
releaseTime

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".
priceChangeBehavior

enum (PreOrderPriceChangeBehavior)

الحقل مطلوب. غير قابل للتغيير تحدّد هذه السمة كيفية تأثير تغييرات الأسعار في الطلبات المُسبقة الحالية.

PreOrderPriceChangeBehavior

تحدّد هذه السمة كيفية تأثير تغييرات الأسعار في الطلبات المُسبقة الحالية.

عمليات التعداد
PRE_ORDER_PRICE_CHANGE_BEHAVIOR_UNSPECIFIED سلوك غير محدّد لتغيير السعر يجب عدم استخدامها.
PRE_ORDER_PRICE_CHANGE_BEHAVIOR_TWO_POINT_LOWEST يتم تحصيل الحد الأدنى من المشتري بين السعر الأولي عند تقديم الطلب المُسبَق وسعر العرض النهائي في تاريخ الإصدار.
PRE_ORDER_PRICE_CHANGE_BEHAVIOR_NEW_ORDERS_ONLY يحصل المشتري على السعر نفسه الذي تم طلبه مُسبقًا، بغض النظر عن أي تغييرات في السعر قد تكون حدثت بعد الطلب المُسبَق.

OneTimeProductDiscountedOffer

إعدادات خاصة بالعروض المخفَّضة

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

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".
endTime

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".
redemptionLimit

string (int64 format)

اختيارية: عدد المرات التي يمكن فيها الاستفادة من هذا العرض في حال عدم ضبطها أو ضبطها على 0، يسمح ذلك بتحصيل قيمة العروض الترويجية بلا حدود. في ما عدا ذلك، يجب أن تكون القيمة عددًا يتراوح بين 1 و50 ضِمنًا.

RegionalPricingAndAvailabilityConfig

إعدادات السعر ومدى التوفّر على مستوى منطقة معيّنة لعرض منتج يتم تحصيل سعره مرة واحدة

تمثيل JSON 
{
  "regionCode": string,
  "availability": enum (Availability),

  // Union field price_override can be only one of the following:
  "noOverride": {
    object (OneTimeProductOfferNoPriceOverrideOptions)
  },
  "relativeDiscount": number,
  "absoluteDiscount": {
    object (Money)
  }
  // End of list of possible types for union field price_override.
}
الحقول
regionCode

string

الحقل مطلوب. رمز المنطقة التي ينطبق عليها هذا الإعداد، كما هو محدّد في معيار ISO 3166-2، مثلاً "US".
availability

enum (Availability)

الحقل مطلوب. تحدّد هذه السمة مدى توفّر المنتج في هذه المنطقة.
حقل الدمج price_override تمثّل هذه السمة السعر البديل لهذا العرض. يجب ضبط قيمة واحدة بالضبط. يمكن أن تكون price_override إحدى القيم التالية فقط:
noOverride

object (OneTimeProductOfferNoPriceOverrideOptions)

سيتم استخدام السعر المحدّد في خيار الشراء لهذه المنطقة.
relativeDiscount

number

تمثّل هذه السمة جزءًا من سعر خيار الشراء الذي يدفعه المستخدم مقابل هذا العرض. على سبيل المثال، إذا كان سعر خيار الشراء في هذه المنطقة هو 12 دولار أمريكي، سيكون الخصم بنسبة ‎50% مساويًا لسعر 6 دولار أمريكي. يجب تحديد الخصم ككسر أكبر من 0 وأصغر من 1. سيتم تقريب السعر الناتج إلى أقرب وحدة قابلة للفوترة (مثل سنتات الدولار الأمريكي). يُعدّ الخصم النسبي غير صالح إذا كان السعر المخفَّض أقل من الحد الأدنى للسعر المسموح به في هذه المنطقة.
absoluteDiscount

object (Money)

القيمة المطلقة للخصم الذي يتم طرحه من سعر خيار الشراء

يجب أن تتراوح القيمة بين 0 وسعر خيار الشراء.

OneTimeProductOfferNoPriceOverrideOptions

لا يتضمّن هذا النوع أي حقول.

خيارات لعروض المنتجات التي يتم تحصيل سعرها مرة واحدة بدون إلغاء السعر على مستوى منطقة معيّنة

مدى التوفّر

تعرض هذه السمة معلومات توفُّر العرض.

عمليات التعداد
AVAILABILITY_UNSPECIFIED مدى التوفّر غير محدّد يجب عدم استخدامها.
AVAILABLE يتوفّر العرض للمستخدمين.
NO_LONGER_AVAILABLE لم يعُد العرض الترويجي متاحًا للمستخدمين. لا يمكن استخدام هذه القيمة إلا إذا تم ضبط مدى التوفّر على AVAILABLE (متوفّر) سابقًا.

الطُرق

activate

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

batchDelete

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

batchGet

 تقرأ هذه السمة عرضًا واحدًا أو أكثر من عروض المنتجات التي يتم تحصيل سعرها مرة واحدة.

batchUpdate

 تنشئ هذه الطريقة عرضًا واحدًا أو أكثر من عروض المنتجات التي يتم تحصيل سعرها مرة واحدة أو تعدّلها.

batchUpdateStates

 تعدِّل هذه الطريقة مجموعة من حالات عروض المنتجات التي يتم تحصيل سعرها مرة واحدة.

cancel

 تلغي هذه الطريقة عرضًا لمنتج يتم تحصيل سعره مرة واحدة.

deactivate

 تؤدي إلى إيقاف عرض منتج يُحصّل سعره مرة واحدة.

list

 تعرض هذه السمة جميع العروض الترويجية ضمن تطبيق أو منتج أو خيار شراء معيّن.

رموز الخطأ

تعرض عمليات هذا المرجع رموز خطأ HTTP التالية:

رمز الخطأ السبب الدقة
5xx حدث خطأ عام في خادم Google Play. أعِد محاولة إرسال طلبك.

إذا استمرت المشكلة، يُرجى التواصل مع مدير حسابك على Google Play أو إرسال طلب دعم. ننصحك بالاطّلاع على لوحة البيانات الخاصة بحالة Play لمعرفة ما إذا كان هناك أي انقطاع معروف في الخدمة.
409 حدث خطأ أثناء تعديل التزامن.

حدثت محاولة لتعديل عنصر قيد التعديل. على سبيل المثال، يتم الإقرار بعملية شراء من خلال استدعاء الطريقة acknowledgePurchase() في Play Billing Library واستدعاء الطريقة purchases.products.acknowledge في Play Developer API في الوقت نفسه.

 أعِد محاولة إرسال طلبك.