Method: monetization.subscriptions.basePlans.offers.batchUpdateStates

تعديل مجموعة من حالات عروض الاشتراك

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

طلب HTTP

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

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

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

المعلمات
packageName

string

مطلوب. التطبيق الرئيسي (اسم الحزمة) لعروض الاشتراك المعدّلة

يجب أن تكون القيمة مساوية لحقل packageName على جميع موارد SubscriptionOffer المعدَّلة.
productId

string

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

string

مطلوب. الخطة الأساسية (رقم التعريف) التي يجب تعديل العروض الترويجية لها يمكن تحديدها على أنّها "-" لتعديل العروض من خطط أساسية متعدّدة

نص الطلب

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

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

object (UpdateSubscriptionOfferStateRequest)

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

نص الاستجابة

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

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

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

object (SubscriptionOffer)

القائمة المعدَّلة لعروض الاشتراك

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

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

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

UpdateSubscriptionOfferStateRequest

اطلب رسالة لتعديل حالة عرض الاشتراك.

تمثيل JSON 
{

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

object (ActivateSubscriptionOfferRequest)

تفعيل أحد العروض الترويجية بعد تفعيل العرض، سيكون متاحًا للمشتركين الجدد.
deactivateSubscriptionOfferRequest

object (DeactivateSubscriptionOfferRequest)

إيقاف عرض ترويجي. بعد إيقاف العرض، سيصبح غير متاح للمشتركين الجدد، ولكن سيبقى الاشتراك للمشتركين الحاليين ساريًا

ActivateSubscriptionOfferRequest

طلب رسالة لـ ActivateSubscriptionOffer

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

string

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

string

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

string

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

string

مطلوب. معرّف العرض الفريد الخاص بالعرض المطلوب تفعيله.
latencyTolerance

enum (ProductUpdateLatencyTolerance)

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

DeactivateSubscriptionOfferRequest

يمكنك طلب تلقّي رسالة بشأن Offer.deactivate.

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

string

مطلوب. التطبيق الرئيسي (اسم الحزمة) للعرض الذي تريد إيقافه.
productId

string

مطلوب. الاشتراك الرئيسي (رقم التعريف) للعرض الذي تريد إيقافه.
basePlanId

string

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

string

مطلوب. معرّف العرض الفريد الخاص بالعرض الذي تريد إيقافه
latencyTolerance

enum (ProductUpdateLatencyTolerance)

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