REST Resource: purchases.subscriptionsv2

রিসোর্স: সাবস্ক্রিপশনপারচেজভি২

ব্যবহারকারীর সাবস্ক্রিপশন ক্রয়ের অবস্থা নির্দেশ করে।

JSON উপস্থাপনা
{
  "kind": string,
  "regionCode": string,
  "lineItems": [
    {
      object (SubscriptionPurchaseLineItem)
    }
  ],
  "startTime": string,
  "subscriptionState": enum (SubscriptionState),
  "latestOrderId": string,
  "linkedPurchaseToken": string,
  "pausedStateContext": {
    object (PausedStateContext)
  },
  "canceledStateContext": {
    object (CanceledStateContext)
  },
  "testPurchase": {
    object (TestPurchase)
  },
  "acknowledgementState": enum (AcknowledgementState),
  "externalAccountIdentifiers": {
    object (ExternalAccountIdentifiers)
  },
  "subscribeWithGoogleInfo": {
    object (SubscribeWithGoogleInfo)
  },
  "outOfAppPurchaseContext": {
    object (OutOfAppPurchaseContext)
  }
}
ক্ষেত্র
kind

string

এই ধরণেরটি androidpublisher পরিষেবাতে একটি SubscriptionPurchaseV2 অবজেক্টকে প্রতিনিধিত্ব করে।

regionCode

string

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

lineItems[]

object ( SubscriptionPurchaseLineItem )

সাবস্ক্রিপশন ক্রয়ের জন্য আইটেম-স্তরের তথ্য। একই ক্রয়ের সমস্ত আইটেম হয় অটোরিনিউয়িংপ্ল্যান সহ অথবা সমস্ত প্রিপেইডপ্ল্যান সহ হওয়া উচিত।

startTime

string ( Timestamp format)

সাবস্ক্রিপশন মঞ্জুর করার সময়। মুলতুবি থাকা সাবস্ক্রিপশনের জন্য সেট করা হয়নি (সাবস্ক্রিপশন তৈরি করা হয়েছিল কিন্তু সাইন আপের সময় পেমেন্টের অপেক্ষায় ছিল)।

RFC 3339 ব্যবহার করে, যেখানে উৎপন্ন আউটপুট সর্বদা Z-স্বাভাবিক হবে এবং 0, 3, 6 অথবা 9 ভগ্নাংশ সংখ্যা ব্যবহার করবে। "Z" ব্যতীত অন্যান্য অফসেটগুলিও গ্রহণযোগ্য। উদাহরণ: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" অথবা "2014-10-02T15:01:23+05:30"

subscriptionState

enum ( SubscriptionState )

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

latestOrderId
(deprecated)

string

বন্ধ করা হয়েছে: পরিবর্তে lineItems.latest_successful_order_id ব্যবহার করুন। সাবস্ক্রিপশন কেনার সাথে সম্পর্কিত সর্বশেষ অর্ডারের অর্ডার আইডি। অটোরিনিউয়িং সাবস্ক্রিপশনের জন্য, এটি সাইনআপ অর্ডারের অর্ডার আইডি যদি এটি এখনও পুনর্নবীকরণ না করা হয়, অথবা শেষ পুনরাবৃত্ত অর্ডার আইডি (সফল, মুলতুবি, বা প্রত্যাখ্যানিত অর্ডার)। প্রিপেইড সাবস্ক্রিপশনের জন্য, এটি হল জিজ্ঞাসা করা ক্রয় টোকেনের সাথে সম্পর্কিত অর্ডার আইডি।

linkedPurchaseToken

string

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

pausedStateContext

object ( PausedStateContext )

পজ করা সাবস্ক্রিপশনের অতিরিক্ত প্রসঙ্গ। সাবস্ক্রিপশনে বর্তমানে সাবস্ক্রিপশনস্টেট SUBSCRIPTION_STATE_PAUSED থাকলেই কেবল তা উপস্থিত থাকবে।

canceledStateContext

object ( CanceledStateContext )

বাতিল করা সাবস্ক্রিপশন সম্পর্কিত অতিরিক্ত প্রসঙ্গ। সাবস্ক্রিপশনে বর্তমানে সাবস্ক্রিপশনের অবস্থা SUBSCRIPTION_STATE_CANCELED অথবা SUBSCRIPTION_STATE_EXPIRED থাকলেই কেবল তা উপস্থাপন করা হবে।

testPurchase

object ( TestPurchase )

এই সাবস্ক্রিপশন ক্রয়টি যদি পরীক্ষামূলক ক্রয় হয় তবেই কেবল এটি উপস্থাপন করুন।

acknowledgementState

enum ( AcknowledgementState )

সাবস্ক্রিপশনের স্বীকৃতির অবস্থা।

externalAccountIdentifiers

object ( ExternalAccountIdentifiers )

তৃতীয় পক্ষের পরিষেবাতে ব্যবহারকারীর অ্যাকাউন্ট শনাক্তকারী।

subscribeWithGoogleInfo

object ( SubscribeWithGoogleInfo )

'Subscribe with Google' ব্যবহার করে করা কেনাকাটার সাথে সম্পর্কিত ব্যবহারকারীর প্রোফাইল।

