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 عنصر يجب أن تعدّل جميع الطلبات عروضًا مختلفة.

نص الاستجابة

Response message for offers.batchUpdateStates.

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

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

object (OneTimeProductOffer)

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

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

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

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

UpdateOneTimeProductOfferStateRequest

رسالة طلب لتحديث حالة عرض منتج مدفوع لمرة واحدة

تمثيل JSON 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "activateOneTimeProductOfferRequest": {
    object (ActivateOneTimeProductOfferRequest)
  },
  "cancelOneTimeProductOfferRequest": {
    object (CancelOneTimeProductOfferRequest)
  },
  "deactivateOneTimeProductOfferRequest": {
    object (DeactivateOneTimeProductOfferRequest)
  }
  // End of mutually exclusive fields.
}
الحقول
نوع انتقال الحالة المطلوب تطبيقه، ويجب ضبط نوع واحد بالضبط. في ما يلي قائمة بالحقول التي يستبعد كلّ منها الآخر. سيتم ضبط حقل واحد على الأكثر في الردّ:
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)

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

DeactivateOneTimeProductOfferRequest

رسالة طلب لإيقاف العروض الترويجية (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)

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