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)

تصنيف المحتوى الرقمي أو الخدمة للمنتجات الموزَّعة على المستخدمين في المنطقة الاقتصادية الأوروبية: نظام الانسحاب وفقًا لقوانين حماية المستهلك في المنطقة الاقتصادية الأوروبية معتمد على هذا التصنيف. يُرجى الرجوع إلى مقالة مركز المساعدة للاطّلاع على مزيد من المعلومات.
taxRateInfoByRegionCode

map (key: string, value: object (RegionalTaxRateInfo))

تعيين من رمز المنطقة إلى تفاصيل معدل الضريبة. والمفاتيح هي رموز مناطق كما هو موضح في CLDR في يونيكود.

عنصر يحتوي على قائمة بأزواج "key": value مثال: { "name": "wrench", "mass": "1.3kg", "count": "3" }
isTokenizedDigitalAsset

boolean

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

الطُرق

batchDelete

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

batchGet

 يقرأ العديد من المنتجات داخل التطبيق، والتي يمكن إدارتها من خلال المنتجات أو الاشتراكات.

batchUpdate

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

delete

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

get

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

insert

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

list

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

patch

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

update

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