outOfAppPurchaseContext

object ( OutOfAppPurchaseContext )

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

সাবস্ক্রিপশনস্টেট

একটি সাবস্ক্রিপশনের সম্ভাব্য অবস্থা, উদাহরণস্বরূপ, এটি সক্রিয় বা বাতিল কিনা। সাবস্ক্রিপশন ক্রয়ের মধ্যে থাকা আইটেমগুলি হয় স্বয়ংক্রিয় পুনর্নবীকরণ পরিকল্পনা বা প্রিপেইড পরিকল্পনা হতে পারে।

এনামস
SUBSCRIPTION_STATE_UNSPECIFIED অনির্দিষ্ট সাবস্ক্রিপশন অবস্থা।
SUBSCRIPTION_STATE_PENDING সাবস্ক্রিপশন তৈরি করা হয়েছে কিন্তু সাইন আপের সময় পেমেন্টের অপেক্ষায় রয়েছে। এই অবস্থায়, সমস্ত আইটেম পেমেন্টের অপেক্ষায় রয়েছে।
SUBSCRIPTION_STATE_ACTIVE সাবস্ক্রিপশন সক্রিয় আছে। - (১) যদি সাবস্ক্রিপশনটি একটি স্বয়ংক্রিয় পুনর্নবীকরণ পরিকল্পনা হয়, তাহলে কমপক্ষে একটি আইটেম স্বয়ংক্রিয় পুনর্নবীকরণ সক্ষম এবং মেয়াদোত্তীর্ণ নয়। - (২) যদি সাবস্ক্রিপশনটি একটি প্রিপেইড পরিকল্পনা হয়, তাহলে কমপক্ষে একটি আইটেমের মেয়াদোত্তীর্ণ নয়।
SUBSCRIPTION_STATE_PAUSED সাবস্ক্রিপশন পজ করা আছে। সাবস্ক্রিপশনটি স্বয়ংক্রিয়ভাবে পুনর্নবীকরণের পরিকল্পনা থাকলেই কেবল এই অবস্থাটি উপলব্ধ থাকে। এই অবস্থায়, সমস্ত আইটেম পজ করা অবস্থায় থাকে।
SUBSCRIPTION_STATE_IN_GRACE_PERIOD সাবস্ক্রিপশন গ্রেস পিরিয়ডে আছে। সাবস্ক্রিপশনটি স্বয়ংক্রিয়ভাবে পুনর্নবীকরণের পরিকল্পনা থাকলেই কেবল এই অবস্থাটি উপলব্ধ। এই অবস্থায়, সমস্ত আইটেম গ্রেস পিরিয়ডে আছে।
SUBSCRIPTION_STATE_ON_HOLD সাবস্ক্রিপশন হোল্ডে আছে (স্থগিত)। সাবস্ক্রিপশনটি স্বয়ংক্রিয় পুনর্নবীকরণ পরিকল্পনার ক্ষেত্রে কেবল তখনই এই অবস্থা উপলব্ধ। এই অবস্থায়, সমস্ত আইটেম হোল্ডে আছে।
SUBSCRIPTION_STATE_CANCELED সাবস্ক্রিপশন বাতিল করা হয়েছে কিন্তু এখনও মেয়াদোত্তীর্ণ হয়নি। সাবস্ক্রিপশনটি স্বয়ংক্রিয় পুনর্নবীকরণ পরিকল্পনার ক্ষেত্রেই কেবল এই অবস্থা উপলব্ধ। সমস্ত আইটেমের autoRenewEnabled মিথ্যাতে সেট করা আছে।
SUBSCRIPTION_STATE_EXPIRED সাবস্ক্রিপশনের মেয়াদ শেষ হয়ে গেছে। সমস্ত আইটেমের অতীতে মেয়াদ শেষ হওয়ার সময় রয়েছে।
SUBSCRIPTION_STATE_PENDING_PURCHASE_CANCELED সাবস্ক্রিপশনের জন্য মুলতুবি থাকা লেনদেন বাতিল করা হয়েছে। যদি এই মুলতুবি থাকা ক্রয়টি কোনও বিদ্যমান সাবস্ক্রিপশনের জন্য হয়ে থাকে, তাহলে সেই সাবস্ক্রিপশনের বর্তমান অবস্থা জানতে linkedPurchaseToken ব্যবহার করুন।

PausedStateContext

সাবস্ক্রিপশনের নির্দিষ্ট তথ্য যা পজ করা অবস্থায় আছে।

JSON উপস্থাপনা
{
  "autoResumeTime": string
}
ক্ষেত্র
autoResumeTime

string ( Timestamp format)

যে সময়ে সাবস্ক্রিপশন স্বয়ংক্রিয়ভাবে পুনরায় চালু হবে।

RFC 3339 ব্যবহার করে, যেখানে উৎপন্ন আউটপুট সর্বদা Z-স্বাভাবিক হবে এবং 0, 3, 6 অথবা 9 ভগ্নাংশ সংখ্যা ব্যবহার করবে। "Z" ব্যতীত অন্যান্য অফসেটগুলিও গ্রহণযোগ্য। উদাহরণ: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" অথবা "2014-10-02T15:01:23+05:30"

