REST Resource: orders

সম্পদ: অর্ডার

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

অর্ডারস এপিআই (Orders APIs) গুগল প্লে ইকোসিস্টেমের মধ্যে আপনার অর্ডার ডেটাতে রিয়েল-টাইম অ্যাক্সেস প্রদান করে। আপনি এককালীন এবং পুনরাবৃত্তিমূলক উভয় অর্ডারের জন্য বিস্তারিত তথ্য এবং মেটাডেটা পুনরুদ্ধার করতে পারেন, যার মধ্যে চার্জ, ট্যাক্স এবং রিফান্ডের মতো লেনদেনের বিবরণ, সেইসাথে সাবস্ক্রিপশনের জন্য প্রাইসিং ফেজের মতো মেটাডেটাও অন্তর্ভুক্ত। অর্ডারস এপিআই আপনাকে অর্ডার ম্যানেজমেন্ট সম্পর্কিত কাজগুলো স্বয়ংক্রিয় করতে দেয়, যার ফলে প্লে ডেভেলপার কনসোলের মাধ্যমে ম্যানুয়াল চেকের প্রয়োজনীয়তা হ্রাস পায়।

এই এপিআই-টির কয়েকটি ব্যবহার নিচে দেওয়া হলো:

  • রিয়েল-টাইম অর্ডার ডেটা পুনরুদ্ধার - একটি অর্ডার আইডি ব্যবহার করে কেনাকাটার পরপরই orders.get থেকে অর্ডারের বিবরণ এবং মেটাডেটা পান।

  • অর্ডার আপডেট সিঙ্ক্রোনাইজেশন - অর্ডারের তথ্যের একটি হালনাগাদ রেকর্ড বজায় রাখতে পর্যায়ক্রমে অর্ডার আপডেটগুলো সিঙ্ক করুন।

দ্রষ্টব্য:

  • অর্ডার এপিআই কলগুলো আপনার প্লে ডেভেলপার এপিআই কোটার অন্তর্ভুক্ত হয়, যা ডিফল্টভাবে দৈনিক ২ লক্ষ (200K) থাকে এবং বিস্তারিত অর্ডার হিস্ট্রি সিঙ্ক করার জন্য তা অপর্যাপ্ত হতে পারে।

  • প্রতি কলে সর্বোচ্চ ১০০০টি অর্ডার পুনরুদ্ধার করা যাবে। কোটার ব্যবহার কমাতে বড় আকারের পেজ ব্যবহার করার পরামর্শ দেওয়া হয়। ক্লাউড কনসোলে আপনার কোটা পরীক্ষা করুন এবং প্রয়োজনে আরও অনুরোধ করুন।

JSON উপস্থাপনা 
{
  "lineItems": [
    {
      object (LineItem)
    }
  ],
  "salesChannel": enum (SalesChannel),
  "orderId": string,
  "purchaseToken": string,
  "state": enum (State),
  "createTime": string,
  "lastEventTime": string,
  "buyerAddress": {
    object (BuyerAddress)
  },
  "total": {
    object (Money)
  },
  "tax": {
    object (Money)
  },
  "orderDetails": {
    object (OrderDetails)
  },
  "orderHistory": {
    object (OrderHistory)
  },
  "developerRevenueInBuyerCurrency": {
    object (Money)
  },
  "pointsDetails": {
    object (PointsDetails)
  }
}
ক্ষেত্র
lineItems[]

object ( LineItem )

এই অর্ডারটি গঠনকারী স্বতন্ত্র আইটেমগুলো।

salesChannel

enum ( SalesChannel )

অর্ডারটির উৎস বিক্রয় চ্যানেল।

orderId

string

অর্ডার আইডি।

purchaseToken

string

সাবস্ক্রিপশন বা আইটেমটি কেনার সময় ব্যবহারকারীর ডিভাইসে যে টোকেনটি দেওয়া হয়।

state

enum ( State )

আদেশের অবস্থা।

createTime

string ( Timestamp format)

যে সময়ে অর্ডারটি তৈরি করা হয়েছিল।

RFC 3339 ব্যবহার করা হয়, যেখানে তৈরি হওয়া আউটপুট সর্বদা Z-নরম্যালাইজড হবে এবং এতে ০, ৩, ৬ বা ৯টি ভগ্নাংশীয় অঙ্ক ব্যবহৃত হবে। "Z" ছাড়াও অন্যান্য অফসেটও গ্রহণ করা হয়। উদাহরণ: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" অথবা "2014-10-02T15:01:23+05:30" ।

