- طلب HTTP
- مَعلمات المسار
- نص الطلب
- نص الاستجابة
- نطاقات التفويض
- UpdateSubscriptionOfferRequest
- جرِّبه الآن
لتعديل مجموعة من عروض الاشتراك
عيِّن حقل "وقت الاستجابة" في الطلبات المتداخلة على 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 عنصر يجب تعديل عروض الاشتراك المختلفة في جميع الطلبات. |
نص الاستجابة
رسالة رد لـ offers.batchUpdate.
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل JSON |
---|
{
"subscriptionOffers": [
{
object ( |
الحقول | |
---|---|
subscriptionOffers[] |
قائمة عروض الاشتراكات المعدّلة |
نطاقات التفويض
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/androidpublisher
UpdateSubscriptionOfferRequest
اطلب رسالة لـ offers.patch.
تمثيل JSON |
---|
{ "subscriptionOffer": { object ( |
الحقول | |
---|---|
subscriptionOffer |
مطلوبة. عرض الاشتراك المطلوب تعديله |
updateMask |
مطلوبة. قائمة الحقول المطلوب تعديلها. هذه قائمة مفصولة بفواصل تضم أسماء الحقول المؤهلة بالكامل. مثال: |
regionsVersion |
مطلوبة. تمثّل هذه السمة إصدار المناطق المتاحة الذي يتم استخدامه في subscriptionOffer. |
allowMissing |
اختياري. سيتم إنشاء عرض في حال تم ضبطه على "صحيح" وعدم توفّر عرض الاشتراك الذي يتضمّن قيمة packageName وproductId وbasePlanId وOfferId. في حال إنشاء عرض جديد، يتم تجاهل updateMask. |
latencyTolerance |
اختياري. مقدار الوقت الذي يستغرقه نشر تحديث المنتج هذا. يتم ضبط الإعدادات التلقائية على حساسية وقت الاستجابة. |