REST Resource: purchases.subscriptions

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

একটি সাবস্ক্রিপশন ক্রয় সংস্থান একটি ব্যবহারকারীর সদস্যতা ক্রয়ের অবস্থা নির্দেশ করে৷

JSON প্রতিনিধিত্ব 
{
  "kind": string,
  "startTimeMillis": string,
  "expiryTimeMillis": string,
  "autoResumeTimeMillis": string,
  "autoRenewing": boolean,
  "priceCurrencyCode": string,
  "priceAmountMicros": string,
  "introductoryPriceInfo": {
    object (IntroductoryPriceInfo)
  },
  "countryCode": string,
  "developerPayload": string,
  "paymentState": integer,
  "cancelReason": integer,
  "userCancellationTimeMillis": string,
  "cancelSurveyResult": {
    object (SubscriptionCancelSurveyResult)
  },
  "orderId": string,
  "linkedPurchaseToken": string,
  "purchaseType": integer,
  "priceChange": {
    object (SubscriptionPriceChange)
  },
  "profileName": string,
  "emailAddress": string,
  "givenName": string,
  "familyName": string,
  "profileId": string,
  "acknowledgementState": integer,
  "externalAccountId": string,
  "promotionType": integer,
  "promotionCode": string,
  "obfuscatedExternalAccountId": string,
  "obfuscatedExternalProfileId": string
}
ক্ষেত্র
kind

string

এই ধরনের একটি সাবস্ক্রিপশন ক্রয় বস্তুর প্রতিনিধিত্ব করে androidpublisher পরিষেবাতে।

startTimeMillis

string ( int64 format)

যুগের পর থেকে মিলিসেকেন্ডে যে সময়ে সদস্যতা মঞ্জুর করা হয়েছিল।

expiryTimeMillis

string ( int64 format)

যুগের পর থেকে মিলিসেকেন্ডে সাবস্ক্রিপশনের মেয়াদ শেষ হওয়ার সময়।

autoResumeTimeMillis

string ( int64 format)

যে সময়ে সাবস্ক্রিপশন স্বয়ংক্রিয়ভাবে পুনরায় শুরু হবে, যুগ থেকে মিলিসেকেন্ডে। ব্যবহারকারী সাবস্ক্রিপশন পজ করার অনুরোধ করলেই কেবল উপস্থিত।

autoRenewing

boolean

সাবস্ক্রিপশন স্বয়ংক্রিয়ভাবে পুনর্নবীকরণ করা হবে কিনা যখন এটি তার বর্তমান মেয়াদ শেষ হওয়ার সময় পৌঁছেছে।

priceCurrencyCode

string

সাবস্ক্রিপশন মূল্যের জন্য ISO 4217 মুদ্রা কোড। উদাহরণস্বরূপ, যদি দামটি ব্রিটিশ পাউন্ড স্টার্লিং-এ নির্দিষ্ট করা হয়, তাহলে মূল্যমুদ্রার কোড হল "GBP"৷

priceAmountMicros

string ( int64 format)

সাবস্ক্রিপশনের মূল্য, ট্যাক্স এক্সক্লুসিভ দেশগুলির জন্য, মূল্য ট্যাক্স অন্তর্ভুক্ত করে না। ট্যাক্স সহ দেশগুলির জন্য, মূল্য ট্যাক্স অন্তর্ভুক্ত। মূল্য মাইক্রো-ইউনিটগুলিতে প্রকাশ করা হয়, যেখানে 1,000,000 মাইক্রো-ইউনিট মুদ্রার একটি ইউনিটকে প্রতিনিধিত্ব করে। উদাহরণস্বরূপ, সাবস্ক্রিপশনের মূল্য €1.99 হলে, মূল্যAmountMicros হল 1990000।

introductoryPriceInfo

object ( IntroductoryPriceInfo )

সদস্যতার পরিচায়ক মূল্য তথ্য. এটি শুধুমাত্র উপস্থিত থাকে যখন সদস্যতা একটি প্রাথমিক মূল্যের সাথে কেনা হয়।

