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.

  // Union field program_details can be only one of the following:
  "externalOfferDetails": {
    object (ExternalOfferDetails)
  }
  // End of list of possible types for union field program_details.
}
שדות
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)

העסקה הזו היא חלק מסדרה חוזרת של עסקאות.
שדה איחוד program_details. פרטים ספציפיים לתוכנית שנדרשים לדיווח על עסקאות. צריך להגדיר את הפרטים רק לתוכנית שאליה משויכת העסקה. הערך program_details יכול להיות רק אחד מהבאים:
externalOfferDetails

object (ExternalOfferDetails)

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

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.

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

סוג הקישור החיצוני.

טיפוסים בני מנייה (enum)
LINK_TO_DIGITAL_CONTENT_OFFER הצעה לרכישת תוכן דיגיטלי.

ExternalOfferAppCategory

קטגוריה של האפליקציה שהורדה. מידע נוסף על קטגוריות של אפליקציות זמין בכתובת https://support.google.com/googleplay/android-developer/answer/9859673.

טיפוסים בני מנייה (enum)
EXTERNAL_OFFER_APP_CATEGORY_UNSPECIFIED לא צוין, אין להשתמש.
APP האפליקציה מסווגת לפי קטגוריית האפליקציה.
GAME האפליקציה מסווגת בקטגוריית המשחקים.

Methods

createexternaltransaction

 יצירת טרנזקציה חיצונית חדשה.

getexternaltransaction

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

refundexternaltransaction

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

קודי שגיאה

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

קוד שגיאה סיבה דרך פתרון
5xx שגיאה כללית בשרת של Google Play. צריך לנסות לשלוח את הבקשה שוב.

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

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

 צריך לנסות לשלוח את הבקשה שוב.