lastEventTime

string ( Timestamp format)

অর্ডারটিতে সংঘটিত সর্বশেষ ঘটনাটির সময়।

RFC 3339 ব্যবহার করা হয়, যেখানে তৈরি হওয়া আউটপুট সর্বদা Z-নরম্যালাইজড হবে এবং এতে ০, ৩, ৬ বা ৯টি ভগ্নাংশীয় অঙ্ক ব্যবহৃত হবে। "Z" ছাড়াও অন্যান্য অফসেটও গ্রহণ করা হয়। উদাহরণ: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" অথবা "2014-10-02T15:01:23+05:30" ।

buyerAddress

object ( BuyerAddress )

কর গণনার জন্য গ্রাহকের ঠিকানার তথ্য। যখন কোনো অর্ডারের জন্য গুগল মার্চেন্ট অফ রেকর্ড হয়, তখন শুধু দেশ দেখানো হয়।

total

object ( Money )

ছাড় ও কর বিবেচনা করে গ্রাহকের পরিশোধিত চূড়ান্ত পরিমাণ।

tax

object ( Money )

এই অর্ডারের অংশ হিসেবে প্রদত্ত মোট কর।

orderDetails

object ( OrderDetails )

অর্ডার তৈরির সময়কার বিস্তারিত তথ্য।

orderHistory

object ( OrderHistory )

যেসব ঘটনা ক্রম পরিবর্তন করেছে সেগুলোর বিবরণ।

developerRevenueInBuyerCurrency

object ( Money )

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

pointsDetails

object ( PointsDetails )

অর্ডারে প্লে পয়েন্ট প্রয়োগ করা হয়েছে, যার মধ্যে অফারের তথ্য, ছাড়ের হার এবং পয়েন্টের মান অন্তর্ভুক্ত রয়েছে।

রাজ্য

আদেশের অবস্থা।

এনাম
STATE_UNSPECIFIED অবস্থা অনির্দিষ্ট। এই মানটি ব্যবহৃত হয় না।
PENDING অর্ডারটি তৈরি করা হয়েছে এবং প্রক্রিয়াকরণের জন্য অপেক্ষারত আছে।
PROCESSED অর্ডারটি সফলভাবে প্রক্রিয়া করা হয়েছে।
CANCELED অর্ডারটি প্রসেস করার আগেই বাতিল করা হয়েছিল।
PENDING_REFUND অনুরোধকৃত ফেরত প্রক্রিয়াধীন রয়েছে।
PARTIALLY_REFUNDED অর্ডারের টাকার একটি অংশ ফেরত দেওয়া হয়েছিল।
REFUNDED অর্ডারের সম্পূর্ণ অর্থ ফেরত দেওয়া হয়েছে।

ক্রেতার ঠিকানা

কর গণনার কাজে ব্যবহারের জন্য গ্রাহকের ঠিকানা সংক্রান্ত তথ্য।

JSON উপস্থাপনা 
{
  "buyerState": string,
  "buyerCountry": string,
  "buyerPostcode": string
}
ক্ষেত্র
buyerState

string

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

buyerCountry

string

ISO-3166-1 Alpha-2 (জাতিসংঘের দেশ কোড) এর উপর ভিত্তি করে দুই অক্ষরের দেশের কোড।

buyerPostcode

string

ঠিকানার পোস্টাল কোড। যখন কোনো অর্ডারের জন্য গুগল মার্চেন্ট অফ রেকর্ড হিসেবে থাকে, তখন এই তথ্যটি অন্তর্ভুক্ত করা হয় না।

অর্ডারের বিবরণ

অর্ডার তৈরির সময়কার বিস্তারিত তথ্য।

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

boolean

তালিকাভুক্ত মূল্যটি করসহ ছিল কি না, তা নির্দেশ করে।

লাইনআইটেম

একটি আইটেমের বিবরণ।

JSON উপস্থাপনা 
{
  "productTitle": string,
  "productId": string,
  "listingPrice": {
    object (Money)
  },
  "total": {
    object (Money)
  },
  "tax": {
    object (Money)
  },

  // Union field details can be only one of the following:
  "oneTimePurchaseDetails": {
    object (OneTimePurchaseDetails)
  },
  "subscriptionDetails": {
    object (SubscriptionDetails)
  },
  "paidAppDetails": {
    object (PaidAppDetails)
  }
  // End of list of possible types for union field details.
}
ক্ষেত্র
productTitle

