Method: monetization.onetimeproducts.purchaseOptions.offers.batchUpdateStates

עדכון של קבוצת מצבים של מוצרים בחיוב חד-פעמי.

בקשת HTTP

POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/oneTimeProducts/{productId}/purchaseOptions/{purchaseOptionId}/offers:batchUpdateStates

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

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

פרמטרים
packageName

string

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

string

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

string

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

גוף הבקשה

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

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

object (UpdateOneTimeProductOfferStateRequest)

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

גוף התשובה

הודעת תגובה ל-offers.batchUpdateStates.

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

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

object (OneTimeProductOffer)

רשימת המוצרים המעודכנת בחיוב חד-פעמי, באותו סדר שבו הם מופיעים בבקשה.

היקפי הרשאה

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

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

UpdateOneTimeProductOfferStateRequest

בקשה לעדכן את הסטטוס של מוצר בחיוב חד-פעמי.

ייצוג ב-JSON 
{

  // Union field state_transition_type can be only one of the following:
  "activateOneTimeProductOfferRequest": {
    object (ActivateOneTimeProductOfferRequest)
  },
  "cancelOneTimeProductOfferRequest": {
    object (CancelOneTimeProductOfferRequest)
  },
  "deactivateOneTimeProductOfferRequest": {
    object (DeactivateOneTimeProductOfferRequest)
  }
  // End of list of possible types for union field state_transition_type.
}
שדות
שדה איחוד state_transition_type. סוג מעבר המצב שרוצים להחיל. צריך להגדיר בדיוק אחד. הערך state_transition_type יכול להיות רק אחד מהערכים הבאים:
activateOneTimeProductOfferRequest

object (ActivateOneTimeProductOfferRequest)

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

object (CancelOneTimeProductOfferRequest)

ביטול מבצע. אחרי שמבטלים את המבצע, הוא לא זמין למשתמשים. כל ההזמנות בהמתנה שקשורות למבצע הזה יבוטלו. המעבר הזה בין מצבים רלוונטי רק להזמנות מראש.
deactivateOneTimeProductOfferRequest

object (DeactivateOneTimeProductOfferRequest)

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

CancelOneTimeProductOfferRequest

בקשת הודעה לביטול מבצעים.

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

string

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

string

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

string

חובה. אפשרות הרכישה הראשית (המזהה) של המבצע לביטול.
offerId

string

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

enum (ProductUpdateLatencyTolerance)

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

DeactivateOneTimeProductOfferRequest

הודעת בקשה להשבתת מבצעים.

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

string

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

string

חובה. מזהה המוצר בחיוב חד-פעמי (הורה) של המבצע שרוצים להשבית.
purchaseOptionId

string

חובה. אפשרות הרכישה הראשית (המזהה שלה) של המבצע שרוצים להשבית.
offerId

string

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

enum (ProductUpdateLatencyTolerance)

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