Method: monetization.onetimeproducts.purchaseOptions.batchUpdateStates

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

בקשת HTTP

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

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

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

פרמטרים
packageName

string

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

string

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

גוף הבקשה

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

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

object (UpdatePurchaseOptionStateRequest)

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

גוף התשובה

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

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

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

object (OneTimeProduct)

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

היקפי הרשאה

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

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

UpdatePurchaseOptionStateRequest

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

ייצוג ב-JSON 
{

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

object (ActivatePurchaseOptionRequest)

הפעלה של אפשרות רכישה. אחרי ההפעלה, אפשרות הרכישה תהיה זמינה.
deactivatePurchaseOptionRequest

object (DeactivatePurchaseOptionRequest)

השבתה של אפשרות רכישה. אחרי ההשבתה, אפשרות הרכישה לא תהיה זמינה יותר.

ActivatePurchaseOptionRequest

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

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

string

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

string

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

string

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

enum (ProductUpdateLatencyTolerance)

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

DeactivatePurchaseOptionRequest

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

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

string

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

string

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

string

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

enum (ProductUpdateLatencyTolerance)

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