Method: monetization.subscriptions.basePlans.offers.batchUpdateStates

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

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

בקשת HTTP

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

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

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

פרמטרים
packageName

string

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

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

string

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

string

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

גוף הבקשה

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

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

object (UpdateSubscriptionOfferStateRequest)

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

גוף התשובה

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

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

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

object (SubscriptionOffer)

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

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

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

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

UpdateSubscriptionOfferStateRequest

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

ייצוג JSON 
{

  // Union field state_transition_type can be only one of the following:
  "activateSubscriptionOfferRequest": {
    object (ActivateSubscriptionOfferRequest)
  },
  "deactivateSubscriptionOfferRequest": {
    object (DeactivateSubscriptionOfferRequest)
  }
  // End of list of possible types for union field state_transition_type.
}
שדות
שדה איחוד state_transition_type. יש להגדיר את סוג המעבר של מדינה בארה"ב שיחול. state_transition_type יכול להיות רק אחת מהאפשרויות הבאות:
activateSubscriptionOfferRequest

object (ActivateSubscriptionOfferRequest)

הפעלת מבצע. לאחר ההפעלה, המבצע יהיה זמין למנויים חדשים.
deactivateSubscriptionOfferRequest

object (DeactivateSubscriptionOfferRequest)

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

ActivateSubscriptionOfferRequest

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

ייצוג JSON 
{
  "packageName": string,
  "productId": string,
  "basePlanId": string,
  "offerId": string,
  "latencyTolerance": enum (ProductUpdateLatencyTolerance)
}
שדות
packageName

string

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

string

חובה. המינוי ההורה (ID) של המבצע שיש להפעיל.
basePlanId

string

חובה. המינוי הבסיסי (ID) של המבצע שמוגדר כהורה להפעלה.
offerId

string

חובה. מזהה המבצע הייחודי של המבצע שיש להפעיל.
latencyTolerance

enum (ProductUpdateLatencyTolerance)

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

DeactivateSubscriptionOfferRequest

בקשה של הודעת Offers.deactivate.

ייצוג JSON 
{
  "packageName": string,
  "productId": string,
  "basePlanId": string,
  "offerId": string,
  "latencyTolerance": enum (ProductUpdateLatencyTolerance)
}
שדות
packageName

string

חובה. אפליקציית ההורה (שם החבילה) של המבצע שצריך להשבית.
productId

string

חובה. המינוי ההורה (ID) של המבצע שצריך להשבית.
basePlanId

string

חובה. המינוי הבסיסי (ID) של המבצע שרוצים להשבית.
offerId

string

חובה. מזהה המבצע הייחודי של המבצע שרוצים להשבית.
latencyTolerance

enum (ProductUpdateLatencyTolerance)

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