Method: monetization.onetimeproducts.purchaseOptions.batchUpdateStates

تفعيل خيارات الشراء أو إيقافها في منتج واحد أو أكثر من المنتجات التي يتم شراؤها لمرة واحدة

طلب HTTP

POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/oneTimeProducts/{productId}/purchaseOptions:batchUpdateStates

يستخدِم عنوان URL بنية تحويل الترميز gRPC.

مَعلمات المسار

المعلمات
packageName

string

مطلوب. التطبيق الرئيسي (اسم الحزمة) لخيارات الشراء المعدَّلة
productId

string

مطلوب. معرّف المنتج الأساسي الذي يتم تحصيل سعره مرة واحدة، إذا كانت جميع خيارات الشراء المعدَّلة تنتمي إلى المنتج نفسه الذي يتم تحصيل سعره مرة واحدة إذا كان هذا التعديل المجمّع يشمل عدّة منتجات تُباع لمرة واحدة، اضبط هذا الحقل على "-".

نص الطلب

يحتوي نص الطلب على بيانات بالبنية التالية:

تمثيل JSON 
{
  "requests": [
    {
      object (UpdatePurchaseOptionStateRequest)
    }
  ]
}
الحقول
requests[]

object (UpdatePurchaseOptionStateRequest)

مطلوب. قائمة طلبات التعديل التي تتضمّن ما يصل إلى 100 عنصر يجب أن تعدّل جميع الطلبات خيارات شراء مختلفة.

نص الاستجابة

رسالة الردّ على purchaseOptions.batchUpdateStates

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل JSON 
{
  "oneTimeProducts": [
    {
      object (OneTimeProduct)
    }
  ]
}
الحقول
oneTimeProducts[]

object (OneTimeProduct)

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

نطاقات الأذونات

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/androidpublisher

UpdatePurchaseOptionStateRequest

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

تمثيل JSON 
{

  // Union field state_transition_type can be only one of the following:
  "activatePurchaseOptionRequest": {
    object (ActivatePurchaseOptionRequest)
  },
  "deactivatePurchaseOptionRequest": {
    object (DeactivatePurchaseOptionRequest)
  }
  // End of list of possible types for union field state_transition_type.
}
الحقول
حقل الدمج state_transition_type نوع تغيير الحالة الذي سيتم تطبيقه، ويجب تحديد نوع واحد فقط. يمكن أن تكون state_transition_type إحدى القيم التالية فقط:
activatePurchaseOptionRequest

object (ActivatePurchaseOptionRequest)

تفعيل خيار شراء بعد تفعيل خيار الشراء، سيصبح متاحًا.
deactivatePurchaseOptionRequest

object (DeactivatePurchaseOptionRequest)

توقِف هذه الطريقة خيار شراء. بعد إيقاف خيار الشراء، لن يكون متاحًا.

ActivatePurchaseOptionRequest

طلب الرسالة UpdatePurchaseOptionState

تمثيل JSON 
{
  "packageName": string,
  "productId": string,
  "purchaseOptionId": string,
  "latencyTolerance": enum (ProductUpdateLatencyTolerance)
}
الحقول
packageName

string

مطلوب. التطبيق الرئيسي (اسم الحزمة) لخيار الشراء الذي سيتم تفعيله
productId

string

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

string

مطلوب. معرّف خيار الشراء الذي تريد تفعيله
latencyTolerance

enum (ProductUpdateLatencyTolerance)

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

DeactivatePurchaseOptionRequest

طلب الرسالة UpdatePurchaseOptionState

تمثيل JSON 
{
  "packageName": string,
  "productId": string,
  "purchaseOptionId": string,
  "latencyTolerance": enum (ProductUpdateLatencyTolerance)
}
الحقول
packageName

string

مطلوب. تمثّل هذه السمة التطبيق الرئيسي (اسم الحزمة) لخيار الشراء المطلوب إيقاف تفعيله.
productId

string

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

string

مطلوب. معرّف خيار الشراء الذي سيتم إيقاف تفعيله
latencyTolerance

enum (ProductUpdateLatencyTolerance)

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