বাতিল করা হয়েছেস্টেটকনটেক্সট

SUBSCRIPTION_STATE_CANCELED অথবা SUBSCRIPTION_STATE_EXPIRED অবস্থায় থাকা সাবস্ক্রিপশন সম্পর্কিত নির্দিষ্ট তথ্য।

JSON উপস্থাপনা
{

  // Union field cancellation_reason can be only one of the following:
  "userInitiatedCancellation": {
    object (UserInitiatedCancellation)
  },
  "systemInitiatedCancellation": {
    object (SystemInitiatedCancellation)
  },
  "developerInitiatedCancellation": {
    object (DeveloperInitiatedCancellation)
  },
  "replacementCancellation": {
    object (ReplacementCancellation)
  }
  // End of list of possible types for union field cancellation_reason.
}
ক্ষেত্র
Union ফিল্ড cancellation_reason । সাবস্ক্রিপশন বাতিল করার কারণ। cancellation_reason নিম্নলিখিতগুলির মধ্যে কেবল একটি হতে পারে:
userInitiatedCancellation

object ( UserInitiatedCancellation )

ব্যবহারকারী সাবস্ক্রিপশন বাতিল করেছেন।

systemInitiatedCancellation

object ( SystemInitiatedCancellation )

সিস্টেমটি সাবস্ক্রিপশন বাতিল করেছে, উদাহরণস্বরূপ, বিলিং সমস্যার কারণে।

developerInitiatedCancellation

object ( DeveloperInitiatedCancellation )

ডেভেলপার সাবস্ক্রিপশন বাতিল করেছেন।

replacementCancellation

object ( ReplacementCancellation )

সাবস্ক্রিপশনের পরিবর্তে একটি নতুন সাবস্ক্রিপশন নেওয়া হয়েছে।

ব্যবহারকারীর সূচনা বাতিলকরণ

ব্যবহারকারীদের দ্বারা শুরু করা বাতিলকরণ সম্পর্কিত নির্দিষ্ট তথ্য।

JSON উপস্থাপনা
{
  "cancelSurveyResult": {
    object (CancelSurveyResult)
  },
  "cancelTime": string
}
ক্ষেত্র
cancelSurveyResult

object ( CancelSurveyResult )

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

cancelTime

string ( Timestamp format)

ব্যবহারকারী যে সময়ে সাবস্ক্রিপশন বাতিল করেছেন। এই সময়ের পরেও ব্যবহারকারীর সাবস্ক্রিপশনে অ্যাক্সেস থাকতে পারে। ব্যবহারকারীর এখনও অ্যাক্সেস আছে কিনা তা নির্ধারণ করতে lineItems.expiry_time ব্যবহার করুন।

RFC 3339 ব্যবহার করে, যেখানে উৎপন্ন আউটপুট সর্বদা Z-স্বাভাবিক হবে এবং 0, 3, 6 অথবা 9 ভগ্নাংশ সংখ্যা ব্যবহার করবে। "Z" ব্যতীত অন্যান্য অফসেটগুলিও গ্রহণযোগ্য। উদাহরণ: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" অথবা "2014-10-02T15:01:23+05:30"

জরিপের ফলাফল বাতিল করুন

ব্যবহারকারী যখন সাবস্ক্রিপশন বাতিল করেছিলেন তখন বাতিলকরণ সমীক্ষার ফলাফল।

JSON উপস্থাপনা
{
  "reason": enum (CancelSurveyReason),
  "reasonUserInput": string
}
ক্ষেত্র
reason

enum ( CancelSurveyReason )

বাতিল জরিপে ব্যবহারকারী যে কারণটি বেছে নিয়েছেন।

reasonUserInput

string

শুধুমাত্র CANCEL_SURVEY_REASON_OTHERS এর জন্য সেট করা হয়েছে। এটি জরিপে ব্যবহারকারীর ফ্রিফর্ম প্রতিক্রিয়া।

বাতিল করুনজরিপকারণ

বাতিল জরিপে ব্যবহারকারী যে কারণটি বেছে নিয়েছেন।

এনামস
CANCEL_SURVEY_REASON_UNSPECIFIED জরিপ বাতিলের অনির্দিষ্ট কারণ।
CANCEL_SURVEY_REASON_NOT_ENOUGH_USAGE সাবস্ক্রিপশনের পর্যাপ্ত ব্যবহার নেই।
CANCEL_SURVEY_REASON_TECHNICAL_ISSUES অ্যাপটি ব্যবহার করার সময় প্রযুক্তিগত সমস্যা।
CANCEL_SURVEY_REASON_FOUND_BETTER_APP ব্যবহারকারী আরও ভালো অ্যাপ খুঁজে পেয়েছেন।
CANCEL_SURVEY_REASON_OTHERS অন্যান্য কারণ।

সিস্টেম ইনিশিয়েটেড ক্যান্সেলেশন

এই ধরণের কোনও ক্ষেত্র নেই।

গুগল সিস্টেম দ্বারা শুরু করা বাতিলকরণ সম্পর্কিত নির্দিষ্ট তথ্য।

