Method: monetization.onetimeproducts.purchaseOptions.offers.batchUpdate

יצירה או עדכון של מבצעים על מוצרים בחיוב חד-פעמי.

בקשת HTTP

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

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

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

פרמטרים
packageName

string

חובה. אפליקציית האב (שם החבילה) של המבצעים המעודכנים.

הערך חייב להיות זהה לערך בשדה packageName בכל המשאבים המעודכנים מסוג OneTimeProductOffer.
productId

string

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

string

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

גוף הבקשה

גוף הבקשה מכיל נתונים עם המבנה הבא:

ייצוג ב-JSON 
{
  "requests": [
    {
      object (UpdateOneTimeProductOfferRequest)
    }
  ]
}
שדות
requests[]

object (UpdateOneTimeProductOfferRequest)

חובה. רשימה של בקשות עדכון של עד 100 רכיבים. כל בקשה צריכה לעדכן מבצעים שונים.

גוף התשובה

הודעת התשובה לשיטה offers.batchUpdate.

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

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

object (OneTimeProductOffer)

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

היקפי הרשאה

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

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

UpdateOneTimeProductOfferRequest

הודעת בקשה ל-UpdateOneTimeProductOffer.

ייצוג ב-JSON 
{
  "oneTimeProductOffer": {
    object (OneTimeProductOffer)
  },
  "updateMask": string,
  "regionsVersion": {
    object (RegionsVersion)
  },
  "allowMissing": boolean,
  "latencyTolerance": enum (ProductUpdateLatencyTolerance)
}
שדות
oneTimeProductOffer

object (OneTimeProductOffer)

חובה. המוצר בחיוב חד-פעמי שרוצים לעדכן.
updateMask

string (FieldMask format)

חובה. רשימת השדות שרוצים לעדכן.

זוהי רשימה של שמות שדות שמוגדרים במלואם, שמופרדים באמצעות פסיקים. דוגמה: "user.displayName,photo"
regionsVersion

object (RegionsVersion)

חובה. הגרסה של האזורים הזמינים שבה נעשה שימוש במבצע.
allowMissing

boolean

אופציונלי. אם הערך מוגדר כ-true, והמוצר עם packageName, ‏ productId, ‏ purchaseOptionId ו-offerId שצוינו לא קיים, ייווצר מוצר.

אם נוצר מבצע חדש, המערכת מתעלמת מ-updateMask.
latencyTolerance

enum (ProductUpdateLatencyTolerance)

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