Method: monetization.subscriptions.basePlans.migratePrices
تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
نقل بيانات المشتركين من مجموعة نموذجية واحدة أو أكثر للأسعار القديمة إلى السعر الحالي تؤدي الطلبات إلى إرسال Google Play إشعارًا إلى المشتركين المعنيّين. لا يمكن استخدام أكثر من 250 مجموعة نموذجية قديمة للأسعار في الوقت نفسه.
طلب HTTP
POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/subscriptions/{productId}/basePlans/{basePlanId}:migratePrices
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
| المعلمات |
packageName | string
مطلوب. اسم حزمة التطبيق الرئيسي يجب أن يكون الحقل مساويًا لحقل packageName في مورد "الاشتراك". |
productId | string
مطلوب. معرّف الاشتراك المطلوب تعديله. يجب أن يكون الحقل مساويًا للحقل productId في مورد "الاشتراك". |
basePlanId | string
مطلوب. معرّف الخطة الأساسية الفريد للخطة الأساسية المطلوب تعديل الأسعار فيها |
نص الطلب
يحتوي نص الطلب على بيانات بالبنية التالية:
| الحقول |
regionalPriceMigrations[] | object (RegionalPriceMigrationConfig)
مطلوب. الأسعار التي سيتم تعديلها على مستوى منطقة معيّنة |
regionsVersion | object (RegionsVersion)
مطلوب. تشير هذه السمة إلى نسخة المناطق المتوفّرة التي يتم استخدامها في AndroidPriceMigrations. |
latencyTolerance | enum (ProductUpdateLatencyTolerance)
اختياريّ. الحدّ المسموح به لوقت الاستجابة لنشر تعديلات هذا المنتج. يتم ضبط الإعدادات التلقائية على الحساسية لوقت الاستجابة. |
نص الاستجابة
إذا كانت الاستجابة ناجحة، يكون نص الاستجابة فارغًا.
نطاقات التفويض
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/androidpublisher
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)"],[[["Migrates subscribers of one or more legacy price cohorts to the current subscription price, notifying affected subscribers via Google Play."],["Supports a maximum of 250 simultaneous legacy price cohorts for migration."],["Requires providing the package name, subscription ID, and base plan ID for the price migration."],["The request body specifies regional price updates, the regions version, and an optional latency tolerance for the update."],["Utilizes the `https://www.googleapis.com/auth/androidpublisher` authorization scope for access."]]],["This content describes the process of migrating subscribers from legacy price cohorts to the current price using the Google Play API. This involves sending a `POST` request to a specific endpoint with parameters like `packageName`, `productId`, and `basePlanId`. The request body requires `regionalPriceMigrations` and `regionsVersion`, with an optional `latencyTolerance` parameter. Successful requests result in an empty response, and require `androidpublisher` authorization scope. Google Play notifies the affected subscribers of changes, with a limit of 250 simultaneous legacy cohorts.\n"]]
