Method: monetization.subscriptions.basePlans.offers.batchUpdate

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

כדי להשיג תפוקת עדכון מקסימלית, יש להגדיר את השדה LateTolerance בבקשות המקננות ל-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

הודעת בקשה ל-offers.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)

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