REST Resource: monetization.subscriptions

منبع: اشتراک

یک اشتراک برای یک برنامه.

نمایندگی JSON
{
  "packageName": string,
  "productId": string,
  "basePlans": [
    {
      object (BasePlan)
    }
  ],
  "listings": [
    {
      object (SubscriptionListing)
    }
  ],
  "archived": boolean,
  "taxAndComplianceSettings": {
    object (SubscriptionTaxAndComplianceSettings)
  }
}
زمینه های
packageName

string

تغییرناپذیر. نام بسته برنامه والد.

productId

string

تغییرناپذیر. شناسه محصول منحصر به فرد محصول. منحصر به فرد در برنامه والد. شناسه محصولات باید از حروف کوچک (az)، اعداد (0-9)، زیرخط (_) و نقطه (.) تشکیل شده باشد. باید با یک حرف یا عدد کوچک شروع شود و طول آن بین 1 تا 40 کاراکتر (شامل) باشد.

basePlans[]

object ( BasePlan )

مجموعه طرح های پایه برای این اشتراک. اگر پیشنهاد دیگری اعمال نشود، قیمت ها و مدت اشتراک را نشان می دهد.

listings[]

object ( SubscriptionListing )

ضروری. فهرست فهرست‌های محلی برای این اشتراک. باید حداقل یک ورودی برای زبان پیش‌فرض برنامه والد داشته باشد.

archived
(deprecated)

boolean

فقط خروجی منسوخ شده: بایگانی اشتراک پشتیبانی نمی شود.

taxAndComplianceSettings

object ( SubscriptionTaxAndComplianceSettings )

جزئیات در مورد مالیات و انطباق قانونی.

بیس پلن

یک طرح پایه واحد برای یک اشتراک.

نمایندگی JSON
{
  "basePlanId": string,
  "state": enum (State),
  "regionalConfigs": [
    {
      object (RegionalBasePlanConfig)
    }
  ],
  "offerTags": [
    {
      object (OfferTag)
    }
  ],
  "otherRegionsConfig": {
    object (OtherRegionsBasePlanConfig)
  },

  // Union field base_plan_type can be only one of the following:
  "autoRenewingBasePlanType": {
    object (AutoRenewingBasePlanType)
  },
  "prepaidBasePlanType": {
    object (PrepaidBasePlanType)
  }
  // End of list of possible types for union field base_plan_type.
}
زمینه های
basePlanId

string

ضروری. تغییرناپذیر. شناسه منحصر به فرد این طرح پایه. باید در اشتراک منحصر به فرد باشد و با RFC-1034 مطابقت داشته باشد. یعنی این شناسه فقط می تواند شامل حروف کوچک (az)، اعداد (0-9) و خط تیره (-) و حداکثر 63 کاراکتر باشد.

state

enum ( State )

فقط خروجی وضعیت طرح پایه، یعنی فعال بودن آن. طرح های پایه پیش نویس و غیر فعال را می توان فعال یا حذف کرد. پلان های پایه فعال را می توان غیر فعال کرد. طرح های پایه غیرفعال را می توان لغو کرد. این فیلد را نمی توان با به روز رسانی منبع تغییر داد. به جای آن از نقاط پایانی اختصاصی استفاده کنید.

regionalConfigs[]

object ( RegionalBasePlanConfig )

اطلاعات ویژه منطقه برای این طرح پایه.

offerTags[]

object ( OfferTag )

فهرست حداکثر 20 برچسب سفارشی که برای این طرح پایه مشخص شده است و از طریق کتابخانه صورتحساب به برنامه بازگردانده شده است. پیشنهادهای اشتراک برای این طرح پایه نیز این برچسب‌های پیشنهادی را در کتابخانه صورت‌حساب دریافت می‌کنند.

otherRegionsConfig

object ( OtherRegionsBasePlanConfig )

اطلاعات قیمت برای هر مکان جدیدی که Play ممکن است در آینده راه اندازی شود. در صورت حذف، BasePlan به‌طور خودکار در دسترس نخواهد بود، مکان‌های جدیدی که Play در آینده ممکن است راه‌اندازی کند.

فیلد اتحادیه base_plan_type . نوع این طرح پایه. دقیقاً یکی باید تنظیم شود. base_plan_type می تواند تنها یکی از موارد زیر باشد:
autoRenewingBasePlanType

object ( AutoRenewingBasePlanType )

زمانی را تنظیم کنید که طرح پایه به طور خودکار در یک بازه زمانی منظم تجدید شود.

prepaidBasePlanType

object ( PrepaidBasePlanType )

زمانی را تنظیم کنید که طرح پایه به طور خودکار در پایان دوره صورتحساب تمدید نشود.

حالت

وضعیت فعلی یک طرح پایه

