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

واحد نگهداری موجودی (SKU) محصول، منحصر به فرد در یک برنامه.

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 از داده‌های عنوان و توضیحات بومی‌سازی شده. کلید نقشه، زبان داده‌های بومی‌سازی شده است، همانطور که توسط 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 )

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

وضعیت

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

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

نوع خرید

نوع محصول.

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

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

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

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

string

عنوان برای فهرست فروشگاه.

description

string

توضیحات مربوط به فهرست فروشگاه.

benefits[]

string

مزایای حق اشتراک محلی.

تنظیمات مدیریت‌شده‌ی مالیات و انطباق محصول

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

نمایش 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 زیر را برمی‌گرداند:

کد خطا دلیل وضوح تصویر
5xx خطای عمومی در سرور گوگل پلی. درخواست خود را دوباره امتحان کنید.

اگر مشکل همچنان ادامه داشت، با مدیر حساب Google Play خود تماس بگیرید یا درخواست پشتیبانی ارسال کنید. داشبورد وضعیت Play را برای هرگونه قطعی شناخته شده بررسی کنید.

409 خطای به‌روزرسانی همزمان.

تلاشی برای به‌روزرسانی شیء در حال به‌روزرسانی صورت گرفته است. برای مثال، یک خرید با فراخوانی متد acknowledgePurchase() از کتابخانه‌ی صورتحساب Play و با فراخوانی همزمان purchases.products.acknowledge از API توسعه‌دهنده‌ی Play، تأیید می‌شود.

 درخواست خود را دوباره امتحان کنید.