Method: monetization.subscriptions.basePlans.batchUpdateStates

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

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

בקשת HTTP

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

כתובת ה-URL משתמשת בתחביר של Transcoding של 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

הודעת בקשה לעדכון המצב של מינוי Base Plan.

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

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