ডেভেলপার শুরু করেছেনবাতিলকরণ

এই ধরণের কোনও ক্ষেত্র নেই।

ডেভেলপারদের দ্বারা শুরু করা বাতিলকরণ সম্পর্কিত নির্দিষ্ট তথ্য।

প্রতিস্থাপনবাতিলকরণ

এই ধরণের কোনও ক্ষেত্র নেই।

সাবস্ক্রিপশন প্রতিস্থাপনের কারণে বাতিলকরণ সম্পর্কিত নির্দিষ্ট তথ্য।

টেস্টপারচেজ

এই ধরণের কোনও ক্ষেত্র নেই।

এই সাবস্ক্রিপশন ক্রয়টি পরীক্ষামূলক ক্রয় কিনা।

স্বীকৃতি রাজ্য

সম্ভাব্য স্বীকৃতিতে সাবস্ক্রিপশনের কথা বলা আছে।

এনামস
ACKNOWLEDGEMENT_STATE_UNSPECIFIED অনির্দিষ্ট স্বীকৃতির অবস্থা।
ACKNOWLEDGEMENT_STATE_PENDING সাবস্ক্রিপশনটি এখনও স্বীকৃত হয়নি।
ACKNOWLEDGEMENT_STATE_ACKNOWLEDGED সাবস্ক্রিপশনটি স্বীকৃত।

বহিরাগত অ্যাকাউন্ট শনাক্তকারী

তৃতীয় পক্ষের পরিষেবাতে ব্যবহারকারীর অ্যাকাউন্ট শনাক্তকারী।

JSON উপস্থাপনা
{
  "externalAccountId": string,
  "obfuscatedExternalAccountId": string,
  "obfuscatedExternalProfileId": string
}
ক্ষেত্র
externalAccountId

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 ব্যবহার করে নির্দিষ্ট করা থাকলেই এটি উপস্থিত হবে।

গুগল ইনফোর সাথে সাবস্ক্রাইব করুন

'Subscribe with Google' ব্যবহার করে করা কেনাকাটার সাথে সম্পর্কিত তথ্য।

JSON উপস্থাপনা
{
  "profileId": string,
  "profileName": string,
  "emailAddress": string,
  "givenName": string,
  "familyName": string
}
ক্ষেত্র
profileId

string

সাবস্ক্রিপশন কেনার সময় ব্যবহারকারীর Google প্রোফাইল আইডি।

profileName

string

সাবস্ক্রিপশন কেনার সময় ব্যবহারকারীর প্রোফাইল নাম।

emailAddress

string

সাবস্ক্রিপশন কেনার সময় ব্যবহারকারীর ইমেল ঠিকানা।

givenName

string

সাবস্ক্রিপশন কেনার সময় ব্যবহারকারীর প্রদত্ত নাম।

familyName

string

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

সাবস্ক্রিপশনপারচেজলাইনআইটেম

সাবস্ক্রিপশন ক্রয়ের জন্য আইটেম-স্তরের তথ্য।

JSON উপস্থাপনা
{
  "productId": string,
  "expiryTime": string,
  "latestSuccessfulOrderId": string,

  // Union field plan_type can be only one of the following:
  "autoRenewingPlan": {
    object (AutoRenewingPlan)
  },
  "prepaidPlan": {
    object (PrepaidPlan)
  }
  // End of list of possible types for union field plan_type.
  "offerDetails": {
    object (OfferDetails)
  },

  // Union field deferred_item_change can be only one of the following:
  "deferredItemReplacement": {
    object (DeferredItemReplacement)
  },
  "deferredItemRemoval": {
    object (DeferredItemRemoval)
  }
  // End of list of possible types for union field deferred_item_change.
  "signupPromotion": {
    object (SignupPromotion)
  },
  "itemReplacement": {
    object (ItemReplacement)
  }
}
ক্ষেত্র
productId

string

ক্রয়কৃত পণ্য আইডি (উদাহরণস্বরূপ, 'monthly001')।

expiryTime

string ( Timestamp format)

যে সময়ে সাবস্ক্রিপশনের মেয়াদ শেষ হয়েছে অথবা মেয়াদ শেষ হবে যদি না অ্যাক্সেস বর্ধিত করা হয় (যেমন নবায়ন)।

RFC 3339 ব্যবহার করে, যেখানে উৎপন্ন আউটপুট সর্বদা Z-স্বাভাবিক হবে এবং 0, 3, 6 অথবা 9 ভগ্নাংশ সংখ্যা ব্যবহার করবে। "Z" ব্যতীত অন্যান্য অফসেটগুলিও গ্রহণযোগ্য। উদাহরণ: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" অথবা "2014-10-02T15:01:23+05:30"

latestSuccessfulOrderId

string

এই আইটেমের সাথে সম্পর্কিত সর্বশেষ সফল অর্ডারের অর্ডার আইডি। যদি আইটেমটি এখনও ব্যবহারকারীর মালিকানাধীন না হয় (যেমন আইটেমটি স্থগিত করা হচ্ছে) তাহলে এটি উপস্থিত থাকবে না।