string

ডেভেলপার কর্তৃক নির্ধারিত পণ্যের নাম। ক্রেতার স্থানীয় ভাষায় প্রদর্শিত হয়। উদাহরণ: কয়েন, মাসিক সাবস্ক্রিপশন, ইত্যাদি।

productId

string

ক্রয়কৃত প্রোডাক্ট আইডি বা ইন-অ্যাপ SKU (উদাহরণস্বরূপ, 'monthly001' বা 'com.some.thing.inapp1')।

listingPrice

object ( Money )

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

total

object ( Money )

ডিসকাউন্ট ও ট্যাক্স বিবেচনা করে, এই নির্দিষ্ট আইটেমটির জন্য ব্যবহারকারীর পরিশোধিত মোট পরিমাণ।

tax

object ( Money )

এই খাতের জন্য প্রদত্ত কর।

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

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

oneTimePurchaseDetails

object ( OneTimePurchaseDetails )

এককালীন ক্রয়ের বিবরণ।

subscriptionDetails

object ( SubscriptionDetails )

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

paidAppDetails

object ( PaidAppDetails )

অর্থের বিনিময়ে কেনা অ্যাপের বিবরণ।

এককালীন ক্রয়ের বিবরণ

এককালীন ক্রয়ের বিবরণ।

JSON উপস্থাপনা 
{
  "quantity": integer,
  "offerId": string,
  "purchaseOptionId": string,
  "preorderDetails": {
    object (PreorderDetails)
  },
  "rentalDetails": {
    object (RentalDetails)
  }
}
ক্ষেত্র
quantity

integer

ক্রয়কৃত সামগ্রীর সংখ্যা (একাধিক সামগ্রী ক্রয়ের ক্ষেত্রে)।

offerId

string

এককালীন ক্রয় অফারটির অফার আইডি।

purchaseOptionId

string

ক্রয় বিকল্পের আইডি। এই ফিল্ডটি ক্রয় বিকল্প এবং ভ্যারিয়েন্ট অফার উভয়ের জন্যই সেট করা হয়। ক্রয় বিকল্পের ক্ষেত্রে, এই আইডিটি স্বয়ং ক্রয় বিকল্পটিকে শনাক্ত করে। ভ্যারিয়েন্ট অফারের ক্ষেত্রে, এই আইডিটি সংশ্লিষ্ট ক্রয় বিকল্পটিকে নির্দেশ করে এবং অফারআইডি (offerId)-এর সাথে মিলে ভ্যারিয়েন্ট অফারটিকে শনাক্ত করে।

preorderDetails

object ( PreorderDetails )

প্রি-অর্ডার ক্রয়ের বিবরণ। শুধুমাত্র প্রি-অর্ডার ক্রয়ের ক্ষেত্রেই এটি সেট করা হবে। মনে রাখবেন, প্রি-অর্ডার সম্পন্ন হওয়ার পরেও এই ফিল্ডটি সেট করা থাকবে।

rentalDetails

object ( RentalDetails )

ভাড়া ক্রয়ের বিবরণ। শুধুমাত্র ভাড়া ক্রয় হলেই সেট করা হয়।

প্রি-অর্ডারের বিবরণ

এই প্রকারে কোনো ক্ষেত্র নেই।

প্রি-অর্ডার ক্রয়ের বিবরণ।

ভাড়ার বিবরণ

এই প্রকারে কোনো ক্ষেত্র নেই।

ভাড়া ক্রয়ের বিবরণ।

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

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

JSON উপস্থাপনা 
{
  "basePlanId": string,
  "offerId": string,
  "offerPhase": enum (OfferPhase),
  "offerPhaseDetails": {
    object (OfferPhaseDetails)
  },
  "servicePeriodStartTime": string,
  "servicePeriodEndTime": string
}
ক্ষেত্র
basePlanId

string

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

offerId

string

বর্তমান সাবস্ক্রিপশন অফারটির অফার আইডি।

offerPhase
(deprecated)

enum ( OfferPhase )

অপ্রচলিত: এর পরিবর্তে offerPhaseDetails ব্যবহার করুন। এই অর্ডার দ্বারা অর্থায়নকৃত বিলিং মেয়াদের জন্য মূল্য নির্ধারণ পর্ব।

