REST Resource: externaltransactions

{
  "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,
  "externalOfferInitialAcquisitionDetails": {
    object (ExternalOfferInitialAcquisitionDetails)
  },

  // 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.
}

string

פלט בלבד. שם המשאב של הטרנזקציה החיצונית. שם החבילה של האפליקציה שבה נמכרו המוצרים מתוך האפליקציה (לדוגמה, 'com.some.app').

string

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

object (Price)

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

object (Price)

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

object (Price)

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

object (Price)

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

object (ExternalTransactionTestPurchase)

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

string (Timestamp format)

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

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

string (Timestamp format)

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

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

enum (TransactionState)

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

object (ExternalTransactionAddress)

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

integer

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

object (ExternalOfferInitialAcquisitionDetails)

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

object (OneTimeExternalTransaction)

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

object (RecurringExternalTransaction)

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

{
  "externalTransactionToken": string
}

string

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

{

  // 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.
}

string

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

string

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

enum (ExternalTransactionProgram)

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

object (ExternalSubscription)

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

object (OtherRecurringProduct)

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

{
  "subscriptionType": enum (SubscriptionType)
}

enum (SubscriptionType)

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

{
  "regionCode": string,
  "administrativeArea": string
}

string

חובה. קוד אזור בן שתי אותיות על סמך קודי אזור של ISO-3166-1 Alpha-2 (קודי אזור של UN).

string

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

{
  "externalTransactionId": string
}

string

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