Union ফিল্ড plan_type । সাবস্ক্রিপশন প্ল্যানের ধরণ । plan_type নিম্নলিখিতগুলির মধ্যে কেবল একটি হতে পারে:
autoRenewingPlan

object ( AutoRenewingPlan )

আইটেমটি স্বয়ংক্রিয়ভাবে পুনর্নবীকরণ হচ্ছে।

prepaidPlan

object ( PrepaidPlan )

জিনিসটি প্রিপেইড।

offerDetails

object ( OfferDetails )

এই আইটেমের অফারের বিবরণ।

Union ক্ষেত্র deferred_item_change । যখন কোনও আইটেমে বিলম্বিত পরিবর্তন থাকে তখন ক্ষেত্রটি উপস্থিত থাকে। এটি হয় অপসারণ করা যেতে পারে অথবা প্রতিস্থাপন করা যেতে পারে। deferred_item_change নিম্নলিখিতগুলির মধ্যে কেবল একটি হতে পারে:
deferredItemReplacement

object ( DeferredItemReplacement )

বিলম্বিত আইটেম প্রতিস্থাপনের তথ্য।

deferredItemRemoval

object ( DeferredItemRemoval )

বিলম্বিত আইটেম অপসারণের তথ্য।

signupPromotion

object ( SignupPromotion )

এই আইটেম সম্পর্কে প্রচারের বিবরণ। সাইন আপের সময় কোনও প্রচার প্রয়োগ করা হয়েছে কিনা তা কেবল সেট করুন।

itemReplacement

object ( ItemReplacement )

প্রতিস্থাপন করা আইটেমের বিবরণ। এই ক্ষেত্রটি কেবল তখনই পূরণ করা হবে যদি এই আইটেমটি পূর্ববর্তী সাবস্ক্রিপশনে অন্য কোনও আইটেম প্রতিস্থাপন করে এবং ক্রয়ের সময় থেকে কেবল 60 দিনের জন্য উপলব্ধ থাকে।

অটোরিনিউইংপ্ল্যান

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

JSON উপস্থাপনা
{
  "autoRenewEnabled": boolean,
  "recurringPrice": {
    object (Money)
  },
  "priceChangeDetails": {
    object (SubscriptionItemPriceChangeDetails)
  },
  "installmentDetails": {
    object (InstallmentPlan)
  },
  "priceStepUpConsentDetails": {
    object (PriceStepUpConsentDetails)
  }
}
ক্ষেত্র
autoRenewEnabled

boolean

যদি সাবস্ক্রিপশনটি বর্তমানে স্বয়ংক্রিয় পুনর্নবীকরণে সেট করা থাকে, যেমন ব্যবহারকারী সাবস্ক্রিপশন বাতিল করেননি

recurringPrice

object ( Money )

স্বয়ংক্রিয় পুনর্নবীকরণ পরিকল্পনার বর্তমান পুনরাবৃত্ত মূল্য। মনে রাখবেন যে মূল্য ছাড় বিবেচনা করে না এবং কর-এক্সক্লুসিভ মূল্যের জন্য কর অন্তর্ভুক্ত করে না, লেনদেনের বিশদ প্রয়োজন হলে অনুগ্রহ করে orders.get API এ কল করুন।

priceChangeDetails

object ( SubscriptionItemPriceChangeDetails )

সাবস্ক্রিপশন সাইন আপের পর থেকে আইটেমের শেষ মূল্য পরিবর্তনের তথ্য।

installmentDetails

object ( InstallmentPlan )

অটো রিনিউয়িং প্ল্যানের জন্য কিস্তি পরিকল্পনার প্রতিশ্রুতি এবং রাজ্য সম্পর্কিত তথ্য।

সাবস্ক্রিপশনআইটেমমূল্যপরিবর্তনবিস্তারিত

সাবস্ক্রিপশন আইটেমের মূল্য পরিবর্তন সম্পর্কিত তথ্য।

JSON উপস্থাপনা
{
  "newPrice": {
    object (Money)
  },
  "priceChangeMode": enum (PriceChangeMode),
  "priceChangeState": enum (PriceChangeState),
  "expectedNewPriceChargeTime": string
}
ক্ষেত্র
newPrice

object ( Money )

সাবস্ক্রিপশন আইটেমের জন্য নতুন পুনরাবৃত্ত মূল্য।

priceChangeMode

enum ( PriceChangeMode )

মূল্য পরিবর্তন মোড সাবস্ক্রিপশন আইটেমের মূল্য কীভাবে পরিবর্তিত হচ্ছে তা নির্দিষ্ট করে।

priceChangeState

enum ( PriceChangeState )

মূল্য পরিবর্তন বর্তমানে চলছে তা বলুন।

expectedNewPriceChargeTime

string ( Timestamp format)

ব্যবহারকারীর জন্য মূল্য পরিবর্তন কার্যকর হওয়ার সময় পুনর্নবীকরণ করা হবে। এটি পরিবর্তন সাপেক্ষে (ভবিষ্যতের সময় পর্যন্ত) কারণ পুনর্নবীকরণের সময় বিরতির মতো পরিবর্তিত হয়। এই ক্ষেত্রটি কেবল তখনই পূরণ করা হবে যদি মূল্য পরিবর্তন কার্যকর না হয়।

