REST Resource: monetization.subscriptions.basePlans.offers

সম্পদ: সাবস্ক্রিপশন অফার

একটি একক, অস্থায়ী অফার

JSON প্রতিনিধিত্ব
{
  "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)
    }
  ]
}
ক্ষেত্র
packageName

string

প্রয়োজন। অপরিবর্তনীয়। অভিভাবক সদস্যতা যে অ্যাপের প্যাকেজটির নাম।

productId

string

প্রয়োজন। অপরিবর্তনীয়। এই অফারটির অভিভাবক সদস্যতার আইডি।

basePlanId

string

প্রয়োজন। অপরিবর্তনীয়। বেস প্ল্যানের আইডি যেখানে এই অফারটি একটি এক্সটেনশন।

offerId

string

প্রয়োজন। অপরিবর্তনীয়। এই সাবস্ক্রিপশন অফারের অনন্য আইডি। বেস প্ল্যানের মধ্যে অনন্য হতে হবে।

state

enum ( State )

শুধুমাত্র আউটপুট। এই অফারের বর্তমান অবস্থা। সক্রিয় এবং নিষ্ক্রিয় কর্ম ব্যবহার করে পরিবর্তন করা যেতে পারে. NB: বেস প্ল্যান স্টেট এই স্টেটকে ছাড়িয়ে যায়, তাই বেস প্ল্যান সক্রিয় না থাকলে একটি সক্রিয় অফার উপলব্ধ নাও হতে পারে।

phases[]

object ( SubscriptionOfferPhase )

প্রয়োজন। এই সাবস্ক্রিপশন অফারের পর্যায়গুলি। কমপক্ষে একটি এবং সর্বাধিক দুটি এন্ট্রি থাকতে হবে। ব্যবহারকারীরা সর্বদা নির্দিষ্ট ক্রমে এই সমস্ত পর্যায়গুলি পাবেন।

targeting

object ( SubscriptionOfferTargeting )

এই অফারের জন্য যোগ্য হতে ব্যবহারকারীদের যে প্রয়োজনীয়তাগুলি পূরণ করতে হবে৷ অফার ফেরত দেওয়া হবে কিনা তা নির্ধারণ করার জন্য Play মূল্যায়ন করবে এমন প্রয়োজনীয়তার প্রতিনিধিত্ব করে। বিকাশকারীরা এই অফারগুলিকে আরও ফিল্টার করতে পারে৷

regionalConfigs[]

object ( RegionalSubscriptionOfferConfig )

প্রয়োজন। এই অফারের অঞ্চল-নির্দিষ্ট কনফিগারেশন। অন্তত একটি এন্ট্রি থাকতে হবে।

otherRegionsConfig

object ( OtherRegionsSubscriptionOfferConfig )

যেকোনো নতুন অবস্থানের জন্য কনফিগারেশন প্লে ভবিষ্যতে চালু হতে পারে।

offerTags[]

object ( OfferTag )

এই অফারের জন্য নির্দিষ্ট করা 20টি পর্যন্ত কাস্টম ট্যাগের তালিকা এবং বিলিং লাইব্রেরির মাধ্যমে অ্যাপে ফিরে এসেছে।

রাজ্য

সাবস্ক্রিপশন অফারের বর্তমান অবস্থা।

Enums
STATE_UNSPECIFIED ডিফল্ট মান, কখনই ব্যবহার করা উচিত নয়।
DRAFT সাবস্ক্রিপশন অফারটি ব্যবহারকারীদের জন্য উপলব্ধ নয় এবং কখনও পাওয়া যায় নি।
ACTIVE সাবস্ক্রিপশন অফারটি নতুন এবং বিদ্যমান ব্যবহারকারীদের জন্য উপলব্ধ।
INACTIVE সদস্যতা অফার নতুন ব্যবহারকারীদের জন্য উপলব্ধ নয়. বিদ্যমান ব্যবহারকারীদের অ্যাক্সেস বজায় রাখা.

সাবস্ক্রিপশন অফার ফেজ

সাবস্ক্রিপশন অফারের একটি একক পর্ব।

JSON প্রতিনিধিত্ব
{
  "recurrenceCount": integer,
  "duration": string,
  "regionalConfigs": [
    {
      object (RegionalSubscriptionOfferPhaseConfig)
    }
  ],
  "otherRegionsConfig": {
    object (OtherRegionsSubscriptionOfferPhaseConfig)
  }
}
ক্ষেত্র
recurrenceCount

