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)

السعر التلقائي لا يمكن أن تكون القيمة صفرًا، لأنّ المنتجات داخل التطبيق لا تكون مجانية أبدًا. تكون دائمًا بعملة التاجر في 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

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 لم يتم نشر المنتج، وبالتالي فهو غير نشط في المتجر.

PurchaseType

نوع المنتج

عمليات التعداد
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

ما إذا كان هذا المنتج داخل التطبيق مُدرَجًا على أنّه منتج يمثّل أصلاً رقميًا محوَّلاً إلى رمز مميّز

الطُرق

batchDelete

حذف المنتجات داخل التطبيق (المنتجات المُدارة أو الاشتراكات)

batchGet

قراءة منتجات متعددة داخل التطبيق، والتي يمكن أن تكون منتجات مُدارة أو اشتراكات

batchUpdate

تعديل منتج واحد أو أكثر داخل التطبيق (منتجات أو اشتراكات مُدارة) أو إدراجه

delete

لحذف منتج داخل التطبيق (منتج مُدار أو اشتراك)

get

الحصول على منتج داخل التطبيق، والذي يمكن أن يكون منتجًا مُدارًا أو اشتراكًا

insert

لإنشاء منتج داخل التطبيق (منتج مُدار أو اشتراك)

list

تعرض هذه الصفحة كل المنتجات داخل التطبيق، سواء المنتجات المُدارة أو الاشتراكات.

patch

تصحيح منتج داخل التطبيق (منتج مُدار أو اشتراك)

update

تعديل منتج داخل التطبيق (منتج مُدار أو اشتراك)