REST Resource: monetization.subscriptions.basePlans.offers

{
  "packageName": string,
  "productId": string,
  "basePlanId": string,
  "offerId": string,
  "state": enum (State),
  "phases": [
    {
      object (SubscriptionOfferPhase)
    }
  ],
  "targeting": {
    object (SubscriptionOfferTargeting)
  },
  "regionalConfigs": [
    {
      object (RegionalSubscriptionOfferConfig)
    }
  ],
  "otherRegionsConfig": {
    object (OtherRegionsSubscriptionOfferConfig)
  },
  "offerTags": [
    {
      object (OfferTag)
    }
  ]
}

string

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

string

مطلوبة. غير قابل للتغيير. معرّف الاشتراك الرئيسي الذي ينتمي إليه هذا العرض.

string

مطلوبة. غير قابل للتغيير. رقم تعريف الخطة الأساسية التي يمثّل هذا العرض الترويجي إضافة إليها.

string

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

enum (State)

النتائج فقط. الوضع الحالي لهذا العرض يمكن تغييرهما باستخدام الإجراءين "تفعيل" و"إيقاف". ملاحظة: تحل حالة الخطة الأساسية محل هذه الحالة، لذلك قد لا يتوفّر عرض نشط إذا كانت الخطة الأساسية غير نشطة.

object (SubscriptionOfferPhase)

مطلوبة. مراحل عرض الاشتراك هذا. يجب أن يحتوي على إدخال واحد على الأقل، وخمسة كحد أقصى. سيتلقّى المستخدمون دائمًا جميع هذه المراحل بالترتيب المحدد. لا يمكن إضافة المراحل أو إزالتها أو إعادة ترتيبها بعد إنشائها لأول مرة.

object (SubscriptionOfferTargeting)

المتطلبات التي يجب أن يستوفيها المستخدمون ليكونوا مؤهّلين لهذا العرض تمثّل هذه السمة المتطلبات التي سيقيّمها Play لتحديد ما إذا كان يجب إرجاع أحد العروض. ويمكن للمطوّرين فلترة هذه العروض بأنفسهم.

object (RegionalSubscriptionOfferConfig)

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

object (OtherRegionsSubscriptionOfferConfig)

وقد يتم إطلاق الإعدادات لأي مواقع جغرافية جديدة في Play في المستقبل.

object (OfferTag)

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

{
  "recurrenceCount": integer,
  "duration": string,
  "regionalConfigs": [
    {
      object (RegionalSubscriptionOfferPhaseConfig)
    }
  ],
  "otherRegionsConfig": {
    object (OtherRegionsSubscriptionOfferPhaseConfig)
  }
}

integer

مطلوبة. عدد مرات تكرار هذه المرحلة. إذا لم تكن مرحلة العرض هذه مجانية، سيفرض كل تكرار على المستخدم سعر مرحلة العرض هذه.

string

مطلوبة. مدة التكرار الواحد لهذه المرحلة. تم تحديد التنسيق بتنسيق ISO 8601.

object (RegionalSubscriptionOfferPhaseConfig)

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

object (OtherRegionsSubscriptionOfferPhaseConfig)

معلومات الأسعار لأي مواقع جغرافية جديدة قد يتم إطلاق Play فيها

{
  "regionCode": string,

  // Union field price_override can be only one of the following:
  "price": {
    object (Money)
  },
  "relativeDiscount": number,
  "absoluteDiscount": {
    object (Money)
  },
  "free": {
    object
  }
  // End of list of possible types for union field price_override.
}

string

مطلوبة. غير قابل للتغيير. المنطقة التي تنطبق عليها هذه الإعدادات.

object (Money)

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

number

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

object (Money)

المبلغ المطلق من المال المطروح من سعر الخطة الأساسية بالتناسب على فترة المرحلة التي يدفعها المستخدم لمرحلة العرض هذه. على سبيل المثال، إذا كان سعر الخطة الأساسية لهذه المنطقة هو 12 دولار أمريكي لمدة عام واحد، سيتطابق الخصم المطلق بقيمة دولار أمريكي واحد (أو ما يعادله بالعملة المحلية) عن فترة 3 أشهر بسعر 2 دولار أمريكي. قد لا يكون السعر الناتج أقلّ من السعر الأدنى المسموح به لهذه المنطقة.

object

يجب تحديد أنّ هذا العرض متاح مجانًا.

{

  // Union field price_override can be only one of the following:
  "otherRegionsPrices": {
    object (OtherRegionsSubscriptionOfferPhasePrices)
  },
  "relativeDiscount": number,
  "absoluteDiscounts": {
    object (OtherRegionsSubscriptionOfferPhasePrices)
  },
  "free": {
    object
  }
  // End of list of possible types for union field price_override.
}

