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 )

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

archived
(deprecated)

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 )

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

otherRegionsConfig

object ( OtherRegionsBasePlanConfig )

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

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

object ( AutoRenewingBasePlanType )

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

prepaidBasePlanType

object ( PrepaidBasePlanType )

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

অবস্থা

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

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

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

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

JSON প্রতিনিধিত্ব
{
  "billingPeriodDuration": string,
  "gracePeriodDuration": string,
  "accountHoldDuration": 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 দিন)। নির্দিষ্ট করা না থাকলে, পুনরাবৃত্ত সময়কালের উপর ভিত্তি করে একটি ডিফল্ট মান ব্যবহার করা হবে।

accountHoldDuration

string

ঐচ্ছিক। সাবস্ক্রিপশনের অ্যাকাউন্ট হোল্ডের সময়কাল, ISO 8601 ফর্ম্যাটে উল্লেখ করা হয়েছে। গ্রহণযোগ্য মান অবশ্যই DAYS এবং P0D (শূন্য দিন) থেকে P30D (30 দিন) এর মধ্যে হতে হবে। নির্দিষ্ট করা না থাকলে, ডিফল্ট মান হল 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() দ্বারা ফেরত দেওয়া হয়।

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

লিগ্যাসি সামঞ্জস্যপূর্ণ হিসাবে কোনো সাবস্ক্রিপশন অফার না থাকার জন্য এই ক্ষেত্রটিকে খালি স্ট্রিং হিসাবে সেট করুন৷

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

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

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

SubscriptionProrationMode

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

Enums
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-এ ডিফল্ট।

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

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

Enums
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
(deprecated)

 অপ্রচলিত: সদস্যতা সংরক্ষণাগার সমর্থিত নয়।

batchGet

 এক বা একাধিক সদস্যতা পড়ে।

batchUpdate

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

create

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

delete

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

get

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

list

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

patch

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