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,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "subscriptionTaxesAndComplianceSettings": {
    object (SubscriptionTaxAndComplianceSettings)
  },
  "managedProductTaxesAndComplianceSettings": {
    object (ManagedProductTaxAndComplianceSettings)
  }
  // End of mutually exclusive fields.
}
שדות
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
(deprecated)

string

הוצא משימוש: אין יותר תמיכה במינויים ב-InAppProducts API. במקום זאת, צריך להשתמש ב-Subscriptions API.
trialPeriod
(deprecated)

string

הוצא משימוש: אין יותר תמיכה במינויים ב-InAppProducts API. במקום זאת, צריך להשתמש ב-Subscriptions API.
gracePeriod
(deprecated)

string

הוצא משימוש: אין יותר תמיכה במינויים ב-InAppProducts API. במקום זאת, צריך להשתמש ב-Subscriptions API.
זו רשימה של שדות שמוציאים זה את זה. בתשובה יוגדר לכל היותר אחד מהשדות הבאים:
subscriptionTaxesAndComplianceSettings
(deprecated)

object (SubscriptionTaxAndComplianceSettings)

הוצא משימוש: אין יותר תמיכה במינויים ב-InAppProducts API. במקום זאת, צריך להשתמש ב-Subscriptions API.
managedProductTaxesAndComplianceSettings

object (ManagedProductTaxAndComplianceSettings)

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

סטטוס

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

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

PurchaseType

סוג המוצר.

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

הוצא משימוש: אין יותר תמיכה במינויים ב-InAppProducts API. במקום זאת, צריך להשתמש ב-Subscriptions API.

InAppProductListing

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

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

string

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

string

תיאור לדף האפליקציה בחנות.
benefits[]
(deprecated)

string

הוצא משימוש: אין יותר תמיכה במינויים ב-InAppProducts API. במקום זאת, צריך להשתמש ב-Subscriptions API.

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:

קוד שגיאה סיבה תיאור פתרון