REST Resource: monetization.subscriptions

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

একটি অ্যাপের জন্য একটি একক সদস্যতা।

JSON প্রতিনিধিত্ব
{
  "packageName": string,
  "productId": string,
  "basePlans": [
    {
      object (BasePlan)
    }
  ],
  "listings": [
    {
      object (SubscriptionListing)
    }
  ],
  "archived": boolean,
  "taxAndComplianceSettings": {
    object (SubscriptionTaxAndComplianceSettings)
  }
}
ক্ষেত্র
packageName

string

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

productId

string

অপরিবর্তনীয়। পণ্যের অনন্য পণ্য আইডি। অভিভাবক অ্যাপের মধ্যে অনন্য। পণ্য আইডি অবশ্যই ছোট হাতের অক্ষর (az), সংখ্যা (0-9), আন্ডারস্কোর (_) এবং বিন্দু (.) দিয়ে গঠিত হতে হবে। এটি অবশ্যই একটি ছোট হাতের অক্ষর বা সংখ্যা দিয়ে শুরু করতে হবে এবং দৈর্ঘ্যে 1 থেকে 40 (অন্তর্ভুক্ত) অক্ষরের মধ্যে হতে হবে৷

basePlans[]

object ( BasePlan )

এই সদস্যতার জন্য ভিত্তি পরিকল্পনা সেট. অন্য কোন অফার প্রযোজ্য না হলে সাবস্ক্রিপশনের মূল্য এবং সময়কালের প্রতিনিধিত্ব করে।

listings[]

object ( SubscriptionListing )

প্রয়োজন। এই সাবস্ক্রিপশনের জন্য স্থানীয় তালিকার apks.list। অভিভাবক অ্যাপের ডিফল্ট ভাষার জন্য অন্তত একটি এন্ট্রি থাকতে হবে।

archived

boolean

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

taxAndComplianceSettings

object ( SubscriptionTaxAndComplianceSettings )

ট্যাক্স এবং আইনি সম্মতি সম্পর্কে বিশদ বিবরণ।

বেসপ্ল্যান

সাবস্ক্রিপশনের জন্য একটি একক বেস প্ল্যান।

JSON প্রতিনিধিত্ব
{
  "basePlanId": string,
  "state": enum (State),
  "regionalConfigs": [
    {
      object (RegionalBasePlanConfig)
    }
  ],
  "offerTags": [
    {
      object (OfferTag)
    }
  ],
  "otherRegionsConfig": {
    object (OtherRegionsBasePlanConfig)
  },

  // Union field base_plan_type can be only one of the following:
  "autoRenewingBasePlanType": {
    object (AutoRenewingBasePlanType)
  },
  "prepaidBasePlanType": {
    object (PrepaidBasePlanType)
  }
  // End of list of possible types for union field base_plan_type.
}
ক্ষেত্র
basePlanId

string

প্রয়োজন। অপরিবর্তনীয়। এই বেস প্ল্যানের অনন্য শনাক্তকারী। সাবস্ক্রিপশনের মধ্যে অনন্য হতে হবে এবং RFC-1034-এর সাথে সামঞ্জস্যপূর্ণ হতে হবে। অর্থাৎ, এই আইডিতে শুধুমাত্র ছোট হাতের অক্ষর (az), সংখ্যা (0-9), এবং হাইফেন (-) থাকতে পারে এবং সর্বাধিক 63টি অক্ষর থাকতে পারে।

state

enum ( State )

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

regionalConfigs[]

object ( RegionalBasePlanConfig )

এই বেস প্ল্যানের জন্য অঞ্চল-নির্দিষ্ট তথ্য।

offerTags[]

object ( OfferTag )

apks.list এই বেস প্ল্যানের জন্য 20টি পর্যন্ত কাস্টম ট্যাগ নির্দিষ্ট করা হয়েছে এবং বিলিং লাইব্রেরির মাধ্যমে অ্যাপে ফিরে এসেছে। এই বেস প্ল্যানের সাবস্ক্রিপশন অফারগুলিও বিলিং লাইব্রেরিতে এই অফার ট্যাগগুলি পাবে৷

