- משאב: ExternalTransaction
- ExternalTransactionTestPurchase
- OneTimeExternalTransaction
- RecurringExternalTransaction
- ExternalTransactionProgram
- ExternalSubscription
- SubscriptionType
- OtherRecurringProduct
- TransactionState
- ExternalTransactionAddress
- שיטות
משאב: ExternalTransaction
הפרטים של עסקה חיצונית.
ייצוג JSON |
---|
{ "packageName": string, "externalTransactionId": string, "originalPreTaxAmount": { object ( |
שדות | |
---|---|
packageName |
פלט בלבד. שם המשאב של הטרנזקציה החיצונית. שם החבילה של האפליקציה שבה נמכרו המוצרים מתוך האפליקציה (לדוגמה, 'com.some.app'). |
externalTransactionId |
פלט בלבד. המזהה של העסקה הזו. כל מזהי העסקאות באותו שם חבילה חייבים להיות ייחודיים. יש להגדיר זאת בזמן יצירת העסקה החיצונית. |
originalPreTaxAmount |
חובה. סכום העסקה המקורי לפני מיסים. הסכום הזה מייצג את הסכום לפני מס ש-Google מסרה במקור לפני החלת החזרים כספיים. |
originalTaxAmount |
חובה. סכום המס המקורי. סכום זה מייצג את סכום המס ש-Google הודיעה במקור לפני שבוצעו החזרים כספיים. |
currentPreTaxAmount |
פלט בלבד. סכום העסקה הנוכחי, לפני מס. זהו הסכום הנוכחי לפני מס, כולל החזרים כספיים שייתכן שהוחלו על העסקה הזו. |
currentTaxAmount |
פלט בלבד. סכום המס הנוכחי. נתון זה מייצג את סכום המס הנוכחי, כולל החזרים כספיים כלשהם שייתכן שהוחלו על העסקה הזו. |
testPurchase |
פלט בלבד. אם הוגדרה, העסקה הזו הייתה רכישה לניסיון. Google לא תחייב אותך על עסקת בדיקה. |
transactionTime |
חובה. השעה שבה העסקה הושלמה. חותמת זמן בפורמט "זולו" RFC3339 UTC, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: |
createTime |
פלט בלבד. השעה שבה העסקה הזו נוצרה. זו השעה שבה נשלחה ל-Google הודעה על העסקה. חותמת זמן בפורמט "זולו" RFC3339 UTC, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: |
transactionState |
פלט בלבד. המצב הנוכחי של העסקה. |
userTaxAddress |
חובה. כתובת המשתמש לצורך חישוב מס. |
שדה איחוד transaction_type . סוג העסקה שבוצעה. transaction_type יכול להיות רק אחד מהבאים: |
|
oneTimeTransaction |
זו עסקה חד-פעמית שאינה חלק ממינוי. |
recurringTransaction |
העסקה הזו היא חלק מסדרה חוזרת של עסקאות. |
ExternalTransactionTestPurchase
אין שדות בסוג הזה.
מייצג עסקה שבוצעה באמצעות חשבון בדיקה. Google לא תחייב את העסקאות האלה.
OneTimeExternalTransaction
מייצג עסקה חד-פעמית.
ייצוג JSON |
---|
{ "externalTransactionToken": string } |
שדות | |
---|---|
externalTransactionToken |
קלט בלבד. סופקו במהלך השיחה ליצירה. אוחזר מהלקוח כשתהליך החיוב החלופי מופעל. |
RecurringExternalTransaction
מייצג עסקה שהיא חלק מסדרה חוזרת של תשלומים. המוצר יכול להיות מינוי או מוצר חד-פעמי שכולל כמה תשלומים (למשל, הזמנה מראש).
ייצוג JSON |
---|
{ // Union field |
שדות | |
---|---|
שדה איחוד
|
|
initialExternalTransactionId |
המזהה החיצוני של העסקה הראשונה של סדרת העסקאות החוזרת הזו. למשל, עבור מינוי, מזהה העסקה של התשלום הראשון. נדרש כשיוצרים עסקאות חיצוניות חוזרות. |
externalTransactionToken |
קלט בלבד. סופקו במהלך השיחה ליצירה. אוחזר מהלקוח כשתהליך החיוב החלופי מופעל. נדרש רק עבור הרכישה הראשונית. |
migratedTransactionProgram |
קלט בלבד. סופקו במהלך השיחה ליצירה. חובה להשתמש רק בעת העברת מינוי מדיווח חודשי ידני לדיווח אוטומטי. |
שדה איחוד product_details . חובה. פרטים על המוצר בעסקה החיצונית החוזרת. product_details יכול להיות רק אחד מהבאים: |
|
externalSubscription |
פרטים על מינוי חיצוני. |
otherRecurringProduct |
פרטים של מוצר עסקה חיצוני קבוע שלא שייך לאף קטגוריה ספציפית אחרת. |
ExternalTransactionProgram
מייצג את תוכנית הטרנזקציות החיצונית שהמשתמש חווה לצורך השלמת העסקה.
טיפוסים בני מנייה (enums) | |
---|---|
EXTERNAL_TRANSACTION_PROGRAM_UNSPECIFIED |
תוכנית העסקה לא צוינה. לא בשימוש. |
USER_CHOICE_BILLING |
חיוב לבחירת המשתמש, שבו המשתמש יכול לבחור בין חיוב בניהול המפתח לחיוב ב-Google Play. |
ALTERNATIVE_BILLING_ONLY |
מערכת חיוב חלופית בלבד, שבה המשתמשים יכולים להשתמש רק בחיוב של חשבון הניהול למפתחים. |
ExternalSubscription
פרטים על מינוי חיצוני.
ייצוג JSON |
---|
{
"subscriptionType": enum ( |
שדות | |
---|---|
subscriptionType |
חובה. סוג המינוי החיצוני. |
SubscriptionType
הסוגים של המינוי החיצוני.
טיפוסים בני מנייה (enums) | |
---|---|
SUBSCRIPTION_TYPE_UNSPECIFIED |
לא צוין, אין להשתמש. |
RECURRING |
זה מינוי קבוע שבו המשתמש מחויב בכל מחזור חיובים. |
PREPAID |
זהו מינוי בתשלום מראש שבו המשתמש משלם מראש. |
OtherRecurringProduct
אין שדות בסוג הזה.
פרטים של מוצר עסקה חיצוני קבוע, שלא שייך לקטגוריה אחרת ספציפית יותר.
TransactionState
המצב של עסקה שמתבצעת.
טיפוסים בני מנייה (enums) | |
---|---|
TRANSACTION_STATE_UNSPECIFIED |
מצב העסקה לא צוין. לא בשימוש. |
TRANSACTION_REPORTED |
העסקה דווחה ל-Google. |
TRANSACTION_CANCELED |
התקבל החזר כספי מלא על העסקה. |
ExternalTransactionAddress
כתובת המשתמש לעסקה החיצונית.
ייצוג JSON |
---|
{ "regionCode": string, "administrativeArea": string } |
שדות | |
---|---|
regionCode |
חובה. קוד אזור בן שתי אותיות על סמך קודי אזור של ISO-3166-1 Alpha-2. |
administrativeArea |
זה שינוי אופציונלי. חלוקת משנה מנהלית ברמה העליונה של המדינה/האזור. נדרש רק לעסקאות בהודו. הערכים החוקיים הם "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" |
שיטות |
|
---|---|
|
יצירת עסקה חיצונית חדשה. |
|
מקבל עסקה חיצונית קיימת. |
|
החזרים כספיים או החזרים כספיים חלקיים על עסקה חיצונית קיימת. |