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 कस्टम टैग की सूची. इसे Play Billing Library के ज़रिए ऐप्लिकेशन को वापस भेजा जाता है. इस प्रॉडक्ट की खरीदारी के विकल्पों और ऑफ़र को भी Play Billing Library में ये टैग मिलेंगे.
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

ज़रूरी है. उस देश/इलाके का कोड जिस पर यह कॉन्फ़िगरेशन लागू होता है.इसे 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), और हाइफ़न (-) ही शामिल किए जा सकते हैं. इसमें ज़्यादा से ज़्यादा 63 वर्ण हो सकते हैं.
state

enum (State)

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

object (RegionalPricingAndAvailabilityConfig)

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

object (OneTimeProductPurchaseOptionNewRegionsConfig)

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

object (OfferTag)

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

OneTimeProductPurchaseOptionNewRegionsConfig

उन नए देशों/इलाकों के लिए कीमत की जानकारी जहां आने वाले समय में Google 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 इस कॉन्फ़िगरेशन का इस्तेमाल उन सभी नए देशों/इलाकों के लिए किया जाएगा जहां आने वाले समय में Google Play पर आपका ऐप्लिकेशन उपलब्ध हो सकता है.
NO_LONGER_AVAILABLE यह कॉन्फ़िगरेशन अब उपलब्ध नहीं है. साथ ही, इसे उन नए देशों/इलाकों के लिए इस्तेमाल नहीं किया जाएगा जहां आने वाले समय में Google Play पर आपका ऐप्लिकेशन उपलब्ध हो सकता है. इस वैल्यू का इस्तेमाल सिर्फ़ तब किया जा सकता है, जब खरीदारी के लिए उपलब्धता को पहले AVAILABLE के तौर पर सेट किया गया हो.

PurchaseOptionTaxAndComplianceSettings

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

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

enum (WithdrawalRightType)

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

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

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

तरीके

batchDelete

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

batchGet

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

batchUpdate

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

delete

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

get

 यह वन-टाइम प्रॉडक्ट की जानकारी ऐक्सेस करता है.

list

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

patch

 वन-टाइम प्रॉडक्ट बनाता है या उसे अपडेट करता है.

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

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

गड़बड़ी का कोड कारण ब्यौरा रिज़ॉल्यूशन