REST Resource: monetization.onetimeproducts

نوع المرجع: OneTimeProduct

منتج واحد يتم تحصيل سعره مرة واحدة لأحد التطبيقات

تمثيل JSON 
{
  "packageName": string,
  "productId": string,
  "listings": [
    {
      object (OneTimeProductListing)
    }
  ],
  "taxAndComplianceSettings": {
    object (OneTimeProductTaxAndComplianceSettings)
  },
  "purchaseOptions": [
    {
      object (OneTimeProductPurchaseOption)
    }
  ],
  "restrictedPaymentCountries": {
    object (RestrictedPaymentCountries)
  },
  "offerTags": [
    {
      object (OfferTag)
    }
  ],
  "regionsVersion": {
    object (RegionsVersion)
  }
}
الحقول
packageName

string

الحقل مطلوب. غير قابل للتغيير اسم حزمة التطبيق الرئيسي
productId

string

الحقل مطلوب. غير قابل للتغيير المعرّف الفريد للمنتج يجب أن يكون المعرّف فريدًا داخل التطبيق الرئيسي، وأن يبدأ برقم أو حرف صغير، ويمكن أن يشتمل على أرقام (0-9) وحروف صغيرة (a-z) وشُرط سفلية (_) ونقاط (.).
listings[]

object (OneTimeProductListing)

الحقل مطلوب. مجموعة من بيانات العنوان والوصف المتوافقة مع اللغة المحلية يجب ألا تتضمّن إدخالات مكرّرة برمز اللغة نفسه.
taxAndComplianceSettings

object (OneTimeProductTaxAndComplianceSettings)

تفاصيل حول الضرائب والامتثال القانوني
purchaseOptions[]

object (OneTimeProductPurchaseOption)

الحقل مطلوب. مجموعة خيارات الشراء لهذا المنتج الذي يتم تحصيل سعره مرة واحدة
restrictedPaymentCountries

object (RestrictedPaymentCountries)

اختيارية: البُلدان التي يتم فيها حصر عمليات شراء هذا المنتج الذي يتم تحصيل سعره مرة واحدة على طرق الدفع المسجّلة في البلد نفسه إذا كان هذا الحقل فارغًا، لن يتم فرض أي قيود على المواقع الجغرافية التي يمكن الدفع فيها.
offerTags[]

object (OfferTag)

اختيارية: قائمة تضمّ ما يصل إلى 20 علامة مخصّصة محدّدة لهذا المنتج الذي يتم تحصيل سعره مرة واحدة، ويتم إرجاعها إلى التطبيق من خلال مكتبة الفوترة. ستتلقّى خيارات الشراء والعروض الترويجية لهذا المنتج أيضًا هذه العلامات في مكتبة الفوترة.
regionsVersion

object (RegionsVersion)

النتائج فقط. تشير هذه السمة إلى إصدار إعدادات المناطق الذي تم استخدامه لإنشاء المنتج الذي يتم تحصيل سعره مرة واحدة.

OneTimeProductListing

بطاقة بيانات المتجر الإقليمية لمنتج يتم تحصيل سعره مرة واحدة

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

string

الحقل مطلوب. تمثّل هذه السمة لغة هذا الإدخال، كما هو محدّد في معيار BCP-47، مثلاً "en-US".
title

string

الحقل مطلوب. عنوان هذا المنتج بلغة هذه البطاقة الحد الأقصى للطول هو 55 حرفًا.
description

string

الحقل مطلوب. وصف هذا المنتج بلغة هذه البطاقة. الحد الأقصى لعدد الأحرف المسموح به هو 200 حرف.

OneTimeProductTaxAndComplianceSettings

تفاصيل حول الضرائب وسياسة Google Play والامتثال للقوانين في ما يتعلّق بالمنتجات التي يتم تحصيل سعرها مرة واحدة

تمثيل JSON 
{
  "regionalTaxConfigs": [
    {
      object (RegionalTaxConfig)
    }
  ],
  "isTokenizedDigitalAsset": boolean
}
الحقول
regionalTaxConfigs[]

object (RegionalTaxConfig)