object (OtherRegionsSubscriptionOfferPhasePrices)

السعر المطلق الذي يدفعه المستخدم مقابل مرحلة العرض هذه. يجب ألا يكون السعر أقل من الحد الأدنى للسعر المسموح به لأي مواقع جغرافية جديدة قد يتم إطلاق Play فيها.

number

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

object (OtherRegionsSubscriptionOfferPhasePrices)

المبلغ المطلق من المال المطروح من سعر الخطة الأساسية بالتناسب على فترة المرحلة التي يدفعها المستخدم لمرحلة العرض هذه. على سبيل المثال، إذا كان سعر الخطة الأساسية لهذه المنطقة هو 12 دولار أمريكي لمدة عام واحد، سيتطابق الخصم المطلق بقيمة دولار أمريكي واحد (أو ما يعادله بالعملة المحلية) عن فترة 3 أشهر بسعر 2 دولار أمريكي. قد لا يكون السعر الناتج أقلّ من الحدّ الأدنى للسعر المسموح به في أي مواقع جغرافية جديدة قد يتم إطلاق Play فيها.

object

يجب تحديد أنّ هذا العرض متاح مجانًا.

{
  "usdPrice": {
    object (Money)
  },
  "eurPrice": {
    object (Money)
  }
}

object (Money)

مطلوبة. السعر بالدولار الأمريكي للاستخدام في أي مواقع جغرافية جديدة قد يتم إطلاق Play فيها

object (Money)

مطلوبة. السعر باليورو الذي يمكن استخدامه في أي مواقع جغرافية جديدة قد يتم إطلاق Play فيها

{

  // Union field rule can be only one of the following:
  "acquisitionRule": {
    object (AcquisitionTargetingRule)
  },
  "upgradeRule": {
    object (UpgradeTargetingRule)
  }
  // End of list of possible types for union field rule.
}

object (AcquisitionTargetingRule)

تقديم قاعدة استهداف لاكتساب مستخدمين جدد.

object (UpgradeTargetingRule)

عرض قاعدة استهداف لترقية الخطط الحالية للمستخدمين

{
  "scope": {
    object (TargetingRuleScope)
  }
}

object (TargetingRuleScope)

مطلوبة. نطاق الاشتراكات التي تراعيها هذه القاعدة. السماح "بهذا الاشتراك" و "أي اشتراك في التطبيق" فقط.

{

  // Union field scope can be only one of the following:
  "thisSubscription": {
    object (TargetingRuleScopeThisSubscription)
  },
  "anySubscriptionInApp": {
    object (TargetingRuleScopeAnySubscriptionInApp)
  },
  "specificSubscriptionInApp": string
  // End of list of possible types for union field scope.
}

object (TargetingRuleScopeThisSubscription)

نطاق قاعدة الاستهداف الحالية هو الاشتراك الذي يتم تحديد هذا العرض فيه.

object (TargetingRuleScopeAnySubscriptionInApp)

نطاق قاعدة الاستهداف الحالية هو أي اشتراك في التطبيق الرئيسي.

string

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

{
  "oncePerUser": boolean,
  "scope": {
    object (TargetingRuleScope)
  },
  "billingPeriodDuration": string
}

boolean

يمكنك حصر هذا العرض مرة واحدة فقط لكل مستخدم. في حال ضبطها على "صحيح"، لا يمكن للمستخدم أن يكون مؤهلاً للاستفادة من هذا العرض مجددًا إذا سبق له الاشتراك فيه.

object (TargetingRuleScope)

مطلوبة. نطاق الاشتراكات التي تراعيها هذه القاعدة. السماح "بهذا الاشتراك" و "الاشتراك المحدد في التطبيق" فقط.

string

هي مدة المدد الزمنية المحدّدة للفوترة، المحددة بتنسيق ISO 8601، والتي يجب أن يكون المستخدم مشتركًا فيها حاليًا ليكون مؤهلاً لهذه القاعدة. وفي حال عدم تحديد أي مدة، ستتم مطابقة المستخدمين المشتركين في أي مدة زمنية للفوترة.

{
  "regionCode": string,
  "newSubscriberAvailability": boolean
}

string

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

boolean

ما إذا كان عرض الاشتراك في المنطقة المحددة متاحًا للمشتركين الجدد. ولن يتم إلغاء اشتراك المشتركين الحاليين إذا تم ضبط هذه القيمة على "خطأ". إذا لم يتم تحديد القيمة، سيتم ضبط القيمة تلقائيًا على "خطأ".

{
  "otherRegionsNewSubscriberAvailability": boolean
}

boolean

ما إذا كان سيتم إطلاق عرض الاشتراك في أي مواقع جغرافية جديدة على Play في المستقبل إذا لم يتم تحديد القيمة، سيتم ضبط القيمة تلقائيًا على "خطأ".