integer

প্রয়োজন। এই পর্বের পুনরাবৃত্তির সংখ্যা। এই অফার পর্বটি বিনামূল্যে না হলে, প্রতিটি পুনরাবৃত্তি ব্যবহারকারীকে এই অফার পর্বের মূল্য চার্জ করে।

duration

string

প্রয়োজন। এই পর্বের একটি একক পুনরাবৃত্তির সময়কাল। ISO 8601 বিন্যাসে নির্দিষ্ট করা হয়েছে।

regionalConfigs[]

object ( RegionalSubscriptionOfferPhaseConfig )

প্রয়োজন। এই অফার পর্বের অঞ্চল-নির্দিষ্ট কনফিগারেশন। এই তালিকায় অবশ্যই প্রতিটি অঞ্চলের জন্য ঠিক একটি এন্ট্রি থাকতে হবে যার জন্য সদস্যতা অফারটির একটি আঞ্চলিক কনফিগারেশন রয়েছে৷

otherRegionsConfig

object ( OtherRegionsSubscriptionOfferPhaseConfig )

যে কোনো নতুন অবস্থানের জন্য মূল্যের তথ্য প্লে চালু হতে পারে।

আঞ্চলিক সাবস্ক্রিপশনঅফারফেজ কনফিগ

একটি একক অঞ্চলে সাবস্ক্রিপশন অফারের একক পর্বের জন্য কনফিগারেশন।

JSON প্রতিনিধিত্ব
{
  "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.
}
ক্ষেত্র
regionCode

string

প্রয়োজন। অপরিবর্তনীয়। যে অঞ্চলে এই কনফিগারেশন প্রযোজ্য।

ইউনিয়ন ক্ষেত্রের price_override । এই পর্যায়ের দাম ওভাররাইড. প্রয়োজন। price_override নিম্নলিখিতগুলির মধ্যে একটি হতে পারে:
price

object ( Money )

এই অফার পর্বের জন্য ব্যবহারকারী যে নিখুঁত মূল্য প্রদান করে। মূল্য এই অঞ্চলের জন্য অনুমোদিত ন্যূনতম মূল্যের চেয়ে ছোট হওয়া উচিত নয়৷

relativeDiscount

number

বেস প্ল্যান মূল্যের ভগ্নাংশ এই অফার পর্বের জন্য ব্যবহারকারী যে ফেজ সময়কালের জন্য অর্থপ্রদান করে তার অনুপাত। উদাহরণস্বরূপ, যদি এই অঞ্চলের জন্য 1 বছরের জন্য বেস প্ল্যান মূল্য $12 হয়, তাহলে 3 মাস মেয়াদী একটি পর্বের জন্য 50% ডিসকাউন্ট $1.50 মূল্যের সাথে মিলবে। ডিসকাউন্টটি অবশ্যই 0 এর চেয়ে বড় এবং 1 এর থেকে কঠোরভাবে ছোট ভগ্নাংশ হিসাবে নির্দিষ্ট করতে হবে। ফলস্বরূপ মূল্যটি নিকটতম বিলযোগ্য ইউনিটে বৃত্তাকার হবে (যেমন USD এর জন্য সেন্ট)। আপেক্ষিক ডিসকাউন্টটি অবৈধ বলে বিবেচিত হয় যদি ছাড়ের মূল্য এই অঞ্চলে অনুমোদিত ন্যূনতম মূল্যের চেয়ে ছোট হয়।

absoluteDiscount

object ( Money )

এই অফার পর্বের জন্য ব্যবহারকারী যে ফেজ সময়কালের জন্য প্রযোজ্য বেস প্ল্যান মূল্য থেকে বিয়োগ করা অর্থের পরম পরিমাণ। উদাহরণস্বরূপ, যদি এই অঞ্চলের জন্য 1 বছরের জন্য বেস প্ল্যান মূল্য $12 হয়, তাহলে 3 মাস মেয়াদের একটি পর্বের জন্য $1 সম্পূর্ণ ছাড় $2 মূল্যের সাথে মিলবে। ফলস্বরূপ মূল্য এই অঞ্চলের জন্য অনুমোদিত ন্যূনতম মূল্যের চেয়ে কম নাও হতে পারে৷

free

object ( RegionalSubscriptionOfferPhaseFreePriceOverride )

এই অফারটি প্রাপ্ত করার জন্য বিনামূল্যে নির্দিষ্ট করতে সেট করুন।

