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 أشهر بسعر يساوي دولارين أمريكيين (أو ما يعادلهما بالعملة المحلية). قد لا يكون السعر الناتج أصغر من الحد الأدنى للسعر المسموح به لهذه المنطقة.

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 أشهر بسعر يساوي دولارين أمريكيين (أو ما يعادلهما بالعملة المحلية). يجب ألا يقل السعر الناتج عن الحد الأدنى للسعر المسموح به لأي مواقع جغرافية جديدة يتم إطلاق 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
  },
  "anySubscriptionInApp": {
    object
  },
  "specificSubscriptionInApp": string
  // End of list of possible types for union field scope.
}

object

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

object

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

string

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

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

boolean

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

object (TargetingRuleScope)

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

string

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

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

string

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

boolean

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

{
  "otherRegionsNewSubscriberAvailability": boolean
}

boolean

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