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 यूटीसी के "Zulu" फ़ॉर्मैट में एक टाइमस्टैंप, नैनोसेकंड रिज़ॉल्यूशन और नौ दशमलव अंकों के साथ. उदाहरण के लिए: "2014-10-02T15:01:23Z" और "2014-10-02T15:01:23.045123456Z".
createTime

string (Timestamp format)

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

आरएफ़सी3339 यूटीसी के "Zulu" फ़ॉर्मैट में एक टाइमस्टैंप, नैनोसेकंड रिज़ॉल्यूशन और नौ दशमलव अंकों के साथ. उदाहरण के लिए: "2014-10-02T15:01:23Z" और "2014-10-02T15:01:23.045123456Z".
transactionState

enum (TransactionState)

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

object (ExternalTransactionAddress)

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

integer

ज़रूरी नहीं. ट्रांज़ैक्शन प्रोग्राम कोड, जिसका इस्तेमाल पार्टनर प्रोग्राम में शामिल ज़रूरी शर्तें पूरी करने वाले ऐप्लिकेशन के लिए, सेवा शुल्क तय करने में किया जाता है. Play Media Experience Program (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

इससे पता चलता है कि लेन-देन पूरा करने के लिए, उपयोगकर्ता ने बाहरी लेन-देन के किस प्रोग्राम का इस्तेमाल किया.

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

ज़रूरी है. ISO-3166-1 Alpha-2 (UN region codes) के आधार पर, दो अक्षर वाला क्षेत्र कोड.
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

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