RFC 3339 ব্যবহার করে, যেখানে উৎপন্ন আউটপুট সর্বদা Z-স্বাভাবিক হবে এবং 0, 3, 6 অথবা 9 ভগ্নাংশ সংখ্যা ব্যবহার করবে। "Z" ব্যতীত অন্যান্য অফসেটগুলিও গ্রহণযোগ্য। উদাহরণ: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" অথবা "2014-10-02T15:01:23+05:30"

মূল্য পরিবর্তন মোড

মূল্য পরিবর্তনের ধরণ।

এনামস
PRICE_CHANGE_MODE_UNSPECIFIED মূল্য পরিবর্তন মোড নির্দিষ্ট করা হয়নি। এই মানটি কখনই সেট করা উচিত নয়।
PRICE_DECREASE যদি সাবস্ক্রিপশনের মূল্য কমতে থাকে।
PRICE_INCREASE যদি সাবস্ক্রিপশনের মূল্য বৃদ্ধি পায় এবং ব্যবহারকারীকে তা গ্রহণ করতে হয়।
OPT_OUT_PRICE_INCREASE যদি অপ্ট আউট মোডের সাথে সাবস্ক্রিপশনের মূল্য বৃদ্ধি পায়।

মূল্য পরিবর্তন রাজ্য

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

এনামস
PRICE_CHANGE_STATE_UNSPECIFIED মূল্য পরিবর্তনের অবস্থা নির্দিষ্ট করা হয়নি। এই মানটি ব্যবহার করা উচিত নয়।
OUTSTANDING দাম পরিবর্তনের জন্য ব্যবহারকারীর সম্মতির জন্য অপেক্ষা করা হচ্ছে।
CONFIRMED ব্যবহারকারীর জন্য মূল্য পরিবর্তন নিশ্চিত করা হয়েছে।
APPLIED মূল্য পরিবর্তন প্রযোজ্য হয়েছে, অর্থাৎ ব্যবহারকারীকে নতুন মূল্য চার্জ করা শুরু হয়েছে।
CANCELED দাম পরিবর্তন বাতিল করা হয়েছে।

কিস্তি পরিকল্পনা

কিস্তি পরিকল্পনার তথ্য।

JSON উপস্থাপনা
{
  "initialCommittedPaymentsCount": integer,
  "subsequentCommittedPaymentsCount": integer,
  "remainingCommittedPaymentsCount": integer,
  "pendingCancellation": {
    object (PendingCancellation)
  }
}
ক্ষেত্র
initialCommittedPaymentsCount

integer

ব্যবহারকারী প্রাথমিকভাবে কতগুলি পেমেন্টের জন্য প্রতিশ্রুতিবদ্ধ।

subsequentCommittedPaymentsCount

integer

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

remainingCommittedPaymentsCount

integer

এই পুনর্নবীকরণ চক্রে মোট কতগুলি প্রতিশ্রুতিবদ্ধ অর্থ প্রদান বাকি আছে।

pendingCancellation

object ( PendingCancellation )

যদি থাকে, তাহলে এই কিস্তি পরিকল্পনাটি বাতিলের জন্য অপেক্ষা করছে। ব্যবহারকারীর সমস্ত প্রতিশ্রুতিবদ্ধ অর্থপ্রদান শেষ করার পরেই বাতিলকরণ করা হবে।

মুলতুবি বাতিলকরণ

এই ধরণের কোনও ক্ষেত্র নেই।

এটি ভার্চুয়াল কিস্তি পরিকল্পনায় কোনও বাতিলকরণ মুলতুবি আছে কিনা তার একটি সূচক। ব্যবহারকারী সমস্ত প্রতিশ্রুতিবদ্ধ অর্থপ্রদান শেষ করার পরেই বাতিলকরণটি ঘটবে।

মূল্যStepUpConsentবিস্তারিত

ব্যবহারকারীর সম্মতি প্রয়োজন এমন দাম বৃদ্ধির সাথে সম্পর্কিত তথ্য।

JSON উপস্থাপনা
{
  "state": enum (ConsentState),
  "consentDeadlineTime": string,
  "newPrice": {
    object (Money)
  }
}
ক্ষেত্র
state

enum ( ConsentState )

শুধুমাত্র আউটপুট। দাম বৃদ্ধির সম্মতির অবস্থা।

consentDeadlineTime

string ( Timestamp format)

ব্যবহারকারীকে যে সময়সীমার মধ্যে সম্মতি প্রদান করতে হবে। এই সময়ের মধ্যে সম্মতি প্রদান না করলে, সাবস্ক্রিপশন বাতিল করা হবে।

RFC 3339 ব্যবহার করে, যেখানে উৎপন্ন আউটপুট সর্বদা Z-স্বাভাবিক হবে এবং 0, 3, 6 অথবা 9 ভগ্নাংশ সংখ্যা ব্যবহার করবে। "Z" ব্যতীত অন্যান্য অফসেটগুলিও গ্রহণযোগ্য। উদাহরণ: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" অথবা "2014-10-02T15:01:23+05:30"

newPrice

object ( Money )

