Method: monetization.subscriptions.basePlans.offers.batchUpdate

מתבצע עדכון של מספר מבצעי מינויים.

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

בקשת HTTP

POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/subscriptions/{productId}/basePlans/{basePlanId}/offers:batchUpdate

בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של gRPC.

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

פרמטרים
packageName

string

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

חייב להיות שווה לשדה packageName בכל המשאבים המעודכנים של SubscriptionOffer.
productId

string

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

string

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

גוף הבקשה

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

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

object (UpdateSubscriptionOfferRequest)

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

גוף התשובה

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

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

ייצוג JSON 
{
  "subscriptionOffers": [
    {
      object (SubscriptionOffer)
    }
  ]
}
שדות
subscriptionOffers[]

object (SubscriptionOffer)

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

היקפי ההרשאות

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

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

UpdateSubscriptionOfferRequest

בקשה להודעת מבצעים.patch.

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

object (SubscriptionOffer)

חובה. הצעת המינוי לעדכון.
updateMask

string (FieldMask format)

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

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

object (RegionsVersion)

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

boolean

זה שינוי אופציונלי. אם המדיניות מוגדרת כ-True ומבצע המינוי עם הפרטים של packageName, productId, basePlanId ו-offerId לא קיים, ייווצר מבצע.

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

enum (ProductUpdateLatencyTolerance)

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