Enums
STATE_UNSPECIFIED وضعیت نامشخص
DRAFT طرح پایه در حال حاضر در حالت پیش نویس است و فعال نشده است. در این مرحله با خیال راحت می توان آن را حذف کرد.
ACTIVE طرح پایه فعال و برای مشترکین جدید در دسترس است.
INACTIVE طرح پایه غیرفعال است و فقط برای مشترکین موجود در دسترس است.

AutoRenewingBasePlanType

یک طرح پایه را نشان می دهد که به طور خودکار در پایان دوره اشتراک آن تمدید می شود.

نمایندگی JSON
{
  "billingPeriodDuration": string,
  "gracePeriodDuration": string,
  "accountHoldDuration": string,
  "resubscribeState": enum (ResubscribeState),
  "prorationMode": enum (SubscriptionProrationMode),
  "legacyCompatible": boolean,
  "legacyCompatibleSubscriptionOfferId": string
}
زمینه های
billingPeriodDuration

string

ضروری. دوره اشتراک، مشخص شده در قالب ISO 8601. برای لیست دوره های صورتحساب قابل قبول، به مرکز راهنمایی مراجعه کنید.

gracePeriodDuration

string

دوره مهلت اشتراک، مشخص شده در قالب ISO 8601. مقادیر قابل قبول P0D (روز صفر)، P3D (3 روز)، P7D (7 روز)، P14D (14 روز)، و P30D (30 روز) هستند. اگر مشخص نشده باشد، یک مقدار پیش فرض بر اساس مدت زمان دوره تکرار شونده استفاده خواهد شد.

accountHoldDuration

string

اختیاری. دوره نگهداری حساب اشتراک، مشخص شده در قالب ISO 8601. مقادیر قابل قبول باید بر حسب DAYS و در محدوده P0D (صفر روز) تا P30D (30 روز) باشد. اگر مشخص نشده باشد، مقدار پیش فرض P30D (30 روز) است.

resubscribeState

enum ( ResubscribeState )

آیا کاربران باید بتوانند مجدداً در این طرح پایه در سطوح Google Play مشترک شوند یا خیر. اگر مشخص نشده باشد، پیش‌فرض RESUBSCRIBE_STATE_ACTIVE است.

prorationMode

enum ( SubscriptionProrationMode )

حالت تناسب برای طرح پایه تعیین می کند که وقتی کاربر از طرح پایه دیگری به این طرح تغییر می کند چه اتفاقی می افتد. اگر مشخص نشده باشد، پیش‌فرض CHARGE_ON_NEXT_BILLING_DATE است.

legacyCompatible

boolean

اینکه آیا طرح پایه تمدید شده با عقب سازگار است یا خیر.

طرح پایه سازگار با عقب‌افتاده توسط روش منسوخ شده QuerySkuDetailsAsync() کتابخانه صورت‌حساب Google Play برگردانده می‌شود.

فقط یک طرح پایه در حال تمدید می تواند به عنوان قدیمی سازگار برای یک اشتراک مشخص علامت گذاری شود.

legacyCompatibleSubscriptionOfferId

string

شناسه پیشنهاد اشتراک که با نسخه قدیمی سازگار است.

پیشنهاد اشتراک سازگار با گذشته توسط روش منسوخ شده QuerySkuDetailsAsync() کتابخانه صورت‌حساب Google Play برگردانده می‌شود.

فقط یک پیشنهاد اشتراک را می‌توان به‌عنوان قدیمی سازگار برای یک طرح پایه در حال تمدید مشخص علامت‌گذاری کرد.

برای اینکه هیچ پیشنهاد اشتراکی به عنوان سازگار قدیمی نداشته باشید، این فیلد را به عنوان رشته خالی تنظیم کنید.

ResubscribeState

وضعیت اشتراک مجدد طرح پایه.

Enums
RESUBSCRIBE_STATE_UNSPECIFIED وضعیت نامشخص
RESUBSCRIBE_STATE_ACTIVE اشتراک مجدد فعال است.
RESUBSCRIBE_STATE_INACTIVE اشتراک مجدد غیرفعال است.

SubscriptionProrationMode

حالت تناسب مورد استفاده برای تجدید طرح های پایه.

Enums
SUBSCRIPTION_PRORATION_MODE_UNSPECIFIED حالت نامشخص
SUBSCRIPTION_PRORATION_MODE_CHARGE_ON_NEXT_BILLING_DATE کاربران برای طرح پایه جدید خود در پایان دوره صورتحساب فعلی خود هزینه دریافت خواهند کرد.
SUBSCRIPTION_PRORATION_MODE_CHARGE_FULL_PRICE_IMMEDIATELY هزینه طرح پایه جدید خود بلافاصله و به طور کامل از کاربران دریافت خواهد شد. هر دوره باقیمانده از اشتراک موجود آنها برای تمدید مدت زمان طرح صورت‌حساب جدید استفاده می‌شود.

