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,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "oneTimeTransaction": {
    object (OneTimeExternalTransaction)
  },
  "recurringTransaction": {
    object (RecurringExternalTransaction)
  }
  // End of mutually exclusive fields.

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "externalOfferDetails": {
    object (ExternalOfferDetails)
  },
  "externalContentLinkDetails": {
    object (ExternalContentLinkDetails)
  }
  // End of mutually exclusive fields.
}
फ़ील्ड
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

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

object (OneTimeExternalTransaction)

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

object (RecurringExternalTransaction)

यह लेन-देन नियमित लेन-देनों की एक श्रृंखला का हिस्सा है.
एक-दूसरे से अलग फ़ील्ड के आखिर में.
लेनदेन की रिपोर्टिंग के लिए आवश्यक प्रोग्राम संबंधी विशिष्ट विवरण. लेनदेन से संबंधित प्रोग्राम के लिए ही विवरण निर्धारित किए जाने चाहिए. यहां ऐसे फ़ील्ड की सूची दी गई है जिनमें से सिर्फ़ एक को चुना जा सकता है. जवाब में, ज़्यादा से ज़्यादा एक फ़ील्ड सेट किया जाएगा:
externalOfferDetails

object (ExternalOfferDetails)

ज़रूरी नहीं. बाह्य प्रस्तावों से संबंधित लेन-देन की सटीक रिपोर्टिंग के लिए आवश्यक विवरण.
externalContentLinkDetails

object (ExternalContentLinkDetails)

ज़रूरी नहीं. बाहरी कॉन्टेंट के लिंक से किए गए लेन-देन की सटीक जानकारी देने के लिए ज़रूरी जानकारी.
एक-दूसरे से अलग फ़ील्ड के आखिर में.

ExternalTransactionTestPurchase

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

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

OneTimeExternalTransaction

यह एक बार के लेन-देन को दर्शाता है.

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

string

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

RecurringExternalTransaction

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

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

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "initialExternalTransactionId": string,
  "externalTransactionToken": string,
  "migratedTransactionProgram": enum (ExternalTransactionProgram)
  // End of mutually exclusive fields.

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "externalSubscription": {
    object (ExternalSubscription)
  },
  "otherRecurringProduct": {
    object (OtherRecurringProduct)
  }
  // End of mutually exclusive fields.
}
फ़ील्ड
यहां ऐसे फ़ील्ड की सूची दी गई है जिनमें से सिर्फ़ एक को चुना जा सकता है. जवाब में, ज़्यादा से ज़्यादा एक फ़ील्ड सेट किया जाएगा:
initialExternalTransactionId

string

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

string

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

enum (ExternalTransactionProgram)

सिर्फ़ इनपुट के लिए. क्रिएट कॉल के दौरान प्रदान किया गया. इसका उपयोग केवल तभी किया जाना चाहिए जब किसी सदस्यता को मैन्युअल मासिक रिपोर्टिंग से स्वचालित रिपोर्टिंग में स्थानांतरित किया जा रहा हो.
एक-दूसरे से अलग फ़ील्ड के आखिर में.
ज़रूरी है. बार-बार होने वाले बाहरी लेन-देन में शामिल प्रॉडक्ट की जानकारी. यहां ऐसे फ़ील्ड की सूची दी गई है जिनमें से सिर्फ़ एक को चुना जा सकता है. जवाब में, ज़्यादा से ज़्यादा एक फ़ील्ड सेट किया जाएगा:
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

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

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 ऐप्लिकेशन को गेम कैटगरी में रखा गया है.

ExternalContentLinkDetails

बाहरी कॉन्टेंट से लिंक करने वाले प्रोग्राम के लिए खास तौर पर तैयार की गई रिपोर्टिंग की जानकारी.

JSON के काेड में दिखाना 
{
  "linkType": enum (ExternalContentLinkType),
  "installedAppPackage": string,
  "externalAppCategory": enum (ExternalContentAppCategory)
}
फ़ील्ड
installedAppPackage

string

ज़रूरी नहीं. इस लेन-देन के ज़रिए डाउनलोड किए गए ऐप्लिकेशन का पैकेज नेम. सिर्फ़ ऐप्लिकेशन इंस्टॉल करने के लिए ज़रूरी है.
externalAppCategory

enum (ExternalContentAppCategory)

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

ExternalContentLinkType

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

Enums
EXTERNAL_CONTENT_LINK_TYPE_UNSPECIFIED नहीं बताया गया है, इसका इस्तेमाल न करें.
LINK_TO_DIGITAL_CONTENT_OFFER डिजिटल कॉन्टेंट खरीदने का ऑफ़र.

ExternalContentAppCategory

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

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

तरीके

createexternaltransaction

 यह बाहरी ट्रांजै़क्शन बनाता है.

getexternaltransaction

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

refundexternaltransaction

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

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

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

गड़बड़ी का कोड कारण ब्यौरा रिज़ॉल्यूशन