আঞ্চলিক সাবস্ক্রিপশন অফারফেজফ্রি প্রাইস ওভাররাইড

এই ধরনের কোন ক্ষেত্র আছে.

সাবস্ক্রিপশন অফারের একটি একক পর্বের জন্য বিনামূল্যের মূল্য ওভাররাইড কনফিগারেশনের প্রতিনিধিত্ব করে

অন্যান্য অঞ্চল সাবস্ক্রিপশনঅফারফেজ কনফিগ

যেকোনো নতুন অবস্থানের জন্য কনফিগারেশন একটি একক অফার পর্বের জন্য প্লে চালু হতে পারে।

JSON প্রতিনিধিত্ব
{

  // 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.
}
ক্ষেত্র
ইউনিয়ন ক্ষেত্রের price_override । এই পর্যায়ের দাম ওভাররাইড. প্রয়োজন। price_override নিম্নলিখিতগুলির মধ্যে একটি হতে পারে:
otherRegionsPrices

object ( OtherRegionsSubscriptionOfferPhasePrices )

এই অফার পর্বের জন্য ব্যবহারকারী যে নিখুঁত মূল্য প্রদান করে। প্লে লঞ্চ হতে পারে এমন যেকোন নতুন লোকেশনের জন্য মূল্য অনুমোদিত ন্যূনতম মূল্যের চেয়ে কম হওয়া উচিত নয়।

relativeDiscount

number

বেস প্ল্যান মূল্যের ভগ্নাংশ এই অফার পর্বের জন্য ব্যবহারকারী যে ফেজ সময়কালের জন্য অর্থপ্রদান করে তার অনুপাত। উদাহরণস্বরূপ, যদি এই অঞ্চলের জন্য 1 বছরের জন্য বেস প্ল্যান মূল্য $12 হয়, তাহলে 3 মাস মেয়াদী একটি পর্বের জন্য 50% ডিসকাউন্ট $1.50 মূল্যের সাথে মিলবে। ডিসকাউন্টটি অবশ্যই 0 এর চেয়ে বড় এবং 1 এর থেকে কঠোরভাবে ছোট ভগ্নাংশ হিসাবে নির্দিষ্ট করতে হবে। ফলস্বরূপ মূল্যটি নিকটতম বিলযোগ্য ইউনিটে বৃত্তাকার হবে (যেমন USD এর জন্য সেন্ট)। আপেক্ষিক ডিসকাউন্টটি অবৈধ বলে বিবেচিত হবে যদি ডিসকাউন্টের মূল্য শেষ পর্যন্ত প্লে লঞ্চ হতে পারে এমন যেকোন নতুন অবস্থানে অনুমোদিত ন্যূনতম মূল্যের চেয়ে কম হয়।

absoluteDiscounts

object ( OtherRegionsSubscriptionOfferPhasePrices )

এই অফার পর্বের জন্য ব্যবহারকারী যে ফেজ সময়কালের জন্য প্রযোজ্য বেস প্ল্যান মূল্য থেকে বিয়োগ করা অর্থের পরম পরিমাণ। উদাহরণস্বরূপ, যদি এই অঞ্চলের জন্য 1 বছরের জন্য বেস প্ল্যান মূল্য $12 হয়, তাহলে 3 মাস মেয়াদের একটি পর্বের জন্য $1 সম্পূর্ণ ছাড় $2 মূল্যের সাথে মিলবে। ফলস্বরূপ মূল্য প্লে লঞ্চ হতে পারে এমন কোনো নতুন অবস্থানের জন্য অনুমোদিত ন্যূনতম মূল্যের চেয়ে কম নাও হতে পারে।

free

object ( OtherRegionsSubscriptionOfferPhaseFreePriceOverride )

এই অফারটি প্রাপ্ত করার জন্য বিনামূল্যে নির্দিষ্ট করতে সেট করুন।

অন্যান্য অঞ্চলের সাবস্ক্রিপশন অফারের পর্যায়মূল্য

যে কোনো নতুন অবস্থানের জন্য মূল্যের তথ্য প্লে চালু হতে পারে।

JSON প্রতিনিধিত্ব
{
  "usdPrice": {
    object (Money)
  },
  "eurPrice": {
    object (Money)
  }
}
ক্ষেত্র
usdPrice

object ( Money )

প্রয়োজন। প্লে লঞ্চ হতে পারে এমন যেকোনো নতুন অবস্থানের জন্য ব্যবহার করার জন্য USD-এ মূল্য।

eurPrice