এই ক্ষেত্রটি নির্দেশ করে না যে সাবস্ক্রিপশনটি বর্তমানে প্রারম্ভিক মূল্যের মেয়াদে রয়েছে।

countryCode

string

সাবস্ক্রিপশন মঞ্জুর করার সময় ব্যবহারকারীর ISO 3166-1 alpha-2 বিলিং দেশ/অঞ্চল কোড।

developerPayload

string

একটি ডেভেলপার-নির্দিষ্ট স্ট্রিং যাতে একটি অর্ডার সম্বন্ধে সম্পূরক তথ্য থাকে।

paymentState

integer

সাবস্ক্রিপশনের অর্থপ্রদানের অবস্থা। সম্ভাব্য মানগুলি হল: 0. পেমেন্ট মুলতুবি 1. পেমেন্ট প্রাপ্ত 2. বিনামূল্যে ট্রায়াল 3. মুলতুবি বিলম্বিত আপগ্রেড/ডাউনগ্রেড

বাতিল, মেয়াদোত্তীর্ণ সাবস্ক্রিপশনের জন্য উপস্থিত নয়।

cancelReason

integer

কেন একটি সদস্যতা বাতিল করা হয়েছে বা স্বয়ংক্রিয়ভাবে পুনর্নবীকরণ হচ্ছে না। সম্ভাব্য মানগুলি হল: 0. ব্যবহারকারী সাবস্ক্রিপশন বাতিল করেছে 1. সাবস্ক্রিপশন সিস্টেম দ্বারা বাতিল করা হয়েছে, উদাহরণস্বরূপ একটি বিলিং সমস্যার কারণে 2. সাবস্ক্রিপশন একটি নতুন সাবস্ক্রিপশন দিয়ে প্রতিস্থাপিত হয়েছে 3. বিকাশকারী দ্বারা সাবস্ক্রিপশন বাতিল করা হয়েছে

userCancellationTimeMillis

string ( int64 format)

যুগের পর থেকে মিলিসেকেন্ডে ব্যবহারকারীর দ্বারা সদস্যতা বাতিল করার সময়। বাতিলের কারণ 0 হলেই উপস্থিত।

cancelSurveyResult

object ( SubscriptionCancelSurveyResult )

সাবস্ক্রিপশন বাতিলকরণ প্রবাহ (বাতিল কারণ সমীক্ষা) সম্পূর্ণ করার সময় ব্যবহারকারীর দ্বারা প্রদত্ত তথ্য।

orderId

string

সাবস্ক্রিপশন কেনার সাথে যুক্ত সাম্প্রতিক পুনরাবৃত্ত অর্ডারের অর্ডার আইডি। পেমেন্ট প্রত্যাখ্যান করার কারণে সাবস্ক্রিপশন বাতিল করা হলে, পেমেন্ট প্রত্যাখ্যান করা অর্ডার থেকে এটি হবে অর্ডার আইডি।

linkedPurchaseToken

string

যদি এই সাবস্ক্রিপশনটি নিম্নলিখিতগুলির মধ্যে একটি হয় তবে প্রারম্ভিক ক্রয়ের ক্রয়ের টোকেন: 0. একটি বাতিল হওয়া কিন্তু অ-ল্যাপস সাবস্ক্রিপশনের পুনরায় সাইনআপ 1. পূর্ববর্তী সাবস্ক্রিপশন থেকে আপগ্রেড/ডাউনগ্রেড করুন

