Method: monetization.onetimeproducts.batchUpdate

تنشئ هذه الطريقة منتجًا واحدًا أو أكثر يتم تحصيل سعره مرة واحدة أو تعدّله.

طلب HTTP

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

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

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

المعلمات
packageName

string

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

نص الطلب

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

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

object (UpdateOneTimeProductRequest)

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

نص الاستجابة

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

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

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

object (OneTimeProduct)

قائمة المنتجات التي يتم تحصيل سعرها مرة واحدة والتي تم تعديلها، بالترتيب نفسه الوارد في الطلب

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

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

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

UpdateOneTimeProductRequest

طلب رسالة onetimeproducts.patch

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

object (OneTimeProduct)

مطلوب. المنتج الذي يتم تحصيل سعره مرة واحدة والذي سيتم إدراجه أو تعديله
updateMask

string (FieldMask format)

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

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

object (RegionsVersion)

مطلوب. إصدار المناطق المتاحة المستخدَم للمنتج الذي يتم شراؤه لمرة واحدة
allowMissing

boolean

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

في حال إنشاء منتج جديد يتم تحصيل سعره مرة واحدة، سيتم تجاهل updateMask.
latencyTolerance

enum (ProductUpdateLatencyTolerance)

اختيارية: الحدّ الأقصى المسموح به لوقت الاستجابة لعملية إدراج/تعديل المنتج هذه. يتم ضبط القيمة التلقائية على "حساسة لوقت الاستجابة".