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)

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

מדינה (State)

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

טיפוסים בני מנייה (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 אפשרות הרכישה לא זמינה בהתחלה, אבל היא הופכת לזמינה דרך מבצע להזמנה מראש של מוצר שכבר הושק.
AVAILABLE_FOR_OFFERS_ONLY אפשרות הרכישה לא זמינה, אבל המבצעים שמקושרים אליה (למשל מבצע של Play Points) זמינים.

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 ההגדרה כבר לא זמינה ולא תהיה בשימוש באזורים חדשים שבהם Google Play תושק בעתיד. אפשר להשתמש בערך הזה רק אם הזמינות הוגדרה קודם כ'זמין'.

PurchaseOptionTaxAndComplianceSettings

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

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

enum (WithdrawalRightType)

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

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

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

Methods

batchDelete

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

batchGet

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

batchUpdate

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

delete

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

get

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

list

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

patch

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

קודי שגיאה

הפעולות של המשאב הזה מחזירות את קודי שגיאות ה-HTTP הבאים:

קוד שגיאה סיבה דרך פתרון
5xx שגיאה כללית בשרת של Google Play. צריך לנסות לשלוח את הבקשה שוב.

אם הבעיה נמשכת, אפשר לפנות למנהל החשבון ב-Google Play או לשלוח בקשת תמיכה. כדאי לבדוק ב-Play Status Dashboard אם יש הפסקות זמניות ידועות בשירות.
409 שגיאה בעדכון של מספר החיבורים בו-זמנית.

היה ניסיון לעדכן אובייקט שנמצא בתהליך עדכון. לדוגמה, רכישה מאושרת על ידי הפעלת ה-method acknowledgePurchase() של Play Billing Library והפעלת ה-method purchases.products.acknowledge של Play Developer API בו-זמנית.

 צריך לנסות לשלוח את הבקשה שוב.