REST Resource: monetization.onetimeproducts

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

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

JSON উপস্থাপনা 
{
  "packageName": string,
  "productId": string,
  "listings": [
    {
      object (OneTimeProductListing)
    }
  ],
  "taxAndComplianceSettings": {
    object (OneTimeProductTaxAndComplianceSettings)
  },
  "purchaseOptions": [
    {
      object (OneTimeProductPurchaseOption)
    }
  ],
  "restrictedPaymentCountries": {
    object (RestrictedPaymentCountries)
  },
  "offerTags": [
    {
      object (OfferTag)
    }
  ],
  "regionsVersion": {
    object (RegionsVersion)
  }
}
ক্ষেত্র
packageName

string

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

productId

string

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

listings[]

object ( OneTimeProductListing )

প্রয়োজনীয়। স্থানীয়করণকৃত শিরোনাম এবং বর্ণনা ডেটার সেট। একই ভাষা কোড সহ ডুপ্লিকেট এন্ট্রি থাকা উচিত নয়।

taxAndComplianceSettings

object ( OneTimeProductTaxAndComplianceSettings )

কর এবং আইনি সম্মতি সম্পর্কে বিশদ বিবরণ।

purchaseOptions[]

object ( OneTimeProductPurchaseOption )

প্রয়োজনীয়। এই এককালীন পণ্যের জন্য ক্রয়ের বিকল্পগুলির সেট।

restrictedPaymentCountries

object ( RestrictedPaymentCountries )

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

offerTags[]

object ( OfferTag )

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

regionsVersion

object ( RegionsVersion )

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

ওয়ানটাইমপ্রোডাক্টলিস্টিং

এককালীন পণ্যের জন্য আঞ্চলিক দোকানের তালিকা।

JSON উপস্থাপনা 
{
  "languageCode": string,
  "title": string,
  "description": string
}
ক্ষেত্র
languageCode

string

প্রয়োজনীয়। এই তালিকার ভাষা, BCP-47 দ্বারা সংজ্ঞায়িত, যেমন, "en-US"।

title

string

প্রয়োজনীয়। এই তালিকার ভাষায় এই পণ্যের শিরোনাম। সর্বোচ্চ দৈর্ঘ্য ৫৫ অক্ষর।

description

string

প্রয়োজনীয়। এই তালিকার ভাষায় এই পণ্যের বর্ণনা। সর্বাধিক দৈর্ঘ্য ২০০ অক্ষর।

ওয়ানটাইমপ্রোডাক্টট্যাক্সএবংসম্মতিসেটিংস

এককালীন পণ্যের জন্য কর, গুগল প্লে নীতি এবং আইনি সম্মতি সম্পর্কে বিশদ বিবরণ।

JSON উপস্থাপনা 
{
  "regionalTaxConfigs": [
    {
      object (RegionalTaxConfig)
    }
  ],
  "isTokenizedDigitalAsset": boolean
}
ক্ষেত্র
regionalTaxConfigs[]

object ( RegionalTaxConfig )

আঞ্চলিক কর বিন্যাস।

isTokenizedDigitalAsset

boolean

এই এককালীন পণ্যটিকে টোকেনাইজড ডিজিটাল সম্পদের প্রতিনিধিত্বকারী পণ্য হিসেবে ঘোষণা করা হবে কিনা।

রিজিওনালট্যাক্সকনফিগ

একটি নির্দিষ্ট ভৌগোলিক অঞ্চলে কর আরোপের বিশদ বিবরণ।

JSON উপস্থাপনা 
{
  "regionCode": string,
  "taxTier": enum (TaxTier),
  "eligibleForStreamingServiceTaxRate": boolean,
  "streamingTaxType": enum (StreamingTaxType)
}
ক্ষেত্র
regionCode

string

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

taxTier

enum ( TaxTier )

হ্রাসকৃত করের হার নির্দিষ্ট করার জন্য কর স্তর। বিভিন্ন অঞ্চলে ডিজিটাল সংবাদ, ম্যাগাজিন, সংবাদপত্র, বই বা অডিওবুক বিক্রি করে এমন ডেভেলপাররা হ্রাসকৃত করের হারের জন্য যোগ্য হতে পারেন।

আরও জানুন ।

eligibleForStreamingServiceTaxRate

boolean

আপনার অ্যাপে মার্কিন যুক্তরাষ্ট্রের রাজ্য এবং স্থানীয় বিক্রয় কর সঠিকভাবে চার্জ করার জন্য স্ট্রিমিং পণ্য আছে কিনা তা আমাদের জানাতে হবে। ক্ষেত্রটি শুধুমাত্র মার্কিন যুক্তরাষ্ট্রে সমর্থিত।

