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 (RegionalSubscriptionOfferPhaseFreePriceOverride)
  }
  // End of list of possible types for union field price_override.
}

string

مورد نیاز. تغییرناپذیر. منطقه ای که این پیکربندی برای آن اعمال می شود.

object ( Money )

قیمت مطلقی که کاربر برای این مرحله پیشنهاد می پردازد. قیمت نباید کمتر از حداقل قیمت مجاز برای این منطقه باشد.

number

کسری از قیمت طرح پایه در طول مدت فازی که کاربر برای این مرحله پیشنهاد پرداخت می‌کند، به نسبت است. به عنوان مثال، اگر قیمت طرح پایه برای این منطقه 12 دلار برای یک دوره 1 ساله باشد، 50٪ تخفیف برای یک مرحله به مدت 3 ماه با قیمت 1.50 دلار مطابقت دارد. تخفیف باید به‌عنوان کسری کاملاً بزرگ‌تر از 0 و کاملاً کوچک‌تر از 1 مشخص شود. قیمت حاصل به نزدیک‌ترین واحد قابل پرداخت گرد می‌شود (مثلاً سنت دلار). اگر قیمت تخفیف خورده کمتر از حداقل قیمت مجاز در این منطقه باشد، تخفیف نسبی نامعتبر تلقی می شود.

object ( Money )

مقدار مطلق پول کسر شده از قیمت طرح پایه نسبت به مدت فازی که کاربر برای این مرحله پیشنهاد می‌پردازد. به عنوان مثال، اگر قیمت طرح پایه برای این منطقه 12 دلار برای یک دوره 1 ساله باشد، آنگاه یک دلار تخفیف مطلق برای یک مرحله به مدت 3 ماه با قیمت 2 دلار مطابقت دارد. قیمت حاصله ممکن است کمتر از حداقل قیمت مجاز برای این منطقه نباشد.

object ( RegionalSubscriptionOfferPhaseFreePriceOverride )

تنظیم برای مشخص کردن این پیشنهاد برای به دست آوردن رایگان است.

{

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

object ( OtherRegionsSubscriptionOfferPhasePrices )

قیمت مطلقی که کاربر برای این مرحله پیشنهاد می پردازد. قیمت نباید کمتر از حداقل قیمت مجاز برای مکان‌های جدیدی باشد که Play ممکن است در آن راه‌اندازی شود.

number

کسری از قیمت طرح پایه در طول مدت فازی که کاربر برای این مرحله پیشنهاد پرداخت می‌کند، به نسبت است. به عنوان مثال، اگر قیمت طرح پایه برای این منطقه 12 دلار برای یک دوره 1 ساله باشد، 50٪ تخفیف برای یک مرحله به مدت 3 ماه با قیمت 1.50 دلار مطابقت دارد. تخفیف باید به‌عنوان کسری کاملاً بزرگ‌تر از 0 و کاملاً کوچک‌تر از 1 مشخص شود. قیمت حاصل به نزدیک‌ترین واحد قابل پرداخت گرد می‌شود (مثلاً سنت دلار). اگر قیمت تخفیف‌خورده کمتر از حداقل قیمت مجاز در مکان‌های جدیدی باشد که Play ممکن است راه‌اندازی شود، تخفیف نسبی نامعتبر تلقی می‌شود.

object ( OtherRegionsSubscriptionOfferPhasePrices )

مقدار مطلق پول کسر شده از قیمت طرح پایه نسبت به مدت فازی که کاربر برای این مرحله پیشنهاد می‌پردازد. به عنوان مثال، اگر قیمت طرح پایه برای این منطقه 12 دلار برای یک دوره 1 ساله باشد، آنگاه یک دلار تخفیف مطلق برای یک مرحله به مدت 3 ماه با قیمت 2 دلار مطابقت دارد. قیمت به‌دست‌آمده ممکن است از حداقل قیمت مجاز برای مکان‌های جدیدی که Play در آن راه‌اندازی شود، کمتر نباشد.

object ( OtherRegionsSubscriptionOfferPhaseFreePriceOverride )

تنظیم برای مشخص کردن این پیشنهاد برای به دست آوردن رایگان است.

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

آیا پیشنهاد اشتراک در منطقه مشخص شده برای مشترکین جدید در دسترس است یا خیر. اگر این مقدار روی false تنظیم شود اشتراک مشترکان موجود لغو نمی شود. اگر مشخص نشده باشد، این به طور پیش فرض نادرست خواهد بود.

{
  "otherRegionsNewSubscriberAvailability": boolean
}

boolean

اینکه آیا پیشنهاد اشتراک در مکان‌های جدید Play ممکن است در آینده راه‌اندازی شود یا خیر. اگر مشخص نشده باشد، این به طور پیش فرض نادرست خواهد بود.