REST Resource: monetization.onetimeproducts.purchaseOptions.offers

রিসোর্স: ওয়ানটাইমপ্রোডাক্টঅফার

এককালীন পণ্যের জন্য একটি মাত্র অফার।

JSON উপস্থাপনা 
{
  "packageName": string,
  "productId": string,
  "purchaseOptionId": string,
  "offerId": string,
  "state": enum (State),
  "regionalPricingAndAvailabilityConfigs": [
    {
      object (RegionalPricingAndAvailabilityConfig)
    }
  ],
  "offerTags": [
    {
      object (OfferTag)
    }
  ],
  "regionsVersion": {
    object (RegionsVersion)
  },

  // Union field offer_type can be only one of the following:
  "preOrderOffer": {
    object (OneTimeProductPreOrderOffer)
  },
  "discountedOffer": {
    object (OneTimeProductDiscountedOffer)
  }
  // End of list of possible types for union field offer_type.
}
ক্ষেত্র
packageName

string

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

productId

string

প্রয়োজনীয়। অপরিবর্তনীয়। এই অফারটি যে মূল পণ্যের সাথে সম্পর্কিত তার আইডি।

purchaseOptionId

string

প্রয়োজনীয়। অপরিবর্তনীয়। এই অফারটি যে ক্রয় বিকল্পের জন্য একটি এক্সটেনশন তার আইডি।

offerId

string

প্রয়োজনীয়। অপরিবর্তনীয়। এই পণ্য অফারের আইডি। ক্রয় বিকল্পের মধ্যে অবশ্যই অনন্য হতে হবে। এটি একটি সংখ্যা বা ছোট হাতের অক্ষর দিয়ে শুরু হতে হবে এবং এতে কেবল ছোট হাতের অক্ষর (az), সংখ্যা (0-9) এবং হাইফেন (-) থাকতে পারে। সর্বাধিক দৈর্ঘ্য 63 অক্ষর।

state

enum ( State )

শুধুমাত্র আউটপুট। এই অফারের বর্তমান অবস্থা। রিসোর্স আপডেট করে এই ক্ষেত্রটি পরিবর্তন করা যাবে না। পরিবর্তে ডেডিকেটেড এন্ডপয়েন্ট ব্যবহার করুন।

regionalPricingAndAvailabilityConfigs[]

object ( RegionalPricingAndAvailabilityConfig )

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

offerTags[]

object ( OfferTag )

ঐচ্ছিক। এই অফারের জন্য নির্দিষ্ট করা সর্বাধিক ২০টি কাস্টম ট্যাগের তালিকা, এবং বিলিং লাইব্রেরির মাধ্যমে অ্যাপে ফেরত পাঠানো হয়েছে।

regionsVersion

object ( RegionsVersion )

শুধুমাত্র আউটপুট। অঞ্চল কনফিগারেশনের সংস্করণ যা এককালীন পণ্য অফার তৈরি করতে ব্যবহৃত হয়েছিল।

Union ফিল্ড offer_type । এই অফারের ধরণ। ঠিক একটি সেট করতে হবে। offer_type নিম্নলিখিতগুলির মধ্যে কেবল একটি হতে পারে:
preOrderOffer

object ( OneTimeProductPreOrderOffer )

একটি প্রি-অর্ডার অফার।

discountedOffer

object ( OneTimeProductDiscountedOffer )

একটি ছাড়ের অফার।

রাজ্য

অফারের বর্তমান অবস্থা।