object ( Money )

প্রয়োজন। প্লে লঞ্চ হতে পারে এমন যেকোনো নতুন অবস্থানের জন্য ব্যবহার করার জন্য মূল্য EUR-এ।

অন্যান্য অঞ্চল সাবস্ক্রিপশন অফারফেজফ্রী প্রাইস ওভাররাইড

এই ধরনের কোন ক্ষেত্র আছে.

প্লে একটি একক অফার পর্বের জন্য লঞ্চ করতে পারে এমন যেকোনো নতুন অবস্থানের জন্য বিনামূল্যের মূল্য ওভাররাইড কনফিগারেশনের প্রতিনিধিত্ব করে।

সাবস্ক্রিপশন অফার টার্গেটিং

এই অফারটি পাওয়ার জন্য একজন ব্যবহারকারীকে যে নিয়মটি সন্তুষ্ট করতে হবে তা সংজ্ঞায়িত করে।

JSON প্রতিনিধিত্ব
{

  // 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.
}
ক্ষেত্র
ইউনিয়ন ক্ষেত্রের rule । বিকাশকারী-নির্ধারিত অফার যোগ্যতার জন্য খালি ছেড়ে দিন। rule নিম্নলিখিতগুলির মধ্যে একটি হতে পারে:
acquisitionRule

object ( AcquisitionTargetingRule )

নতুন ব্যবহারকারী অধিগ্রহণের জন্য অফার টার্গেটিং নিয়ম।

upgradeRule

object ( UpgradeTargetingRule )

ব্যবহারকারীদের বিদ্যমান প্ল্যান আপগ্রেড করার জন্য অফার টার্গেটিং নিয়ম।

অধিগ্রহণ টার্গেটিং নিয়ম

ফর্মের একটি টার্গেটিং নিয়ম উপস্থাপন করে: ব্যবহারকারীর আগে কখনো {স্কোপ} ছিল না।

JSON প্রতিনিধিত্ব
{
  "scope": {
    object (TargetingRuleScope)
  }
}
ক্ষেত্র
scope

object ( TargetingRuleScope )

প্রয়োজন। সাবস্ক্রিপশনের সুযোগ এই নিয়ম বিবেচনা করে। শুধুমাত্র "এই সাবস্ক্রিপশন" এবং "অ্যাপে যেকোন সাবস্ক্রিপশন" মঞ্জুরি দেয়।

টার্গেটিং রুলস্কোপ

সাবস্ক্রিপশনের সুযোগ সংজ্ঞায়িত করে যা একটি টার্গেটিং নিয়ম অতীত বা বর্তমান এনটাইটেলমেন্টের উপর ভিত্তি করে ব্যবহারকারীদের লক্ষ্য অফারগুলির সাথে মেলে।

JSON প্রতিনিধিত্ব
{

  // 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.
}
ক্ষেত্র

ইউনিয়ন ক্ষেত্রের scope

scope নিম্নলিখিতগুলির মধ্যে একটি হতে পারে:

thisSubscription

object ( TargetingRuleScopeThisSubscription )

বর্তমান টার্গেটিং নিয়মের সুযোগ হল সাবস্ক্রিপশন যেখানে এই অফারটি সংজ্ঞায়িত করা হয়েছে।

anySubscriptionInApp

object ( TargetingRuleScopeAnySubscriptionInApp )

বর্তমান টার্গেটিং নিয়মের সুযোগ হল প্যারেন্ট অ্যাপের যেকোনো সাবস্ক্রিপশন।

specificSubscriptionInApp

string

বর্তমান টার্গেটিং নিয়মের সুযোগ হল নির্দিষ্ট সাবস্ক্রিপশন আইডি সহ সাবস্ক্রিপশন। একই অভিভাবক অ্যাপের মধ্যে একটি সদস্যতা হতে হবে।

TargetingRuleScopeThisSubscription

এই ধরনের কোন ক্ষেত্র আছে.

এই অফারটি সংজ্ঞায়িত করা সাবস্ক্রিপশনের সাথে সঙ্গতিপূর্ণ টার্গেটিং নিয়মের সুযোগের প্রতিনিধিত্ব করে।

TargetingRuleScopeAnySubscriptionInApp

এই ধরনের কোন ক্ষেত্র আছে.

অভিভাবক অ্যাপের যেকোনো সদস্যতার সাথে সম্পর্কিত টার্গেটিং নিয়মের সুযোগ উপস্থাপন করে।

