Method: monetization.subscriptions.basePlans.offers.deactivate
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
لإيقاف عرض اشتراك معيّن بعد إيقاف العرض للمشتركين الحاليين، سيظل بإمكانهم الاحتفاظ باشتراكهم، ولكن سيصبح العرض غير متاح للمشتركين الجدد.
طلب HTTP
POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/subscriptions/{productId}/basePlans/{basePlanId}/offers/{offerId}:deactivate
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
| المعلمات |
packageName |
string
مطلوب. التطبيق الرئيسي (اسم الحزمة) للعرض الذي تريد إيقافه.
|
productId |
string
مطلوب. الاشتراك الرئيسي (رقم التعريف) للعرض الذي تريد إيقافه.
|
basePlanId |
string
مطلوب. الخطة الأساسية الرئيسية (رقم تعريف) العرض المطلوب إيقافها.
|
offerId |
string
مطلوب. معرّف العرض الفريد الخاص بالعرض الذي تريد إيقافه
|
نص الطلب
يحتوي نص الطلب على بيانات بالبنية التالية:
| الحقول |
latencyTolerance |
enum (ProductUpdateLatencyTolerance)
اختياريّ. مقدار التفاوت في وقت الاستجابة لنشر تحديث المنتج هذا يتم ضبط الإعدادات التلقائية على الحساسية لوقت الاستجابة.
|
نص الاستجابة
إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال SubscriptionOffer.
نطاقات الأذونات
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/androidpublisher
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eDeactivates a subscription offer, preventing new subscriptions while existing ones remain active.\u003c/p\u003e\n"],["\u003cp\u003eSends a POST request to the specified URL with necessary path parameters like package name, product ID, base plan ID, and offer ID.\u003c/p\u003e\n"],["\u003cp\u003eOptionally includes a request body specifying the latency tolerance for the update.\u003c/p\u003e\n"],["\u003cp\u003eUpon success, returns a SubscriptionOffer object in the response body.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/androidpublisher\u003c/code\u003e scope.\u003c/p\u003e\n"]]],["This API call deactivates a subscription offer for an Android app. It uses a `POST` request to a specific URL, incorporating the app's package name, subscription ID, base plan ID, and offer ID as required path parameters. The request body, in JSON format, allows for specifying `latencyTolerance`. A successful request returns data of `SubscriptionOffer`, and requires the `https://www.googleapis.com/auth/androidpublisher` OAuth scope for authorization. The deactivation makes the offer unavailable to new subscribers.\n"],null,["# Method: monetization.subscriptions.basePlans.offers.deactivate\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n - [JSON representation](#body.request_body.SCHEMA_REPRESENTATION)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nDeactivates a subscription offer. Once deactivated, existing subscribers will maintain their subscription, but the offer will become unavailable to new subscribers.\n\n### HTTP request\n\n`POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/subscriptions/{productId}/basePlans/{basePlanId}/offers/{offerId}:deactivate`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|---------------|------------------------------------------------------------------------------|\n| `packageName` | `string` Required. The parent app (package name) of the offer to deactivate. |\n| `productId` | `string` Required. The parent subscription (ID) of the offer to deactivate. |\n| `basePlanId` | `string` Required. The parent base plan (ID) of the offer to deactivate. |\n| `offerId` | `string` Required. The unique offer ID of the offer to deactivate. |\n\n### Request body\n\nThe request body contains data with the following structure:\n\n| JSON representation |\n|---------------------------------------------------------------------------------------------------------|\n| ``` { \"latencyTolerance\": enum (/android-publisher/api-ref/rest/v3/ProductUpdateLatencyTolerance) } ``` |\n\n| Fields ||\n|--------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `latencyTolerance` | `enum (`[ProductUpdateLatencyTolerance](/android-publisher/api-ref/rest/v3/ProductUpdateLatencyTolerance)`)` Optional. The latency tolerance for the propagation of this product update. Defaults to latency-sensitive. |\n\n### Response body\n\nIf successful, the response body contains an instance of [SubscriptionOffer](/android-publisher/api-ref/rest/v3/monetization.subscriptions.basePlans.offers#SubscriptionOffer).\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/androidpublisher`"]]
