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)

مطلوب. مجموعة من بيانات العنوان والوصف المتوافقة مع اللغة المحلية يجب ألا يحتوي على إدخالات مكرّرة تتضمّن languageCode نفسه.
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

اختيارية: تحديد ما إذا كان خيار الشراء هذا سيكون متاحًا في مسارات "الشراء داخل التطبيق" القديمة التي لا تتوافق مع نموذج المنتجات التي يتم تحصيل سعرها مرة واحدة

يمكن وضع علامة "متوافق مع الأنظمة القديمة" على خيار شراء واحد فقط.
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

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