REST Resource: monetization.onetimeproducts

রিসোর্স: OneTimeProduct

কোনও অ্যাপের জন্য একটি এককালীন প্রোডাক্ট।

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), ছোট হাতের অক্ষর (a-z), আন্ডারস্কোর (_) এবং পিরিয়ড (.) থাকতে পারে।

listings[]

object (OneTimeProductListing)

প্রয়োজনীয়। লোকালাইজ করা শীর্ষক ও বিবরণের ডেটার সেট। একই languageCode-এর ডুপ্লিকেট এন্ট্রি থাকলে চলবে না।

taxAndComplianceSettings

object (OneTimeProductTaxAndComplianceSettings)

ট্যাক্স ও আইন মেনে চলা সংক্রান্ত বিবরণ।

purchaseOptions[]

object (OneTimeProductPurchaseOption)

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

restrictedPaymentCountries

object (RestrictedPaymentCountries)

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

offerTags[]

object (OfferTag)

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

regionsVersion

object (RegionsVersion)

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

OneTimeProductListing

এককালীন প্রোডাক্টের জন্য আঞ্চলিক স্টোর লিস্টিং।

JSON উপস্থাপনা
{
  "languageCode": string,
  "title": string,
  "description": string
}
ফিল্ড
languageCode

string

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

title

string

প্রয়োজনীয়। এই লিস্টিংয়ের ভাষায় এই প্রোডাক্টের নাম। এটি ৫৫টি অক্ষরের মধ্যে লিখতে হবে।

description

string

প্রয়োজনীয়। এই তালিকার ভাষায় এই প্রোডাক্টের বিবরণ। এটি ২০০টি অক্ষরের মধ্যে লিখতে হবে।

OneTimeProductTaxAndComplianceSettings

এককালীন প্রোডাক্টের ক্ষেত্রে ট্যাক্স, Google Play নীতি ও আইন মেনে চলা সংক্রান্ত বিবরণ।

JSON উপস্থাপনা
{
  "regionalTaxConfigs": [
    {
      object (RegionalTaxConfig)
    }
  ],
  "isTokenizedDigitalAsset": boolean,
  "regionalProductAgeRatingInfos": [
    {
      object (RegionalProductAgeRatingInfo)
    }
  ],
  "productTaxCategoryCode": string
}
ফিল্ড
regionalTaxConfigs[]

object (RegionalTaxConfig)

আঞ্চলিক ট্যাক্স কনফিগারেশন।

isTokenizedDigitalAsset

boolean

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

regionalProductAgeRatingInfos[]

object (RegionalProductAgeRatingInfo)

অঞ্চল ভিত্তিক বয়স রেটিং সংক্রান্ত তথ্য। বর্তমানে এই ফিল্ডটি শুধুমাত্র অঞ্চল কোড US-এর জন্য কাজ করে।

productTaxCategoryCode

string

এককালীন প্রোডাক্টে অ্যাসাইন করার জন্য প্রোডাক্ট ট্যাক্স ক্যাটেগরি কোড। প্রোডাক্টের ট্যাক্স ক্যাটেগরি থেকে জানা যাবে যে প্রোডাক্টের উপর ট্রানজ্যাকশন ট্যাক্স রেট কোন হারে ধার্য হবে। আরও তথ্যের জন্য সহায়তা কেন্দ্রের নিবন্ধ দেখুন।

RegionalTaxConfig

প্রদত্ত ভৌগোলিক অঞ্চলে ট্যাক্সেশন সংক্রান্ত বিবরণ।

JSON উপস্থাপনা
{
  "regionCode": string,
  "taxTier": enum (TaxTier),
  "eligibleForStreamingServiceTaxRate": boolean,
  "streamingTaxType": enum (StreamingTaxType)
}
ফিল্ড
regionCode

string

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

taxTier

enum (TaxTier)

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

আরও জানুন।

eligibleForStreamingServiceTaxRate

boolean

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

streamingTaxType

enum (StreamingTaxType)

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

আরও জানুন।

OneTimeProductPurchaseOption

এককালীন প্রোডাক্টের জন্য একটি কেনাকাটার বিকল্প।

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

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "buyOption": {
    object (OneTimeProductBuyPurchaseOption)
  },
  "rentOption": {
    object (OneTimeProductRentPurchaseOption)
  }
  // End of mutually exclusive fields.
}
ফিল্ড
purchaseOptionId