offerPhaseDetails

object ( OfferPhaseDetails )

এই আদেশ দ্বারা অর্থায়িত প্রাপ্যতার মেয়াদের জন্য মূল্য নির্ধারণ পর্বের বিশদ বিবরণ।

servicePeriodStartTime

string ( Timestamp format)

এই অর্ডারের মাধ্যমে অর্থায়নকৃত বিলিং পিরিয়ডের শুরু। এটি অর্ডারটি প্রসেস করার মুহূর্তের বিলিং/পরিষেবা পিরিয়ড শুরুর সময়ের একটি চিত্র, এবং এটি শুধুমাত্র হিসাবরক্ষণের জন্য ব্যবহার করা উচিত।

RFC 3339 ব্যবহার করা হয়, যেখানে তৈরি হওয়া আউটপুট সর্বদা Z-নরম্যালাইজড হবে এবং এতে ০, ৩, ৬ বা ৯টি ভগ্নাংশীয় অঙ্ক ব্যবহৃত হবে। "Z" ছাড়াও অন্যান্য অফসেটও গ্রহণ করা হয়। উদাহরণ: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" অথবা "2014-10-02T15:01:23+05:30" ।

servicePeriodEndTime

string ( Timestamp format)

এই অর্ডারের মাধ্যমে অর্থায়নকৃত বিলিং পিরিয়ডের শেষ সময়। এটি অর্ডারটি প্রসেস করার মুহূর্তের বিলিং/পরিষেবা পিরিয়ড শেষের সময়ের একটি স্ন্যাপশট, এবং এটি শুধুমাত্র হিসাবরক্ষণের জন্য ব্যবহার করা উচিত। সাবস্ক্রিপশন পরিষেবা পিরিয়ডের বর্তমান শেষের সময় জানতে, purchases.subscriptionsv2.get ব্যবহার করুন।

RFC 3339 ব্যবহার করা হয়, যেখানে তৈরি হওয়া আউটপুট সর্বদা Z-নরম্যালাইজড হবে এবং এতে ০, ৩, ৬ বা ৯টি ভগ্নাংশীয় অঙ্ক ব্যবহৃত হবে। "Z" ছাড়াও অন্যান্য অফসেটও গ্রহণ করা হয়। উদাহরণ: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" অথবা "2014-10-02T15:01:23+05:30" ।

অফার ফেজ

এই আদেশ দ্বারা অর্থায়িত প্রাপ্যতার মেয়াদের জন্য মূল্য নির্ধারণ পর্ব।

এনাম
OFFER_PHASE_UNSPECIFIED অফার পর্যায় অনির্দিষ্ট। এই মানটি ব্যবহৃত হয় না।
BASE এই অর্ডারটি একটি ভিত্তি মূল্যের সময়কালের জন্য অর্থায়ন করে।
INTRODUCTORY এই আদেশের মাধ্যমে একটি প্রারম্ভিক মূল্যছাড়ের সময়কালের জন্য অর্থায়ন করা হয়।
FREE_TRIAL এই অর্ডারের মাধ্যমে একটি বিনামূল্যে ট্রায়াল পিরিয়ড পাওয়া যায়।

অফার পর্বের বিবরণ

এই আদেশ দ্বারা অর্থায়িত প্রাপ্যতার মেয়াদের জন্য মূল্য নির্ধারণ পর্বের বিবরণ।

JSON উপস্থাপনা 
{

  // Union field phase_details can be only one of the following:
  "freeTrialDetails": {
    object (FreeTrialDetails)
  },
  "introductoryPriceDetails": {
    object (IntroductoryPriceDetails)
  },
  "baseDetails": {
    object (BaseDetails)
  },
  "prorationPeriodDetails": {
    object (ProrationPeriodDetails)
  }
  // End of list of possible types for union field phase_details.
}
ক্ষেত্র
ইউনিয়ন ফিল্ড phase_details । এটি মূল্য নির্ধারণ পর্বের বিস্তারিত তথ্য। phase_details নিম্নলিখিতগুলির মধ্যে কেবল একটি হতে পারে:
freeTrialDetails

object ( FreeTrialDetails )

এই অর্ডারের মাধ্যমে একটি বিনামূল্যে ট্রায়াল পিরিয়ড পাওয়া যায়।

introductoryPriceDetails

object ( IntroductoryPriceDetails )