এনামস
STATE_UNSPECIFIED ডিফল্ট মান, কখনও ব্যবহার করা উচিত নয়।
DRAFT এই অফারটি ব্যবহারকারীদের জন্য উপলব্ধ ছিল না এবং কখনও ছিলও না।
ACTIVE অফারটি ব্যবহারকারীদের জন্য উপলব্ধ, যতক্ষণ না এর শর্তাবলী পূরণ করা হয়।
CANCELLED এই অবস্থাটি প্রি-অর্ডারের জন্য নির্দিষ্ট। অফারটি বাতিল করা হয়েছে এবং ব্যবহারকারীদের জন্য উপলব্ধ নয়। এই অফার সম্পর্কিত সমস্ত মুলতুবি থাকা অর্ডার বাতিল করা হয়েছে।
INACTIVE এই অবস্থাটি কেবলমাত্র ছাড়যুক্ত অফারগুলির জন্য। অফারটি আর ব্যবহারকারীদের জন্য উপলব্ধ নেই।

ওয়ানটাইমপ্রোডাক্টপ্রিঅর্ডারঅফার

প্রি-অর্ডার অফারগুলির জন্য নির্দিষ্ট কনফিগারেশন।

JSON উপস্থাপনা 
{
  "startTime": string,
  "endTime": string,
  "releaseTime": string,
  "priceChangeBehavior": enum (PreOrderPriceChangeBehavior)
}
ক্ষেত্র
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" ।

endTime

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" ।

releaseTime

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" ।

priceChangeBehavior

enum ( PreOrderPriceChangeBehavior )

প্রয়োজনীয়। অপরিবর্তনীয়। মূল্য পরিবর্তন কীভাবে পূর্ব-বিদ্যমান প্রি-অর্ডারগুলিকে প্রভাবিত করে তা নির্দিষ্ট করে।

প্রি-অর্ডার মূল্য পরিবর্তন আচরণ

মূল্য পরিবর্তন কীভাবে পূর্ব-বিদ্যমান প্রি-অর্ডারগুলিকে প্রভাবিত করে তা নির্দিষ্ট করে।

এনামস
PRE_ORDER_PRICE_CHANGE_BEHAVIOR_UNSPECIFIED অনির্দিষ্ট মূল্য পরিবর্তনের আচরণ। ব্যবহার করা উচিত নয়।
PRE_ORDER_PRICE_CHANGE_BEHAVIOR_TWO_POINT_LOWEST ক্রেতাকে প্রি-অর্ডারের সময় প্রাথমিক মূল্য এবং প্রকাশের তারিখে চূড়ান্ত অফার মূল্যের মধ্যে সর্বনিম্ন চার্জ করা হবে।
PRE_ORDER_PRICE_CHANGE_BEHAVIOR_NEW_ORDERS_ONLY ক্রেতা যে দামে প্রি-অর্ডার করেছিলেন, সেই দামই পাবেন, প্রি-অর্ডারের পরে দামের কোনও পরিবর্তন ঘটুক না কেন।

এককালীন পণ্য ছাড়প্রাপ্ত অফার

ছাড়ের অফারগুলির জন্য নির্দিষ্ট কনফিগারেশন।

JSON উপস্থাপনা 
{
  "startTime": string,
  "endTime": string,
  "redemptionLimit": string
}
ক্ষেত্র
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" ।

endTime

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" ।

redemptionLimit

string ( int64 format)

ঐচ্ছিক। এই অফারটি কতবার রিডিম করা যাবে। যদি সেট না করা থাকে বা 0 তে সেট করা থাকে, তাহলে সীমাহীন অফার রিডিম করার সুযোগ রয়েছে। অন্যথায় ১ থেকে ৫০ সহ একটি সংখ্যা হতে হবে।

আঞ্চলিক মূল্য এবং উপলব্ধতা কনফিগ

এককালীন পণ্য অফারের জন্য আঞ্চলিক মূল্য এবং প্রাপ্যতা কনফিগারেশন।

JSON উপস্থাপনা 
{
  "regionCode": string,
  "availability": enum (Availability),

  // Union field price_override can be only one of the following:
  "noOverride": {
    object (OneTimeProductOfferNoPriceOverrideOptions)
  },
  "relativeDiscount": number,
  "absoluteDiscount": {
    object (Money)
  }
  // End of list of possible types for union field price_override.
}
ক্ষেত্র
regionCode

string