streamingTaxType

enum ( StreamingTaxType )

মার্কিন যুক্তরাষ্ট্রে যোগাযোগ বা বিনোদন কর সংগ্রহ করতে, উপযুক্ত কর বিভাগটি বেছে নিন।

আরও জানুন ।

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

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

JSON উপস্থাপনা 
{
  "purchaseOptionId": string,
  "state": enum (State),
  "regionalPricingAndAvailabilityConfigs": [
    {
      object (RegionalPricingAndAvailabilityConfig)
    }
  ],
  "newRegionsConfig": {
    object (OneTimeProductPurchaseOptionNewRegionsConfig)
  },
  "offerTags": [
    {
      object (OfferTag)
    }
  ],
  "taxAndComplianceSettings": {
    object (PurchaseOptionTaxAndComplianceSettings)
  },

  // Union field purchase_option_type can be only one of the following:
  "buyOption": {
    object (OneTimeProductBuyPurchaseOption)
  },
  "rentOption": {
    object (OneTimeProductRentPurchaseOption)
  }
  // End of list of possible types for union field purchase_option_type.
}
ক্ষেত্র
purchaseOptionId

string

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

state

enum ( State )

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

regionalPricingAndAvailabilityConfigs[]

object ( RegionalPricingAndAvailabilityConfig )

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

newRegionsConfig

object ( OneTimeProductPurchaseOptionNewRegionsConfig )

ভবিষ্যতে Play-র যেকোনো নতুন অবস্থানের জন্য মূল্য নির্ধারণের তথ্য। যদি বাদ দেওয়া হয়, তাহলে ভবিষ্যতে Play-র যেকোনো নতুন অবস্থানে ক্রয়ের বিকল্পটি স্বয়ংক্রিয়ভাবে উপলব্ধ হবে না।

offerTags[]

object ( OfferTag )

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

taxAndComplianceSettings

object ( PurchaseOptionTaxAndComplianceSettings )

ঐচ্ছিক। কর এবং আইনি সম্মতি সম্পর্কে বিশদ বিবরণ।

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

object ( OneTimeProductBuyPurchaseOption )

একটি ক্রয় বিকল্প যা কেনা যায়।

rentOption

object ( OneTimeProductRentPurchaseOption )

ভাড়া নেওয়া যায় এমন একটি ক্রয়ের বিকল্প।

রাজ্য

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

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

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

একটি ক্রয় বিকল্প যা কেনা যায়।

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

boolean

ঐচ্ছিক। এই ক্রয়ের বিকল্পটি কি লিগ্যাসি PBL ফ্লোতে পাওয়া যাবে যা এককালীন পণ্য মডেল সমর্থন করে না।

সর্বাধিক একটি "কিনুন" ক্রয় বিকল্পকে বিপরীতমুখী সামঞ্জস্যপূর্ণ হিসাবে চিহ্নিত করা যেতে পারে।

multiQuantityEnabled

boolean

ঐচ্ছিক। এই ক্রয় বিকল্পটি বহু-পরিমাণে ক্রয় করার অনুমতি দেয় কিনা। বহু-পরিমাণে ক্রয়কারীকে একক চেকআউটে একাধিক আইটেম ক্রয় করার অনুমতি দেয়।

এককালীন পণ্য ভাড়া ক্রয় বিকল্প

ভাড়া নেওয়া যায় এমন একটি ক্রয়ের বিকল্প।

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

string

প্রয়োজনীয়। একজন ব্যবহারকারীর কতক্ষণের জন্য এনটাইটেলমেন্ট থাকবে। ক্রয় প্রবাহ সমাপ্তির পর থেকে শুরু হবে। ISO 8601 ফর্ম্যাটে উল্লেখ করা হয়েছে।

expirationPeriod

string

ঐচ্ছিক। এনটাইটেলমেন্ট ব্যবহার শুরু করার পর ব্যবহারকারীর কাছে এটি বাতিল করার আগে কত সময় থাকে। ISO 8601 ফর্ম্যাটে নির্দিষ্ট করা হয়েছে।

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

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

JSON উপস্থাপনা 
{
  "regionCode": string,
  "price": {
    object (Money)
  },
  "availability": enum (Availability)
}
ক্ষেত্র
regionCode

string

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

price

object ( Money )

নির্দিষ্ট অঞ্চলে ক্রয় বিকল্পের মূল্য। নির্দিষ্ট অঞ্চলের সাথে সংযুক্ত মুদ্রায় সেট করতে হবে।

availability

enum ( Availability )

ক্রয় বিকল্পের প্রাপ্যতা।

