Method: monetization.subscriptions.basePlans.offers.create
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
ينشئ عرض اشتراك جديد. تتوفّر عروض اشتراك في الخطط الأساسية التي تتجدّد تلقائيًا فقط. وستتمّ مسودّة حالة العرض إلى أن يتم تفعيلها.
طلب HTTP
POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/subscriptions/{productId}/basePlans/{basePlanId}/offers
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
| المَعلمات |
packageName |
string
مطلوبة. التطبيق الرئيسي (اسم الحزمة) الذي يجب إنشاء العرض له. يجب أن يكون مساويًا لحقل packageName في مورد "الاشتراك".
|
productId |
string
مطلوبة. الاشتراك الرئيسي (رقم التعريف) الذي يجب إنشاء العرض له يجب أن يكون مساويًا للحقل productId في المورد SubscriptionOffer.
|
basePlanId |
string
مطلوبة. الخطة الأساسية (رقم التعريف) التي يجب إنشاء العرض لها يجب أن يكون الحقل مساويًا للحقل basePlanId في المورد SubscriptionOffer.
|
معلمات طلب البحث
| المَعلمات |
offerId |
string
مطلوبة. رقم التعريف المطلوب استخدامه للعرض. للاطّلاع على المتطلبات لهذا التنسيق، يمكنك مراجعة مستندات حقل OfferId في مورد SubscriptionOffer.
|
regionsVersion |
object (RegionsVersion)
مطلوبة. تمثّل هذه السمة إصدار المناطق المتاحة الذي يتم استخدامه في subscriptionOffer.
|
نص الطلب
يحتوي نص الطلب على مثال SubscriptionOffer.
نص الاستجابة
إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثيل SubscriptionOffer تم إنشاؤه حديثًا.
نطاقات التفويض
يجب توفير نطاق 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 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eCreates a new subscription offer for auto-renewing base plans, initially in DRAFT state until activated.\u003c/p\u003e\n"],["\u003cp\u003eUses an HTTP POST request to \u003ccode\u003ehttps://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/subscriptions/{productId}/basePlans/{basePlanId}/offers\u003c/code\u003e with specified path and query parameters.\u003c/p\u003e\n"],["\u003cp\u003eRequires providing a \u003ccode\u003eSubscriptionOffer\u003c/code\u003e object in the request body, detailing the offer's specifics.\u003c/p\u003e\n"],["\u003cp\u003eUpon success, the response body returns the newly created \u003ccode\u003eSubscriptionOffer\u003c/code\u003e object.\u003c/p\u003e\n"],["\u003cp\u003eNeeds authorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/androidpublisher\u003c/code\u003e OAuth scope.\u003c/p\u003e\n"]]],["This document details how to create a new subscription offer for auto-renewing base plans. The `POST` request is sent to a specific URL with `packageName`, `productId`, and `basePlanId` as required path parameters. The `offerId` and `regionsVersion` are required query parameters. The request body must contain `SubscriptionOffer` data, and a successful response returns the newly created `SubscriptionOffer`. Authorization requires the `https://www.googleapis.com/auth/androidpublisher` OAuth scope.\n"],null,[]]
