REST Resource: monetization.onetimeproducts.purchaseOptions.offers

সম্পদ: OneTimeProductOffer

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

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 )

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

regionsVersion

object ( RegionsVersion )

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

ইউনিয়ন ক্ষেত্র offer_type । এই অফারের ধরন। ঠিক একটি সেট করা আবশ্যক. offer_type নিম্নলিখিতগুলির মধ্যে একটি হতে পারে:
preOrderOffer

object ( OneTimeProductPreOrderOffer )

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

discountedOffer

object ( OneTimeProductDiscountedOffer )

একটি ডিসকাউন্ট অফার.

রাজ্য

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

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

OneTimeProductPreOrderOffer

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

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 প্রি-অর্ডারের পরে যে কোনও দামের পরিবর্তন ঘটতে পারে না কেন, ক্রেতা তার প্রি-অর্ডার করা দামের সমান দাম পাবেন।

OneTimeProduct DiscountedOffer

ডিসকাউন্ট অফার নির্দিষ্ট কনফিগারেশন.

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 তে সেট করা হয়, সীমাহীন অফার রিডিমশনের জন্য অনুমতি দেয়। অন্যথায় অবশ্যই 1 থেকে 50 এর মধ্যে একটি সংখ্যা হতে হবে।

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

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

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 )

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

ইউনিয়ন ক্ষেত্রের price_override । এই অফারের দাম ওভাররাইড। ঠিক একটি সেট করা আবশ্যক. price_override নিম্নলিখিতগুলির মধ্যে একটি হতে পারে:
noOverride

object ( OneTimeProductOfferNoPriceOverrideOptions )

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

relativeDiscount

number

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

absoluteDiscount

object ( Money )

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

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

OneTimeProductOfferNoPriceOverrideOptions

এই ধরনের কোন ক্ষেত্র নেই.

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

প্রাপ্যতা

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

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

পদ্ধতি

activate

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

batchDelete

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

batchGet

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

batchUpdate

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

batchUpdateStates

 এক-কালীন পণ্য অফার রাজ্যগুলির একটি ব্যাচ আপডেট করে৷

cancel

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

deactivate

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

list

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