REST Resource: externaltransactions

संसाधन: ExternalTransaction

किसी बाहरी लेन-देन की जानकारी.

JSON के काेड में दिखाना 
{
  "packageName": string,
  "externalTransactionId": string,
  "originalPreTaxAmount": {
    object (Price)
  },
  "originalTaxAmount": {
    object (Price)
  },
  "currentPreTaxAmount": {
    object (Price)
  },
  "currentTaxAmount": {
    object (Price)
  },
  "testPurchase": {
    object (ExternalTransactionTestPurchase)
  },
  "transactionTime": string,
  "createTime": string,
  "transactionState": enum (TransactionState),
  "userTaxAddress": {
    object (ExternalTransactionAddress)
  },
  "transactionProgramCode": integer,

  // Union field transaction_type can be only one of the following:
  "oneTimeTransaction": {
    object (OneTimeExternalTransaction)
  },
  "recurringTransaction": {
    object (RecurringExternalTransaction)
  }
  // End of list of possible types for union field transaction_type.

  // Union field program_details can be only one of the following:
  "externalOfferDetails": {
    object (ExternalOfferDetails)
  }
  // End of list of possible types for union field program_details.
}
फ़ील्ड
packageName

string

सिर्फ़ आउटपुट के लिए. बाहरी लेन-देन का संसाधन नाम. उस ऐप्लिकेशन के पैकेज का नाम जिसमें ऐप्लिकेशन में खरीदने के लिए उपलब्ध प्रॉडक्ट बेचे गए थे. उदाहरण के लिए, 'com.some.app'.
externalTransactionId

string

सिर्फ़ आउटपुट के लिए. इस लेन-देन का आईडी. एक ही पैकेज के नाम वाले सभी ट्रांज़ैक्शन आईडी यूनीक होने चाहिए. बाहरी लेन-देन बनाते समय इसे सेट किया जाता है.
originalPreTaxAmount

object (Price)

ज़रूरी है. टैक्स से पहले, लेन-देन की मूल रकम. यह टैक्स से पहले की वह रकम है जिसके बारे में Google को मूल रूप से सूचना दी गई थी. यह रकम, रिफ़ंड लागू होने से पहले की है.
originalTaxAmount

object (Price)

ज़रूरी है. टैक्स की मूल रकम. यह टैक्स की वह रकम है जिसके बारे में Google को मूल रूप से सूचना दी गई थी. यह रकम, रिफ़ंड लागू होने से पहले की है.
currentPreTaxAmount

object (Price)

सिर्फ़ आउटपुट के लिए. टैक्स से पहले, लेन-देन की मौजूदा रकम. यह टैक्स से पहले की मौजूदा रकम है. इसमें इस लेन-देन पर लागू किए गए सभी रिफ़ंड शामिल हैं.
currentTaxAmount

object (Price)

सिर्फ़ आउटपुट के लिए. मौजूदा टैक्स की रकम. यह मौजूदा टैक्स की रकम है. इसमें इस लेन-देन पर लागू होने वाले रिफ़ंड भी शामिल हैं.
testPurchase

object (ExternalTransactionTestPurchase)

सिर्फ़ आउटपुट के लिए. अगर यह सेट है, तो इसका मतलब है कि यह लेन-देन, जांच के लिए की गई खरीदारी है. Google, टेस्ट लेन-देन के लिए कोई शुल्क नहीं लेगा.
transactionTime

string (Timestamp format)

ज़रूरी है. वह समय जब लेन-देन पूरा हुआ था.

यह आरएफ़सी 3339 का इस्तेमाल करता है. इसमें जनरेट किया गया आउटपुट हमेशा Z-नॉर्मलाइज़ किया जाएगा और इसमें 0, 3, 6 या 9 फ़्रैक्शनल अंक इस्तेमाल किए जाएंगे. "Z" के अलावा, अन्य ऑफ़सेट भी स्वीकार किए जाते हैं. उदाहरण: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" या "2014-10-02T15:01:23+05:30".
createTime

string (Timestamp format)

सिर्फ़ आउटपुट के लिए. इस लेन-देन को बनाए जाने का समय. यह वह समय है, जब Google को लेन-देन के बारे में सूचना दी गई थी.

