Method: monetization.subscriptions.basePlans.batchUpdateStates

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

اضبط حقل latencyTolerance في الطلبات المُدمجة على 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)

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