উদাহরণস্বরূপ, ধরুন একজন ব্যবহারকারী মূলত সাইন আপ করেন এবং আপনি ক্রয় টোকেন X পান, তারপর ব্যবহারকারী বাতিল করেন এবং পদত্যাগের প্রবাহের মধ্য দিয়ে যান (তাদের সদস্যতা শেষ হওয়ার আগে) এবং আপনি ক্রয় টোকেন Y পান এবং অবশেষে ব্যবহারকারী তাদের সদস্যতা আপগ্রেড করে এবং আপনি ক্রয় গ্রহণ করেন টোকেন Z। আপনি যদি ক্রয় টোকেন Z দিয়ে এই API কল করেন, তাহলে এই ক্ষেত্রটি Y তে সেট করা হবে। আপনি যদি ক্রয় টোকেন Y দিয়ে এই API কল করেন, তাহলে এই ক্ষেত্রটি X-তে সেট করা হবে। আপনি যদি ক্রয় টোকেন X সহ এই APIকে কল করেন, তাহলে এটি ক্ষেত্র সেট করা হবে না।

purchaseType

integer

সাবস্ক্রিপশন কেনার ধরন। এই ক্ষেত্রটি শুধুমাত্র সেট করা হয় যদি এই ক্রয়টি স্ট্যান্ডার্ড ইন-অ্যাপ বিলিং ফ্লো ব্যবহার করে করা না হয়। সম্ভাব্য মানগুলি হল: 0. পরীক্ষা (যেমন একটি লাইসেন্স টেস্টিং অ্যাকাউন্ট থেকে কেনা) 1. প্রচার (অর্থাৎ একটি প্রচার কোড ব্যবহার করে কেনা)

priceChange

object ( SubscriptionPriceChange )

সর্বশেষ মূল্য পরিবর্তন তথ্য উপলব্ধ. এটি শুধুমাত্র তখনই উপস্থিত থাকে যখন সাবস্ক্রিপশনের জন্য একটি আসন্ন মূল্য পরিবর্তন হয় যা এখনও প্রয়োগ করা হয়নি।

একবার সাবস্ক্রিপশন নতুন মূল্যের সাথে পুনর্নবীকরণ হয়ে গেলে বা সদস্যতা বাতিল হয়ে গেলে, মূল্য পরিবর্তনের কোনো তথ্য ফেরত দেওয়া হবে না।

profileName

string

সদস্যতা কেনার সময় ব্যবহারকারীর প্রোফাইল নাম। শুধুমাত্র 'Subscribe with Google'-এর মাধ্যমে করা কেনাকাটার জন্যই উপস্থিত।

emailAddress

string

সাবস্ক্রিপশন কেনার সময় ব্যবহারকারীর ইমেল ঠিকানা। শুধুমাত্র 'Subscribe with Google'-এর মাধ্যমে করা কেনাকাটার জন্যই উপস্থিত।

givenName

string

সাবস্ক্রিপশন কেনার সময় ব্যবহারকারীর দেওয়া নাম। শুধুমাত্র 'Subscribe with Google'-এর মাধ্যমে করা কেনাকাটার জন্যই উপস্থিত।

familyName

string

সদস্যতা কেনার সময় ব্যবহারকারীর পারিবারিক নাম। শুধুমাত্র 'Subscribe with Google'-এর মাধ্যমে করা কেনাকাটার জন্যই উপস্থিত।

profileId

string

সাবস্ক্রিপশন কেনার সময় ব্যবহারকারীর Google প্রোফাইল আইডি। শুধুমাত্র 'Subscribe with Google'-এর মাধ্যমে করা কেনাকাটার জন্যই উপস্থিত।

acknowledgementState

integer

সাবস্ক্রিপশন পণ্যের স্বীকৃতি অবস্থা। সম্ভাব্য মানগুলি হল: 0. এখনও স্বীকার করতে হবে 1. স্বীকৃত৷

externalAccountId

string

তৃতীয় পক্ষের পরিষেবাতে ব্যবহারকারী অ্যাকাউন্ট শনাক্তকারী। সাবস্ক্রিপশন ক্রয় প্রবাহের অংশ হিসাবে অ্যাকাউন্ট লিঙ্ক করা হলেই কেবল উপস্থিত।

promotionType

integer

এই কেনাকাটায় প্রযোজ্য প্রচারের ধরন। এই ক্ষেত্রটি কেবল তখনই সেট করা হয় যখন সদস্যতা কেনার সময় একটি প্রচার প্রয়োগ করা হয়৷ সম্ভাব্য মানগুলি হল: 0. ওয়ান টাইম কোড 1. ভ্যানিটি কোড৷

