REST Resource: monetization.onetimeproducts

משאב: OneTimeProduct

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

ייצוג ב-JSON 
{
  "packageName": string,
  "productId": string,
  "listings": [
    {
      object (OneTimeProductListing)
    }
  ],
  "taxAndComplianceSettings": {
    object (OneTimeProductTaxAndComplianceSettings)
  },
  "purchaseOptions": [
    {
      object (OneTimeProductPurchaseOption)
    }
  ],
  "restrictedPaymentCountries": {
    object (RestrictedPaymentCountries)
  },
  "offerTags": [
    {
      object (OfferTag)
    }
  ],
  "regionsVersion": {
    object (RegionsVersion)
  }
}
שדות
packageName

string

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

string

חובה. אי אפשר לשנות אותו. מזהה המוצר הייחודי של המוצר. המזהה צריך להיות ייחודי באפליקציית האב. מזהי מוצרים חייבים להתחיל בספרה או באות קטנה, ויכולים להכיל ספרות (0-9), אותיות קטנות (a-z), קווים תחתונים (_) ונקודות (.).
listings[]

object (OneTimeProductListing)

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

object (OneTimeProductTaxAndComplianceSettings)

פרטים על מיסים ותאימות משפטית.
purchaseOptions[]

object (OneTimeProductPurchaseOption)

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

object (RestrictedPaymentCountries)

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

object (OfferTag)

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

object (RegionsVersion)

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

OneTimeProductListing

כרטיס אזורי למוצר בחיוב חד-פעמי.

ייצוג ב-JSON 
{
  "languageCode": string,
  "title": string,
  "description": string
}
שדות
languageCode

string

חובה. השפה של כרטיס המוצר הזה, כפי שמוגדרת בתקן BCP-47, למשל ‫"en-US".
title

string

חובה. שם המוצר בשפה של כרטיס המוצר הזה. האורך המקסימלי הוא 55 תווים.
description

string

חובה. תיאור המוצר בשפה של כרטיס המוצר. האורך המקסימלי הוא 200 תווים.

OneTimeProductTaxAndComplianceSettings

פרטים על מיסוי, מדיניות Google Play ותאימות משפטית למוצרים בחיוב חד-פעמי.

ייצוג ב-JSON 
{
  "regionalTaxConfigs": [
    {
      object (RegionalTaxConfig)
    }
  ],
  "isTokenizedDigitalAsset": boolean
}
שדות
regionalTaxConfigs[]

object (RegionalTaxConfig)

הגדרת מס אזורי.
isTokenizedDigitalAsset

boolean

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

RegionalTaxConfig

פרטים על מיסוי באזור גיאוגרפי מסוים.

ייצוג ב-JSON 
{
  "regionCode": string,
  "taxTier": enum (TaxTier),
  "eligibleForStreamingServiceTaxRate": boolean,
  "streamingTaxType": enum (StreamingTaxType)
}
שדות
regionCode

string

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

enum (TaxTier)

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

מידע נוסף
eligibleForStreamingServiceTaxRate

boolean

עליך להודיע לנו אם האפליקציה שלך מכילה מוצרי סטרימינג כדי שנוכל לגבות את השיעור הנכון של מס המכירה ברמה המקומית וברמת המדינה בארה"ב. השדה נתמך רק בארצות הברית.
streamingTaxType

enum (StreamingTaxType)

כדי לגבות מיסי תקשורת או בידור בארצות הברית, צריך לבחור את קטגוריית המס המתאימה.

מידע נוסף

OneTimeProductPurchaseOption

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

