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 علامة مخصّصة تم تحديدها لهذا المنتج المدفوع لمرة واحدة، ويتم عرضها في التطبيق من خلال Billing Library. وستتلقّى خيارات الشراء والعروض الترويجية لهذا المنتج أيضًا هذه العلامات في Billing Library.
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,
  "regionalProductAgeRatingInfos": [
    {
      object (RegionalProductAgeRatingInfo)
    }
  ],
  "productTaxCategoryCode": string
}
الحقول
regionalTaxConfigs[]

object (RegionalTaxConfig)

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

boolean

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

object (RegionalProductAgeRatingInfo)

معلومات التقييم حسب الفئة العمرية في المنطقة لا يتوفّر هذا الحقل حاليًا إلا لرمز المنطقة US.
productTaxCategoryCode

string

رمز فئة الضريبة المفروضة على المنتج المدفوع لمرة واحدة تحدّد فئة الضريبة المفروضة على المنتج معدّلات الضرائب على المعاملات التي تنطبق على المنتج. لمزيد من المعلومات، يُرجى الرجوع إلى مقالة "مركز المساعدة".

RegionalTaxConfig

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

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

string

الحقل مطلوب. رمز المنطقة الذي تنطبق عليه هذه الإعدادات، كما هو محدّد في معيار ISO 3166-1 alpha-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)
  },

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "buyOption": {
    object (OneTimeProductBuyPurchaseOption)
  },
  "rentOption": {
    object (OneTimeProductRentPurchaseOption)
  }
  // End of mutually exclusive fields.
}
الحقول
purchaseOptionId

string

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

enum (State)

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

object (RegionalPricingAndAvailabilityConfig)

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

object (OneTimeProductPurchaseOptionNewRegionsConfig)

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

object (OfferTag)

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

object (PurchaseOptionTaxAndComplianceSettings)

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

object (OneTimeProductBuyPurchaseOption)

خيار شراء يمكن شراؤه
rentOption

object (OneTimeProductRentPurchaseOption)

خيار شراء يمكن استئجاره
نهاية الحقول التي يستبعد كلّ منها الآخر

ولاية

الحالة الحالية لخيار الشراء

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

OneTimeProductBuyPurchaseOption

خيار شراء يمكن شراؤه

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

boolean

اختيارية: يشير ذلك إلى ما إذا كان خيار الشراء هذا سيتوفّر في مسارات PBL القديمة التي لا تتوافق مع نموذج المنتجات المدفوعة لمرة واحدة.

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

object (Money)

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

enum (Availability)

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

مدى التوفّر

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

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

OneTimeProductPurchaseOptionNewRegionsConfig

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

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

object (Money)

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

object (Money)

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

enum (Availability)

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

مدى التوفّر

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

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

PurchaseOptionTaxAndComplianceSettings

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

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

enum (WithdrawalRightType)

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

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

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

الطُرق

batchDelete

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

batchGet

 لقراءة بيانات منتج واحد أو أكثر من المنتجات المدفوعة لمرة واحدة

batchUpdate

 تنشئ أو تعدّل منتجًا واحدًا أو أكثر من المنتجات المدفوعة لمرة واحدة.

delete

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

get

 لقراءة بيانات منتج واحد مدفوع لمرة واحدة.

list

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

patch

 لإنشاء منتج مدفوع لمرة واحدة أو تعديله.

رموز الخطأ

تعرض عمليات هذا المورد رموز الخطأ التالية في بروتوكول HTTP:

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