Method: monetization.onetimeproducts.purchaseOptions.offers.batchUpdateStates

تعدّل هذه الطريقة مجموعة من حالات عروض المنتجات التي يتم تحصيل سعرها مرة واحدة.

طلب HTTP

POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/oneTimeProducts/{productId}/purchaseOptions/{purchaseOptionId}/offers:batchUpdateStates

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

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

المعلمات
packageName

string

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

string

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

string

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

نص الطلب

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

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

object (UpdateOneTimeProductOfferStateRequest)

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

نص الاستجابة

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

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

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

object (OneTimeProductOffer)

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

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

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

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

UpdateOneTimeProductOfferStateRequest

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

تمثيل JSON 
{

  // Union field state_transition_type can be only one of the following:
  "activateOneTimeProductOfferRequest": {
    object (ActivateOneTimeProductOfferRequest)
  },
  "cancelOneTimeProductOfferRequest": {
    object (CancelOneTimeProductOfferRequest)
  },
  "deactivateOneTimeProductOfferRequest": {
    object (DeactivateOneTimeProductOfferRequest)
  }
  // End of list of possible types for union field state_transition_type.
}
الحقول
حقل الدمج state_transition_type نوع تغيير الحالة الذي سيتم تطبيقه، ويجب تحديد نوع واحد فقط. يمكن أن تكون state_transition_type إحدى القيم التالية فقط:
activateOneTimeProductOfferRequest

object (ActivateOneTimeProductOfferRequest)

تفعيل عرض بعد تفعيل العرض، يصبح متاحًا للمستخدمين طالما تم استيفاء شروطه.
cancelOneTimeProductOfferRequest

object (CancelOneTimeProductOfferRequest)

تلغي هذه الطريقة عرضًا. وبعد إلغاء العرض، لن يكون متاحًا للمستخدمين. سيتم إلغاء أي طلبات معلّقة مرتبطة بهذا العرض. ويقتصر انتقال الحالة هذا على الطلبات المُسبقة.
deactivateOneTimeProductOfferRequest

object (DeactivateOneTimeProductOfferRequest)

توقِف هذه الطريقة عرضًا ترويجيًا. بعد إيقاف العرض الترويجي، لن يكون متاحًا للمستخدمين. يكون انتقال الحالة هذا خاصًا بالعروض المخفَّضة.

CancelOneTimeProductOfferRequest

طلب الرسالة الخاص بـ offers.cancel

تمثيل JSON 
{
  "packageName": string,
  "productId": string,
  "purchaseOptionId": string,
  "offerId": string,
  "latencyTolerance": enum (ProductUpdateLatencyTolerance)
}
الحقول
packageName

string

مطلوب. التطبيق الرئيسي (اسم الحزمة) للعرض الذي سيتم إلغاؤه
productId

string

مطلوب. المنتج الرئيسي الذي يتم تحصيل سعره مرة واحدة (معرّف) للعرض الذي سيتم إلغاؤه
purchaseOptionId

string

مطلوب. خيار الشراء الرئيسي (المعرّف) للعرض الترويجي الذي سيتم إلغاؤه
offerId

string

مطلوب. معرّف العرض الترويجي للاشتراك الذي سيتم إلغاؤه.
latencyTolerance

enum (ProductUpdateLatencyTolerance)

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

DeactivateOneTimeProductOfferRequest

Request message for offers.deactivate.

تمثيل JSON 
{
  "packageName": string,
  "productId": string,
  "purchaseOptionId": string,
  "offerId": string,
  "latencyTolerance": enum (ProductUpdateLatencyTolerance)
}
الحقول
packageName

string

مطلوب. التطبيق الرئيسي (اسم الحزمة) للعرض الترويجي الذي سيتم إيقافه
productId

string

مطلوب. المنتج الرئيسي الذي يتم تحصيل سعره مرة واحدة (المعرّف) للعرض الذي سيتم إيقافه
purchaseOptionId

string

مطلوب. تمثّل هذه السمة خيار الشراء الرئيسي (المعرّف) للعرض الذي سيتم إيقاف تفعيله.
offerId

string

مطلوب. معرّف العرض الترويجي الذي سيتم إيقافه.
latencyTolerance

enum (ProductUpdateLatencyTolerance)

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