REST Resource: purchases.productsv2

מקור מידע: ProductPurchaseV2

משאב ProductPurchaseV2 מציין את הסטטוס של רכישת מוצר מתוך האפליקציה של משתמש.

ייצוג ב-JSON 
{
  "productLineItem": [
    {
      object (ProductLineItem)
    }
  ],
  "kind": string,
  "purchaseStateContext": {
    object (PurchaseStateContext)
  },
  "testPurchaseContext": {
    object (TestPurchaseContext)
  },
  "orderId": string,
  "obfuscatedExternalAccountId": string,
  "obfuscatedExternalProfileId": string,
  "regionCode": string,
  "purchaseCompletionTime": string,
  "acknowledgementState": enum (AcknowledgementState)
}
שדות
productLineItem[]

object (ProductLineItem)

מכיל מידע ברמת הפריט לגבי ProductPurchaseV2.
kind

string

הסוג הזה מייצג אובייקט ProductPurchaseV2 בשירות androidpublisher.
purchaseStateContext

object (PurchaseStateContext)

מידע על מצב הרכישה.
testPurchaseContext

object (TestPurchaseContext)

מידע שקשור לרכישות לצורך בדיקה. ההגדרה הזו תהיה רלוונטית רק לרכישות לצורך בדיקה.
orderId

string

מזהה ההזמנה שמשויך לרכישה של המוצר מתוך האפליקציה. יכול להיות שהפרמטר לא יוגדר אם אין הזמנה שמשויכת לרכישה.
obfuscatedExternalAccountId

string

גרסה מעורפלת של המזהה שמשויך באופן ייחודי לחשבון של המשתמש באפליקציה. הערך הזה מופיע רק אם הוא צוין באמצעות https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedaccountid בזמן ביצוע הרכישה.
obfuscatedExternalProfileId

string

גרסה מעורפלת של המזהה שמשויך באופן ייחודי לפרופיל של המשתמש באפליקציה. הערך הזה מופיע רק אם הוא צוין באמצעות https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedprofileid בזמן ביצוע הרכישה.
regionCode

string

קוד אזור החיוב של המשתמש לפי תקן ISO 3166-1 alpha-2 בזמן שהמוצר הוענק.
purchaseCompletionTime

string (Timestamp format)

השעה שבה הרכישה בוצעה בהצלחה, כלומר השעה שבה PurchaseState השתנה ל-PURCHASED. השדה הזה לא יופיע עד שהתשלום יושלם. לדוגמה, אם המשתמש יזם עסקה בהמתנה (https://developer.android.com/google/play/billing/integrate#pending), השדה הזה לא יאוכלס עד שהמשתמש ישלים בהצלחה את השלבים הנדרשים להשלמת העסקה.

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

enum (AcknowledgementState)

פלט בלבד. מצב האישור של הרכישה.

PurchaseStateContext

הקשר לגבי מצב הרכישה.

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

enum (PurchaseState)

פלט בלבד. מצב הרכישה.

PurchaseState

מצבי רכישה אפשריים.

טיפוסים בני מנייה (enum)
PURCHASE_STATE_UNSPECIFIED מצב הרכישה לא צוין. אסור להגדיר את הערך הזה.
PURCHASED הרכישה בוצעה בהצלחה.
CANCELLED הרכישה בוטלה.
PENDING הרכישה נמצאת במצב המתנה והיא עדיין לא הושלמה. מידע נוסף על טיפול ברכישות בהמתנה זמין בכתובת https://developer.android.com/google/play/billing/integrate#pending.

TestPurchaseContext

הקשר לרכישה לבדיקה.

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

enum (FopType)

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

FopType

סוגי fop אפשריים.

טיפוסים בני מנייה (enum)
FOP_TYPE_UNSPECIFIED לא צוין סוג אמצעי התשלום. אסור להגדיר את הערך הזה.
TEST הרכישה בוצעה באמצעות כרטיס בדיקה.

ProductLineItem

מכיל מידע ברמת הפריט לגבי ProductPurchaseV2.

ייצוג ב-JSON 
{
  "productId": string,
  "productOfferDetails": {
    object (ProductOfferDetails)
  }
}
שדות
productId

string

מזהה המוצר שנרכש (לדוגמה, monthly001).
productOfferDetails

object (ProductOfferDetails)

פרטי המבצע של הפריט הזה.

ProductOfferDetails

פרטי המבצע שקשורים לפריט רכישה.

ייצוג ב-JSON 
{
  "offerTags": [
    string
  ],
  "offerId": string,
  "purchaseOptionId": string,
  "rentOfferDetails": {
    object (RentOfferDetails)
  },
  "offerToken": string,
  "quantity": integer,
  "refundableQuantity": integer,
  "consumptionState": enum (ConsumptionState)
}
שדות
offerTags[]

string

תגי המבצע העדכניים שמשויכים למבצע. הוא כולל תגים שעברו בירושה מאפשרות הרכישה.
offerId

string

מזהה המוצר. המאפיין הזה מוצג רק במבצעים.
purchaseOptionId

string

המזהה של אפשרות הרכישה.
rentOfferDetails

object (RentOfferDetails)

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

string

הטוקן של המבצע לכל עסקה ששימש לרכישת הפריט הזה.
quantity

integer

הכמות שמשויכת לרכישה של המוצר מתוך האפליקציה.
refundableQuantity

integer

הכמות שעומדת בדרישות לקבלת החזר כספי, כלומר הכמות שלא קיבלה החזר כספי. הערך משקף החזרים כספיים חלקיים שמבוססים על כמות והחזרים כספיים מלאים.
consumptionState

enum (ConsumptionState)

פלט בלבד. מצב הצריכה של הרכישה.

RentOfferDetails

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

פרטים על פריט להשכרה.

ConsumptionState

מצבי צריכה אפשריים.

טיפוסים בני מנייה (enum)
CONSUMPTION_STATE_UNSPECIFIED לא צוין מצב הצריכה. אסור להגדיר את הערך הזה.
CONSUMPTION_STATE_YET_TO_BE_CONSUMED עדיין לא נצרך.
CONSUMPTION_STATE_CONSUMED כבר נעשה בו שימוש.

AcknowledgementState

סטטוס האישור של המוצר בחיוב חד-פעמי.

טיפוסים בני מנייה (enum)
ACKNOWLEDGEMENT_STATE_UNSPECIFIED לא צוין סטטוס אישור.
ACKNOWLEDGEMENT_STATE_PENDING הרכישה עדיין לא אושרה.
ACKNOWLEDGEMENT_STATE_ACKNOWLEDGED הרכישה אושרה.

Methods

getproductpurchasev2

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

קודי שגיאה

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

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

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

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

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