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

رمز التخزين التعريفي للمنتج، وهو رمز فريد داخل التطبيق
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 of localized title and description data. مفتاح الخريطة هو لغة البيانات المترجمة، كما هو محدّد في 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

 تعدِّل هذه الطريقة منتجًا داخل التطبيق (منتجًا مُدارًا أو اشتراكًا).

رموز الخطأ

تعرض عمليات هذا المرجع رموز خطأ HTTP التالية:

رمز الخطأ السبب الدقة
5xx حدث خطأ عام في خادم Google Play. أعِد محاولة إرسال طلبك.

إذا استمرت المشكلة، يُرجى التواصل مع مدير حسابك على Google Play أو إرسال طلب دعم. ننصحك بالاطّلاع على لوحة البيانات الخاصة بحالة Play لمعرفة ما إذا كان هناك أي انقطاع معروف في الخدمة.
409 حدث خطأ أثناء تعديل التزامن.

حدثت محاولة لتعديل عنصر قيد التعديل. على سبيل المثال، يتم الإقرار بعملية شراء من خلال استدعاء الطريقة acknowledgePurchase() في Play Billing Library واستدعاء الطريقة purchases.products.acknowledge في Play Developer API في الوقت نفسه.

 أعِد محاولة إرسال طلبك.