প্রয়োজনীয়। এই কনফিগারেশনটি প্রযোজ্য অঞ্চল কোড, যেমন ISO 3166-2 দ্বারা সংজ্ঞায়িত, যেমন, "US"।

availability

enum ( Availability )

প্রয়োজনীয়। এই অঞ্চলের জন্য প্রাপ্যতা।

Union ফিল্ড price_override । এই অফারের মূল্য ওভাররাইড। ঠিক একটি সেট করতে হবে। price_override নিম্নলিখিতগুলির মধ্যে কেবল একটি হতে পারে:
noOverride

object ( OneTimeProductOfferNoPriceOverrideOptions )

এই অঞ্চলের জন্য ক্রয় বিকল্পে নির্ধারিত মূল্য ব্যবহার করা হবে।

relativeDiscount

number

এই অফারের জন্য ব্যবহারকারী যে ক্রয় বিকল্প মূল্য প্রদান করে তার ভগ্নাংশ। উদাহরণস্বরূপ, যদি এই অঞ্চলের জন্য ক্রয় বিকল্প মূল্য $12 হয়, তাহলে 50% ছাড় $6 মূল্যের সাথে সামঞ্জস্যপূর্ণ হবে। ছাড়টি অবশ্যই 0 এর চেয়ে সম্পূর্ণ বড় এবং 1 এর চেয়ে সম্পূর্ণ ছোট ভগ্নাংশ হিসাবে নির্দিষ্ট করতে হবে। ফলস্বরূপ মূল্যটি নিকটতম বিলযোগ্য ইউনিটে পূর্ণাঙ্গ করা হবে (যেমন USD এর জন্য সেন্ট)। যদি ছাড়কৃত মূল্য এই অঞ্চলে অনুমোদিত সর্বনিম্ন মূল্যের চেয়ে কম হয় তবে আপেক্ষিক ছাড়টি অবৈধ বলে বিবেচিত হবে।

absoluteDiscount

object ( Money )

ক্রয় বিকল্পের মূল্য থেকে বিয়োগ করা ছাড়ের পরম মান।

এটি 0 এবং ক্রয় বিকল্পের মূল্যের মধ্যে হওয়া উচিত।

OneTimeProductOfferNoPriceOverrideবিকল্পগুলি

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

আঞ্চলিক মূল্য ওভাররাইড ছাড়াই এককালীন পণ্য অফারগুলির বিকল্প।

উপস্থিতি

অফারের প্রাপ্যতা।

এনামস
AVAILABILITY_UNSPECIFIED অনির্দিষ্ট প্রাপ্যতা। ব্যবহার করা উচিত নয়।
AVAILABLE অফারটি ব্যবহারকারীদের জন্য উপলব্ধ।
NO_LONGER_AVAILABLE এই অফারটি আর ব্যবহারকারীদের জন্য উপলব্ধ নেই। এই মানটি শুধুমাত্র তখনই ব্যবহার করা যাবে যদি পূর্বে উপলব্ধতা হিসাবে সেট করা থাকে।

পদ্ধতি

activate

 এককালীন পণ্য অফার সক্রিয় করে।

batchDelete

 এক বা একাধিক এককালীন পণ্য অফার মুছে ফেলে।

batchGet

 এক বা একাধিক এককালীন পণ্য অফার পড়ে।

batchUpdate

 এক বা একাধিক এককালীন পণ্য অফার তৈরি বা আপডেট করে।

batchUpdateStates

 এককালীন পণ্য অফার স্টেটের একটি ব্যাচ আপডেট করে।

cancel

 এককালীন পণ্য অফার বাতিল করে।

deactivate

 এককালীন পণ্য অফার নিষ্ক্রিয় করে।

list

 একটি প্রদত্ত অ্যাপ, পণ্য, অথবা ক্রয় বিকল্পের অধীনে সমস্ত অফার তালিকাভুক্ত করে।

ত্রুটি কোড

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

ত্রুটি কোড কারণ বিবরণ রেজোলিউশন