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 יוגבלו ל-1,000.
pageToken

string

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

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

גוף הבקשה

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

גוף התשובה

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

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

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

object (OneTimeProductOffer)

המבצעים על מוצרים חד-פעמיים מהבקשה שצוינה.
nextPageToken

string

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

היקפי הרשאה

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

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