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

واحد نگهداری موجودی (SKU) محصول، منحصربه‌فرد در برنامه.
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 پشتیبانی نمی‌شوند. درعوض از میانای برنامه‌سازی کاربردی «اشتراک‌ها» استفاده کنید.
trialPeriod
(deprecated)

string

منسوخ‌شده: اشتراک‌ها دیگر در میانای برنامه‌سازی کاربردی InAppProducts پشتیبانی نمی‌شوند. درعوض از میانای برنامه‌سازی کاربردی «اشتراک‌ها» استفاده کنید.
gracePeriod
(deprecated)

string

منسوخ‌شده: اشتراک‌ها دیگر در میانای برنامه‌سازی کاربردی InAppProducts پشتیبانی نمی‌شوند. درعوض از میانای برنامه‌سازی کاربردی «اشتراک‌ها» استفاده کنید.
در زیر فهرستی از فیلدهای متقابلاً انحصاری آمده است. حداکثر یکی از فیلدها در پاسخ تنظیم خواهد شد:
subscriptionTaxesAndComplianceSettings
(deprecated)

object (SubscriptionTaxAndComplianceSettings)

منسوخ‌شده: اشتراک‌ها دیگر در میانای برنامه‌سازی کاربردی InAppProducts پشتیبانی نمی‌شوند. درعوض از میانای برنامه‌سازی کاربردی «اشتراک‌ها» استفاده کنید.
managedProductTaxesAndComplianceSettings

object (ManagedProductTaxAndComplianceSettings)

جزئیات مربوط به مالیات و رعایت استانداردهای قانونی. فقط برای محصولات مدیریت‌شده قابل‌اجرا است.
پایان فیلدهای متقابلاً انحصاری.

وضعیت

وضعیت محصول درون‌برنامه.

شمارشی‌ها
statusUnspecified وضعیت نامشخص.
active محصول منتشر شده و در فروشگاه فعال است.
inactive محصول منتشر نشده است و بنابراین در فروشگاه غیرفعال است.

PurchaseType

نوع محصول.

شمارشی‌ها
purchaseTypeUnspecified نوع خرید نامشخص است.
managedUser نوع محصول پیش‌فرض - خرید یک‌باره.
subscription

منسوخ‌شده: اشتراک‌ها دیگر در میانای برنامه‌سازی کاربردی InAppProducts پشتیبانی نمی‌شوند. درعوض از میانای برنامه‌سازی کاربردی «اشتراک‌ها» استفاده کنید.

InAppProductListing

فهرستگان فروشگاه یک محصول درون‌برنامه.

نمایش JSON 
{
  "title": string,
  "description": string,
  "benefits": [
    string
  ]
}
فیلدها
title

string

عنوان فهرستگان مکان.
description

string

توضیحات مربوط به فهرستگان فروشگاه.
benefits[]
(deprecated)

string

منسوخ‌شده: اشتراک‌ها دیگر در میانای برنامه‌سازی کاربردی InAppProducts پشتیبانی نمی‌شوند. درعوض از میانای برنامه‌سازی کاربردی «اشتراک‌ها» استفاده کنید.

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» یونی‌کد تعریف شده‌اند.

شیئی که حاوی فهرستی از جفت‌های "key": value است. مثال: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
isTokenizedDigitalAsset

boolean

اینکه این محصول درون‌برنامه به‌عنوان محصولی که دارایی دیجیتال نشانه‌گذاری‌شده ارائه می‌دهد اعلام شده است یا نه.
regionalProductAgeRatingInfos[]

object (RegionalProductAgeRatingInfo)

اطلاعات رده‌بندی سنی منطقه‌ای. درحال‌حاضر این فیلد فقط برای کد منطقه US پشتیبانی می‌شود.
productTaxCategoryCode

string

کد دسته مالیاتی محصول برای اختصاص دادن به محصول درون‌برنامه‌ای. دسته مالیات محصول تعیین می‌کند که چه نرخ مالیات تراکنشی بر محصول اعمال شود. برای اطلاعات بیشتر، به مقاله «مرکز راهنمایی» مراجعه کنید.

روش‌ها

batchDelete

 محصولات درون‌برنامه (محصولات یا اشتراک‌های مدیریت‌شده) را حذف می‌کند.

batchGet

 چندین محصول درون‌برنامه‌ای را می‌خواند که می‌تواند محصولات یا اشتراک‌های مدیریت‌شده باشد.

batchUpdate

 یک یا چند محصول درون‌برنامه (محصولات یا اشتراک‌های مدیریت‌شده) را به‌روزرسانی یا درج می‌کند.

delete

 محصول درون‌برنامه‌ای (محصول مدیریت‌شده یا اشتراک) را حذف می‌کند.

get

 محصول درون‌برنامه‌ای را دریافت می‌کند که می‌تواند محصول مدیریت‌شده یا اشتراک باشد.

insert

 محصول درون‌برنامه‌ای (محصول مدیریت‌شده یا اشتراک) ایجاد می‌کند.

list

 همه محصولات درون‌برنامه را فهرست می‌کند - هم محصولات مدیریت‌شده و هم اشتراک‌ها.

patch

 محصول درون‌برنامه‌ای (محصول مدیریت‌شده یا اشتراک) را وصله می‌کند.

update

 محصول درون‌برنامه‌ای (محصول مدیریت‌شده یا اشتراک) را به‌روز می‌کند.

کدهای خطا

عملیات این منبع، کدهای خطای HTTP زیر را برمی‌گرداند:

کد خطا استدلال شرح وضوح