এই আদেশের মাধ্যমে একটি প্রারম্ভিক মূল্যছাড়ের সময়কালের জন্য অর্থায়ন করা হয়।

baseDetails

object ( BaseDetails )

এই অর্ডারটি একটি ভিত্তি মূল্যের সময়কালের জন্য অর্থায়ন করে।

prorationPeriodDetails

object ( ProrationPeriodDetails )

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

বিনামূল্যে ট্রায়ালের বিবরণ

এই প্রকারে কোনো ক্ষেত্র নেই।

বিনামূল্যে ট্রায়াল মূল্য নির্ধারণ পর্বের বিবরণ।

প্রারম্ভিক মূল্যের বিবরণ

এই প্রকারে কোনো ক্ষেত্র নেই।

প্রারম্ভিক মূল্য নির্ধারণ পর্বের বিবরণ।

বেসডিটেইলস

এই প্রকারে কোনো ক্ষেত্র নেই।

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

আনুপাতিক সময়কালের বিবরণ

আনুপাতিক বন্টনকালের বিবরণ।

প্রোরেশন পিরিয়ড হলো প্ল্যান পরিবর্তনের সময় বিদ্যমান এনটাইটেলমেন্টগুলো অন্তর্ভুক্ত করার জন্য গণনা করা একটি সময়কাল (আরও তথ্যের জন্য, ‘ব্যবহারকারীদের তাদের সাবস্ক্রিপশন আপগ্রেড, ডাউনগ্রেড বা পরিবর্তন করার অনুমতি দিন’ দেখুন), অথবা বেস প্ল্যানের সাথে অ্যাড-অন রিনিউয়ালের তারিখগুলো মেলানোর জন্য একটি প্রোরেটেড সময়কাল (আরও তথ্যের জন্য, ‘ক্রয়ের আইটেমগুলোর জন্য প্রযোজ্য নিয়মাবলী ’ দেখুন)।

JSON উপস্থাপনা 
{
  "originalOfferPhase": enum (OfferPhase)
}
ক্ষেত্র
originalOfferPhase

enum ( OfferPhase )

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

পেইডঅ্যাপের বিবরণ

এই প্রকারে কোনো ক্ষেত্র নেই।

অর্থের বিনিময়ে কেনা অ্যাপের বিবরণ।

অর্ডারহিস্ট্রি

যেসব ঘটনা ক্রম পরিবর্তন করেছে সেগুলোর বিবরণ।

JSON উপস্থাপনা 
{
  "partialRefundEvents": [
    {
      object (PartialRefundEvent)
    }
  ],
  "processedEvent": {
    object (ProcessedEvent)
  },
  "cancellationEvent": {
    object (CancellationEvent)
  },
  "refundEvent": {
    object (RefundEvent)
  }
}
ক্ষেত্র
partialRefundEvents[]

object ( PartialRefundEvent )

এই অর্ডারের জন্য আংশিক রিফান্ডের বিবরণ।

processedEvent

object ( ProcessedEvent )

অর্ডারটি কখন প্রসেস করা হয়েছিল তার বিবরণ।

cancellationEvent

object ( CancellationEvent )

অর্ডারটি কখন বাতিল করা হয়েছিল তার বিবরণ।

refundEvent

object ( RefundEvent )

অর্ডারটির সম্পূর্ণ অর্থ ফেরত দেওয়ার সময়কার বিবরণ।

প্রক্রিয়াকৃত ইভেন্ট

অর্ডারটি কখন প্রসেস করা হয়েছিল তার বিবরণ।

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

string ( Timestamp format)

যে সময়ে অর্ডারটি প্রসেস করা হয়েছিল।

RFC 3339 ব্যবহার করা হয়, যেখানে তৈরি হওয়া আউটপুট সর্বদা Z-নরম্যালাইজড হবে এবং এতে ০, ৩, ৬ বা ৯টি ভগ্নাংশীয় অঙ্ক ব্যবহৃত হবে। "Z" ছাড়াও অন্যান্য অফসেটও গ্রহণ করা হয়। উদাহরণ: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" অথবা "2014-10-02T15:01:23+05:30" ।

বাতিলকরণ ইভেন্ট

অর্ডারটি কখন বাতিল করা হয়েছিল তার বিবরণ।

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

string ( Timestamp format)

যে সময়ে অর্ডারটি বাতিল করা হয়েছিল।

