REST Resource: monetization.onetimeproducts.purchaseOptions.offers

משאב: OneTimeProductOffer

מבצע יחיד למוצר בחיוב חד-פעמי.

ייצוג ב-JSON 
{
  "packageName": string,
  "productId": string,
  "purchaseOptionId": string,
  "offerId": string,
  "state": enum (State),
  "regionalPricingAndAvailabilityConfigs": [
    {
      object (RegionalPricingAndAvailabilityConfig)
    }
  ],
  "offerTags": [
    {
      object (OfferTag)
    }
  ],
  "regionsVersion": {
    object (RegionsVersion)
  },

  // Union field offer_type can be only one of the following:
  "preOrderOffer": {
    object (OneTimeProductPreOrderOffer)
  },
  "discountedOffer": {
    object (OneTimeProductDiscountedOffer)
  }
  // End of list of possible types for union field offer_type.
}
שדות
packageName

string

חובה. אי אפשר לשנות אותו. שם החבילה של האפליקציה שאליה שייך מוצר האב.
productId

string

חובה. אי אפשר לשנות אותו. המזהה של מוצר האב שאליו שייך המבצע הזה.
purchaseOptionId

string

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

string

חובה. אי אפשר לשנות אותו. המזהה של מבצע המוצר הזה. המזהה חייב להיות ייחודי במסגרת אפשרות הרכישה. המזהה צריך להתחיל במספר או באות קטנה, ויכול לכלול רק אותיות קטנות באנגלית (a-z), ספרות (0-9) ומקפים (-). האורך המקסימלי הוא 63 תווים.
state

enum (State)

פלט בלבד. המצב הנוכחי של המבצע. אי אפשר לשנות את השדה הזה על ידי עדכון המשאב. במקום זאת, צריך להשתמש בנקודות הקצה הייעודיות.
regionalPricingAndAvailabilityConfigs[]

object (RegionalPricingAndAvailabilityConfig)

קבוצה של נתוני תמחור וזמינות לפי אזור למוצר הזה. אסור לכלול רשומות כפולות עם אותו ערך של regionCode.
offerTags[]

object (OfferTag)

אופציונלי. רשימה של עד 20 תגים מותאמים אישית שצוינו למוצר הזה ומוחזרים לאפליקציה דרך ספריית החיוב.
regionsVersion

object (RegionsVersion)

פלט בלבד. הגרסה של הגדרת האזורים ששימשה ליצירת הצעת המוצר החד-פעמית.
שדה איחוד offer_type. סוג המבצע. צריך להגדיר בדיוק אחד מהם. הערך offer_type יכול להיות רק אחד מהערכים הבאים:
preOrderOffer

object (OneTimeProductPreOrderOffer)

מבצע להזמנה מראש.
discountedOffer

object (OneTimeProductDiscountedOffer)

הנחה.

מדינה

המצב הנוכחי של ההטבה.

טיפוסים בני מנייה (enum)
STATE_UNSPECIFIED ערך ברירת מחדל, לא אמור לשמש אף פעם.
DRAFT המבצע לא זמין למשתמשים, ולא היה זמין אף פעם.
ACTIVE המבצע זמין למשתמשים שעומדים בתנאים שלו.
CANCELLED המצב הזה ספציפי להזמנות מראש. המבצע מבוטל ולא זמין למשתמשים. כל ההזמנות בהמתנה שקשורות למבצע הזה בוטלו.
INACTIVE הסטטוס הזה ספציפי למוצרים עם הנחה. המבצע כבר לא זמין למשתמשים.

OneTimeProductPreOrderOffer

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

ייצוג ב-JSON 
{
  "startTime": string,
  "endTime": string,
  "releaseTime": string,
  "priceChangeBehavior": enum (PreOrderPriceChangeBehavior)
}
שדות
startTime

string (Timestamp format)

חובה. השעה שבה ההזמנה מראש תתחיל להיות זמינה.

הפונקציה משתמשת ב-RFC 3339, והפלט שנוצר תמיד יהיה מנורמל ל-Z וישתמש ב-0, 3, 6 או 9 ספרות חלקיות. אפשר להשתמש גם בהיסטים אחרים מלבד Z. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
endTime

string (Timestamp format)

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

הפונקציה משתמשת ב-RFC 3339, והפלט שנוצר תמיד יהיה מנורמל ל-Z וישתמש ב-0, 3, 6 או 9 ספרות חלקיות. אפשר להשתמש גם בהיסטים אחרים מלבד Z. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
releaseTime

string (Timestamp format)

חובה. השעה שבה המוצר שמשויך להזמנה מראש יושק וההזמנות מראש יושלמו.

