Method: monetization.subscriptions.basePlans.batchUpdateStates

הפעלה או השבתה של מינויים בסיסיים במינוי אחד או במספר מינויים.

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

בקשת HTTP

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

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

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

פרמטרים
packageName

string

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

string

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

גוף הבקשה

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

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

object (UpdateBasePlanStateRequest)

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

גוף התשובה

הודעת תגובה לגבי basePlans.batchUpdateStates.

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

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

object (Subscription)

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

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

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

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

UpdateBasePlanStateRequest

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

ייצוג JSON 
{

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

object (ActivateBasePlanRequest)

הפעלת מינוי בסיסי. לאחר ההפעלה, המינויים הבסיסיים יהיו זמינים למנויים חדשים.
deactivateBasePlanRequest

object (DeactivateBasePlanRequest)

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

ActivateBasePlanRequest

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

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

string

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

string

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

string

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

enum (ProductUpdateLatencyTolerance)

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

DeactivateBasePlanRequest

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

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

string

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

string

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

string

חובה. המזהה הייחודי של המינוי הבסיסי להשבתה.
latencyTolerance

enum (ProductUpdateLatencyTolerance)

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