নতুন দাম যার জন্য ব্যবহারকারীর সম্মতি প্রয়োজন।

সম্মতি রাজ্য

দাম বৃদ্ধির সম্মতির অবস্থা।

এনামস
CONSENT_STATE_UNSPECIFIED অনির্দিষ্ট সম্মতির অবস্থা।
PENDING ব্যবহারকারী এখনও সম্মতি দেননি।
CONFIRMED ব্যবহারকারী সম্মতি দিয়েছেন, এবং নতুন দাম কার্যকর হওয়ার অপেক্ষায় রয়েছে।
COMPLETED ব্যবহারকারী সম্মতি দিয়েছেন এবং নতুন দাম কার্যকর হয়েছে।

প্রিপেইড প্ল্যান

প্রিপেইড প্ল্যানের সাথে সম্পর্কিত তথ্য।

JSON উপস্থাপনা
{
  "allowExtendAfterTime": string
}
ক্ষেত্র
allowExtendAfterTime

string ( Timestamp format)

যদি উপস্থিত থাকে, তাহলে এই সময়ের পরে প্রিপেইড প্ল্যানের জন্য টপ-আপ কেনাকাটা অনুমোদিত হবে। মেয়াদোত্তীর্ণ প্রিপেইড প্ল্যানের জন্য উপস্থিত থাকবে না।

RFC 3339 ব্যবহার করে, যেখানে উৎপন্ন আউটপুট সর্বদা Z-স্বাভাবিক হবে এবং 0, 3, 6 অথবা 9 ভগ্নাংশ সংখ্যা ব্যবহার করবে। "Z" ব্যতীত অন্যান্য অফসেটগুলিও গ্রহণযোগ্য। উদাহরণ: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" অথবা "2014-10-02T15:01:23+05:30"

অফারের বিবরণ

ক্রয় লাইন আইটেম সম্পর্কিত বিস্তারিত তথ্য প্রদান করুন।

JSON উপস্থাপনা
{
  "offerTags": [
    string
  ],
  "basePlanId": string,
  "offerId": string
}
ক্ষেত্র
offerTags[]

string

অফারের সাথে সম্পর্কিত সর্বশেষ অফার ট্যাগ। এতে বেস প্ল্যান থেকে উত্তরাধিকারসূত্রে প্রাপ্ত ট্যাগগুলি অন্তর্ভুক্ত রয়েছে।

basePlanId

string

বেস প্ল্যান আইডি। সমস্ত বেস প্ল্যান এবং অফারের জন্য উপস্থাপন করুন।

offerId

string

অফার আইডি। শুধুমাত্র ছাড়ের অফারগুলির জন্য উপলব্ধ।

বিলম্বিত আইটেম প্রতিস্থাপন

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

JSON উপস্থাপনা
{
  "productId": string
}
ক্ষেত্র
productId

string

productId বিদ্যমান productId কে প্রতিস্থাপন করবে।

বিলম্বিত আইটেম অপসারণ

এই ধরণের কোনও ক্ষেত্র নেই।

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

সাইনআপপ্রচার

এই আইটেমটি কেনার সময় প্রমোশনটি প্রযোজ্য হয়েছিল।

JSON উপস্থাপনা
{

  // Union field promotion_type can be only one of the following:
  "oneTimeCode": {
    object (OneTimeCode)
  },
  "vanityCode": {
    object (VanityCode)
  }
  // End of list of possible types for union field promotion_type.
}
ক্ষেত্র
ইউনিয়ন ফিল্ড promotion_type । আইটেমটিতে প্রয়োগ করা প্রচারের ধরণ। promotion_type নিম্নলিখিতগুলির মধ্যে কেবল একটি হতে পারে:
oneTimeCode

object ( OneTimeCode )

একটি এককালীন কোড প্রয়োগ করা হয়েছে।

vanityCode

object ( VanityCode )

একটি ভ্যানিটি কোড প্রয়োগ করা হয়েছে।

ওয়ানটাইমকোড

এই ধরণের কোনও ক্ষেত্র নেই।

একটি একক ব্যবহারের প্রচার কোড।

ভ্যানিটিকোড

একটি বহুমুখী, পূর্বনির্ধারিত প্রচার কোড।

JSON উপস্থাপনা
{
  "promotionCode": string
}
ক্ষেত্র
promotionCode

string

প্রচার কোড।

আইটেম প্রতিস্থাপন

প্রতিস্থাপন করা হচ্ছে এমন একটি সাবস্ক্রিপশন লাইন আইটেম সম্পর্কে বিশদ বিবরণ।

JSON উপস্থাপনা
{
  "productId": string,
  "replacementMode": enum (ReplacementMode),
  "basePlanId": string,
  "offerId": string
}
ক্ষেত্র
productId

string

যে সাবস্ক্রিপশন লাইন আইটেমটি প্রতিস্থাপন করা হচ্ছে তার পণ্য আইডি।

replacementMode

enum ( ReplacementMode )

ক্রয়ের সময় প্রয়োগ করা প্রতিস্থাপন মোড।

basePlanId

string

যে সাবস্ক্রিপশন লাইন আইটেমটি প্রতিস্থাপন করা হচ্ছে তার বেস প্ল্যান আইডি।

