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

קוד שגיאה סיבה תיאור רזולוציה
400 invalidValue צוין ערך לא תקין בבקשה. השגיאה הזו מוחזרת לעיתים קרובות כשפורמט טוקן הרכישה שגוי או כשהוא לא תקין. מתקנים את הערך הלא תקין של השדה בגוף הבקשה או בפרמטרים על סמך הפניה ל-API.
400 required חסר שדה או פרמטר חובה בבקשה. כדאי לעיין במסמכי התיעוד בנושא API כדי לוודא שכללתם את כל שדות החובה והפרמטרים הנדרשים.
403 userInsufficientPermission למשתמש אין מספיק הרשאות לביצוע הפעולה המבוקשת. מוודאים שלמשתמש המאומת יש את ההרשאות הנדרשות ב-Google Play Console. פרטים נוספים מופיעים במאמר בנושא שימוש בחשבון שירות.
404 notFound לא נמצא המשאב המבוקש. מוודאים שהמזהים (לדוגמה: טוקן רכישה, שם חבילה, מזהה מוצר, מזהה מינוי) נכונים.
409 concurrentUpdate היה ניסיון לעדכן אובייקט שנמצא בתהליך עדכון בו-זמני. מנסים לשלוח שוב את הבקשה עם השהיה מעריכית לפני ניסיון חוזר (exponential backoff). מומלץ להימנע משינויים בו-זמניים באותו משאב.
5xx Generic error שגיאה כללית בשרת של Google Play. צריך לנסות לשלוח את הבקשה שוב.

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