Method: monetization.subscriptions.basePlans.offers.batchUpdateStates

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

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

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

string

חובה. המינוי הבסיסי ההורה (מזהה) של המבצע שצריך להפעיל.
offerId

string

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

enum (ProductUpdateLatencyTolerance)

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

DeactivateSubscriptionOfferRequest

הודעת בקשה ל-offers.deactivate.

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

string

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

string

חובה. המינוי הראשי (מזהה) של המבצע שרוצים להשבית.
basePlanId

string

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

string

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

enum (ProductUpdateLatencyTolerance)

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