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.
}
फ़ील्ड
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)

यह लेन-देन, बार-बार होने वाले लेन-देन की सीरीज़ का हिस्सा है.

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

यह उस External Transaction Program को दिखाता है जिसका इस्तेमाल करके उपयोगकर्ता ने लेन-देन पूरा किया है.

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".

तरीके

createexternaltransaction

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

getexternaltransaction

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

refundexternaltransaction

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

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

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

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

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

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

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