otherRegionsConfig

object ( OtherRegionsBasePlanConfig )

যে কোনো নতুন অবস্থানের জন্য মূল্যের তথ্য Play ভবিষ্যতে চালু হতে পারে। যদি বাদ দেওয়া হয়, তাহলে বেসপ্ল্যান স্বয়ংক্রিয়ভাবে উপলব্ধ হবে না যে কোনো নতুন অবস্থান Play ভবিষ্যতে লঞ্চ করতে পারে।

ইউনিয়ন ফিল্ড base_plan_type । এই বেস প্ল্যানের ধরন। ঠিক একটি সেট করা আবশ্যক. base_plan_type নিম্নলিখিতগুলির মধ্যে একটি হতে পারে:
autoRenewingBasePlanType

object ( AutoRenewingBasePlanType )

সেট করুন যখন বেস প্ল্যান স্বয়ংক্রিয়ভাবে একটি নিয়মিত বিরতিতে পুনর্নবীকরণ হয়।

prepaidBasePlanType

object ( PrepaidBasePlanType )

সেট করুন যখন বেস প্ল্যান স্বয়ংক্রিয়ভাবে বিলিং সময়ের শেষে পুনর্নবীকরণ হয় না।

রাষ্ট্র

একটি বেস প্ল্যানের বর্তমান অবস্থা।

এনামস
STATE_UNSPECIFIED অনির্দিষ্ট অবস্থা।
DRAFT বেস প্ল্যানটি বর্তমানে একটি খসড়া অবস্থায় রয়েছে এবং এটি সক্রিয় করা হয়নি। এই সময়ে এটি নিরাপদে মুছে ফেলা যেতে পারে।
ACTIVE বেস প্ল্যানটি সক্রিয় এবং নতুন গ্রাহকদের জন্য উপলব্ধ।
INACTIVE বেস প্ল্যানটি নিষ্ক্রিয় এবং শুধুমাত্র বিদ্যমান গ্রাহকদের জন্য উপলব্ধ।

স্বয়ংক্রিয় পুনর্নবীকরণ বেসপ্ল্যান টাইপ

একটি বেস প্ল্যানের প্রতিনিধিত্ব করে যা স্বয়ংক্রিয়ভাবে এর সদস্যতার মেয়াদ শেষে পুনর্নবীকরণ হয়।

JSON প্রতিনিধিত্ব
{
  "billingPeriodDuration": string,
  "gracePeriodDuration": string,
  "resubscribeState": enum (ResubscribeState),
  "prorationMode": enum (SubscriptionProrationMode),
  "legacyCompatible": boolean,
  "legacyCompatibleSubscriptionOfferId": string
}
ক্ষেত্র
billingPeriodDuration

string

প্রয়োজন। সাবস্ক্রিপশনের সময়কাল, ISO 8601 ফর্ম্যাটে উল্লেখ করা হয়েছে। গ্রহণযোগ্য বিলিং সময়ের তালিকার জন্য, সহায়তা কেন্দ্র দেখুন।

gracePeriodDuration

string

সাবস্ক্রিপশনের গ্রেস পিরিয়ড, ISO 8601 ফর্ম্যাটে উল্লেখ করা হয়েছে। গ্রহণযোগ্য মানগুলি হল P0D (শূন্য দিন), P3D (3 দিন), P7D (7 দিন), P14D (14 দিন), এবং P30D (30 দিন)। নির্দিষ্ট করা না থাকলে, পুনরাবৃত্ত সময়কালের উপর ভিত্তি করে একটি ডিফল্ট মান ব্যবহার করা হবে।

resubscribeState

enum ( ResubscribeState )

ব্যবহারকারীরা Google Play সারফেসগুলিতে এই বেস প্ল্যানে পুনরায় সদস্যতা নিতে সক্ষম হবেন কিনা। নির্দিষ্ট না থাকলে RESUBSCRIBE_STATE_ACTIVE-তে ডিফল্ট।

