REST Resource: externaltransactions

संसाधन: Externalलेन-देन

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

जेएसओएन के काेड में दिखाना
{
  "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)
  },

  // 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)

ज़रूरी है. लेन-देन पूरा होने का समय.

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

createTime

string (Timestamp format)

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

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

transactionState

enum (TransactionState)

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

userTaxAddress

object (ExternalTransactionAddress)

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

यूनियन फ़ील्ड transaction_type. किया गया लेन-देन किस तरह का है. transaction_type इनमें से सिर्फ़ एक हो सकती है:
oneTimeTransaction

object (OneTimeExternalTransaction)

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

recurringTransaction

object (RecurringExternalTransaction)

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

ExternalTransactionTestPurchase

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

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

OneTimeExternalTransaction

एक बार के लेन-देन को दिखाता है.

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

string

सिर्फ़ इनपुट. इसे बनाने के लिए कॉल करते समय उपलब्ध कराया जाता है. अन्य बिलिंग फ़्लो लॉन्च होने पर, क्लाइंट से डेटा वापस लाया जाता है.

RecurringExternalTransaction

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

जेएसओएन के काेड में दिखाना
{

  // 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)
  }
  // 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)

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

ExternalTransactionProgram

लेन-देन पूरा करने के लिए, उपयोगकर्ता ने जो बाहरी लेन-देन प्रोग्राम अनुभव किया है उसके बारे में बताता है.

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

ExternalSubscription

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

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

enum (SubscriptionType)

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

SubscriptionType

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

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

TransactionState

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

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

ExternalTransactionAddress

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

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

string

ज़रूरी है. ISO-3166-1 Alpha-2 (UN क्षेत्र कोड) के आधार पर दो अक्षर वाला क्षेत्र का कोड.

administrativeArea

string

ज़रूरी नहीं. देश/इलाके का टॉप-लेवल का प्रशासनिक सबग्रुप. सिर्फ़ भारत में लेन-देन के लिए ज़रूरी है. "अंडमान और निकोबाराद्राष्णेश्वर", "शंदेश्वर", "शंदेश्वर", "शंदेश्वर", "शंदेश्वर", "आंध्र प्रदेशा", "शंदेश्वर", "शंदेश्वर", "आंध्रचंद्र", "शर्मणद्राष्ट्र", "आंध्रचंद्र", "शैन्ध्राष्णेश्वर", "शैणचंद्र", "शर्मणद्राज", "चंद्राचंद्र", "शर्मणद्दा", "राजेंद्र", "राजेंद्र", "राजेंद्र", "राजेंद्र", "राजेंद्र", "राजस्थान",

तरीके

createexternaltransaction

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

getexternaltransaction

पहले से मौजूद बाहरी लेन-देन पाने के लिए.

refundexternaltransaction

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