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)

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

הפונקציה משתמשת ב-RFC 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 קיבלה הודעה על העסקה.

הפונקציה משתמשת ב-RFC 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

אופציונלי. קוד התוכנית של העסקה, שמשמש לקביעת עמלת השירות עבור אפליקציות שעומדות בדרישות ומשתתפות בתוכניות שותפים. מפתחים שמשתתפים בתוכנית חוויית המדיה של Play (https://play.google.com/console/about/programs/mediaprogram/) צריכים לספק את קוד התוכנית כשהם מדווחים על עסקאות שבוצעו באמצעות מערכת חיוב חלופית. אם אתם מפתחים שעומדים בדרישות, אתם יכולים לפנות אל מנהל פיתוח העסקים שלכם כדי לקבל מידע נוסף על הגדרת השדה הזה. הערה: אי אפשר להשתמש בשדה הזה לעסקאות של מבצעים חיצוניים.
שדה איחוד 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

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

קודי שגיאה

הפעולות של המשאב הזה מחזירות את קודי שגיאות ה-HTTP הבאים:

קוד שגיאה סיבה רזולוציה
5xx שגיאה כללית בשרת של Google Play. מנסים לשלוח את הבקשה שוב.

אם הבעיה נמשכת, אפשר לפנות למנהל החשבון שלכם ב-Google Play או לשלוח בקשת תמיכה. כדאי לבדוק בלוח הבקרה של סטטוס Play אם יש הפסקות זמניות ידועות בשירות.
409 שגיאה בעדכון של מספר החיבורים בו-זמנית.

היה ניסיון לעדכן אובייקט שנמצא בתהליך עדכון. לדוגמה, רכישה מאושרת על ידי הפעלת המתודה acknowledgePurchase() של Play Billing Library והפעלת המתודה purchases.products.acknowledge של Play Developer API בו-זמנית.

 מנסים לשלוח את הבקשה שוב.