prorationMode

enum ( SubscriptionProrationMode )

বেস প্ল্যানের জন্য প্রোরেশন মোড নির্ধারণ করে যখন একজন ব্যবহারকারী অন্য বেস প্ল্যান থেকে এই প্ল্যানে স্যুইচ করে তখন কী ঘটবে। অনির্দিষ্ট থাকলে, ডিফল্ট CHARGE_ON_NEXT_BILLING_DATE এ।

legacyCompatible

boolean

পুনর্নবীকরণ বেস প্ল্যান পশ্চাদপদ সামঞ্জস্যপূর্ণ কিনা।

পশ্চাদগামী সামঞ্জস্যপূর্ণ বেস প্ল্যানটি Google Play বিলিং লাইব্রেরি অবচিত পদ্ধতি querySkuDetailsAsync() দ্বারা ফেরত দেওয়া হয়।

একটি প্রদত্ত সাবস্ক্রিপশনের জন্য শুধুমাত্র একটি পুনর্নবীকরণ বেস প্ল্যানকে লিগ্যাসি সামঞ্জস্যপূর্ণ হিসাবে চিহ্নিত করা যেতে পারে।

legacyCompatibleSubscriptionOfferId

string

সাবস্ক্রিপশন অফার আইডি যা লিগ্যাসি সামঞ্জস্যপূর্ণ।

পশ্চাদগামী সামঞ্জস্যপূর্ণ সাবস্ক্রিপশন অফারটি Google Play বিলিং লাইব্রেরি অবচিত পদ্ধতি querySkuDetailsAsync() দ্বারা ফেরত দেওয়া হয়। একটি প্রদত্ত পুনর্নবীকরণ বেস প্ল্যানের জন্য শুধুমাত্র একটি সাবস্ক্রিপশন অফারকে লিগ্যাসি সামঞ্জস্যপূর্ণ হিসাবে চিহ্নিত করা যেতে পারে। লিগ্যাসি সামঞ্জস্যপূর্ণ হিসাবে কোনো সাবস্ক্রিপশন অফার না থাকার জন্য এই ক্ষেত্রটিকে খালি স্ট্রিং হিসাবে সেট করুন৷

পুনঃসাবস্ক্রাইব স্টেট

বেস প্ল্যান রিসাবস্ক্রাইব স্টেট।

এনামস
RESUBSCRIBE_STATE_UNSPECIFIED অনির্দিষ্ট অবস্থা।
RESUBSCRIBE_STATE_ACTIVE পুনরায় সদস্যতা সক্রিয় আছে.
RESUBSCRIBE_STATE_INACTIVE পুনরায় সদস্যতা নিষ্ক্রিয়.

SubscriptionProrationMode

বেস প্ল্যান পুনর্নবীকরণের জন্য ব্যবহৃত প্রেশন মোড।

এনামস
SUBSCRIPTION_PRORATION_MODE_UNSPECIFIED অনির্দিষ্ট মোড।
SUBSCRIPTION_PRORATION_MODE_CHARGE_ON_NEXT_BILLING_DATE ব্যবহারকারীদের তাদের বর্তমান বিলিং মেয়াদ শেষে তাদের নতুন বেস প্ল্যানের জন্য চার্জ করা হবে।
SUBSCRIPTION_PRORATION_MODE_CHARGE_FULL_PRICE_IMMEDIATELY ব্যবহারকারীদের তাদের নতুন বেস প্ল্যানের জন্য অবিলম্বে এবং সম্পূর্ণরূপে চার্জ করা হবে। তাদের বিদ্যমান সাবস্ক্রিপশনের যে কোনো অবশিষ্ট সময় নতুন বিলিং পরিকল্পনার মেয়াদ বাড়ানোর জন্য ব্যবহার করা হবে।

PrepaidBasePlanType

