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)

ज़रूरी नहीं. इस वन-टाइम प्रॉडक्ट के लिए तय किए गए ज़्यादा से ज़्यादा 20 कस्टम टैग की सूची. इन्हें बिलिंग लाइब्रेरी के ज़रिए ऐप्लिकेशन को वापस भेजा जाता है. इस प्रॉडक्ट के लिए खरीदारी के विकल्पों और ऑफ़र को भी बिलिंग लाइब्रेरी में ये टैग मिलेंगे.
regionsVersion

object (RegionsVersion)

सिर्फ़ आउटपुट के लिए. क्षेत्रों के कॉन्फ़िगरेशन का वह वर्शन जिसका इस्तेमाल वन-टाइम प्रॉडक्ट जनरेट करने के लिए किया गया था.

OneTimeProductListing

वन-टाइम प्रॉडक्ट के लिए, रीजनल स्टोर पेज.

JSON के काेड में दिखाना 
{
  "languageCode": string,
  "title": string,
  "description": string
}
फ़ील्ड
languageCode

string

ज़रूरी है. BCP-47 के मुताबिक, इस लिस्टिंग की भाषा. उदाहरण के लिए, "en-US".
title

string

ज़रूरी है. इस लिस्टिंग की भाषा में इस प्रॉडक्ट का टाइटल. इसमें 55 से ज़्यादा वर्ण नहीं हो सकते.
description

string

ज़रूरी है. इस लिस्टिंग की भाषा में इस प्रॉडक्ट का ब्यौरा. इसमें ज़्यादा से ज़्यादा 200 वर्ण इस्तेमाल किए जा सकते हैं.

OneTimeProductTaxAndComplianceSettings

वन-टाइम प्रॉडक्ट के लिए, टैक्स, Google Play की नीति, और कानूनी नियमों के पालन के बारे में जानकारी.

JSON के काेड में दिखाना 
{
  "regionalTaxConfigs": [
    {
      object (RegionalTaxConfig)
    }
  ],
  "isTokenizedDigitalAsset": boolean
}
फ़ील्ड
regionalTaxConfigs[]

object (RegionalTaxConfig)

देश/इलाके के हिसाब से टैक्स कॉन्फ़िगरेशन.
isTokenizedDigitalAsset

boolean

क्या इस वन-टाइम प्रॉडक्ट को, टोकन के तौर पर मौजूद डिजिटल ऐसेट के तौर पर दिखाया गया है.

RegionalTaxConfig

किसी भौगोलिक क्षेत्र में टैक्स से जुड़ी जानकारी.

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)

अमेरिका में कम्यूनिकेशन या मनोरंजन सेवाओं पर लगने वाले टैक्स इकट्ठा करने के लिए, टैक्स की सही कैटगरी चुनें.

ज़्यादा जानें.

OneTimeProductPurchaseOption

वन-टाइम प्रॉडक्ट के लिए, खरीदारी का एक विकल्प.

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

ज़रूरी है. इम्यूटेबल. खरीदारी के इस विकल्प का यूनीक आइडेंटिफ़ायर. वन-टाइम प्रॉडक्ट के लिए, यह यूनीक होना चाहिए. यह किसी संख्या या अंग्रेज़ी के छोटे अक्षर से शुरू होना चाहिए. इसमें सिर्फ़ अंग्रेज़ी के छोटे अक्षर (a-z), संख्याएं (0-9), और हाइफ़न (-) शामिल हो सकते हैं. इसकी लंबाई ज़्यादा से ज़्यादा 63 वर्ण होनी चाहिए.
state

enum (State)

सिर्फ़ आउटपुट के लिए. खरीदारी के विकल्प की स्थिति. जैसे, यह चालू है या नहीं. संसाधन को अपडेट करके, इस फ़ील्ड में बदलाव नहीं किया जा सकता. इसके बजाय, खास एंडपॉइंट का इस्तेमाल करें.
regionalPricingAndAvailabilityConfigs[]

object (RegionalPricingAndAvailabilityConfig)

खरीदारी के इस विकल्प के लिए, क्षेत्र के हिसाब से कीमत और उपलब्धता की जानकारी.
newRegionsConfig