إعدادات الضرائب على مستوى منطقة معيّنة
isTokenizedDigitalAsset

boolean

تُستخدَم لتحديد ما إذا كان هذا المنتج الذي يتم تحصيل سعره مرة واحدة معرَّفًا على أنّه منتج يمثّل أصلاً رقميًا محوَّلاً إلى رمز مميّز.

RegionalTaxConfig

تفاصيل حول الضرائب في منطقة جغرافية معيّنة

تمثيل JSON 
{
  "regionCode": string,
  "taxTier": enum (TaxTier),
  "eligibleForStreamingServiceTaxRate": boolean,
  "streamingTaxType": enum (StreamingTaxType)
}
الحقول
regionCode

string

الحقل مطلوب. تمثّل هذه السمة رمز المنطقة التي ينطبق عليها هذا الإعداد، كما هو محدّد في معيار ISO 3166-2، مثلاً "US".
taxTier

enum (TaxTier)

فئة الضرائب لتحديد معدّل الضريبة المخفَّض بالنسبة إلى المطوِّرين الذين يبيعون الأخبار الرقمية أو المجلّات أو الصحف أو الكتب أو الكتب المسموعة في مناطق مختلفة، قد يكونون مؤهَّلين للاستفادة من تخفيض معدّلات الضريبة.

مزيد من المعلومات
eligibleForStreamingServiceTaxRate

boolean

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

enum (StreamingTaxType)

لتحصيل الضرائب المفروضة على خدمات الاتصالات أو الترفيه في الولايات المتحدة، يُرجى اختيار فئة الضريبة المناسبة.

مزيد من المعلومات

OneTimeProductPurchaseOption

خيار شراء واحد لمنتج يتم تحصيل سعره مرة واحدة

تمثيل JSON 
{
  "purchaseOptionId": string,
  "state": enum (State),
  "regionalPricingAndAvailabilityConfigs": [
    {
      object (RegionalPricingAndAvailabilityConfig)
    }
  ],
  "newRegionsConfig": {
    object (OneTimeProductPurchaseOptionNewRegionsConfig)
  },
  "offerTags": [
    {
      object (OfferTag)
    }
  ],
  "taxAndComplianceSettings": {
    object (PurchaseOptionTaxAndComplianceSettings)
  },

  // Union field purchase_option_type can be only one of the following:
  "buyOption": {
    object (OneTimeProductBuyPurchaseOption)
  },
  "rentOption": {
    object (OneTimeProductRentPurchaseOption)
  }
  // End of list of possible types for union field purchase_option_type.
}
الحقول
purchaseOptionId

string

الحقل مطلوب. غير قابل للتغيير المعرّف الفريد لخيار الشراء هذا. يجب أن يكون المعرّف فريدًا ضمن المنتج الذي يتم تحصيل سعره مرة واحدة. ويجب أن يبدأ برقم أو حرف صغير، وألّا يتضمّن سوى أحرف صغيرة (a-z) وأرقام (0-9) وواصلات (-)، ويجب ألّا يزيد عن 63 حرفًا.
state

enum (State)

النتائج فقط. حالة خيار الشراء، أي ما إذا كان نشطًا. لا يمكن تغيير هذا الحقل من خلال تعديل المرجع. استخدِم نقاط النهاية المخصّصة بدلاً من ذلك.
regionalPricingAndAvailabilityConfigs[]

object (RegionalPricingAndAvailabilityConfig)

معلومات السعر ومدى التوفّر على مستوى منطقة معيّنة لخيار الشراء هذا
newRegionsConfig

object (OneTimeProductPurchaseOptionNewRegionsConfig)

معلومات الأسعار لأي مواقع جغرافية جديدة قد يتيحها Play في المستقبل في حال عدم إدخالها، لن يتوفّر خيار الشراء تلقائيًا في أي مواقع جغرافية جديدة قد يتم إطلاق Play فيها في المستقبل.
offerTags[]

object (OfferTag)