একটি বেস প্ল্যানের প্রতিনিধিত্ব করে যা বেস প্ল্যানের শেষে স্বয়ংক্রিয়ভাবে পুনর্নবীকরণ হয় না এবং ব্যবহারকারীর দ্বারা ম্যানুয়ালি পুনর্নবীকরণ করা আবশ্যক।

JSON প্রতিনিধিত্ব
{
  "billingPeriodDuration": string,
  "timeExtension": enum (TimeExtension)
}
ক্ষেত্র
billingPeriodDuration

string

প্রয়োজন। সাবস্ক্রিপশনের সময়কাল, ISO 8601 ফর্ম্যাটে উল্লেখ করা হয়েছে। গ্রহণযোগ্য বিলিং সময়ের তালিকার জন্য, সহায়তা কেন্দ্র দেখুন।

timeExtension

enum ( TimeExtension )

ব্যবহারকারীরা Google Play সারফেসগুলিতে এই প্রিপেইড বেস প্ল্যানটি প্রসারিত করতে সক্ষম হবেন কিনা। নির্দিষ্ট না থাকলে TIME_EXTENSION_ACTIVE-এ ডিফল্ট।

টাইম এক্সটেনশন

বেস প্ল্যান টাইম এক্সটেনশন।

এনামস
TIME_EXTENSION_UNSPECIFIED অনির্দিষ্ট অবস্থা।
TIME_EXTENSION_ACTIVE সময় এক্সটেনশন সক্রিয় আছে. ব্যবহারকারীদের তাদের প্রিপেইড প্ল্যান টপ-আপ বা প্রসারিত করার অনুমতি দেওয়া হয়।
TIME_EXTENSION_INACTIVE সময় এক্সটেনশন নিষ্ক্রিয়. ব্যবহারকারীরা তাদের প্রিপেইড প্ল্যান টপ-আপ বা প্রসারিত করতে পারবেন না।

RegionalBasePlanConfig

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

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

string

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

newSubscriberAvailability

boolean

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

price

object ( Money )

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

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

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

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

object ( Money )

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

eurPrice

object ( Money )

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

newSubscriberAvailability

boolean

বেস প্ল্যানটি নতুন গ্রাহকদের জন্য যেকোন নতুন অবস্থানে উপলব্ধ কিনা প্লে চালু হতে পারে৷ যদি নির্দিষ্ট না করা হয় তবে এটি ডিফল্ট হিসাবে মিথ্যা হয়ে যাবে৷

সদস্যতা তালিকা

সাবস্ক্রিপশনের ভোক্তা-দৃশ্যমান মেটাডেটা।

JSON প্রতিনিধিত্ব
{
  "languageCode": string,
  "title": string,
  "benefits": [
    string
  ],
  "description": string
}
ক্ষেত্র
languageCode

string

প্রয়োজন। এই তালিকার ভাষা, যেমন BCP-47 দ্বারা সংজ্ঞায়িত করা হয়েছে, যেমন "en-US"৷

title

string

প্রয়োজন। এই তালিকার ভাষায় এই সদস্যতার শিরোনাম। সরল পাঠ্য।

benefits[]

string

প্লে স্টোরের মতো প্ল্যাটফর্মে ব্যবহারকারীকে দেখানো সুবিধার একটি তালিকা এবং এই তালিকার ভাষায় পুনরুদ্ধার প্রবাহ। সরল পাঠ্য। সর্বোচ্চ চারটি সুবিধার অর্ডার করা তালিকা।

description

string

এই তালিকার ভাষায় এই সদস্যতার বর্ণনা। সর্বাধিক দৈর্ঘ্য - 80 অক্ষর। সরল পাঠ্য।

পদ্ধতি

archive

একটি সদস্যতা সংরক্ষণাগার.

create

একটি নতুন সদস্যতা তৈরি করে।

delete

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

get

একটি একক সাবস্ক্রিপশন পড়ে।

list

একটি প্রদত্ত অ্যাপের অধীনে সমস্ত সদস্যতা তালিকাভুক্ত করে৷

patch

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