Method: monetization.subscriptions.batchUpdate

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

عيِّن حقل "وقت الاستجابة" في الطلبات المتداخلة على product_UPDATE_LATENCY_TOLERANCE_LATENCY_TOLERANT لتحقيق الحد الأقصى لسرعة معالجة التحديث.

طلب HTTP

POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/subscriptions:batchUpdate

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

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

المَعلمات
packageName

string

مطلوبة. التطبيق الرئيسي (اسم الحزمة) الذي يجب تعديل اشتراكاته. يجب أن تكون القيمة مساوية لحقل packageName في جميع موارد "الاشتراكات".

نص الطلب

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

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

object (UpdateSubscriptionRequest)

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

نص الاستجابة

رسالة الرد الخاصة بـ BatchUpdate Subscription.

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

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

object (Subscription)

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

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

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

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

UpdateSubscriptionRequest

اطلب رسالة بشأن Subscription.patch.

تمثيل JSON
{
  "subscription": {
    object (Subscription)
  },
  "updateMask": string,
  "regionsVersion": {
    object (RegionsVersion)
  },
  "allowMissing": boolean,
  "latencyTolerance": enum (ProductUpdateLatencyTolerance)
}
الحقول
subscription

object (Subscription)

مطلوبة. الاشتراك المطلوب تعديله

updateMask

string (FieldMask format)

مطلوبة. قائمة الحقول المطلوب تعديلها.

هذه قائمة مفصولة بفواصل تضم أسماء الحقول المؤهلة بالكامل. مثال: "user.displayName,photo"

regionsVersion

object (RegionsVersion)

مطلوبة. يشير إلى إصدار المناطق المتاحة الذي يتم استخدامه للاشتراك.

allowMissing

boolean

اختياري. في حال ضبط هذه السياسة على "صحيح"، ولم يتوفّر الاشتراك الذي يحمل قيمة packageName وproductId المحدّدة، سيتم إنشاء الاشتراك.

في حال إنشاء اشتراك جديد، يتم تجاهل updateMask.

latencyTolerance

enum (ProductUpdateLatencyTolerance)

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