Method: monetization.subscriptions.batchUpdate

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

يمكنك ضبط حقل TimeTolerance في الطلبات المتداخلة على 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 عنصر. يجب تعديل اشتراكات مختلفة في جميع الطلبات.

نص الاستجابة

رسالة ردّ على BatchUpdateSubscription

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

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

object (Subscription)

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

نطاقات الأذونات

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

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

UpdateSubscriptionRequest

طلب رسالة for Subscriptions.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)

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