ייצוג ב-JSON 
{
  "purchaseOptionId": string,
  "state": enum (State),
  "regionalPricingAndAvailabilityConfigs": [
    {
      object (RegionalPricingAndAvailabilityConfig)
    }
  ],
  "newRegionsConfig": {
    object (OneTimeProductPurchaseOptionNewRegionsConfig)
  },
  "offerTags": [
    {
      object (OfferTag)
    }
  ],
  "taxAndComplianceSettings": {
    object (PurchaseOptionTaxAndComplianceSettings)
  },

  // Union field purchase_option_type can be only one of the following:
  "buyOption": {
    object (OneTimeProductBuyPurchaseOption)
  },
  "rentOption": {
    object (OneTimeProductRentPurchaseOption)
  }
  // End of list of possible types for union field purchase_option_type.
}
שדות
purchaseOptionId

string

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

enum (State)

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

object (RegionalPricingAndAvailabilityConfig)

פרטי התמחור והזמינות לפי אזור של אפשרות הרכישה הזו.
newRegionsConfig

object (OneTimeProductPurchaseOptionNewRegionsConfig)

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

object (OfferTag)

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

object (PurchaseOptionTaxAndComplianceSettings)

אופציונלי. פרטים על מיסים ותאימות משפטית.
שדה איחוד purchase_option_type. סוג אפשרות הרכישה. צריך להגדיר בדיוק אחד מהם. הערך purchase_option_type יכול להיות רק אחד מהערכים הבאים:
buyOption

object (OneTimeProductBuyPurchaseOption)

אפשרות רכישה שאפשר לקנות.
rentOption

object (OneTimeProductRentPurchaseOption)

אפשרות רכישה שאפשר לשכור.

מדינה

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

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

OneTimeProductBuyPurchaseOption

אפשרות רכישה שאפשר לקנות.

ייצוג ב-JSON 
{
  "legacyCompatible": boolean,
  "multiQuantityEnabled": boolean
}
שדות
legacyCompatible

boolean

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

אפשר לסמן עד אפשרות רכישה אחת מסוג 'קנייה' כתואמת לדור קודם.
multiQuantityEnabled

boolean

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

OneTimeProductRentPurchaseOption

אפשרות רכישה שאפשר לשכור.

ייצוג ב-JSON 
{
  "rentalPeriod": string,
  "expirationPeriod": string
}
שדות
rentalPeriod

string

חובה. משך הזמן שבו למשתמש יש את ההרשאה. מתחיל עם השלמת תהליך הרכישה. התאריך צריך להיות בפורמט ISO 8601.
expirationPeriod

string

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

RegionalPricingAndAvailabilityConfig

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

ייצוג ב-JSON 
{
  "regionCode": string,
  "price": {
    object (Money)
  },
  "availability": enum (Availability)
}
שדות
regionCode

string

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

object (Money)

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

enum (Availability)

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

זמינות

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

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

OneTimeProductPurchaseOptionNewRegionsConfig

פרטי התמחור לכל אזור חדש ש-Play עשויה להשיק בעתיד.

ייצוג ב-JSON 
{
  "usdPrice": {
    object (Money)
  },
  "eurPrice": {
    object (Money)
  },
  "availability": enum (Availability)
}
שדות
usdPrice

object (Money)

חובה. המחיר בדולר ארה"ב לשימוש בכל האזורים החדשים שבהם יכול להיות ש-Play תושק.
eurPrice

object (Money)

חובה. המחיר ב-EUR לשימוש בכל האזורים החדשים ש-Play עשויה להשיק בהם.
availability

enum (Availability)

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

זמינות

הזמינות של הגדרת האזורים החדשה.

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

PurchaseOptionTaxAndComplianceSettings

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

ייצוג ב-JSON 
{
  "withdrawalRightType": enum (WithdrawalRightType)
}
שדות
withdrawalRightType

enum (WithdrawalRightType)

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

אם לא מגדירים ערך לפרמטר הזה, ערך ברירת המחדל שלו הוא WITHDRAWAL_RIGHT_DIGITAL_CONTENT.

מידע נוסף זמין במאמר הזה במרכז העזרה.

Methods

batchDelete

 מחיקת מוצר אחד או יותר בחיוב חד-פעמי.

batchGet

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

batchUpdate

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

delete

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

get

 קריאת מוצר בחיוב חד-פעמי.

list

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

patch

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