Method: monetization.subscriptions.basePlans.offers.batchUpdateStates

• طلب HTTP
• مَعلمات المسار
• نص الطلب
  • تمثيل JSON
• نص الاستجابة
  • تمثيل JSON
• نطاقات التفويض
• UpdateSubscriptionOfferStateRequest
  • تمثيل JSON
• ActivateSubscriptionOfferRequest
  • تمثيل JSON
• DeactivateSubscriptionOfferRequest
  • تمثيل JSON
• جرِّبه الآن

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

اضبط حقل 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) اختيارية: الحدّ المسموح به لوقت الاستجابة لنشر تحديث المنتج هذا. الإعداد التلقائي هو "حساسة لوقت الاستجابة".