promotionCode

string

এই কেনাকাটায় প্রযোজ্য প্রচার কোড। সাবস্ক্রিপশন কেনার সময় ভ্যানিটি কোড প্রচার প্রয়োগ করা হলেই এই ক্ষেত্রটি সেট করা হয়।

obfuscatedExternalAccountId

string

আইডির একটি অস্পষ্ট সংস্করণ যা আপনার অ্যাপে ব্যবহারকারীর অ্যাকাউন্টের সাথে অনন্যভাবে যুক্ত। নিম্নলিখিত ক্রয়ের জন্য উপস্থাপন করুন: * যদি সাবস্ক্রিপশন ক্রয় প্রবাহের অংশ হিসাবে অ্যাকাউন্ট লিঙ্ক করা হয়। * এটি https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedaccountid ব্যবহার করে নির্দিষ্ট করা হয়েছিল যখন কেনাকাটা করা হয়েছিল।

obfuscatedExternalProfileId

string

আইডির একটি অস্পষ্ট সংস্করণ যা আপনার অ্যাপে ব্যবহারকারীর প্রোফাইলের সাথে অনন্যভাবে যুক্ত। কেনার সময় https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedprofileid ব্যবহার করে নির্দিষ্ট করা হলেই কেবল উপস্থিত।

সূচনামূল্য তথ্য

সাবস্ক্রিপশনের জন্য প্রাথমিক মূল্যের তথ্য রয়েছে।

JSON প্রতিনিধিত্ব 
{
  "introductoryPriceCurrencyCode": string,
  "introductoryPriceAmountMicros": string,
  "introductoryPricePeriod": string,
  "introductoryPriceCycles": integer
}
ক্ষেত্র
introductoryPriceCurrencyCode

string

প্রাথমিক সদস্যতার মূল্যের জন্য ISO 4217 মুদ্রা কোড। উদাহরণস্বরূপ, যদি দামটি ব্রিটিশ পাউন্ড স্টার্লিং-এ নির্দিষ্ট করা হয়, তাহলে মূল্যমুদ্রার কোড হল "GBP"৷

introductoryPriceAmountMicros

string ( int64 format)

সাবস্ক্রিপশনের প্রাথমিক মূল্য, ট্যাক্স সহ নয়। কারেন্সি প্রাইস কারেন্সি কোডের মতোই। মূল্য মাইক্রো-ইউনিটগুলিতে প্রকাশ করা হয়, যেখানে 1,000,000 মাইক্রো-ইউনিট মুদ্রার একটি ইউনিটকে প্রতিনিধিত্ব করে। উদাহরণস্বরূপ, সাবস্ক্রিপশনের মূল্য €1.99 হলে, মূল্যAmountMicros হল 1990000।

introductoryPricePeriod

string

প্রাথমিক মূল্যের সময়কাল, ISO 8601 ফর্ম্যাটে নির্দিষ্ট করা হয়েছে। সাধারণ মানগুলি হল (তবে সীমাবদ্ধ নয়) "P1W" (এক সপ্তাহ), "P1M" (এক মাস), "P3M" (তিন মাস), "P6M" (ছয় মাস), এবং "P1Y" (এক বছর)।

introductoryPriceCycles

integer

প্রারম্ভিক মূল্য প্রস্তাব করার জন্য বিলিং সময়ের সংখ্যা।

সদস্যতা বাতিল সার্ভে ফলাফল

সাবস্ক্রিপশন বাতিলকরণ প্রবাহ (বাতিল কারণ সমীক্ষা) সম্পূর্ণ করার সময় ব্যবহারকারীর দ্বারা প্রদত্ত তথ্য।

JSON প্রতিনিধিত্ব 
{
  "cancelSurveyReason": integer,
  "userInputCancelReason": string
}
ক্ষেত্র
cancelSurveyReason

