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))

قائمة ملفات APK لبيانات العنوان والوصف المترجَم. مفتاح الخريطة هو لغة البيانات المترجَمة، على النحو المحدّد في BCP-47، على سبيل المثال &"en-US&quot.

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

نوع الشراء

تمثّل هذه الخاصية نوع المنتج.

عمليات التعداد
purchaseTypeUnspecified نوع شراء غير محدّد.
managedUser نوع المنتج التلقائي، وهو عملية شراء لمرة واحدة.
subscription منتج داخل التطبيق مع فترة متكرّرة

إدراج InAppProductListing

بطاقة بيانات متجر لمنتج واحد داخل التطبيق

تمثيل JSON
{
  "title": string,
  "description": string,
  "benefits": [
    string
  ]
}
الحقول
title

string

عنوان بطاقة بيانات المتجر.

description

string

وصف بطاقة بيانات المتجر.

benefits[]

string

مزايا التخويل المترجَمة للاشتراك.

إعدادات ManagedProductTaxAndCompliance

تفاصيل حول الضرائب والامتثال القانوني للمنتجات المُدارة

تمثيل JSON
{
  "eeaWithdrawalRightType": enum (WithdrawalRightType),
  "taxRateInfoByRegionCode": {
    string: {
      object (RegionalTaxRateInfo)
    },
    ...
  }
}
الحقول
eeaWithdrawalRightType

enum (WithdrawalRightType)

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

taxRateInfoByRegionCode

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

عملية ربط من رمز المنطقة إلى تفاصيل معدّل الضريبة المفاتيح هي رموز المناطق وفقًا للتعريف الوارد في Unicode's "CLDR&quot؛

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

الطُرق

delete

حذف منتج داخل التطبيق (أي

get

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

insert

تنشئ منتجًا داخل التطبيق (أي

list

يعرض جميع المنتجات داخل التطبيق - كل من المنتجات المُدارة والاشتراكات.

patch

يحصل على منتج داخل التطبيق (أي

update

تحديث منتج داخل التطبيق (أي