string

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

state

enum (State)

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

regionalPricingAndAvailabilityConfigs[]

object (RegionalPricingAndAvailabilityConfig)

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

newRegionsConfig

object (OneTimeProductPurchaseOptionNewRegionsConfig)

ভবিষ্যতে Play লঞ্চ করতে পারে এমন যেকোনও নতুন লোকেশনের জন্য দাম সংক্রান্ত তথ্য। বাদ দেওয়া হলে, ভবিষ্যতে Play লঞ্চ করতে পারে এমন কোনও নতুন লোকেশনে কেনাকাটার বিকল্প অটোমেটিক উপলভ্য হবে না।

offerTags[]

object (OfferTag)

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

taxAndComplianceSettings

object (PurchaseOptionTaxAndComplianceSettings)

ঐচ্ছিক। ট্যাক্স ও আইন মেনে চলা সংক্রান্ত বিবরণ।

এই কেনাকাটার বিকল্পের ধরন। ঠিক একটি সেট করতে হবে। নিচে পারস্পরিকভাবে এক্সক্লুসিভ ফিল্ডের তালিকা দেওয়া হল। উত্তরে সর্বাধিক একটি ফিল্ড সেট করা হবে:
buyOption

object (OneTimeProductBuyPurchaseOption)

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

rentOption

object (OneTimeProductRentPurchaseOption)

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

মিউচুয়ালি এক্সক্লুসিভ ফিল্ডের শেষ।

রাজ্য

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

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

OneTimeProductBuyPurchaseOption

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

JSON উপস্থাপনা
{
  "legacyCompatible": boolean,
  "multiQuantityEnabled": boolean
}
ফিল্ড
legacyCompatible

boolean

ঐচ্ছিক। এই কেনাকাটার বিকল্পটি পুরনো PBL ফ্লোতে উপলভ্য হবে কিনা যা এককালীন প্রোডাক্ট মডেলকে সমর্থন করে না।

সর্বাধিক একটি "কিনুন" কেনাকাটার বিকল্প ব্যাকওয়ার্ড কম্প্যাটিবল হিসেবে চিহ্নিত করা যেতে পারে।

multiQuantityEnabled

boolean

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

OneTimeProductRentPurchaseOption

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

JSON উপস্থাপনা
{
  "rentalPeriod": string,
  "expirationPeriod": string
}
ফিল্ড
rentalPeriod

string

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

expirationPeriod

string

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

RegionalPricingAndAvailabilityConfig

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

JSON উপস্থাপনা
{
  "regionCode": string,
  "price": {
    object (Money)
  },
  "availability": enum (Availability)
}
ফিল্ড
regionCode

string

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

price

object (Money)

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

availability

enum (Availability)

কেনাকাটার বিকল্পের উপলভ্যতা।

উপলভ্যতা

কেনাকাটার বিকল্পের উপলভ্যতা।

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

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)

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

উপলভ্যতা

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

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

PurchaseOptionTaxAndComplianceSettings

এককালীন প্রোডাক্ট কেনার বিকল্পের জন্য ট্যাক্স, Google Play নীতি এবং আইন মেনে চলা সংক্রান্ত বিবরণ।

JSON উপস্থাপনা
{
  "withdrawalRightType": enum (WithdrawalRightType)
}
ফিল্ড
withdrawalRightType

enum (WithdrawalRightType)

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

সেট করা না থাকলে, ডিফল্ট হিসেবে WITHDRAWAL_RIGHT_DIGITAL_CONTENT সেট করা হয়।

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

পদ্ধতি

batchDelete

এক বা একাধিক এককালীন প্রোডাক্ট মুছে দেয়।

batchGet

এক বা একাধিক এককালীন প্রোডাক্ট পড়ে।

batchUpdate

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

delete

এককালীন প্রোডাক্ট মুছে দেয়।

get

একটি এককালীন প্রোডাক্ট পড়ে।

list

প্রদত্ত অ্যাপের অধীনে সমস্ত এককালীন প্রোডাক্টের তালিকা তৈরি করে।

patch

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

ত্রুটি কোড

এই রিসোর্সের অপারেশন, নিম্নলিখিত HTTP ত্রুটি কোড রিটার্ন করে:

সমস্যার কোড কারণ বিবরণ রেজোলিউশন