اختيارية: قائمة تضمّ ما يصل إلى 20 علامة مخصّصة محدّدة لخيار الشراء هذا، ويتم إرجاعها إلى التطبيق من خلال مكتبة الفوترة. ستتلقّى العروض الخاصة بخيار الشراء هذا أيضًا هذه العلامات في مكتبة الفوترة.
taxAndComplianceSettings

object (PurchaseOptionTaxAndComplianceSettings)

اختيارية: تفاصيل حول الضرائب والامتثال القانوني
حقل الدمج purchase_option_type تمثّل هذه السمة نوع خيار الشراء. يجب ضبط قيمة واحدة بالضبط. يمكن أن تكون purchase_option_type إحدى القيم التالية فقط:
buyOption

object (OneTimeProductBuyPurchaseOption)

تمثّل هذه السمة خيار شراء يمكن شراؤه.
rentOption

object (OneTimeProductRentPurchaseOption)

خيار شراء يمكن استئجاره

الحالة

تمثّل هذه السمة الحالة الحالية لخيار الشراء.

عمليات التعداد
STATE_UNSPECIFIED القيمة التلقائية، ويجب عدم استخدامها مطلقًا.
DRAFT خيار الشراء غير متاح للمستخدمين ولم يكن متاحًا لهم في أي وقت.
ACTIVE يتوفّر خيار الشراء للمستخدمين.
INACTIVE لم يعُد خيار الشراء متاحًا للمستخدمين.
INACTIVE_PUBLISHED لم يعُد خيار الشراء متاحًا، ولكننا نواصل عرض العرض الترويجي الخاص به من خلال واجهة Play Billing Library لضمان التوافق مع الأنظمة القديمة. لا يمكن أن تكون خيارات الشراء في هذه الحالة إلا تلك التي تم نقلها تلقائيًا.

OneTimeProductBuyPurchaseOption

تمثّل هذه السمة خيار شراء يمكن شراؤه.

تمثيل JSON 
{
  "legacyCompatible": boolean,
  "multiQuantityEnabled": boolean
}
الحقول
legacyCompatible

boolean

اختيارية: تُستخدَم لتحديد ما إذا كان خيار الشراء هذا سيكون متاحًا في مسارات واجهة Google Play Billing Library القديمة التي لا تتوافق مع نموذج المنتجات التي يتم تحصيل سعرها مرة واحدة.

يمكن وضع علامة "متوافق مع الأنظمة القديمة" على خيار شراء واحد فقط.
multiQuantityEnabled

boolean

اختيارية: تحدّد هذه السمة ما إذا كان خيار الشراء هذا يسمح بشراء كميات متعدّدة. تسمح ميزة "الكميات المتعدّدة" للمشتري بشراء أكثر من سلعة واحدة في عملية دفع واحدة.

OneTimeProductRentPurchaseOption

خيار شراء يمكن استئجاره

تمثيل JSON 
{
  "rentalPeriod": string,
  "expirationPeriod": string
}
الحقول
rentalPeriod

string

الحقل مطلوب. تمثّل هذه السمة المدة التي يملك فيها المستخدم إذن الوصول إلى التطبيق. تبدأ الخطة عند إكمال مسار الشراء. يجب تحديدها بتنسيق ISO 8601.
expirationPeriod

string

اختيارية: تمثّل هذه السمة المدة المتاحة للمستخدم بعد بدء استخدام المنتج قبل إبطال الإذن. يجب تحديدها بتنسيق ISO 8601.

RegionalPricingAndAvailabilityConfig

إعدادات السعر ومدى التوفّر على مستوى منطقة معيّنة لخيار شراء

تمثيل JSON 
{
  "regionCode": string,
  "price": {
    object (Money)
  },
  "availability": enum (Availability)
}
الحقول
regionCode

string

الحقل مطلوب. رمز المنطقة التي ينطبق عليها هذا الإعداد، كما هو محدّد في معيار ISO 3166-2، مثلاً "US".
price

object (Money)

سعر خيار الشراء في المنطقة المحدّدة يجب ضبطها بالعملة المرتبطة بالمنطقة المحدّدة.
availability

enum (Availability)

تمثّل هذه السمة مدى توفّر خيار الشراء.

مدى التوفّر

تمثّل هذه السمة مدى توفّر خيار الشراء.

