Method: monetization.subscriptions.basePlans.offers.batchUpdateStates

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

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

طلب رسالة من أجل offers.deactivate

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

string

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

string

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

string

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

string

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

enum (ProductUpdateLatencyTolerance)

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