আপগ্রেড টার্গেটিং নিয়ম

ফর্মের একটি টার্গেটিং নিয়ম উপস্থাপন করে: ব্যবহারকারীর বর্তমানে {স্কোপ} আছে [বিলিং পিরিয়ড {billing_period} সহ]।

JSON প্রতিনিধিত্ব
{
  "oncePerUser": boolean,
  "scope": {
    object (TargetingRuleScope)
  },
  "billingPeriodDuration": string
}
ক্ষেত্র
oncePerUser

boolean

প্রতি ব্যবহারকারী শুধুমাত্র একবার এই অফার সীমিত. যদি সত্য হিসাবে সেট করা হয়, কোনো ব্যবহারকারী যদি কখনো এই অফারটিতে সদস্যতা নেন তাহলে তিনি আর কখনো এই অফারটির জন্য যোগ্য হতে পারবেন না।

scope

object ( TargetingRuleScope )

প্রয়োজন। সাবস্ক্রিপশনের সুযোগ এই নিয়ম বিবেচনা করে। শুধুমাত্র "এই সাবস্ক্রিপশন" এবং "অ্যাপে নির্দিষ্ট সদস্যতা" মঞ্জুরি দেয়।

billingPeriodDuration

string

নির্দিষ্ট বিলিং সময়কাল, ISO 8601 ফর্ম্যাটে নির্দিষ্ট করা হয়েছে, যেটি ব্যবহারকারীকে এই নিয়মের জন্য যোগ্য হতে বর্তমানে সদস্যতা নিতে হবে। যদি নির্দিষ্ট করা না থাকে, যে কোনো বিলিং মেয়াদে সদস্যতা নেওয়া ব্যবহারকারীরা মিলে যায়।

RegionalSubscriptionOfferConfig

একটি একক অঞ্চলে সাবস্ক্রিপশন অফারের জন্য কনফিগারেশন।

JSON প্রতিনিধিত্ব
{
  "regionCode": string,
  "newSubscriberAvailability": boolean
}
ক্ষেত্র
regionCode

string

প্রয়োজন। অপরিবর্তনীয়। অঞ্চল কোড এই কনফিগারেশন প্রযোজ্য, যেমন ISO 3166-2 দ্বারা সংজ্ঞায়িত, যেমন "US"।

newSubscriberAvailability

boolean

নির্দিষ্ট অঞ্চলে সাবস্ক্রিপশন অফারটি নতুন গ্রাহকদের জন্য উপলব্ধ কিনা। এই মান মিথ্যা সেট করা থাকলে বিদ্যমান গ্রাহকদের তাদের সদস্যতা বাতিল করা হবে না। যদি নির্দিষ্ট করা না থাকে, তাহলে এটি ডিফল্ট হিসেবে মিথ্যা হবে।

অন্যান্য অঞ্চল সাবস্ক্রিপশনঅফার কনফিগ

যেকোন নতুন লোকেশনের জন্য কনফিগারেশন প্লে একটি সাবস্ক্রিপশন অফারে নির্দিষ্টভাবে চালু হতে পারে।

JSON প্রতিনিধিত্ব
{
  "otherRegionsNewSubscriberAvailability": boolean
}
ক্ষেত্র
otherRegionsNewSubscriberAvailability

boolean

ভবিষ্যতে প্লে শুরু হতে পারে এমন কোনো নতুন লোকেশনে সাবস্ক্রিপশন অফার আছে কিনা। যদি নির্দিষ্ট করা না থাকে, তাহলে এটি ডিফল্ট হিসেবে মিথ্যা হবে।

পদ্ধতি

activate

একটি সাবস্ক্রিপশন অফার সক্রিয় করে।

batchGet

এক বা একাধিক সাবস্ক্রিপশন অফার পড়ে।

batchUpdate

সদস্যতা অফার একটি ব্যাচ আপডেট.

batchUpdateStates

সদস্যতা অফার রাজ্যের একটি ব্যাচ আপডেট করে।

create

একটি নতুন সাবস্ক্রিপশন অফার তৈরি করে।

deactivate

একটি সাবস্ক্রিপশন অফার নিষ্ক্রিয় করে।

delete

একটি সাবস্ক্রিপশন অফার মুছে দেয়।

get

একটি একক অফার পড়ে

list

একটি প্রদত্ত সাবস্ক্রিপশন অধীনে সমস্ত অফার তালিকা.

patch

একটি বিদ্যমান সাবস্ক্রিপশন অফার আপডেট করে।