উপস্থিতি

ক্রয় বিকল্পের প্রাপ্যতা।

এনামস
AVAILABILITY_UNSPECIFIED অনির্দিষ্ট প্রাপ্যতা। ব্যবহার করা উচিত নয়।
AVAILABLE ক্রয়ের বিকল্প ব্যবহারকারীদের জন্য উপলব্ধ।
NO_LONGER_AVAILABLE ব্যবহারকারীদের জন্য ক্রয়ের বিকল্পটি আর উপলব্ধ নেই। এই মানটি কেবল তখনই ব্যবহার করা যাবে যদি পূর্বে উপলব্ধতা হিসাবে সেট করা থাকে।
AVAILABLE_IF_RELEASED ক্রয়ের বিকল্পটি প্রাথমিকভাবে অনুপলব্ধ, তবে একটি প্রকাশিত প্রি-অর্ডার অফারের মাধ্যমে উপলব্ধ করা হয়েছে।
AVAILABLE_FOR_OFFERS_ONLY ক্রয়ের বিকল্পটি অনুপলব্ধ তবে এর সাথে লিঙ্ক করা অফারগুলি (যেমন প্লে পয়েন্টস অফার) উপলব্ধ।

OneTimeProductPurchaseOptionNewRegionsConfig

ভবিষ্যতে যেকোনো নতুন অঞ্চলের জন্য মূল্য নির্ধারণের তথ্য Play চালু হতে পারে।

JSON উপস্থাপনা 
{
  "usdPrice": {
    object (Money)
  },
  "eurPrice": {
    object (Money)
  },
  "availability": enum (Availability)
}
ক্ষেত্র
usdPrice

object ( Money )

প্রয়োজনীয়। Play যে কোনও নতুন অঞ্চলে লঞ্চ হতে পারে তার জন্য USD-তে মূল্য ব্যবহার করতে হবে।

eurPrice

object ( Money )

প্রয়োজনীয়। যেকোনো নতুন অঞ্চলে Play চালু হতে পারে তার জন্য EUR মূল্য ব্যবহার করতে হবে।

availability

enum ( Availability )

প্রয়োজনীয়। নতুন অঞ্চল কনফিগারেশনের জন্য আঞ্চলিক প্রাপ্যতা। AVAILABLE তে সেট করা হলে, ভবিষ্যতে Play লঞ্চ হতে পারে এমন যেকোনো নতুন অঞ্চলের জন্য মূল্যের তথ্য ব্যবহার করা হবে।

উপস্থিতি

নতুন অঞ্চল কনফিগারেশনের প্রাপ্যতা।

এনামস
AVAILABILITY_UNSPECIFIED অনির্দিষ্ট প্রাপ্যতা। ব্যবহার করা উচিত নয়।
AVAILABLE ভবিষ্যতে Play-তে যেকোনো নতুন অঞ্চল চালু হতে পারে, তার জন্য কনফিগারেশনটি ব্যবহার করা হবে।
NO_LONGER_AVAILABLE এই কনফিগারেশনটি আর উপলব্ধ নেই এবং ভবিষ্যতে Play লঞ্চ হতে পারে এমন কোনও নতুন অঞ্চলে এটি ব্যবহার করা হবে না। এই মানটি শুধুমাত্র তখনই ব্যবহার করা যেতে পারে যদি পূর্বে উপলব্ধতা হিসাবে সেট করা থাকে।

ক্রয়বিকল্পকরএবংসম্মতিসেটিংস

এককালীন পণ্য ক্রয়ের বিকল্পগুলির জন্য কর, গুগল প্লে নীতি এবং আইনি সম্মতি সম্পর্কে বিশদ বিবরণ।

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

enum ( WithdrawalRightType )

ঐচ্ছিক। যোগ্য অঞ্চলের ব্যবহারকারীদের কাছে বিতরণ করা পণ্যের জন্য ডিজিটাল সামগ্রী বা পরিষেবার শ্রেণীবিভাগ।

যদি সেট না করা থাকে, তাহলে এটি ডিফল্টভাবে WITHDRAWAL_RIGHT_DIGITAL_CONTENT এ থাকবে।

আরও তথ্যের জন্য সহায়তা কেন্দ্রের নিবন্ধটি দেখুন।

পদ্ধতি

batchDelete

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

batchGet

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

batchUpdate

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

delete

 এককালীন পণ্য মুছে ফেলে।

get

 একটি একক-এককালীন পণ্য পড়ে।

list

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

patch

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

ত্রুটি কোড

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

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

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

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

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

 আপনার অনুরোধটি আবার চেষ্টা করুন।