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 (7 ימים) לבין P999D (999 ימים).
gracePeriod

string

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

שדה האיחוד TaxAndComplianceType.

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

object (SubscriptionTaxAndComplianceSettings)

פרטים על מיסים ותאימות משפטית. רלוונטי רק למוצרים שמוגדרים כמינויים.
managedProductTaxesAndComplianceSettings

object (ManagedProductTaxAndComplianceSettings)

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

סטטוס

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

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

PurchaseType

סוג המוצר.

טיפוסים בני מנייה (enum)
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). התנאים לביטול עסקה בהתאם לחוקים להגנת הצרכן באזור הכלכלי האירופי תלויים בסיווג הזה. מידע נוסף זמין במאמר הזה במרכז העזרה.
taxRateInfoByRegionCode

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

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

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

boolean

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

Methods

batchDelete

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

batchGet

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

batchUpdate

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

delete

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

get

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

insert

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

list

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

patch

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

update

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