تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

Method: monetization.subscriptions.basePlans.offers.batchUpdate

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

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

اضبط حقل latencyTolerance في الطلبات المُدمجة على PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_TOLERANT لتحقيق الحد الأقصى من معدل نقل البيانات للتعديل.

طلب HTTP

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

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

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

المعلمات

المعلمات
`packageName`	`string` مطلوب. التطبيق الرئيسي (اسم الحزمة) لعروض الاشتراك المعدَّلة. يجب أن يكون حقل packageName متطابقًا مع جميع موارد SubscriptionOffer التي تم تعديلها.
`productId`	`string` مطلوب. معرّف المنتج للاشتراك الرئيسي، إذا كانت جميع العروض المعدَّلة تنتمي إلى الاشتراك نفسه. إذا كان هذا الطلب يشمل اشتراكات متعددة، اضبط هذا الحقل على "-". يجب ضبط هذا الحقل.
`basePlanId`	`string` مطلوب. الخطة الأساسية الرئيسية (رقم التعريف) التي يجب تعديل العروض لها. يمكن تحديده على أنّه "-" لتعديل العروض من خطط أساسية متعددة.

packageName

string

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

يجب أن يكون حقل packageName متطابقًا مع جميع موارد SubscriptionOffer التي تم تعديلها.

productId

string

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

basePlanId

string

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

نص الطلب

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

تمثيل JSON
{ "requests": [ { object (`UpdateSubscriptionOfferRequest`) } ] }

الحقول

الحقول
`requests[]`	`object (UpdateSubscriptionOfferRequest)` مطلوب. قائمة بطلبات التعديل التي تضمّ ما يصل إلى 100 عنصر يجب أن تُعدّل جميع الطلبات عروض الاشتراك المختلفة.

requests[]

object (UpdateSubscriptionOfferRequest)

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

نص الاستجابة

رسالة الردّ على offers.batchUpdate

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

تمثيل JSON
{ "subscriptionOffers": [ { object (`SubscriptionOffer`) } ] }

الحقول

الحقول
`subscriptionOffers[]`	`object (SubscriptionOffer)` قائمة عروض الاشتراك المعدّلة

subscriptionOffers[]

object (SubscriptionOffer)

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

نطاقات التفويض

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

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

UpdateSubscriptionOfferRequest

رسالة طلب لملف offers.patch

تمثيل JSON

تمثيل JSON
{ "subscriptionOffer": { object (`SubscriptionOffer`) }, "updateMask": string, "regionsVersion": { object (`RegionsVersion`) }, "allowMissing": boolean, "latencyTolerance": enum (`ProductUpdateLatencyTolerance`) }

{
  "subscriptionOffer": {
    object (SubscriptionOffer)
  },
  "updateMask": string,
  "regionsVersion": {
    object (RegionsVersion)
  },
  "allowMissing": boolean,
  "latencyTolerance": enum (ProductUpdateLatencyTolerance)
}

الحقول
`subscriptionOffer`	`object (SubscriptionOffer)` مطلوب. عرض الاشتراك المطلوب تعديله
`updateMask`	`string (FieldMask format)` مطلوب. قائمة الحقول التي سيتم تعديلها هذه قائمة مفصولة بفواصل تتضمّن أسماء حقول مؤهَّلة بالكامل. مثال: `"user.displayName,photo"`
`regionsVersion`	`object (RegionsVersion)` مطلوب. إصدار المناطق المتاحة المستخدَمة في subscriptionOffer.
`allowMissing`	`boolean` اختيارية: في حال ضبطها على "صحيح" وعدم توفّر عرض الاشتراك الذي يحمل packageName وproductId وbasePlanId وofferId المحدّدة، سيتم إنشاء عرض. في حال إنشاء عرض جديد، يتم تجاهل updateMask.
`latencyTolerance`	`enum (ProductUpdateLatencyTolerance)` اختيارية: الحدّ المسموح به لوقت الاستجابة لنشر تحديث المنتج هذا. الإعداد التلقائي هو "حساسة لوقت الاستجابة".