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

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