REST Resource: inappproducts

משאב: InAppProduct

מוצר מתוך האפליקציה. המשאב עבור InappproductsService.

ייצוג JSON
{
  "packageName": string,
  "sku": string,
  "status": enum (Status),
  "purchaseType": enum (PurchaseType),
  "defaultPrice": {
    object (Price)
  },
  "prices": {
    string: {
      object (Price)
    },
    ...
  },
  "listings": {
    string: {
      object (InAppProductListing)
    },
    ...
  },
  "defaultLanguage": string,
  "subscriptionPeriod": string,
  "trialPeriod": string,
  "gracePeriod": string,

  // Union field TaxAndComplianceType can be only one of the following:
  "subscriptionTaxesAndComplianceSettings": {
    object (SubscriptionTaxAndComplianceSettings)
  },
  "managedProductTaxesAndComplianceSettings": {
    object (ManagedProductTaxAndComplianceSettings)
  }
  // End of list of possible types for union field TaxAndComplianceType.
}
שדות
packageName

string

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

sku

string

יחידת אחזקת מלאי (מק"ט) של המוצר, ייחודית בתוך אפליקציה.

status

enum (Status)

סטטוס המוצר, למשל אם הוא פעיל.

purchaseType

enum (PurchaseType)

סוג המוצר, למשל מינוי קבוע.

defaultPrice

object (Price)

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

prices

map (key: string, value: object (Price))

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

אובייקט שמכיל רשימה של "key": value זוגות. דוגמה: { "name": "wrench", "mass": "1.3kg", "count": "3" }

listings

map (key: string, value: object (InAppProductListing))

inappproducts.list של נתוני כותרות ותיאורים מותאמים לשוק המקומי. מפתח המפה הוא השפה של הנתונים המקומיים, כפי שמוגדר על ידי BCP-47, למשל 'en-US'.

אובייקט שמכיל רשימה של "key": value זוגות. דוגמה: { "name": "wrench", "mass": "1.3kg", "count": "3" }

defaultLanguage

string

שפת ברירת המחדל של הנתונים שמותאמים לשוק המקומי, כפי שמוגדר ב-BCP-47. למשל 'en-US'.

subscriptionPeriod

string

תקופת המינוי, המצוינת בפורמט ISO 8601. הערכים הקבילים הם P1W (שבוע אחד), P1M (חודש אחד), P3M (שלושה חודשים), P6M (שישה חודשים) ו-P1Y (שנה אחת).

trialPeriod

string

תקופת ניסיון, המצוינת בפורמט ISO 8601. הערכים הקבילים הם כל ערך בטווח של P7D (שבעה ימים) עד P999D (999 ימים).

gracePeriod

string

תקופת חסד של המינוי, שצוינה בפורמט ISO 8601. המפתחים יכולים לתת למנויים שלהם תקופת חסד כאשר התשלום על תקופת החזרה החדשה נדחה. הערכים הקבילים הם P0D (אפס ימים), P3D (שלושה ימים), P7D (שבעה ימים), P14D (14 ימים) ו-P30D (30 ימים).

שדה איחוד TaxAndComplianceType.

הערך של TaxAndComplianceType יכול להיות רק אחת מהאפשרויות הבאות:

subscriptionTaxesAndComplianceSettings

object (SubscriptionTaxAndComplianceSettings)

פרטים לגבי מיסים ותאימות לחוק. רלוונטי רק למוצרים מסוג מינוי.

managedProductTaxesAndComplianceSettings

object (ManagedProductTaxAndComplianceSettings)

פרטים לגבי מיסים ותאימות לחוק. רלוונטי רק למוצרים מנוהלים.

סטטוס

הסטטוס של מוצר מתוך האפליקציה.

טיפוסים בני מנייה (enums)
statusUnspecified הסטטוס לא צוין.
active המוצר פורסם ופעיל בחנות.
inactive המוצר לא פורסם ולכן הוא לא פעיל בחנות.

PurchaseType

סוג המוצר.

טיפוסים בני מנייה (enums)
purchaseTypeUnspecified סוג רכישה לא צוין.
managedUser סוג המוצר שמוגדר כברירת מחדל – רכישה חד-פעמית.
subscription מוצר מתוך האפליקציה עם תקופה חוזרת.

InAppProductListing

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

ייצוג JSON
{
  "title": string,
  "description": string,
  "benefits": [
    string
  ]
}
שדות
title

string

כותרת לדף האפליקציה בחנות.

description

string

התיאור של דף האפליקציה בחנות.

benefits[]

string

הטבות זכאות מקומיות של מינוי.

ManagedProductTaxAndComplianceSettings

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

ייצוג JSON
{
  "eeaWithdrawalRightType": enum (WithdrawalRightType),
  "taxRateInfoByRegionCode": {
    string: {
      object (RegionalTaxRateInfo)
    },
    ...
  },
  "isTokenizedDigitalAsset": boolean
}
שדות
eeaWithdrawalRightType

enum (WithdrawalRightType)

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

taxRateInfoByRegionCode

map (key: string, value: object (RegionalTaxRateInfo))

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

אובייקט שמכיל רשימה של "key": value זוגות. דוגמה: { "name": "wrench", "mass": "1.3kg", "count": "3" }

isTokenizedDigitalAsset

boolean

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

שיטות

batchDelete

מחיקת מוצרים מתוך האפליקציה (מוצרים מנוהלים או מינויים).

batchGet

קורא כמה מוצרים מתוך האפליקציה, שיכולים להיות מוצרים מנוהלים או מינויים.

batchUpdate

מעדכן או מוסיף מוצר אחד או יותר מתוך האפליקציה (מוצרים מנוהלים או מינויים).

delete

מחיקת מוצר מתוך האפליקציה (מוצר מנוהל או מינוי).

get

מקבל מוצר מתוך האפליקציה, שיכול להיות מוצר מנוהל או מינוי.

insert

יצירת מוצר מתוך האפליקציה (מוצר מנוהל או מינוי).

list

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

patch

תיקונים של מוצר מתוך האפליקציה (מוצר מנוהל או מינוי).

update

עדכון מוצר מתוך האפליקציה (מוצר מנוהל או מינוי).