Method: monetization.subscriptions.basePlans.offers.batchUpdateStates

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

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

בקשת HTTP

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

כתובת ה-URL משתמשת בתחביר של Transcoding של gRPC.

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

פרמטרים
packageName

string

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

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

string

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

string

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

גוף הבקשה

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

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

object (UpdateSubscriptionOfferStateRequest)

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

גוף התשובה

הודעת התגובה של ה-method‏ 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)

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