offerId

string

প্রযোজ্য হলে, প্রতিস্থাপন করা সাবস্ক্রিপশন লাইন আইটেমের অফার আইডি।

প্রতিস্থাপন মোড

সাবস্ক্রিপশন প্রতিস্থাপনের পদ্ধতি।

এনামস
REPLACEMENT_MODE_UNSPECIFIED অনির্দিষ্ট প্রতিস্থাপন মোড।
WITH_TIME_PRORATION নতুন পরিকল্পনাটি পুরাতন পরিকল্পনা থেকে আনুপাতিক হারে এবং ক্রেডিট করা হবে।
CHARGE_PRORATED_PRICE নতুন প্ল্যানের জন্য ব্যবহারকারীকে আনুপাতিক মূল্য চার্জ করা হবে।
WITHOUT_PRORATION নতুন পরিকল্পনাটি সময় নির্ধারণ না করেই পুরানো পরিকল্পনাটিকে প্রতিস্থাপন করবে।
CHARGE_FULL_PRICE নতুন প্ল্যানের জন্য ব্যবহারকারীকে সম্পূর্ণ মূল্য চার্জ করা হবে।
DEFERRED পুরাতন পরিকল্পনা বাতিল করা হবে এবং পুরাতন পরিকল্পনার মেয়াদ শেষ হওয়ার পর নতুন পরিকল্পনা কার্যকর হবে।
KEEP_EXISTING এই প্রতিস্থাপনের সাথে পরিকল্পনাটি অপরিবর্তিত থাকবে।

অ্যাপের বাইরে ক্রয়প্রসঙ্গ

অ্যাপের বাইরের কেনাকাটার জন্য নির্দিষ্ট তথ্য।

JSON উপস্থাপনা
{
  "expiredExternalAccountIdentifiers": {
    object (ExternalAccountIdentifiers)
  },
  "expiredPurchaseToken": string
}
ক্ষেত্র
expiredExternalAccountIdentifiers

object ( ExternalAccountIdentifiers )

এই SKU-এর শেষ মেয়াদোত্তীর্ণ সাবস্ক্রিপশন থেকে ব্যবহারকারী অ্যাকাউন্ট শনাক্তকারী।

expiredPurchaseToken

string

শেষ মেয়াদোত্তীর্ণ সাবস্ক্রিপশনের ক্রয় টোকেন। এই ক্রয় টোকেনটি কেবলমাত্র ব্যবহারকারীকে শনাক্ত করতে ব্যবহার করা উচিত যদি purchaseToken এবং ব্যবহারকারীর মধ্যে লিঙ্কটি আপনার ডাটাবেসে সংরক্ষিত থাকে। মেয়াদ শেষ হওয়ার পর থেকে 60 দিনের বেশি সময় হয়ে গেলে Google Developer API কল করার জন্য এটি ব্যবহার করা যাবে না।

পদ্ধতি

cancel

ব্যবহারকারীর জন্য সাবস্ক্রিপশন ক্রয় বাতিল করুন।

get

সাবস্ক্রিপশন সম্পর্কে মেটাডেটা পান

revoke

ব্যবহারকারীর জন্য সাবস্ক্রিপশন ক্রয় প্রত্যাহার করুন।

ত্রুটি কোড

এই রিসোর্সের ক্রিয়াকলাপগুলি নিম্নলিখিত HTTP ত্রুটি কোডগুলি ফেরত দেয়:

ত্রুটি কোড কারণ রেজোলিউশন
5xx গুগল প্লে সার্ভারে সাধারণ ত্রুটি। আপনার অনুরোধটি আবার চেষ্টা করুন।

যদি সমস্যাটি থেকে যায়, তাহলে আপনার Google Play অ্যাকাউন্ট ম্যানেজারের সাথে যোগাযোগ করুন অথবা একটি সহায়তা অনুরোধ জমা দিন। কোনও পরিচিত বিভ্রাটের জন্য Play Status Dashboard চেক করার কথা বিবেচনা করুন।

409 কনকারেন্সি আপডেট ত্রুটি।

একটি অবজেক্ট আপডেট করার চেষ্টা করা হয়েছিল যা আপডেট করা হচ্ছে। উদাহরণস্বরূপ, Play Billing Library এর acknowledgePurchase() পদ্ধতিতে কল করে এবং Play Developer API এর purchases.products.acknowledge একই সময়ে কল করে একটি ক্রয়ের স্বীকৃতি পাওয়া যাচ্ছে।

আপনার অনুরোধটি আবার চেষ্টা করুন।
410 সাবস্ক্রিপশন ক্রয়টি আর অনুসন্ধানের জন্য উপলব্ধ নেই কারণ এটির মেয়াদ অনেক দিন ধরে শেষ হয়ে গেছে। ৬০ দিনের বেশি মেয়াদোত্তীর্ণ সাবস্ক্রিপশনের জন্য জিজ্ঞাসা করার সময় নিক্ষেপ করা হয়। আপনার আর এই সাবস্ক্রিপশনগুলির জন্য জিজ্ঞাসা করা উচিত নয়।