- طلب HTTP
- مَعلمات المسار
- نص الطلب
- نص الاستجابة
- نطاقات التفويض
- UpdateSubscriptionOfferRequest
- جرِّبه الآن
يتيح هذا الخيار تعديل مجموعة من عروض الاشتراك.
يمكنك ضبط حقل TimeTolerance في الطلبات المتداخلة على PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_TOLERANT لتحقيق الحد الأقصى من سرعة معالجة بيانات التحديثات.
طلب HTTP
POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/subscriptions/{productId}/basePlans/{basePlanId}/offers:batchUpdate
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
المعلمات | |
---|---|
packageName |
مطلوب. التطبيق الرئيسي (اسم الحزمة) لعروض الاشتراك المعدّلة يجب أن تكون القيمة مساوية لحقل packageName على جميع موارد SubscriptionOffer المعدَّلة. |
productId |
مطلوب. معرّف المنتج للاشتراك الرئيسي، إذا كانت جميع العروض المعدَّلة تنتمي إلى الاشتراك نفسه. إذا كان هذا الطلب يشمل اشتراكات متعددة، اضبط هذا الحقل على "-". يجب ضبطها. |
basePlanId |
مطلوب. الخطة الأساسية (رقم التعريف) التي يجب تعديل العروض الترويجية لها يمكن تحديدها على أنّها "-" لتعديل العروض من خطط أساسية متعدّدة |
نص الطلب
يحتوي نص الطلب على بيانات بالبنية التالية:
تمثيل JSON |
---|
{
"requests": [
{
object ( |
الحقول | |
---|---|
requests[] |
مطلوب. قائمة بطلبات التعديل لما يصل إلى 100 عنصر. يجب تعديل عروض الاشتراك المختلفة في جميع الطلبات. |
نص الاستجابة
رسالة ردّ لـ Offer.batchUpdate.
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل JSON |
---|
{
"subscriptionOffers": [
{
object ( |
الحقول | |
---|---|
subscriptionOffers[] |
القائمة المعدَّلة لعروض الاشتراك |
نطاقات الأذونات
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/androidpublisher
UpdateSubscriptionOfferRequest
يمكنك طلب تلقّي رسالة بشأن Offer.patch.
تمثيل JSON |
---|
{ "subscriptionOffer": { object ( |
الحقول | |
---|---|
subscriptionOffer |
مطلوب. عرض الاشتراك الذي سيتم تعديله |
updateMask |
مطلوب. قائمة الحقول التي سيتم تعديلها هذه قائمة مفصولة بفواصل تضم أسماء الحقول المؤهلة بالكامل. مثال: |
regionsVersion |
مطلوب. تشير هذه السمة إلى إصدار المناطق المتوفّرة التي يتم استخدامها في SubscriptionOffer. |
allowMissing |
اختياريّ. إذا تم ضبط هذه السياسة على "صحيح"، ولم يتم العثور على عرض الاشتراك الذي يتضمّن packageName وproductId وbasePlanId وOfferId، سيتم إنشاء عرض. في حال إنشاء عرض جديد، يتم تجاهل updateMask. |
latencyTolerance |
اختياريّ. مقدار التفاوت في وقت الاستجابة لنشر تحديث المنتج هذا يتم ضبط الإعدادات التلقائية على الحساسية لوقت الاستجابة. |