عمليات التعداد
AVAILABILITY_UNSPECIFIED مدى التوفّر غير محدّد يجب عدم استخدامها.
AVAILABLE يتوفّر خيار الشراء للمستخدمين.
NO_LONGER_AVAILABLE لم يعُد خيار الشراء متاحًا للمستخدمين. لا يمكن استخدام هذه القيمة إلا إذا تم ضبط مدى التوفّر على AVAILABLE (متوفّر) سابقًا.
AVAILABLE_IF_RELEASED لا يتوفّر خيار الشراء في البداية، ولكن يتم إتاحته من خلال عرض طلب مُسبَق تم إصداره.

OneTimeProductPurchaseOptionNewRegionsConfig

معلومات الأسعار لأي مناطق جديدة قد يطلق فيها Play خدماته في المستقبل

تمثيل JSON 
{
  "usdPrice": {
    object (Money)
  },
  "eurPrice": {
    object (Money)
  },
  "availability": enum (Availability)
}
الحقول
usdPrice

object (Money)

الحقل مطلوب. السعر بالدولار الأمريكي الذي سيتم استخدامه في أي مناطق جديدة قد يطلقها Play
eurPrice

object (Money)

الحقل مطلوب. السعر باليورو الذي سيتم استخدامه في أي مناطق جديدة قد يتيحها Play.
availability

enum (Availability)

الحقل مطلوب. مدى التوفّر على مستوى منطقة معيّنة لإعدادات المناطق الجديدة عند ضبط الحالة على "متاحة"، سيتم استخدام معلومات الأسعار في أي مناطق جديدة قد يطلقها Play في المستقبل.

مدى التوفّر

مدى توفّر إعدادات المناطق الجديدة

عمليات التعداد
AVAILABILITY_UNSPECIFIED مدى التوفّر غير محدّد يجب عدم استخدامها.
AVAILABLE سيتم استخدام الإعدادات لأي مناطق جديدة قد يتيحها Play في المستقبل.
NO_LONGER_AVAILABLE لم يعُد الإعداد متاحًا ولن يتم استخدامه في أي مناطق جديدة قد يتيحها Play في المستقبل. لا يمكن استخدام هذه القيمة إلا إذا تم ضبط مدى التوفّر على AVAILABLE (متوفّر) سابقًا.

PurchaseOptionTaxAndComplianceSettings

تفاصيل حول الضرائب وسياسة Google Play والامتثال القانوني لخيارات شراء المنتجات التي يتم تحصيل سعرها مرة واحدة

تمثيل JSON 
{
  "withdrawalRightType": enum (WithdrawalRightType)
}
الحقول
withdrawalRightType

enum (WithdrawalRightType)

اختيارية: تصنيف المحتوى الرقمي أو الخدمة للمنتجات الموزَّعة على المستخدمين في المناطق المؤهَّلة

وفي حال ترك هذه السياسة بدون ضبط، سيتم ضبط الإجراء تلقائيًا على WITHDRAWAL_RIGHT_DIGITAL_CONTENT.

يُرجى الرجوع إلى مقالة مركز المساعدة للحصول على مزيد من المعلومات.

الطُرق

batchDelete

 لحذف منتج واحد أو أكثر يتم تحصيل سعره مرة واحدة

batchGet

 قراءة منتج واحد أو أكثر يتم تحصيل سعره مرة واحدة

batchUpdate

 تنشئ هذه الطريقة منتجًا واحدًا أو أكثر من المنتجات التي يتم تحصيل سعرها مرة واحدة أو تعدّلها.

delete

 تحذف هذه الطريقة منتجًا يتم تحصيل سعره مرة واحدة.

get

 تقرأ هذه السمة منتجًا واحدًا يتم تحصيل سعره مرة واحدة.

list

 تعرض هذه الطريقة جميع المنتجات التي يتم تحصيل سعرها مرة واحدة ضمن تطبيق معيّن.

patch

 تنشئ هذه الطريقة منتجًا يتم تحصيل سعره مرة واحدة أو تعدّله.

رموز الخطأ

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

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

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

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

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