Method: monetization.subscriptions.basePlans.offers.batchUpdateStates

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

تعدّل هذه السياسة مجموعة من حالات عروض الاشتراك.

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