यह आरएफ़सी 3339 का इस्तेमाल करता है. इसमें जनरेट किया गया आउटपुट हमेशा Z-नॉर्मलाइज़ किया जाएगा और इसमें 0, 3, 6 या 9 फ़्रैक्शनल अंक इस्तेमाल किए जाएंगे. "Z" के अलावा, अन्य ऑफ़सेट भी स्वीकार किए जाते हैं. उदाहरण: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" या "2014-10-02T15:01:23+05:30".
transactionState

enum (TransactionState)

सिर्फ़ आउटपुट के लिए. लेन-देन की मौजूदा स्थिति.
userTaxAddress

object (ExternalTransactionAddress)

ज़रूरी है. टैक्स का हिसाब लगाने के लिए उपयोगकर्ता का पता.
transactionProgramCode

integer

ज़रूरी नहीं. यह लेन-देन का प्रोग्राम कोड है. इसका इस्तेमाल, पार्टनर प्रोग्राम में शामिल होने की ज़रूरी शर्तें पूरी करने वाले ऐप्लिकेशन के लिए सेवा शुल्क तय करने में मदद करने के लिए किया जाता है. Play मीडिया एक्सपीरियंस प्रोग्राम (https://play.google.com/console/about/programs/mediaprogram/) में शामिल डेवलपर को, अन्य बिलिंग सिस्टम के लेन-देन की रिपोर्ट करते समय प्रोग्राम कोड देना होगा. अगर आप ज़रूरी शर्तें पूरी करने वाले डेवलपर हैं, तो कृपया इस फ़ील्ड को सेट करने के तरीके के बारे में ज़्यादा जानने के लिए, अपने बीडीएम से संपर्क करें. ध्यान दें: इस फ़ील्ड का इस्तेमाल, बाहरी ऑफ़र के लेन-देन के लिए नहीं किया जा सकता.
यूनियन फ़ील्ड transaction_type. किस तरह का लेन-देन किया गया. transaction_type इनमें से सिर्फ़ एक हो सकता है:
oneTimeTransaction

object (OneTimeExternalTransaction)

यह एक बार किया जाने वाला लेन-देन है और सदस्यता का हिस्सा नहीं है.
recurringTransaction

object (RecurringExternalTransaction)

यह लेन-देन, बार-बार होने वाले लेन-देन की सीरीज़ का हिस्सा है.
यूनियन फ़ील्ड program_details. प्रोग्राम के बारे में खास जानकारी, जो लेन-देन की रिपोर्टिंग के लिए ज़रूरी है. यह जानकारी सिर्फ़ उस प्रोग्राम के लिए सेट की जानी चाहिए जिससे लेन-देन जुड़ा है. program_details इनमें से सिर्फ़ एक हो सकता है:
externalOfferDetails

object (ExternalOfferDetails)

ज़रूरी नहीं. बाहरी ऑफ़र के लेन-देन की सटीक रिपोर्टिंग के लिए ज़रूरी जानकारी.

ExternalTransactionTestPurchase

इस टाइप में कोई फ़ील्ड नहीं है.

यह टेस्ट खाते का इस्तेमाल करके किए गए लेन-देन को दिखाता है. इन लेन-देन के लिए, Google आपसे कोई शुल्क नहीं लेगा.

OneTimeExternalTransaction

इसमें सिर्फ़ एक बार के लेन-देन की जानकारी दी गई है.

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

string

सिर्फ़ इनपुट के लिए. यह कॉल के दौरान उपलब्ध कराया जाता है. जब बिलिंग का दूसरा तरीका लॉन्च किया जाता है, तब क्लाइंट से यह जानकारी मिलती है.

RecurringExternalTransaction

यह एक ऐसे लेन-देन को दिखाता है जो बार-बार होने वाले पेमेंट की सीरीज़ का हिस्सा है. यह सदस्यता या एक बार खरीदा जाने वाला ऐसा प्रॉडक्ट हो सकता है जिसके लिए कई बार पेमेंट करना पड़ता है. जैसे, प्रीऑर्डर.

JSON के काेड में दिखाना 
{

  // Union field source can be only one of the following:
  "initialExternalTransactionId": string,
  "externalTransactionToken": string,
  "migratedTransactionProgram": enum (ExternalTransactionProgram)
  // End of list of possible types for union field source.

  // Union field product_details can be only one of the following:
  "externalSubscription": {
    object (ExternalSubscription)
  },
  "otherRecurringProduct": {
    object (OtherRecurringProduct)
  }
  // End of list of possible types for union field product_details.
}
फ़ील्ड

यूनियन फ़ील्ड source.

source इनमें से सिर्फ़ एक हो सकता है:
initialExternalTransactionId

string

बार-बार होने वाले लेन-देन की इस सीरीज़ के पहले लेन-देन का बाहरी लेन-देन आईडी. उदाहरण के लिए, सदस्यता के लिए यह पहले पेमेंट का लेन-देन आईडी होगा. बार-बार होने वाले बाहरी लेन-देन बनाते समय यह ज़रूरी है.
externalTransactionToken

string

सिर्फ़ इनपुट के लिए. यह कॉल के दौरान, खाता बनाने के लिए दिया जाता है. जब बिलिंग का दूसरा तरीका लॉन्च किया जाता है, तब क्लाइंट से यह जानकारी मिलती है. यह सिर्फ़ पहली बार खरीदारी करने के लिए ज़रूरी है.
migratedTransactionProgram

enum (ExternalTransactionProgram)

सिर्फ़ इनपुट के लिए. यह कॉल के दौरान, खाता बनाने के लिए दिया जाता है. इसका इस्तेमाल सिर्फ़ तब किया जाना चाहिए, जब सदस्यता को मैन्युअल तरीके से हर महीने रिपोर्ट करने से बदलकर, अपने-आप रिपोर्ट करने की सुविधा पर माइग्रेट किया जा रहा हो.
यूनियन फ़ील्ड product_details. ज़रूरी है. बार-बार होने वाले बाहरी लेन-देन में शामिल प्रॉडक्ट की जानकारी. product_details इनमें से सिर्फ़ एक हो सकता है:
externalSubscription

object (ExternalSubscription)

बाहरी सदस्यता की जानकारी.
otherRecurringProduct

object (OtherRecurringProduct)

बार-बार होने वाले बाहरी लेन-देन वाले ऐसे प्रॉडक्ट की जानकारी जो किसी अन्य कैटगरी में नहीं आता.

ExternalTransactionProgram

यह कुकी, उपयोगकर्ता को लेन-देन पूरा करने के लिए, ऐप्लिकेशन के बाहर लेन-देन करने के प्रोग्राम के बारे में बताती है.

Enums
EXTERNAL_TRANSACTION_PROGRAM_UNSPECIFIED लेन-देन के प्रोग्राम की जानकारी नहीं दी गई है. इस्तेमाल नहीं किया गया.
USER_CHOICE_BILLING उपयोगकर्ता की पसंद का बिलिंग सिस्टम (यूज़र चॉइस बिलिंग), जिसमें उपयोगकर्ता के पास Google Play Billing या डेवलपर के मैनेज किए गए बिलिंग सिस्टम में से किसी एक को चुनने का विकल्प होता है.
ALTERNATIVE_BILLING_ONLY सिर्फ़ बिलिंग का दूसरा तरीका, जहां उपयोगकर्ता सिर्फ़ डेवलपर-मैनेजर की बिलिंग का इस्तेमाल कर सकते हैं.

ExternalSubscription

बाहरी सदस्यता की जानकारी.

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

enum (SubscriptionType)

ज़रूरी है. बाहरी सदस्यता का टाइप.

SubscriptionType

बाहरी सदस्यता के टाइप.

Enums
SUBSCRIPTION_TYPE_UNSPECIFIED नहीं बताया गया है, इसका इस्तेमाल न करें.
RECURRING यह बार-बार ली जाने वाली सदस्यता है. इसमें उपयोगकर्ता से हर बिलिंग साइकल में शुल्क लिया जाता है.
PREPAID यह एक प्रीपेड सदस्यता है, जिसमें उपयोगकर्ता को ऐडवांस में पेमेंट करना होता है.

OtherRecurringProduct

इस टाइप में कोई फ़ील्ड नहीं है.

बार-बार होने वाले बाहरी लेन-देन वाले ऐसे प्रॉडक्ट की जानकारी जो किसी अन्य कैटगरी में नहीं आता.

TransactionState

लेन-देन की स्थिति.

Enums
TRANSACTION_STATE_UNSPECIFIED लेन-देन की स्थिति के बारे में जानकारी नहीं है. इस्तेमाल नहीं किया गया.
TRANSACTION_REPORTED लेन-देन की शिकायत Google को भेज दी गई है.
TRANSACTION_CANCELED लेन-देन का पूरा रिफ़ंड कर दिया गया है.

ExternalTransactionAddress

बाहरी लेन-देन के लिए उपयोगकर्ता का पता.

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

string

ज़रूरी है. आईएसओ-3166-1 ऐल्फ़ा-2 (संयुक्त राष्ट्र के क्षेत्र कोड) के आधार पर, दो अक्षर वाला क्षेत्र कोड.
administrativeArea

string

ज़रूरी नहीं. देश/इलाके का टॉप-लेवल का प्रशासनिक उपखंड. यह सिर्फ़ भारत में किए जाने वाले लेन-देन के लिए ज़रूरी है. मान्य वैल्यू ये हैं: "ANDAMAN AND NICOBAR ISLANDS", "ANDHRA PRADESH", "ARUNACHAL PRADESH", "ASSAM", "BIHAR", "CHANDIGARH", "CHHATTISGARH", "DADRA AND NAGAR HAVELI", "DADRA AND NAGAR HAVELI AND DAMAN AND DIU", "DAMAN AND DIU", "DELHI", "GOA", "GUJARAT", "HARYANA", "HIMACHAL PRADESH", "JAMMU AND KASHMIR", "JHARKHAND", "KARNATAKA", "KERALA", "LADAKH", "LAKSHADWEEP", "MADHYA PRADESH", "MAHARASHTRA", "MANIPUR", "MEGHALAYA", "MIZORAM", "NAGALAND", "ODISHA", "PUDUCHERRY", "PUNJAB", "RAJASTHAN", "SIKKIM", "TAMIL NADU", "TELANGANA", "TRIPURA", "UTTAR PRADESH", "UTTARAKHAND", और "WEST BENGAL".

ExternalOfferDetails

ऐप्लिकेशन के बाहर ऑफ़र वगैरह प्रमोट करने के प्रोग्राम के लिए खास रिपोर्टिंग की जानकारी.

JSON के काेड में दिखाना 
{
  "linkType": enum (ExternalOfferLinkType),
  "installedAppPackage": string,
  "installedAppCategory": enum (ExternalOfferAppCategory),
  "appDownloadEventExternalTransactionId": string
}
फ़ील्ड
installedAppPackage

string

ज़रूरी नहीं. इस लेन-देन के ज़रिए डाउनलोड किए गए ऐप्लिकेशन का पैकेज नेम. यह तब ज़रूरी है, जब linkType की वैल्यू LINK_TO_APP_DOWNLOAD हो.
installedAppCategory

enum (ExternalOfferAppCategory)

ज़रूरी नहीं. इस लेन-देन के ज़रिए डाउनलोड किए गए ऐप्लिकेशन की कैटगरी. यह कैटगरी, Play Console में बाहरी ऐप्लिकेशन की पुष्टि करने की प्रोसेस के दौरान दी गई कैटगरी से मेल खानी चाहिए. यह सिर्फ़ ऐप्लिकेशन डाउनलोड के लिए ज़रूरी है.
appDownloadEventExternalTransactionId

string

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

ExternalOfferLinkType

बाहरी लिंक का टाइप.

Enums
LINK_TO_DIGITAL_CONTENT_OFFER डिजिटल कॉन्टेंट खरीदने का ऑफ़र.

ExternalOfferAppCategory

डाउनलोड किए गए ऐप्लिकेशन की कैटगरी. ऐप्लिकेशन की कैटगरी के बारे में ज़्यादा जानने के लिए, https://support.google.com/googleplay/android-developer/answer/9859673 पर जाएं.

Enums
EXTERNAL_OFFER_APP_CATEGORY_UNSPECIFIED नहीं बताया गया है, इसका इस्तेमाल न करें.
APP ऐप्लिकेशन को ऐप्लिकेशन की कैटगरी में रखा जाता है.
GAME ऐप्लिकेशन को गेम कैटगरी में शामिल किया गया है.

तरीके

createexternaltransaction

 यह कुकी, नया बाहरी लेन-देन बनाती है.

getexternaltransaction

 यह किसी मौजूदा बाहरी लेन-देन को ऐक्सेस करता है.

refundexternaltransaction

 यह मौजूदा बाहरी लेन-देन के लिए रिफ़ंड या कुछ हिस्से का रिफ़ंड देता है.

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

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

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

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