Method: monetization.subscriptions.basePlans.batchUpdateStates

تفعيل الخطط الأساسية أو إيقافها في اشتراك واحد أو عدة اشتراك

يمكنك ضبط حقل TimeTolerance في الطلبات المتداخلة على PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_TOLERANT لتحقيق الحد الأقصى من سرعة معالجة بيانات التحديثات.

طلب HTTP

POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/subscriptions/{productId}/basePlans:batchUpdateStates

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

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

المعلمات
packageName

string

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

string

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

نص الطلب

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

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

object (UpdateBasePlanStateRequest)

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

نص الاستجابة

رسالة استجابة لـ basePlans.batchUpdateStates.

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

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

object (Subscription)

قائمة الاشتراكات المعدَّلة ستطابق هذه القائمة الطلبات واحدًا لواحد، بالترتيب نفسه.

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

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

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

UpdateBasePlanStateRequest

يمكنك طلب رسالة لتعديل حالة الخطة الأساسية للاشتراك.

تمثيل JSON 
{

  // Union field state_transition_type can be only one of the following:
  "activateBasePlanRequest": {
    object (ActivateBasePlanRequest)
  },
  "deactivateBasePlanRequest": {
    object (DeactivateBasePlanRequest)
  }
  // End of list of possible types for union field state_transition_type.
}
الحقول
حقل الاتحاد state_transition_type. نوع انتقال الحالة المطلوب تطبيقه، يجب تحديد حالة واحدة فقط. يمكن أن يكون state_transition_type واحدًا فقط مما يلي:
activateBasePlanRequest

object (ActivateBasePlanRequest)

يتم تفعيل خطة أساسية. وبعد تفعيل الخطط الأساسية، ستصبح متاحة للمشتركين الجدد.
deactivateBasePlanRequest

object (DeactivateBasePlanRequest)

يؤدي هذا الإجراء إلى إيقاف خطة أساسية. بعد إيقاف الخطة الأساسية، لن تكون متاحة للمشتركين الجُدد، ولكن سيبقى اشتراكهم متاحًا للمشتركين الحاليين.

ActivateBasePlanRequest

طلب رسالة لـ ActivateBasePlan.

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

string

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

string

مطلوب. الاشتراك الرئيسي (رقم التعريف) للخطة الأساسية المطلوب تفعيله.
basePlanId

string

مطلوب. معرّف الخطة الأساسية الفريد للخطة الأساسية المطلوب تفعيلها
latencyTolerance

enum (ProductUpdateLatencyTolerance)

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

DeactivateBasePlanRequest

يمكنك طلب إرسال رسالة إلى basePlans.deactivate.

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

string

مطلوب. التطبيق الرئيسي (اسم الحزمة) للخطة الأساسية المطلوب إيقافه.
productId

string

مطلوب. الاشتراك الرئيسي (رقم التعريف) للخطة الأساسية المطلوب إيقافه.
basePlanId

string

مطلوب. معرّف الخطة الأساسية الفريد للخطة الأساسية المطلوب إيقافها
latencyTolerance

enum (ProductUpdateLatencyTolerance)

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