integer

বাতিল করার কারণ ব্যবহারকারী জরিপে বেছে নিয়েছেন। সম্ভাব্য মানগুলি হল: 0. অন্যান্য 1. আমি এই পরিষেবাটি যথেষ্ট ব্যবহার করি না 2. প্রযুক্তিগত সমস্যা 3. খরচ-সম্পর্কিত কারণ 4. আমি একটি ভাল অ্যাপ খুঁজে পেয়েছি

userInputCancelReason

string

ব্যবহারকারীর কাছ থেকে কাস্টমাইজড ইনপুট বাতিলের কারণ। বাতিলের কারণ 0 হলেই উপস্থিত।

সাবস্ক্রিপশন মূল্য পরিবর্তন

একটি সাবস্ক্রিপশনের জন্য মূল্য পরিবর্তনের তথ্য রয়েছে যা অ্যাপে মূল্য পরিবর্তনের জন্য ব্যবহারকারীর যাত্রা নিয়ন্ত্রণ করতে ব্যবহার করা যেতে পারে। এটি ব্যবহারকারীর কাছ থেকে নিশ্চিতকরণ চাওয়ার আকারে হতে পারে বা সফল রূপান্তরের জন্য অভিজ্ঞতাকে উপযোগী করে তুলতে পারে।

JSON প্রতিনিধিত্ব 
{
  "newPrice": {
    object (Price)
  },
  "state": integer
}
ক্ষেত্র
newPrice

object ( Price )

নতুন মূল্যের সাথে সাবস্ক্রিপশন পুনর্নবীকরণ করা হবে যদি মূল্য পরিবর্তন ব্যবহারকারী দ্বারা গৃহীত হয়।

state

integer

দাম পরিবর্তনের বর্তমান অবস্থা। সম্ভাব্য মানগুলি হল: 0. অসামান্য: একটি মুলতুবি মূল্য পরিবর্তনের অবস্থা যা ব্যবহারকারীর সম্মত হওয়ার জন্য অপেক্ষা করছে৷ এই অবস্থায়, আপনি ঐচ্ছিকভাবে ইন-অ্যাপ API ব্যবহার করে ব্যবহারকারীর কাছ থেকে নিশ্চিতকরণ চাইতে পারেন। 1. স্বীকৃত: একটি স্বীকৃত মূল্য পরিবর্তনের জন্য স্টেট যা সাবস্ক্রিপশনটি বাতিল করা না হলে তা পুনর্নবীকরণ করা হবে। সাবস্ক্রিপশন পুনর্নবীকরণের সময় মূল্য পরিবর্তন ভবিষ্যতের তারিখে কার্যকর হয়। নোট করুন যে সাবস্ক্রিপশন পরবর্তী পুনর্নবীকরণ করা হলে পরিবর্তনটি ঘটতে পারে না।

পদ্ধতি

acknowledge

 সাবস্ক্রিপশন ক্রয় স্বীকার করে।

cancel

 একজন ব্যবহারকারীর সদস্যতা ক্রয় বাতিল করে।

defer

 একটি নির্দিষ্ট ভবিষ্যত মেয়াদ শেষ হওয়ার সময় পর্যন্ত ব্যবহারকারীর সাবস্ক্রিপশন ক্রয় স্থগিত করে।

get

 ব্যবহারকারীর সাবস্ক্রিপশন ক্রয় বৈধ কিনা তা পরীক্ষা করে এবং এর মেয়াদ শেষ হওয়ার সময় ফেরত দেয়।

refund

 একজন ব্যবহারকারীর সাবস্ক্রিপশন ক্রয় ফেরত দেয়, কিন্তু সদস্যতা তার মেয়াদ শেষ না হওয়া পর্যন্ত বৈধ থাকে এবং এটি পুনরাবৃত্তি হতে থাকবে।

revoke

 ফেরত দেয় এবং অবিলম্বে একজন ব্যবহারকারীর সদস্যতা ক্রয় প্রত্যাহার করে।