הפונקציה משתמשת ב-RFC 3339, והפלט שנוצר תמיד יהיה מנורמל ל-Z וישתמש ב-0, 3, 6 או 9 ספרות חלקיות. אפשר להשתמש גם בהיסטים אחרים מלבד Z. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
priceChangeBehavior

enum (PreOrderPriceChangeBehavior)

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

PreOrderPriceChangeBehavior

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

טיפוסים בני מנייה (enum)
PRE_ORDER_PRICE_CHANGE_BEHAVIOR_UNSPECIFIED התנהגות לא מוגדרת של שינוי מחיר. אסור להשתמש בו.
PRE_ORDER_PRICE_CHANGE_BEHAVIOR_TWO_POINT_LOWEST הקונה יחויב במחיר המינימלי בין המחיר הראשוני בזמן ההזמנה מראש לבין מחיר המבצע הסופי בתאריך הפרסום.
PRE_ORDER_PRICE_CHANGE_BEHAVIOR_NEW_ORDERS_ONLY הקונה מקבל את אותו המחיר שבו הוא הזמין מראש, ללא קשר לשינויים במחיר שאולי קרו אחרי ההזמנה מראש.

OneTimeProductDiscountedOffer

הגדרה ספציפית למבצעים עם הנחה.

ייצוג ב-JSON 
{
  "startTime": string,
  "endTime": string,
  "redemptionLimit": string
}
שדות
startTime

string (Timestamp format)

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

הפונקציה משתמשת ב-RFC 3339, והפלט שנוצר תמיד יהיה מנורמל ל-Z וישתמש ב-0, 3, 6 או 9 ספרות חלקיות. אפשר להשתמש גם בהיסטים אחרים מלבד Z. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
endTime

string (Timestamp format)

השעה שבה המבצע יפסיק להיות זמין.

הפונקציה משתמשת ב-RFC 3339, והפלט שנוצר תמיד יהיה מנורמל ל-Z וישתמש ב-0, 3, 6 או 9 ספרות חלקיות. אפשר להשתמש גם בהיסטים אחרים מלבד Z. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
redemptionLimit

string (int64 format)

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

RegionalPricingAndAvailabilityConfig

הגדרת תמחור וזמינות לפי אזור למוצר חד-פעמי.

ייצוג ב-JSON 
{
  "regionCode": string,
  "availability": enum (Availability),

  // Union field price_override can be only one of the following:
  "noOverride": {
    object (OneTimeProductOfferNoPriceOverrideOptions)
  },
  "relativeDiscount": number,
  "absoluteDiscount": {
    object (Money)
  }
  // End of list of possible types for union field price_override.
}
שדות
regionCode

string

חובה. קוד האזור שאליו חלה ההגדרה הזו, כפי שמוגדר בתקן ISO 3166-2, למשל: "US".
availability

enum (Availability)

חובה. הזמינות באזור הזה.
שדה איחוד price_override. המחיר החלופי של המבצע הזה. צריך להגדיר בדיוק אחד מהם. הערך price_override יכול להיות רק אחד מהערכים הבאים:
noOverride

object (OneTimeProductOfferNoPriceOverrideOptions)

המערכת תשתמש במחיר שהוגדר באפשרות הרכישה לאזור הזה.
relativeDiscount

number

החלק ממחיר אפשרות הרכישה שהמשתמש משלם על המבצע הזה. לדוגמה, אם מחיר אפשרות הרכישה באזור הזה הוא 12$, הנחה של 50% תתאים למחיר של 6$. ההנחה צריכה להיות שבר שגדול מ-0 וקטן מ-1. המחיר שיתקבל יעוגל ליחידת החיוב הקרובה ביותר (למשל, סנטים לדולר ארה"ב). ההנחה היחסית נחשבת לא תקינה אם המחיר אחרי ההנחה נמוך מהמחיר המינימלי שמותר באזור הזה.
absoluteDiscount

object (Money)

הערך המוחלט של ההנחה שמופחתת ממחיר אפשרות הרכישה.

הוא צריך להיות בין 0 לבין מחיר אפשרות הרכישה.

OneTimeProductOfferNoPriceOverrideOptions

אין שדות מסוג זה.

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

זמינות

זמינות המבצע.

טיפוסים בני מנייה (enum)
AVAILABILITY_UNSPECIFIED זמינות לא מוגדרת. אסור להשתמש בו.
AVAILABLE המבצע זמין למשתמשים.
NO_LONGER_AVAILABLE המבצע כבר לא זמין למשתמשים. אפשר להשתמש בערך הזה רק אם הזמינות הוגדרה קודם כ'זמין'.

Methods

activate

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

batchDelete

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

batchGet

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

batchUpdate

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

batchUpdateStates

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

cancel

 ביטול מבצע של מוצר בחיוב חד-פעמי.

deactivate

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

list

 רשימה של כל המבצעים באפליקציה, במוצר או באפשרות רכישה מסוימים.