PrepaidBasePlanType

یک طرح پایه را نشان می دهد که در پایان طرح پایه به طور خودکار تمدید نمی شود و باید به صورت دستی توسط کاربر تمدید شود.

نمایندگی JSON
{
  "billingPeriodDuration": string,
  "timeExtension": enum (TimeExtension)
}
زمینه های
billingPeriodDuration

string

ضروری. دوره اشتراک، مشخص شده در قالب ISO 8601. برای لیست دوره های صورتحساب قابل قبول، به مرکز راهنمایی مراجعه کنید.

timeExtension

enum ( TimeExtension )

آیا کاربران باید بتوانند این طرح پایه پیش‌پرداخت را در سطوح Google Play گسترش دهند یا خیر. اگر مشخص نشده باشد، پیش‌فرض TIME_EXTENSION_ACTIVE می‌شود.

تمدید زمان

تمدید زمان طرح پایه

Enums
TIME_EXTENSION_UNSPECIFIED وضعیت نامشخص
TIME_EXTENSION_ACTIVE تمدید زمان فعال است. کاربران مجازند طرح پیش پرداخت خود را شارژ یا تمدید کنند.
TIME_EXTENSION_INACTIVE تمدید زمان غیرفعال است. کاربران نمی توانند طرح پیش پرداخت خود را شارژ یا تمدید کنند.

RegionalBasePlanConfig

پیکربندی برای یک طرح پایه خاص برای یک منطقه.

نمایندگی JSON
{
  "regionCode": string,
  "newSubscriberAvailability": boolean,
  "price": {
    object (Money)
  }
}
زمینه های
regionCode

string

ضروری. کد منطقه ای این پیکربندی، همانطور که توسط ISO 3166-2 تعریف شده است، به عنوان مثال "US".

newSubscriberAvailability

boolean

آیا طرح پایه در منطقه مشخص شده برای مشترکین جدید در دسترس است یا خیر. اگر این مقدار روی false تنظیم شود اشتراک مشترکان موجود لغو نخواهد شد. اگر مشخص نشده باشد، این به طور پیش فرض نادرست خواهد بود.

price

object ( Money )

قیمت طرح پایه در منطقه مشخص شده. اگر طرح پایه برای مشترکین جدید در دسترس باشد، باید تنظیم شود. باید به واحد پولی که به منطقه مشخص شده مرتبط است تنظیم شود.

OtherRegionsBasePlanConfig

اطلاعات قیمت برای هر مکان جدیدی که Play ممکن است در آن راه اندازی شود.

نمایندگی JSON
{
  "usdPrice": {
    object (Money)
  },
  "eurPrice": {
    object (Money)
  },
  "newSubscriberAvailability": boolean
}
زمینه های
usdPrice

object ( Money )

ضروری. قیمت به دلار برای استفاده برای مکان‌های جدیدی که ممکن است Play در آن راه‌اندازی شود.

eurPrice

object ( Money )

ضروری. قیمت به یورو برای استفاده در مکان‌های جدیدی که ممکن است Play در آن راه اندازی شود.

newSubscriberAvailability

boolean

اینکه آیا طرح پایه برای مشترکین جدید در مکان‌های جدیدی در دسترس است یا نه. اگر Play در آن راه‌اندازی شود.

فهرست اشتراک

فراداده قابل مشاهده برای مصرف کننده یک اشتراک.

نمایندگی JSON
{
  "languageCode": string,
  "title": string,
  "benefits": [
    string
  ],
  "description": string
}
زمینه های
languageCode

string

ضروری. زبان این فهرست، همانطور که توسط BCP-47 تعریف شده است، به عنوان مثال "en-US".

title

string

ضروری. عنوان این اشتراک به زبان این فهرست است. متن ساده

benefits[]

string

فهرستی از مزایای نشان داده شده به کاربر در پلتفرم هایی مانند Play Store و در جریان بازیابی به زبان این فهرست است. متن ساده لیست سفارش داده شده از حداکثر چهار مزیت.

description

string

شرح این اشتراک به زبان این فهرست. حداکثر طول - 80 کاراکتر. متن ساده

مواد و روش ها

archive
(deprecated)

 منسوخ شده: بایگانی اشتراک پشتیبانی نمی شود.

batchGet

 یک یا چند اشتراک را می خواند.

batchUpdate

 دسته ای از اشتراک ها را به روز می کند.

create

 یک اشتراک جدید ایجاد می کند.

delete

 اشتراک را حذف می کند.

get

 یک اشتراک را می خواند.

list

 همه اشتراک‌های یک برنامه خاص را فهرست می‌کند.

patch

 اشتراک موجود را به روز می کند.