object (OneTimeProductPurchaseOptionNewRegionsConfig)

उन नई जगहों के लिए कीमत की जानकारी जहां Play आने वाले समय में लॉन्च हो सकता है. अगर इसे शामिल नहीं किया जाता है, तो खरीदारी का विकल्प उन नए देशों/इलाकों में अपने-आप उपलब्ध नहीं होगा जहां Play आने वाले समय में लॉन्च हो सकता है.
offerTags[]

object (OfferTag)

ज़रूरी नहीं. इस खरीदारी के विकल्प के लिए तय किए गए ज़्यादा से ज़्यादा 20 कस्टम टैग की सूची. इन्हें बिलिंग लाइब्रेरी के ज़रिए ऐप्लिकेशन को वापस भेजा जाता है. इस खरीदारी के विकल्प के लिए उपलब्ध ऑफ़र को भी बिलिंग लाइब्रेरी में ये टैग मिलेंगे.
taxAndComplianceSettings

object (PurchaseOptionTaxAndComplianceSettings)

ज़रूरी नहीं. टैक्स और कानूनी नियमों के पालन के बारे में जानकारी.
यूनियन फ़ील्ड purchase_option_type. यह प्रॉपर्टी बताती है कि खरीदारी का यह विकल्प किस तरह का है. इनमें से किसी एक को सेट करना ज़रूरी है. purchase_option_type इनमें से सिर्फ़ एक हो सकता है:
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-2 के हिसाब से तय किया जाता है. उदाहरण के लिए, "US".
price

object (Money)

बताए गए देश/इलाके में खरीदारी के विकल्प की कीमत. इसे उस मुद्रा में सेट किया जाना चाहिए जो बताए गए क्षेत्र से लिंक है.
availability

enum (Availability)

खरीदारी के विकल्प की उपलब्धता.

उपलब्धता

खरीदारी के विकल्प की उपलब्धता.

Enums
AVAILABILITY_UNSPECIFIED उपलब्धता की जानकारी नहीं दी गई है. इसका इस्तेमाल नहीं किया जाना चाहिए.
AVAILABLE खरीदारी का विकल्प, लोगों के लिए उपलब्ध है.
NO_LONGER_AVAILABLE खरीदारी का विकल्प अब लोगों के लिए उपलब्ध नहीं है. इस वैल्यू का इस्तेमाल सिर्फ़ तब किया जा सकता है, जब उपलब्धता को पहले AVAILABLE के तौर पर सेट किया गया हो.
AVAILABLE_IF_RELEASED शुरुआत में, खरीदारी का विकल्प उपलब्ध नहीं होता है. हालांकि, पहले से ऑर्डर करने के लिए रिलीज़ किए गए ऑफ़र के ज़रिए इसे उपलब्ध कराया जाता है.

OneTimeProductPurchaseOptionNewRegionsConfig

उन नए देशों/इलाकों के लिए कीमत की जानकारी जहां Play आने वाले समय में लॉन्च हो सकता है.

JSON के काेड में दिखाना 
{
  "usdPrice": {
    object (Money)
  },
  "eurPrice": {
    object (Money)
  },
  "availability": enum (Availability)
}
फ़ील्ड
usdPrice

object (Money)

ज़रूरी है. Play जिन नए देशों/इलाकों में लॉन्च हो सकता है वहां इस्तेमाल करने के लिए, डॉलर में कीमत.
eurPrice

object (Money)

ज़रूरी है. Play जिन नए देशों/इलाकों में लॉन्च हो सकता है वहां इस्तेमाल करने के लिए, यूरो में कीमत.
availability

enum (Availability)

ज़रूरी है. नए क्षेत्रों के कॉन्फ़िगरेशन के लिए, क्षेत्र के हिसाब से प्रॉडक्ट की उपलब्धता की जानकारी. 'उपलब्ध है' पर सेट होने पर, कीमत की जानकारी का इस्तेमाल उन नए देशों/इलाकों के लिए किया जाएगा जहां Play आने वाले समय में लॉन्च हो सकता है.

