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

  // 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 UTC, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".

createTime

string (Timestamp format)

פלט בלבד. השעה שבה העסקה הזו נוצרה. זו השעה שבה נשלחה ל-Google הודעה על העסקה.

חותמת זמן בפורמט "זולו" RFC3339 UTC, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "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

מייצג עסקה חד-פעמית.

ייצוג 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)
  }
  // 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.
ALTERNATIVE_BILLING_ONLY מערכת חיוב חלופית בלבד, שבה המשתמשים יכולים להשתמש רק בחיוב של חשבון הניהול למפתחים.

ExternalSubscription

פרטים על מינוי חיצוני.

ייצוג JSON
{
  "subscriptionType": enum (SubscriptionType)
}
שדות
subscriptionType

enum (SubscriptionType)

חובה. סוג המינוי החיצוני.

SubscriptionType

הסוגים של המינוי החיצוני.

טיפוסים בני מנייה (enums)
SUBSCRIPTION_TYPE_UNSPECIFIED לא צוין, אין להשתמש.
RECURRING זה מינוי קבוע שבו המשתמש מחויב בכל מחזור חיובים.
PREPAID זהו מינוי בתשלום מראש שבו המשתמש משלם מראש.

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

זה שינוי אופציונלי. חלוקת משנה מנהלית ברמה העליונה של המדינה/האזור. נדרש רק לעסקאות בהודו. הערכים החוקיים הם "ANDAMAN AND NICOBAR ISLANDS", "ANDHRA PRADESH, "ARUNACHAL PRADESH, "ASSAM", "BIHAR", "CHANDIGARH", "CHHATTISGARH", DADRA AND NAGAR HAVELI, DADRA AND NAGAR HAVELI, DADRA AND NAGAR HAVELI, "ANDHRA PRADESH", "ARUNACHAL PRADESH, "ASSAM, "BIHAR", "CHANDIGARH"

שיטות

createexternaltransaction

יצירת עסקה חיצונית חדשה.

getexternaltransaction

מקבל עסקה חיצונית קיימת.

refundexternaltransaction

החזרים כספיים או החזרים כספיים חלקיים על עסקה חיצונית קיימת.