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,
  "regionalProductAgeRatingInfos": [
    {
      object (RegionalProductAgeRatingInfo)
    }
  ],
  "productTaxCategoryCode": string
}
שדות
regionalTaxConfigs[]

object (RegionalTaxConfig)

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

isTokenizedDigitalAsset

boolean

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

regionalProductAgeRatingInfos[]

object (RegionalProductAgeRatingInfo)

מידע על סיווג תוכן אזורי. כרגע השדה הזה נתמך רק בקוד האזור US.

productTaxCategoryCode

string

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

RegionalTaxConfig

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

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

string

חובה. קוד האזור שההגדרה הזו חלה עליו, כפי שמוגדר בתקן ISO 3166-1 alpha-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)
  },

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "buyOption": {
    object (OneTimeProductBuyPurchaseOption)
  },
  "rentOption": {
    object (OneTimeProductRentPurchaseOption)
  }
  // End of mutually exclusive fields.
}
שדות
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)

אופציונלי. פרטים על מיסים ועמידה בהוראות הדין.

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

object (OneTimeProductBuyPurchaseOption)

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

rentOption

object (OneTimeProductRentPurchaseOption)

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

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

מדינה (State)

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

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

OneTimeProductBuyPurchaseOption

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

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

boolean

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

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

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-1 alpha-2, למשל "US".

price

object (Money)

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

availability

enum (Availability)

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

זמינות

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

טיפוסים בני מנייה (enum)
AVAILABILITY_UNSPECIFIED לא צוינה זמינות. אסור להשתמש בהם.
AVAILABLE אפשרות הרכישה זמינה למשתמשים.
NO_LONGER_AVAILABLE אפשרות הרכישה לא זמינה יותר למשתמשים. אפשר להשתמש בערך הזה רק אם הזמינות הוגדרה בעבר כ-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)

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

availability

enum (Availability)

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

זמינות

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

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

PurchaseOptionTaxAndComplianceSettings

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

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

enum (WithdrawalRightType)

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

אם המדיניות לא מוגדרת, ברירת המחדל היא WITHDRAWAL_RIGHT_DIGITAL_CONTENT.

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

Methods

batchDelete

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

batchGet

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

batchUpdate

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

delete

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

get

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

list

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

patch

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

קודי שגיאה

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

קוד שגיאה סיבה תיאור פתרון