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)

ज़रूरी है. स्थानीय भाषा में टाइटल और ब्यौरे का डेटा सेट. एक ही भाषा कोड के लिए डुप्लीकेट एंट्री नहीं होनी चाहिए.
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,
  "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

ज़रूरी है. यह कॉन्फ़िगरेशन जिस क्षेत्र पर लागू होता है उसका कोड.यह कोड, आईएसओ 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

ज़रूरी है. उपयोगकर्ता के पास एनटाइटलमेंट कितने समय तक रहेगा. खरीदारी की प्रोसेस पूरी होने पर शुरू होता है. आईएसओ 8601 फ़ॉर्मैट में तय किया गया है.
expirationPeriod

string

ज़रूरी नहीं. एनटाइटलमेंट का इस्तेमाल शुरू करने के बाद, उपयोगकर्ता के पास इसे रद्द किए जाने से पहले कितना समय होता है. आईएसओ 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 शुरुआत में, खरीदारी का विकल्प उपलब्ध नहीं होता है. हालांकि, पहले से ऑर्डर करने के लिए रिलीज़ किए गए ऑफ़र के ज़रिए इसे उपलब्ध कराया जाता है.
AVAILABLE_FOR_OFFERS_ONLY खरीदारी का विकल्प उपलब्ध नहीं है, लेकिन इससे जुड़े ऑफ़र (जैसे, Play Points का ऑफ़र) उपलब्ध हैं.

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

 इस फ़ंक्शन का इस्तेमाल करके, वन-टाइम प्रॉडक्ट बनाया या अपडेट किया जा सकता है.

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

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

गड़बड़ी का कोड कारण ब्यौरा रिज़ॉल्यूशन
400 invalidValue अनुरोध में अमान्य वैल्यू दी गई है. आम तौर पर, यह गड़बड़ी तब दिखती है, जब खरीदारी का टोकन गलत हो या मान्य न हो. एपीआई के रेफ़रंस के आधार पर, अनुरोध के मुख्य हिस्से या पैरामीटर में मौजूद फ़ील्ड की अमान्य वैल्यू को ठीक करें.
400 required अनुरोध में कोई ज़रूरी फ़ील्ड या पैरामीटर मौजूद नहीं है. एपीआई के दस्तावेज़ देखें और पक्का करें कि सभी ज़रूरी फ़ील्ड और पैरामीटर शामिल किए गए हों.
403 userInsufficientPermission अनुरोध की गई कार्रवाई को पूरा करने के लिए, उपयोगकर्ता के पास ज़रूरी अनुमति नहीं है. पक्का करें कि पुष्टि किए गए उपयोगकर्ता के पास, Google Play Console में ज़रूरी अनुमतियां हों. ज़्यादा जानकारी के लिए, सेवा खाते का इस्तेमाल करना लेख पढ़ें.
404 notFound अनुरोध किया गया संसाधन नहीं मिला. पुष्टि करें कि आइडेंटिफ़ायर (जैसे, खरीदारी का टोकन, पैकेज का नाम, प्रॉडक्ट आईडी, सदस्यता आईडी) सही हैं.
409 concurrentUpdate किसी ऐसे ऑब्जेक्ट को अपडेट करने की कोशिश की गई जिसे एक साथ अपडेट किया जा रहा है. एक्स्पोनेंशियल बैकऑफ़ के साथ अनुरोध को फिर से भेजें. एक ही संसाधन में एक साथ कई बदलाव न करें.
5xx Generic error Google Play सर्वर में सामान्य गड़बड़ी. अनुरोध को फिर से भेजें.

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