- طلب HTTP
- مَعلمات المسار
- نص الطلب
- نص الاستجابة
- نطاقات التفويض
- UpdateSubscriptionOfferStateRequest
- ActivateSubscriptionOfferRequest
- DeactivateSubscriptionOfferRequest
- جرِّبه الآن
تعدّل هذه السياسة مجموعة من حالات عروض الاشتراك.
عيِّن حقل "وقت الاستجابة" في الطلبات المتداخلة على product_UPDATE_LATENCY_TOLERANCE_LATENCY_TOLERANT لتحقيق الحد الأقصى لسرعة معالجة التحديث.
طلب HTTP
POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/subscriptions/{productId}/basePlans/{basePlanId}/offers:batchUpdateStates
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
المَعلمات | |
---|---|
packageName |
مطلوبة. التطبيق الرئيسي (اسم الحزمة) لعروض الاشتراك المعدّلة يجب أن تكون القيمة مساوية لحقل packageName في جميع موارد SubscriptionOffer المُعدَّلة. |
productId |
مطلوبة. معرّف المنتج للاشتراك الرئيسي، إذا كانت كل العروض المعدّلة تعود إلى الاشتراك نفسه إذا كان هذا الطلب يمتد إلى عدة اشتراكات، اضبط هذا الحقل على "-". ويجب ضبطه. |
basePlanId |
مطلوبة. الخطة الأساسية (رقم التعريف) التي يجب تعديل عروضها الترويجية يمكن تحديد العلامة "-" لتعديل العروض من خطط أساسية متعددة. |
نص الطلب
يحتوي نص الطلب على بيانات بالبنية التالية:
تمثيل JSON |
---|
{
"requests": [
{
object ( |
الحقول | |
---|---|
requests[] |
مطلوبة. قائمة طلبات التعديل تضم ما يصل إلى 100 عنصر. يجب تعديل عروض مختلفة في جميع الطلبات. |
نص الاستجابة
رسالة رد لـ offers.batchUpdateStates.
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل JSON |
---|
{
"subscriptionOffers": [
{
object ( |
الحقول | |
---|---|
subscriptionOffers[] |
قائمة عروض الاشتراكات المعدّلة |
نطاقات التفويض
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/androidpublisher
UpdateSubscriptionOfferStateRequest
رسالة طلب لتعديل حالة عرض الاشتراك
تمثيل JSON |
---|
{ // Union field |
الحقول | |
---|---|
حقل الاتحاد state_transition_type نوع انتقال الحالة المطلوب تطبيقه، يجب تحديد نوع بالضبط. يمكن أن تكون السمة "state_transition_type " واحدة فقط مما يلي: |
|
activateSubscriptionOfferRequest |
تفعِّل أحد العروض. بعد تفعيل العرض، سيصبح متاحًا للمشتركين الجدد. |
deactivateSubscriptionOfferRequest |
لإيقاف عرض، بعد إلغاء تنشيط العرض، سيصبح غير متوفر للمشتركين الجدد، ولكن سيبقى اشتراكهم الحالي ساريًا |
ActivateSubscriptionOfferRequest
طلب رسالة بشأن ActivateSUBSCRIPTIONOffer.
تمثيل JSON |
---|
{
"packageName": string,
"productId": string,
"basePlanId": string,
"offerId": string,
"latencyTolerance": enum ( |
الحقول | |
---|---|
packageName |
مطلوبة. التطبيق الرئيسي (اسم الحزمة) للعرض المطلوب تفعيله. |
productId |
مطلوبة. الاشتراك الرئيسي (رقم التعريف) للعرض المطلوب تفعيله. |
basePlanId |
مطلوبة. الخطة الأساسية (رقم تعريف) العرض المطلوب تفعيله. |
offerId |
مطلوبة. معرّف العرض الفريد للعرض المطلوب تفعيله. |
latencyTolerance |
اختياريّ. مقدار الوقت الذي يستغرقه نشر تحديث المنتج هذا. يتم ضبط الإعدادات التلقائية على حساسية وقت الاستجابة. |
DeactivateSubscriptionOfferRequest
اطلب رسالة لـ offers.deactivate.
تمثيل JSON |
---|
{
"packageName": string,
"productId": string,
"basePlanId": string,
"offerId": string,
"latencyTolerance": enum ( |
الحقول | |
---|---|
packageName |
مطلوبة. التطبيق الرئيسي (اسم الحزمة) للعرض المطلوب إيقافه. |
productId |
مطلوبة. الاشتراك الرئيسي (رقم التعريف) للعرض المطلوب إيقافه. |
basePlanId |
مطلوبة. سيتم إيقاف الخطة الأساسية (رقم تعريف) الخطة الأساسية للعرض الترويجي. |
offerId |
مطلوبة. معرّف العرض الفريد للعرض المطلوب إيقافه. |
latencyTolerance |
اختياريّ. مقدار الوقت الذي يستغرقه نشر تحديث المنتج هذا. يتم ضبط الإعدادات التلقائية على حساسية وقت الاستجابة. |