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,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "subscriptionTaxesAndComplianceSettings": {
    object (SubscriptionTaxAndComplianceSettings)
  },
  "managedProductTaxesAndComplianceSettings": {
    object (ManagedProductTaxAndComplianceSettings)
  }
  // End of mutually exclusive fields.
}
الحقول
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
(deprecated)

string

متوقّفة نهائيًا: لم تعُد الاشتراكات متاحة في واجهة برمجة التطبيقات InAppProducts API. يمكنك استخدام واجهة برمجة التطبيقات Subscriptions API بدلاً من ذلك.
trialPeriod
(deprecated)

string

متوقّفة نهائيًا: لم تعُد الاشتراكات متاحة في واجهة برمجة التطبيقات InAppProducts API. يمكنك استخدام واجهة برمجة التطبيقات Subscriptions API بدلاً من ذلك.
gracePeriod
(deprecated)

string

متوقّفة نهائيًا: لم تعُد الاشتراكات متاحة في واجهة برمجة التطبيقات InAppProducts API. يمكنك استخدام واجهة برمجة التطبيقات Subscriptions API بدلاً من ذلك.
في ما يلي قائمة بالحقول التي يستبعد بعضها بعضًا. سيتم ضبط حقل واحد على الأكثر في الرد:
subscriptionTaxesAndComplianceSettings
(deprecated)

object (SubscriptionTaxAndComplianceSettings)

متوقّفة نهائيًا: لم تعُد الاشتراكات متاحة في واجهة برمجة التطبيقات InAppProducts API. يمكنك استخدام واجهة برمجة التطبيقات Subscriptions API بدلاً من ذلك.
managedProductTaxesAndComplianceSettings

object (ManagedProductTaxAndComplianceSettings)

تفاصيل حول الضرائب والامتثال القانوني ينطبق ذلك على المنتجات المُدارة فقط.
نهاية الحقول التي يستبعد كلّ منها الآخر

الحالة

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

عمليات التعداد
statusUnspecified حالة غير محدّدة
active تم نشر المنتج وهو نشط في المتجر.
inactive لم يتم نشر المنتج، وبالتالي فهو غير نشط في المتجر.

PurchaseType

نوع المنتج

عمليات التعداد
purchaseTypeUnspecified نوع الشراء غير محدّد.
managedUser نوع المنتج التلقائي - عملية شراء لمرة واحدة
subscription

متوقّفة نهائيًا: لم تعُد الاشتراكات متاحة في واجهة برمجة التطبيقات InAppProducts API. يمكنك استخدام واجهة برمجة التطبيقات Subscriptions API بدلاً من ذلك.

InAppProductListing

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

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

string

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

string

وصف بطاقة بيانات المتجر
benefits[]
(deprecated)

string

متوقّفة نهائيًا: لم تعُد الاشتراكات متاحة في واجهة برمجة التطبيقات InAppProducts API. يمكنك استخدام واجهة برمجة التطبيقات Subscriptions API بدلاً من ذلك.

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

تمثيل من رمز المنطقة إلى تفاصيل معدّل الضريبة المفاتيح هي رموز المناطق كما يحدّدها "مستودع بيانات لغة Unicode المشتركة" (CLDR).

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

رمز الخطأ السبب الوصف الدقة