उपलब्धता

नए क्षेत्रों के कॉन्फ़िगरेशन की उपलब्धता.

Enums
AVAILABILITY_UNSPECIFIED उपलब्धता की जानकारी नहीं दी गई है. इसका इस्तेमाल नहीं किया जाना चाहिए.
AVAILABLE इस कॉन्फ़िगरेशन का इस्तेमाल उन सभी नए देशों/इलाकों के लिए किया जाएगा जहां आने वाले समय में Play को लॉन्च किया जा सकता है.
NO_LONGER_AVAILABLE यह कॉन्फ़िगरेशन अब उपलब्ध नहीं है. साथ ही, इसका इस्तेमाल उन नए देशों/इलाकों के लिए नहीं किया जाएगा जहां आने वाले समय में Play लॉन्च हो सकता है. इस वैल्यू का इस्तेमाल सिर्फ़ तब किया जा सकता है, जब उपलब्धता को पहले AVAILABLE के तौर पर सेट किया गया हो.

PurchaseOptionTaxAndComplianceSettings

वन-टाइम प्रॉडक्ट खरीदने के विकल्पों के लिए, टैक्स, Google Play की नीति, और कानूनी नियमों के पालन के बारे में जानकारी.

JSON के काेड में दिखाना 
{
  "withdrawalRightType": enum (WithdrawalRightType)
}
फ़ील्ड
withdrawalRightType

enum (WithdrawalRightType)

ज़रूरी नहीं. ज़रूरी शर्तें पूरी करने वाले देशों/इलाकों में रहने वाले लोगों के लिए उपलब्ध कराए गए प्रॉडक्ट को डिजिटल कॉन्टेंट या सेवा के तौर पर कैटगरी में बांटना.

अगर इसे सेट नहीं किया जाता है, तो डिफ़ॉल्ट रूप से WITHDRAWAL_RIGHT_DIGITAL_CONTENT लागू हो जाती है.

ज़्यादा जानकारी के लिए, सहायता केंद्र का लेख पढ़ें.

तरीके

batchDelete

 एक या उससे ज़्यादा वन-टाइम प्रॉडक्ट मिटाता है.

batchGet

 यह कुकी, एक या उससे ज़्यादा वन-टाइम प्रॉडक्ट को पढ़ती है.

batchUpdate

 इससे एक या उससे ज़्यादा वन-टाइम प्रॉडक्ट बनाए या अपडेट किए जाते हैं.

delete

 यह कुकी, वन-टाइम प्रॉडक्ट को मिटाती है.

get

 यह कुकी, एक बार इस्तेमाल किया जा सकने वाला प्रॉडक्ट पढ़ती है.

list

 यह किसी ऐप्लिकेशन के सभी वन-टाइम प्रॉडक्ट की सूची बनाता है.

patch

 इस तरीके का इस्तेमाल, वन-टाइम प्रॉडक्ट बनाने या उसे अपडेट करने के लिए किया जाता है.

गड़बड़ी के कोड

इस संसाधन के ऑपरेशन, यहां दिए गए एचटीटीपी गड़बड़ी कोड दिखाते हैं:

गड़बड़ी का कोड कारण रिज़ॉल्यूशन
5xx Google Play सर्वर में सामान्य गड़बड़ी. अनुरोध को फिर से भेजें.

अगर समस्या बनी रहती है, तो अपने Google Play खाता मैनेजर से संपर्क करें या सहायता का अनुरोध सबमिट करें. अगर आपको किसी समस्या के बारे में पहले से पता है, तो Play का स्टेटस डैशबोर्ड देखें.
409 एक साथ कई अपडेट करने पर गड़बड़ी हुई.

किसी ऐसे ऑब्जेक्ट को अपडेट करने की कोशिश की गई जिसे पहले से ही अपडेट किया जा रहा है. उदाहरण के लिए, Play Billing Library के acknowledgePurchase() तरीके को कॉल करके और Play Developer API के purchases.products.acknowledge को एक साथ कॉल करके, खरीदारी की पुष्टि की जा रही है.

 अनुरोध को फिर से भेजें.