RFC 3339 ব্যবহার করা হয়, যেখানে তৈরি হওয়া আউটপুট সর্বদা Z-নরম্যালাইজড হবে এবং এতে ০, ৩, ৬ বা ৯টি ভগ্নাংশীয় অঙ্ক ব্যবহৃত হবে। "Z" ছাড়াও অন্যান্য অফসেটও গ্রহণ করা হয়। উদাহরণ: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" অথবা "2014-10-02T15:01:23+05:30" ।

রিফান্ডইভেন্ট

অর্ডারটির সম্পূর্ণ অর্থ ফেরত দেওয়ার সময়কার বিবরণ।

JSON উপস্থাপনা 
{
  "eventTime": string,
  "refundDetails": {
    object (RefundDetails)
  },
  "refundReason": enum (RefundReason)
}
ক্ষেত্র
eventTime

string ( Timestamp format)

যে সময়ে অর্ডারটির সম্পূর্ণ টাকা ফেরত দেওয়া হয়েছিল।

RFC 3339 ব্যবহার করা হয়, যেখানে তৈরি হওয়া আউটপুট সর্বদা Z-নরম্যালাইজড হবে এবং এতে ০, ৩, ৬ বা ৯টি ভগ্নাংশীয় অঙ্ক ব্যবহৃত হবে। "Z" ছাড়াও অন্যান্য অফসেটও গ্রহণ করা হয়। উদাহরণ: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" অথবা "2014-10-02T15:01:23+05:30" ।

refundDetails

object ( RefundDetails )

সম্পূর্ণ অর্থ ফেরতের বিবরণ।

refundReason

enum ( RefundReason )

যে কারণে অর্ডারটি ফেরত দেওয়া হয়েছিল।

ফেরতের বিবরণ

আংশিক বা সম্পূর্ণ অর্থ ফেরতের বিবরণ।

JSON উপস্থাপনা 
{
  "total": {
    object (Money)
  },
  "tax": {
    object (Money)
  }
}
ক্ষেত্র
total

object ( Money )

কর সহ ফেরত দেওয়া মোট টাকার পরিমাণ।

tax

object ( Money )

ফেরতকৃত করের পরিমাণ।

ফেরতের কারণ

যে কারণে অর্ডারটি ফেরত দেওয়া হয়েছিল।

এনাম
REFUND_REASON_UNSPECIFIED অর্ডার ফেরতের কারণ অনির্দিষ্ট। এই মানটি ব্যবহৃত হয় না।
OTHER এখানে তালিকাভুক্ত কারণগুলো ছাড়া অন্য কোনো কারণে অর্ডারটি ফেরত দেওয়া হয়েছিল।
CHARGEBACK অর্ডারটির মূল্য ফেরত নেওয়া হয়েছিল।

আংশিক ফেরত ইভেন্ট

এই অর্ডারের জন্য আংশিক রিফান্ডের বিবরণ।

JSON উপস্থাপনা 
{
  "createTime": string,
  "processTime": string,
  "state": enum (State),
  "refundDetails": {
    object (RefundDetails)
  }
}
ক্ষেত্র
createTime

string ( Timestamp format)

যে সময়ে আংশিক রিফান্ডটি তৈরি করা হয়েছিল।

RFC 3339 ব্যবহার করা হয়, যেখানে তৈরি হওয়া আউটপুট সর্বদা Z-নরম্যালাইজড হবে এবং এতে ০, ৩, ৬ বা ৯টি ভগ্নাংশীয় অঙ্ক ব্যবহৃত হবে। "Z" ছাড়াও অন্যান্য অফসেটও গ্রহণ করা হয়। উদাহরণ: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" অথবা "2014-10-02T15:01:23+05:30" ।

processTime

string ( Timestamp format)

যে সময়ে আংশিক অর্থ ফেরত প্রক্রিয়া করা হয়েছিল।

RFC 3339 ব্যবহার করা হয়, যেখানে তৈরি হওয়া আউটপুট সর্বদা Z-নরম্যালাইজড হবে এবং এতে ০, ৩, ৬ বা ৯টি ভগ্নাংশীয় অঙ্ক ব্যবহৃত হবে। "Z" ছাড়াও অন্যান্য অফসেটও গ্রহণ করা হয়। উদাহরণ: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" অথবা "2014-10-02T15:01:23+05:30" ।

state

enum ( State )

আংশিক ফেরতের অবস্থা।

refundDetails

object ( RefundDetails )

আংশিক অর্থ ফেরতের বিবরণ।

