Method: monetization.subscriptions.basePlans.migratePrices

تنقل بيانات المشتركين الذين يتلقون سعر اشتراك سابقًا إلى السعر المعروض حاليًا للمنطقة المحددة. ستؤدي الطلبات إلى إرسال إشعارات بتغيير السعر إلى المستخدمين الذين يتلقّون حاليًا سعرًا سابقًا أقدم من الطابع الزمني المقدّم. وفي حال عدم الموافقة على السعر الجديد، سيتم إنهاء اشتراكهم عند موعد التجديد القادم.

طلب HTTP

POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/subscriptions/{productId}/basePlans/{basePlanId}:migratePrices

يستخدم عنوان URL بنية gRPC Transcode.

معلّمات المسار

المعلّمات
packageName

string

مطلوبة. اسم حزمة التطبيق الرئيسي. يجب أن يساوي حقل packageName في مورد "الاشتراك".
productId

string

مطلوبة. رقم تعريف الاشتراك المطلوب تعديله يجب أن تساوي حقل productId في مورد الاشتراك.
basePlanId

string

مطلوبة. رقم تعريف الخطة الأساسية الفريدة للخطة الأساسية لتعديل الأسعار وفقًا لها.

نص الطلب

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

تمثيل JSON 
{
  "regionalPriceMigrations": [
    {
      object (RegionalPriceMigrationConfig)
    }
  ],
  "regionsVersion": {
    object (RegionsVersion)
  }
}
الحقول
regionalPriceMigrations[]

object (RegionalPriceMigrationConfig)

مطلوبة. يجب تعديل الأسعار على مستوى منطقة معيّنة.
regionsVersion

object (RegionsVersion)

مطلوبة. تمثّل هذه السمة إصدار المناطق المتاحة المُستخدَمة في الطريقة الإقليمي السعر.

نص الاستجابة

وفي حال نجاح هذا الإجراء، سيكون نص الاستجابة فارغًا.

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

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

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

ضبط السعر على مستوى منطقة معيّنة

عملية إعداد لنقل السعر

تمثيل JSON 
{
  "regionCode": string,
  "oldestAllowedPriceVersionTime": string
}
الحقول
regionCode

string

مطلوبة. رمز المنطقة الذي ينطبق عليه هذا الضبط، على النحو المحدّد في ISO 3166-2، مثل "US".
oldestAllowedPriceVersionTime

string (Timestamp format)

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

طابع زمني بتنسيق RFC3339 UTC "Zulu"، بدقة تصل إلى نانو ثانية وما يصل إلى تسعة أرقام كسور أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z".