- সম্পদ: অর্ডার
- রাজ্য
- ক্রেতার ঠিকানা
- অর্ডারের বিবরণ
- লাইন আইটেম
- OneTimePurchase Details
- ভাড়ার বিবরণ
- সদস্যতার বিবরণ
- অফারফেজ
- PaidApp বিস্তারিত
- অর্ডার ইতিহাস
- প্রক্রিয়াকৃত ইভেন্ট
- বাতিলকরণ ইভেন্ট
- রিফান্ড ইভেন্ট
- ফেরতের বিবরণ
- ফেরতের কারণ
- আংশিক রিফান্ড ইভেন্ট
- রাজ্য
- পয়েন্টের বিবরণ
- পদ্ধতি
সম্পদ: অর্ডার
অর্ডার রিসোর্স Google Play-তে করা একটি লেনদেন সম্পর্কে বিস্তৃত তথ্য এনক্যাপসুলেট করে। এটিতে বিভিন্ন ধরণের বৈশিষ্ট্য রয়েছে যা অর্ডার নিজেই, কেনা পণ্য এবং অর্ডার সম্পর্কিত ইভেন্টের ইতিহাস সম্পর্কে বিশদ প্রদান করে।
অর্ডার API Google Play ইকোসিস্টেমের মধ্যে আপনার অর্ডার ডেটাতে রিয়েল-টাইম অ্যাক্সেস প্রদান করে। আপনি চার্জ, ট্যাক্স এবং রিফান্ডের মতো লেনদেনের বিশদ বিবরণ সহ সাবস্ক্রিপশনের মূল্যের পর্যায়গুলির মতো মেটাডেটা সহ এক-কালীন এবং পুনরাবৃত্ত অর্ডার উভয়ের জন্যই বিস্তারিত তথ্য এবং মেটাডেটা পুনরুদ্ধার করতে পারেন। অর্ডার এপিআই আপনাকে প্লে ডেভেলপার কনসোলের মাধ্যমে ম্যানুয়াল চেকের প্রয়োজনীয়তা কমিয়ে অর্ডার ম্যানেজমেন্ট সম্পর্কিত কাজগুলিকে স্বয়ংক্রিয় করতে দেয়।
এই API-এর জন্য কিছু ব্যবহারের ক্ষেত্রে নিচে দেওয়া হল:
রিয়েল-টাইম অর্ডার ডেটা পুনরুদ্ধার - অর্ডার আইডি ব্যবহার করে ক্রয়ের পরেই অর্ডারের বিবরণ এবং মেটাডেটা পান।
অর্ডার আপডেট সিঙ্ক্রোনাইজেশন - অর্ডার তথ্যের আপ-টু-ডেট রেকর্ড বজায় রাখতে পর্যায়ক্রমে অর্ডার আপডেট সিঙ্ক করুন।
দ্রষ্টব্য:
অর্ডার API কলগুলি আপনার প্লে ডেভেলপার API কোটার জন্য গণনা করা হয়, যা দৈনিক 200K তে ডিফল্ট হয় এবং বিস্তৃত অর্ডার ইতিহাস সিঙ্ক করার জন্য অপর্যাপ্ত হতে পারে।
প্রতি কলে সর্বাধিক 1000টি অর্ডার পুনরুদ্ধার করা যেতে পারে। কোটা ব্যবহার কমাতে বড় পৃষ্ঠার আকার ব্যবহার করার পরামর্শ দেওয়া হয়। ক্লাউড কনসোলে আপনার কোটা পরীক্ষা করুন এবং প্রয়োজন হলে আরও অনুরোধ করুন।
JSON প্রতিনিধিত্ব |
---|
{ "lineItems": [ { object ( |
ক্ষেত্র | |
---|---|
lineItems[] | পৃথক লাইন আইটেম এই অর্ডার তৈরি. |
orderId | অর্ডার আইডি। |
purchaseToken | সদস্যতা বা আইটেম কেনার সময় ব্যবহারকারীর ডিভাইসে দেওয়া টোকেন। |
state | আদেশের অবস্থা। |
createTime | যে সময় অর্ডার তৈরি হয়েছিল। RFC 3339 ব্যবহার করে, যেখানে উৎপন্ন আউটপুট সর্বদা Z-সাধারণ করা হবে এবং 0, 3, 6 বা 9 ভগ্নাংশ সংখ্যা ব্যবহার করে। "Z" ব্যতীত অন্যান্য অফসেটগুলিও গ্রহণ করা হয়। উদাহরণ: |
lastEventTime | আদেশে ঘটে যাওয়া শেষ ঘটনার সময়। RFC 3339 ব্যবহার করে, যেখানে উৎপন্ন আউটপুট সর্বদা Z-সাধারণ করা হবে এবং 0, 3, 6 বা 9 ভগ্নাংশ সংখ্যা ব্যবহার করে। "Z" ব্যতীত অন্যান্য অফসেটগুলিও গ্রহণ করা হয়। উদাহরণ: |
buyerAddress | ট্যাক্স গণনায় ব্যবহারের জন্য গ্রাহকের জন্য ঠিকানা তথ্য। Google যখন অর্ডারের জন্য মার্চেন্ট অফ রেকর্ড, শুধুমাত্র দেশ দেখানো হয়। |
total | ডিসকাউন্ট এবং ট্যাক্স বিবেচনা করে গ্রাহকের দেওয়া চূড়ান্ত পরিমাণ। |
tax | এই আদেশের একটি অংশ হিসাবে প্রদত্ত মোট কর। |
orderDetails | সৃষ্টির সময় অর্ডার সম্পর্কে বিস্তারিত তথ্য। |
orderHistory | ইভেন্ট সম্পর্কে বিশদ বিবরণ যা অর্ডার পরিবর্তন করেছে৷ |
developerRevenueInBuyerCurrency | আংশিক ফেরত, ট্যাক্স এবং ফি কেটে নেওয়া সহ ক্রেতার মুদ্রায় এই অর্ডারের জন্য আপনার রাজস্ব। Google কিছু অঞ্চলে ভ্যাট সহ প্রতিটি বিক্রয় থেকে স্ট্যান্ডার্ড লেনদেন এবং তৃতীয় পক্ষের ফি কেটে নেয়। |
pointsDetails | অফারের তথ্য, ডিসকাউন্ট রেট এবং পয়েন্টের মান সহ অর্ডারে প্লে পয়েন্ট প্রয়োগ করা হয়। |
রাজ্য
আদেশের অবস্থা।
এনামস | |
---|---|
STATE_UNSPECIFIED | রাজ্য অনির্দিষ্ট. এই মান ব্যবহার করা হয় না. |
PENDING | অর্ডার তৈরি করা হয়েছে এবং প্রক্রিয়াকরণের জন্য অপেক্ষা করছে। |
PROCESSED | অর্ডার সফলভাবে প্রক্রিয়া করা হয়েছে. |
CANCELED | প্রক্রিয়া হওয়ার আগেই অর্ডার বাতিল করা হয়েছে। |
PENDING_REFUND | অনুরোধকৃত অর্থ ফেরত প্রক্রিয়া করার জন্য অপেক্ষা করছে। |
PARTIALLY_REFUNDED | অর্ডারের পরিমাণের কিছু অংশ ফেরত দেওয়া হয়েছে। |
REFUNDED | সম্পূর্ণ অর্ডারের পরিমাণ ফেরত দেওয়া হয়েছে। |
ক্রেতার ঠিকানা
ট্যাক্স গণনায় ব্যবহারের জন্য গ্রাহকের জন্য ঠিকানা তথ্য।
JSON প্রতিনিধিত্ব |
---|
{ "buyerState": string, "buyerCountry": string, "buyerPostcode": string } |
ক্ষেত্র | |
---|---|
buyerState | ক্রেতার ঠিকানা দেশের শীর্ষ-স্তরের প্রশাসনিক উপবিভাগ। যখন Google অর্ডারের জন্য রেকর্ডের মার্চেন্ট হয়, তখন এই তথ্য অন্তর্ভুক্ত করা হয় না। |
buyerCountry | ISO-3166-1 আলফা-2 (UN দেশের কোড) এর উপর ভিত্তি করে দুটি অক্ষরের দেশের কোড। |
buyerPostcode | একটি ঠিকানার পোস্টাল কোড। যখন Google অর্ডারের জন্য রেকর্ডের মার্চেন্ট হয়, তখন এই তথ্য অন্তর্ভুক্ত করা হয় না। |
অর্ডারের বিবরণ
সৃষ্টির সময় অর্ডার সম্পর্কে বিস্তারিত তথ্য।
JSON প্রতিনিধিত্ব |
---|
{ "taxInclusive": boolean } |
ক্ষেত্র | |
---|---|
taxInclusive | তালিকাভুক্ত মূল্য ট্যাক্স সহ ছিল কি না তা নির্দেশ করে। |
লাইন আইটেম
একটি লাইন আইটেমের বিশদ বিবরণ।
JSON প্রতিনিধিত্ব |
---|
{ "productTitle": string, "productId": string, "listingPrice": { object ( |
ক্ষেত্র | |
---|---|
productTitle | পণ্যের ডেভেলপার-নির্দিষ্ট নাম। ক্রেতার লোকেলে প্রদর্শিত। উদাহরণ: কয়েন, মাসিক সাবস্ক্রিপশন, ইত্যাদি। |
productId | কেনা পণ্য আইডি বা অ্যাপ-মধ্যস্থ SKU (উদাহরণস্বরূপ, 'monthly001' বা 'com.some.thing.inapp1')। |
listingPrice | প্লে স্টোরে আইটেমের তালিকাভুক্ত মূল্য, এতে ট্যাক্স অন্তর্ভুক্ত থাকতে পারে বা নাও থাকতে পারে। কোন ডিসকাউন্ট বা প্রচার বাদ. |
total | ডিসকাউন্ট এবং ট্যাক্স বিবেচনা করে এই লাইন আইটেমের জন্য ব্যবহারকারীর দ্বারা প্রদত্ত মোট পরিমাণ। |
tax | এই লাইন আইটেম জন্য প্রদত্ত ট্যাক্স. |
ইউনিয়ন ক্ষেত্রের | |
oneTimePurchaseDetails | এককালীন কেনাকাটার বিশদ বিবরণ। |
subscriptionDetails | সাবস্ক্রিপশন ক্রয়ের বিশদ বিবরণ। |
paidAppDetails | একটি প্রদত্ত অ্যাপ ক্রয়ের বিশদ বিবরণ৷ |
OneTimePurchase Details
এককালীন কেনাকাটার বিশদ বিবরণ।
JSON প্রতিনিধিত্ব |
---|
{
"quantity": integer,
"offerId": string,
"purchaseOptionId": string,
"rentalDetails": {
object ( |
ক্ষেত্র | |
---|---|
quantity | ক্রয়কৃত আইটেমের সংখ্যা (বহু-পরিমাণ আইটেম কেনার জন্য)। |
offerId | এককালীন কেনাকাটার অফারের অফার আইডি। |
purchaseOptionId | ক্রয় বিকল্পের আইডি। এই ক্ষেত্রটি ক্রয় বিকল্প এবং বৈকল্পিক অফার উভয়ের জন্য সেট করা হয়েছে। ক্রয় বিকল্পের জন্য, এই আইডি ক্রয় বিকল্পটি নিজেই সনাক্ত করে। ভেরিয়েন্ট অফারের জন্য, এই আইডিটি সংশ্লিষ্ট ক্রয়ের বিকল্পকে নির্দেশ করে এবং offerId-এর সাথে এটি ভেরিয়েন্ট অফারটিকে চিহ্নিত করে। |
rentalDetails | একটি ভাড়া ক্রয় বিবরণ. এটি একটি ভাড়া ক্রয় হলে শুধুমাত্র সেট. |
ভাড়ার বিবরণ
এই ধরনের কোন ক্ষেত্র আছে.
একটি ভাড়া ক্রয় বিবরণ.
সদস্যতার বিবরণ
সাবস্ক্রিপশন ক্রয়ের বিশদ বিবরণ।
JSON প্রতিনিধিত্ব |
---|
{
"basePlanId": string,
"offerId": string,
"offerPhase": enum ( |
ক্ষেত্র | |
---|---|
basePlanId | সাবস্ক্রিপশনের বেস প্ল্যান আইডি। |
offerId | বর্তমান সাবস্ক্রিপশন অফারের জন্য অফার আইডি। |
offerPhase | এই আদেশ দ্বারা অর্থায়ন করা বিলিং সময়ের জন্য মূল্য ধাপ। |
servicePeriodStartTime | এই আদেশ দ্বারা অর্থায়ন বিলিং সময়কাল শুরু. অর্ডারটি প্রক্রিয়াকরণের মুহুর্তে এটি বিলিং/পরিষেবা সময়কালের শুরুর সময়ের একটি স্ন্যাপশট, এবং শুধুমাত্র অ্যাকাউন্টিংয়ের জন্য ব্যবহার করা উচিত। RFC 3339 ব্যবহার করে, যেখানে উৎপন্ন আউটপুট সর্বদা Z-সাধারণ করা হবে এবং 0, 3, 6 বা 9 ভগ্নাংশ সংখ্যা ব্যবহার করে। "Z" ব্যতীত অন্যান্য অফসেটগুলিও গ্রহণ করা হয়। উদাহরণ: |
servicePeriodEndTime | এই আদেশ দ্বারা অর্থায়ন বিলিং সময়কাল শেষ. অর্ডারটি প্রক্রিয়াকরণের মুহুর্তে এটি বিলিং/পরিষেবার সময়কালের শেষ সময়ের একটি স্ন্যাপশট, এবং শুধুমাত্র অ্যাকাউন্টিংয়ের জন্য ব্যবহার করা উচিত। সাবস্ক্রিপশন পরিষেবার বর্তমান শেষ সময় পেতে, purchases.subscriptionsv2.get ব্যবহার করুন। RFC 3339 ব্যবহার করে, যেখানে উৎপন্ন আউটপুট সর্বদা Z-সাধারণ করা হবে এবং 0, 3, 6 বা 9 ভগ্নাংশ সংখ্যা ব্যবহার করে। "Z" ব্যতীত অন্যান্য অফসেটগুলিও গ্রহণ করা হয়। উদাহরণ: |
অফারফেজ
এই আদেশ দ্বারা অর্থায়ন এনটাইটেলমেন্ট সময়ের জন্য মূল্য ধাপ।
এনামস | |
---|---|
OFFER_PHASE_UNSPECIFIED | অফার ফেজ অনির্দিষ্ট. এই মান ব্যবহার করা হয় না. |
BASE | অর্ডার একটি বেস মূল্য সময়কাল তহবিল. |
INTRODUCTORY | অর্ডার একটি পরিচায়ক মূল্য সময়কাল তহবিল. |
FREE_TRIAL | অর্ডার একটি বিনামূল্যে ট্রায়াল সময় তহবিল. |
PaidApp বিস্তারিত
এই ধরনের কোন ক্ষেত্র নেই.
একটি প্রদত্ত অ্যাপ ক্রয়ের বিশদ বিবরণ৷
অর্ডার ইতিহাস
ইভেন্ট সম্পর্কে বিশদ বিবরণ যা অর্ডার পরিবর্তন করেছে৷
JSON প্রতিনিধিত্ব |
---|
{ "partialRefundEvents": [ { object ( |
ক্ষেত্র | |
---|---|
partialRefundEvents[] | এই অর্ডারের জন্য আংশিক রিফান্ড ইভেন্টের বিবরণ। |
processedEvent | অর্ডারটি কখন প্রক্রিয়া করা হয়েছিল তার বিশদ। |
cancellationEvent | কখন অর্ডার বাতিল করা হয়েছে তার বিশদ বিবরণ। |
refundEvent | অর্ডার সম্পূর্ণরূপে ফেরত দেওয়া হয়েছে যখন বিশদ. |
প্রক্রিয়াকৃত ইভেন্ট
অর্ডারটি কখন প্রক্রিয়া করা হয়েছিল তার বিশদ।
JSON প্রতিনিধিত্ব |
---|
{ "eventTime": string } |
ক্ষেত্র | |
---|---|
eventTime | যে সময় অর্ডারটি প্রসেস করা হয়েছিল। RFC 3339 ব্যবহার করে, যেখানে উৎপন্ন আউটপুট সর্বদা Z-সাধারণ করা হবে এবং 0, 3, 6 বা 9 ভগ্নাংশ সংখ্যা ব্যবহার করে। "Z" ব্যতীত অন্যান্য অফসেটগুলিও গ্রহণ করা হয়। উদাহরণ: |
বাতিলকরণ ইভেন্ট
কখন অর্ডার বাতিল করা হয়েছে তার বিশদ বিবরণ।
JSON প্রতিনিধিত্ব |
---|
{ "eventTime": string } |
ক্ষেত্র | |
---|---|
eventTime | যে সময় অর্ডার বাতিল করা হয়েছিল। RFC 3339 ব্যবহার করে, যেখানে উৎপন্ন আউটপুট সর্বদা Z-সাধারণ করা হবে এবং 0, 3, 6 বা 9 ভগ্নাংশ সংখ্যা ব্যবহার করে। "Z" ব্যতীত অন্যান্য অফসেটগুলিও গ্রহণ করা হয়। উদাহরণ: |
রিফান্ড ইভেন্ট
অর্ডার সম্পূর্ণরূপে ফেরত দেওয়া হয়েছে যখন বিশদ.
JSON প্রতিনিধিত্ব |
---|
{ "eventTime": string, "refundDetails": { object ( |
ক্ষেত্র | |
---|---|
eventTime | অর্ডার সম্পূর্ণরূপে ফেরত দেওয়ার সময়। RFC 3339 ব্যবহার করে, যেখানে উৎপন্ন আউটপুট সর্বদা Z-সাধারণ করা হবে এবং 0, 3, 6 বা 9 ভগ্নাংশ সংখ্যা ব্যবহার করে। "Z" ব্যতীত অন্যান্য অফসেটগুলিও গ্রহণ করা হয়। উদাহরণ: |
refundDetails | সম্পূর্ণ ফেরতের জন্য বিশদ বিবরণ। |
refundReason | যে কারণে অর্ডারটি ফেরত দেওয়া হয়েছে। |
ফেরতের বিবরণ
আংশিক বা সম্পূর্ণ ফেরতের জন্য বিশদ বিবরণ।
JSON প্রতিনিধিত্ব |
---|
{ "total": { object ( |
ক্ষেত্র | |
---|---|
total | ট্যাক্স সহ ফেরত দেওয়া মোট পরিমাণ। |
tax | ফেরত দেওয়া ট্যাক্সের পরিমাণ। |
ফেরতের কারণ
যে কারণে অর্ডারটি ফেরত দেওয়া হয়েছে।
এনামস | |
---|---|
REFUND_REASON_UNSPECIFIED | orders.refund কারণ অনির্দিষ্ট. এই মান ব্যবহার করা হয় না. |
OTHER | এখানে তালিকাভুক্ত কারণ ব্যতীত অন্য কোনো কারণে অর্ডারটি ফেরত দেওয়া হয়েছে৷ |
CHARGEBACK | আদেশ ফেরত চার্জ করা হয়. |
আংশিক রিফান্ড ইভেন্ট
এই অর্ডারের জন্য আংশিক রিফান্ড ইভেন্টের বিবরণ।
JSON প্রতিনিধিত্ব |
---|
{ "createTime": string, "processTime": string, "state": enum ( |
ক্ষেত্র | |
---|---|
createTime | যে সময় আংশিক ফেরত তৈরি করা হয়েছিল। RFC 3339 ব্যবহার করে, যেখানে উৎপন্ন আউটপুট সর্বদা Z-সাধারণ করা হবে এবং 0, 3, 6 বা 9 ভগ্নাংশ সংখ্যা ব্যবহার করে। "Z" ব্যতীত অন্যান্য অফসেটগুলিও গ্রহণ করা হয়। উদাহরণ: |
processTime | যে সময় আংশিক ফেরত প্রক্রিয়া করা হয়েছিল। RFC 3339 ব্যবহার করে, যেখানে উৎপন্ন আউটপুট সর্বদা Z-সাধারণ করা হবে এবং 0, 3, 6 বা 9 ভগ্নাংশ সংখ্যা ব্যবহার করে। "Z" ব্যতীত অন্যান্য অফসেটগুলিও গ্রহণ করা হয়। উদাহরণ: |
state | আংশিক ফেরতের অবস্থা। |
refundDetails | আংশিক ফেরত জন্য বিশদ. |
রাজ্য
আংশিক ফেরতের অবস্থা।
এনামস | |
---|---|
STATE_UNSPECIFIED | রাজ্য অনির্দিষ্ট. এই মান ব্যবহার করা হয় না. |
PENDING | আংশিক ফেরত তৈরি করা হয়েছে, কিন্তু এখনও প্রক্রিয়া করা হয়নি. |
PROCESSED_SUCCESSFULLY | আংশিক ফেরত সফলভাবে প্রক্রিয়া করা হয়েছে. |
পয়েন্টের বিবরণ
কোনো অর্ডারে প্রয়োগ করা যেকোনো Play Points সম্পর্কিত বিশদ বিবরণ।
JSON প্রতিনিধিত্ব |
---|
{
"pointsOfferId": string,
"pointsCouponValue": {
object ( |
ক্ষেত্র | |
---|---|
pointsOfferId | এই অর্ডারের জন্য ব্যবহার করা প্লে পয়েন্ট অফারের জন্য অনন্য আইডি। |
pointsCouponValue | একটি Play Points কুপনের আর্থিক মূল্য। এটি কুপন প্রদান করে ডিসকাউন্ট, যা মোট পরিমাণ নাও হতে পারে। Play Points কুপন ব্যবহার করা হলে শুধুমাত্র সেট করুন। যেমন $2 কুপনের জন্য 100 পয়েন্টের জন্য, এটি হল $2। |
pointsDiscountRateMicros | Play Points প্রমোশন যে শতাংশ হারে খরচ কমিয়ে দেয়। যেমন $2 কুপনের জন্য 100 পয়েন্টের জন্য, এটি হল 500,000৷ যেহেতু $2 এর আনুমানিক 200 পয়েন্ট আছে, কিন্তু প্রকৃত পয়েন্ট প্রয়োজন, 100, এর 50%, এবং মাইক্রোতে 50% হল 500,000। 0 থেকে 1,000,000 এর মধ্যে। |
pointsSpent | এই ক্রমে প্রয়োগ করা প্লে পয়েন্টের সংখ্যা। যেমন $2 কুপনের জন্য 100 পয়েন্টের জন্য, এটি হল 100। বেস অফার সহ স্তুপীকৃত কুপনের জন্য, এটি উভয় জুড়ে ব্যয় করা মোট পয়েন্ট। |
পদ্ধতি | |
---|---|
| অর্ডারের তালিকার জন্য অর্ডারের বিবরণ পান। |
| একক অর্ডারের জন্য অর্ডারের বিবরণ পান। |
| ব্যবহারকারীর সাবস্ক্রিপশন বা ইন-অ্যাপ ক্রয় অর্ডার ফেরত দেয়। |