রাজ্য

আংশিক ফেরতের অবস্থা।

এনাম
STATE_UNSPECIFIED অবস্থা অনির্দিষ্ট। এই মানটি ব্যবহৃত হয় না।
PENDING আংশিক রিফান্ড তৈরি করা হয়েছে, কিন্তু এখনো প্রক্রিয়া করা হয়নি।
PROCESSED_SUCCESSFULLY আংশিক অর্থ ফেরতের প্রক্রিয়াটি সফলভাবে সম্পন্ন হয়েছে।

পয়েন্ট বিবরণ

কোনো অর্ডারে প্রযোজ্য প্লে পয়েন্ট সম্পর্কিত বিবরণ।

JSON উপস্থাপনা 
{
  "pointsOfferId": string,
  "pointsCouponValue": {
    object (Money)
  },
  "pointsDiscountRateMicros": string,
  "pointsSpent": string
}
ক্ষেত্র
pointsOfferId

string

এই অর্ডারের জন্য ব্যবহৃত প্লে পয়েন্ট অফারটির একটি অনন্য আইডি রয়েছে।

pointsCouponValue

object ( Money )

একটি প্লে পয়েন্টস কুপনের আর্থিক মূল্য। এটি হলো কুপনটির মাধ্যমে প্রাপ্ত ছাড়, যা মোট পরিমাণ নাও হতে পারে। এটি শুধুমাত্র তখনই নির্ধারিত হয় যখন প্লে পয়েন্টস কুপন ব্যবহার করা হয়। যেমন, $২ মূল্যের ১০০ পয়েন্টের একটি কুপনের জন্য, এর পরিমাণ হলো $২।

pointsDiscountRateMicros

string ( int64 format)

প্লে পয়েন্টস প্রোমোশন যে শতাংশ হারে খরচ কমায়। যেমন, $২ এর জন্য ১০০ পয়েন্টের একটি কুপনের ক্ষেত্রে, এটি হলো ৫০০,০০০। যেহেতু $২ এর জন্য আনুমানিক ২০০ পয়েন্ট লাগে, কিন্তু প্রকৃতপক্ষে প্রয়োজনীয় পয়েন্ট হলো ১০০, যা এর ৫০%, এবং ৫০% কে ক্ষুদ্র এককে প্রকাশ করলে হয় ৫০০,০০০। এর মান ০ থেকে ১,০০০,০০০ এর মধ্যে।

pointsSpent

string ( int64 format)

প্লে পয়েন্টের সংখ্যা এই ক্রমে প্রয়োগ করা হয়। যেমন, $২ কুপনের জন্য ১০০ পয়েন্টের ক্ষেত্রে, এটি হলো ১০০। বেস অফারের সাথে কুপন একসাথে ব্যবহার করা হলে, এটি হলো উভয় মিলিয়ে মোট খরচ হওয়া পয়েন্ট।

বিক্রয় চ্যানেল

অর্ডারটির উৎস বিক্রয় চ্যানেল।

এনাম
SALES_CHANNEL_UNSPECIFIED বিক্রয় চ্যানেল অনির্দিষ্ট। এই মানটি ব্যবহৃত হয় না।
IN_APP অ্যাপের ভেতর থেকে শুরু হওয়া সাধারণ অর্ডারগুলো।
PC_EMULATOR ইন-অ্যাপ কেনাকাটার জন্য পিসি এমুলেটর থেকে অর্ডার শুরু করা হয়েছে।
NATIVE_PC ইন-অ্যাপ কেনাকাটার জন্য নেটিভ পিসি অ্যাপ থেকে অর্ডার শুরু করা হয়।
PLAY_STORE গুগল প্লে স্টোর থেকে অর্ডার শুরু করা হয়েছে।
OUTSIDE_PLAY_STORE গুগল প্লে স্টোরের বাইরে থেকে শুরু করা অর্ডার।

পদ্ধতি

batchget

 অর্ডারগুলোর তালিকা দেখতে অর্ডারের বিবরণ দেখুন।

get

 একটি অর্ডারের বিস্তারিত তথ্য জানুন।

refund

 ব্যবহারকারীর সাবস্ক্রিপশন বা ইন-অ্যাপ ক্রয়ের অর্ডারের অর্থ ফেরত দেওয়া হয়।

ত্রুটি কোড

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

ত্রুটি কোড কারণ বর্ণনা সমাধান