Method: monetization.subscriptions.basePlans.batchUpdateStates

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

عيِّن حقل "وقت الاستجابة" في الطلبات المتداخلة على 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)

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