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)

חובה. השעה שבה העסקה הושלמה.

חותמת זמן בפורמט UTC 'Zulu' של RFC3339, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".
createTime

string (Timestamp format)

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

חותמת זמן בפורמט UTC 'Zulu' של RFC3339, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".
transactionState

enum (TransactionState)

פלט בלבד. המצב הנוכחי של העסקה.
userTaxAddress

object (ExternalTransactionAddress)

חובה. כתובת המשתמש לצורך חישוב המס.
transactionProgramCode

integer

זה שינוי אופציונלי. קוד התוכנית של העסקה, שמשמש לקביעת עמלת השירות לאפליקציות שעומדות בדרישות ומשתתפות בתוכניות שותפים. מפתחים שמשתתפים בתוכנית חוויית המדיה של Play (https://play.google.com/console/about/programs/mediaprogram/) חייבים לספק את קוד התוכנית כשהם מדווחים על עסקאות בחיוב חלופי. אם אתם מפתחים שעומדים בדרישות, תוכלו לפנות ל-BDM שלכם כדי לקבל מידע נוסף על הגדרת השדה הזה. הערה: לא ניתן להשתמש בשדה הזה לעסקאות של מבצעים חיצוניים.
שדה האיחוד transaction_type. סוג העסקה שבוצעה. הערך של transaction_type יכול להיות רק אחת מהאפשרויות הבאות:
oneTimeTransaction

object (OneTimeExternalTransaction)

זוהי עסקה חד-פעמית ולא חלק ממינוי.
recurringTransaction

object (RecurringExternalTransaction)

העסקה הזו היא חלק מסדרה של עסקאות חוזרות.

ExternalTransactionTestPurchase

אין שדות לסוג הזה.

מייצג עסקה שבוצעה באמצעות חשבון בדיקה. Google לא תחייב על העסקאות האלה.

OneTimeExternalTransaction

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

ייצוג ב-JSON 
{
  "externalTransactionToken": string
}
שדות
externalTransactionToken

string

קלט בלבד. מצוין בקריאה ל-Create. נשלף מהלקוח כשמתבצעת הפעלה של תהליך החיוב החלופי.

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

קלט בלבד. מצוין בקריאה ל-Create. נשלף מהלקוח כשמתבצעת הפעלה של תהליך החיוב החלופי. נדרש רק לרכישה הראשונית.
migratedTransactionProgram

enum (ExternalTransactionProgram)

קלט בלבד. מצוין בקריאה ל-Create. צריך להשתמש בה רק כשעוברים עם מינוי מדיווח חודשי ידני לדיווח אוטומטי.
שדה האיחוד product_details. חובה. פרטי המוצר בעסקה החיצונית החוזרת. הערך של product_details יכול להיות רק אחת מהאפשרויות הבאות:
externalSubscription

object (ExternalSubscription)

פרטי מינוי חיצוני.
otherRecurringProduct

object (OtherRecurringProduct)

פרטים של מוצר עסקה חיצוני קבוע שלא שייך לאף קטגוריה ספציפית אחרת.

ExternalTransactionProgram

מייצג את תוכנית העסקאות החיצונית שהמשתמש נתקל בה כדי להשלים את העסקה.

טיפוסים בני מנייה (enum)
EXTERNAL_TRANSACTION_PROGRAM_UNSPECIFIED תוכנית עסקאות לא צוינה. לא בשימוש.
USER_CHOICE_BILLING חיוב לבחירת המשתמש, שבו המשתמש יכול לבחור בין חיוב ב-Google Play לבין חיוב בניהול המפתח.
ALTERNATIVE_BILLING_ONLY חיוב חלופי בלבד, שבו המשתמשים יכולים להשתמש רק בחיוב של מנהל הפיתוח.

ExternalSubscription

פרטי מינוי חיצוני.

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

enum (SubscriptionType)

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

SubscriptionType

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

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

OtherRecurringProduct

אין שדות לסוג הזה.

פרטים של מוצר עסקה חיצוני קבוע שלא שייך לאף קטגוריה ספציפית אחרת.

TransactionState

המצב של עסקה שמתבצעת.

טיפוסים בני מנייה (enum)
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 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".

Methods

createexternaltransaction

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

getexternaltransaction

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

refundexternaltransaction

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