Method: monetization.subscriptions.basePlans.offers.batchUpdate

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

כדי להשיג את תפוקת העדכונים המקסימלית, מגדירים את השדה latencyTolerance בבקשות בתצוגת עץ לערך PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_TOLERANT.

בקשת HTTP

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

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

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

פרמטרים
packageName

string

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

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

string

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

string

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

גוף הבקשה

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

ייצוג ב-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)

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

boolean

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

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

enum (ProductUpdateLatencyTolerance)

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