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
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "activateOneTimeProductOfferRequest": {
    object (ActivateOneTimeProductOfferRequest)
  },
  "cancelOneTimeProductOfferRequest": {
    object (CancelOneTimeProductOfferRequest)
  },
  "deactivateOneTimeProductOfferRequest": {
    object (DeactivateOneTimeProductOfferRequest)
  }
  // End of mutually exclusive fields.
}
שדות
סוג המעבר בין המצבים שצריך להחיל. צריך להגדיר בדיוק אחד. ברשימה הבאה מפורטים שדות שמוציאים זה את זה. בתשובה יוגדר לכל היותר אחד מהשדות הבאים:
activateOneTimeProductOfferRequest

object (ActivateOneTimeProductOfferRequest)

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

cancelOneTimeProductOfferRequest

object (CancelOneTimeProductOfferRequest)

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

deactivateOneTimeProductOfferRequest

object (DeactivateOneTimeProductOfferRequest)

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

סוף השדות שמוציאים זה את זה.

CancelOneTimeProductOfferRequest

הודעת בקשה ל-offers.cancel.

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

string

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

productId

string

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

purchaseOptionId

string

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

offerId

string

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

latencyTolerance

enum (ProductUpdateLatencyTolerance)

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

DeactivateOneTimeProductOfferRequest

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

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

string

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

productId

string

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

purchaseOptionId

string

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

offerId

string

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

latencyTolerance

enum (ProductUpdateLatencyTolerance)

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