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
}
שדות
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

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

קודי שגיאה

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

קוד שגיאה סיבה רזולוציה
5xx שגיאה כללית בשרת של Google Play. מנסים לשלוח את הבקשה שוב.

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

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

 מנסים לשלוח את הבקשה שוב.