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 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,
  "regionalProductAgeRatingInfos": [
    {
      object (RegionalProductAgeRatingInfo)
    }
  ],
  "productTaxCategoryCode": string
}
الحقول
eeaWithdrawalRightType

enum (WithdrawalRightType)

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

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

تعرض هذه السمة عملية ربط بين رمز المنطقة وتفاصيل معدّل الضريبة. المفاتيح هي رموز المناطق كما هو محدّد في "CLDR" من Unicode.

عنصر يحتوي على قائمة بأزواج "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 التالية:

رمز الخطأ السبب الوصف الدقة
400 invalidValue تم إدخال قيمة غير صالحة في الطلب. يتم عرض هذا الرمز غالبًا عند تقديم رمز مميّز غير صالح أو غير مكتمل لعملية الشراء. صحِّح قيمة الحقل غير الصالحة في نص الطلب أو المَعلمات استنادًا إلى مرجع واجهة برمجة التطبيقات.
400 required لم يتم إدخال حقل أو مَعلمة مطلوبة في الطلب. راجِع مستندات واجهة برمجة التطبيقات للتأكّد من تضمين جميع الحقول والمَعلمات الإلزامية.
403 userInsufficientPermission لا يملك المستخدم الإذن الكافي لتنفيذ العملية المطلوبة. تأكَّد من أنّ المستخدم المصادَق عليه لديه الأذونات اللازمة في Google Play Console. لمزيد من التفاصيل، يُرجى الاطّلاع على استخدام حساب خدمة.
404 notFound تعذَّر العثور على المورد المطلوب. تأكَّد من صحة المعرّفات (مثل رمز الشراء أو اسم الحزمة أو معرّف المنتج أو معرّف الاشتراك).
409 concurrentUpdate تمت محاولة تعديل عنصر يتم تعديله في الوقت نفسه. أعِد محاولة إرسال الطلب باستخدام خوارزمية الرقود الأسي الثنائي. تجنَّب إجراء تعديلات متزامنة على المرجع نفسه.
5xx Generic error حدث خطأ عام في خادم Google Play. أعِد محاولة إرسال طلبك.

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