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)

מחיר ברירת המחדל. הערך לא יכול להיות אפס, כי מוצרים מתוך האפליקציה אף פעם לא חינמיים. תמיד במטבע של המוכר שמוגדר בתהליך התשלום של המפתח.
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 of localized title and description data. מפתח המפה הוא השפה של הנתונים המותאמים לשוק המקומי, כפי שמוגדר בתקן 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)

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

סטטוס

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

טיפוסים בני מנייה (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,
  "regionalProductAgeRatingInfos": [
    {
      object (RegionalProductAgeRatingInfo)
    }
  ],
  "productTaxCategoryCode": string
}
שדות
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

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

object (RegionalProductAgeRatingInfo)

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

string

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

Methods

batchDelete

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

batchGet

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

batchUpdate

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

delete

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

get

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

insert

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

list

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

patch

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

update

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

קודי שגיאה

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

קוד שגיאה סיבה תיאור רזולוציה