Method: monetization.subscriptions.basePlans.batchUpdateStates

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

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

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

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

string

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

string

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

string

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

enum (ProductUpdateLatencyTolerance)

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

DeactivateBasePlanRequest

הודעת בקשה עבור basePlans.deactivate.

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

string

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

string

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

string

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

enum (ProductUpdateLatencyTolerance)

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