Method: monetization.onetimeproducts.purchaseOptions.offers.list

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

בקשת HTTP

GET https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/oneTimeProducts/{productId}/purchaseOptions/{purchaseOptionId}/offers

כתובת ה-URL כתובה בתחביר של gRPC Transcoding.

פרמטרים של הנתיב

פרמטרים
packageName

string

חובה. האפליקציה הראשית (שם החבילה) שבה צריך לקרוא את המוצרים.

productId

string

חובה. המזהה הראשי של המוצר בחיוב חד-פעמי של המוצרים שרוצים לקרוא. אפשר לציין את הערך '-' כדי לקרוא את כל המבצעים באפליקציה.

purchaseOptionId

string

חובה. אפשרות הרכישה הראשית (המזהה) שלגביה צריך לקרוא את המבצעים. אפשר לציין את הערך "-" כדי לקרוא את כל המבצעים של מוצר בחיוב חד-פעמי או של אפליקציה. חובה לציין את הערך "-" אם הערך של productId הוא "-".

פרמטרים של שאילתה

פרמטרים
pageSize

integer

אופציונלי. המספר המקסימלי של מוצרים שיוחזרו. יכול להיות שהשירות יחזיר פחות מהערך הזה. אם לא מציינים ערך, יוחזרו עד 50 מוצרים. הערך המקסימלי הוא 1,000. ערכים גבוהים יותר יומרו ל-1,000.

pageToken

string

אופציונלי. טוקן של דף שהתקבל מקריאה קודמת של offers.list. צריך להזין את הטוקן כדי לאחזר את הדף הבא.

כשמבצעים חלוקה לעמודים, הפרמטרים productId, ‏ packageName ו-purchaseOptionId שסופקו ל-ListOneTimeProductOffersRequest חייבים להיות זהים לקריאה שסיפקה את הטוקן של הדף.

גוף הבקשה

גוף הבקשה צריך להיות ריק.

גוף התשובה

הודעת התגובה ל-offers.list.

אם הפעולה מצליחה, גוף התשובה מכיל נתונים במבנה הבא:

ייצוג ב-JSON
{
  "oneTimeProductOffers": [
    {
      object (OneTimeProductOffer)
    }
  ],
  "nextPageToken": string
}
שדות
oneTimeProductOffers[]

object (OneTimeProductOffer)

מבצעי oneTimeProduct מהבקשה שצוינה.

nextPageToken

string

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

היקפי הרשאות

נדרש היקף ההרשאות הבא של OAuth:

  • https://www.googleapis.com/auth/androidpublisher