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,
  "externalOfferInitialAcquisitionDetails": {
    object (ExternalOfferInitialAcquisitionDetails)
  },

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

createTime

string (Timestamp format)

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

आरएफ़सी3339 यूटीसी "ज़ुलु" में टाइमस्टैंप फ़ॉर्मैट, नैनोसेकंड रिज़ॉल्यूशन और ज़्यादा से ज़्यादा नौ फ़्रैक्शनल अंकों के साथ हो सकता है. उदाहरण: "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/) में हिस्सा लेने वाले डेवलपर को, अन्य बिलिंग सिस्टम से किए जाने वाले लेन-देन की रिपोर्ट करते समय प्रोग्राम का कोड देना होगा. अगर आप ज़रूरी शर्तें पूरी करने वाले डेवलपर हैं, तो इस फ़ील्ड को सेट करने के तरीके के बारे में ज़्यादा जानकारी के लिए, कृपया अपने BDM से संपर्क करें. ध्यान दें: इस फ़ील्ड का इस्तेमाल, बाहरी ऑफ़र से किए जाने वाले लेन-देन के लिए नहीं किया जा सकता.

externalOfferInitialAcquisitionDetails

object (ExternalOfferInitialAcquisitionDetails)

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

यूनियन फ़ील्ड 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 (यूएन क्षेत्र कोड) पर आधारित दो अक्षरों वाला क्षेत्र कोड.

administrativeArea

string

ज़रूरी नहीं. देश/इलाके का टॉप-लेवल एडमिन. सिर्फ़ भारत में लेन-देन के लिए ज़रूरी है.

ExternalOfferInitialAcquisitionDetails

इस बारे में जानकारी कि किसी उपयोगकर्ता या डिवाइस ने बाहरी ऑफ़र का इस्तेमाल करके पहली बार लेन-देन कब किया.

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

string

ज़रूरी है. उपयोगकर्ता ने पहली बार जो खरीदारी की है उसका बाहरी लेन-देन आईडी.

तरीके

createexternaltransaction

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

getexternaltransaction

इसकी मदद से, पहले से कोई बाहरी लेन-देन किया जा सकता है.

refundexternaltransaction

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