- Kaynak: Abonelik
- Temel Plan
- Durum
- AutoRenewingBasePlanType
- Aboneliği yenileme
- SubscriptionProrationMode
- PrepaidBasePlanType
- Zaman Uzantısı
- RegionalBasePlanConfig
- OtherRegionsBasePlanConfig
- Abonelik Listesi
- Yöntemler
Kaynak: Abonelik
Bir uygulama için tek bir abonelik.
JSON representation |
---|
{ "packageName": string, "productId": string, "basePlans": [ { object ( |
Alanlar | |
---|---|
packageName |
Sabit. Ana uygulamanın paket adı. |
productId |
Sabit. Ürünün benzersiz ürün kimliği. Üst uygulama içinde benzersizdir. Ürün kimlikleri küçük harf (a-z), rakam (0-9), alt çizgi (_) ile noktadan (.) oluşmalıdır. Küçük harfle veya rakamla başlamalı, uzunluğu 1-40 (kapsayıcı) karakter olmalıdır. |
basePlans[] |
Bu abonelik için temel planlar grubu. Başka teklif geçerli değilse aboneliğin fiyatlarını ve süresini temsil eder. |
listings[] |
Gerekli. Bu abonelik için yerelleştirilmiş listelemelerin apks.list'i. Üst uygulamanın varsayılan dili için en az bir giriş içermelidir. |
archived |
Yalnızca çıkış. Bu aboneliğin arşivlenip arşivlenmediği. Arşivlenen abonelikler artık hiçbir abone tarafından kullanılamaz, güncellenemez ve arşivlenmiş program bayrağı aktarılmadıkça liste isteklerinde döndürülmez. |
taxAndComplianceSettings |
Vergiler ve yasalara uygunlukla ilgili ayrıntılar. |
Temel Plan
Abonelik için tek bir temel plan.
JSON gösterimi |
---|
{ "basePlanId": string, "state": enum ( |
Alanlar | |
---|---|
basePlanId |
Zorunlu. Sabit. Bu temel planın benzersiz tanımlayıcısı. Abonelik içinde benzersiz olmalı ve RFC-1034'e uygun olmalıdır. Yani bu kimlik yalnızca küçük harf (a-z), rakam (0-9), kısa çizgi (-) ve en fazla 63 karakter içerebilir. |
state |
Yalnızca çıkış. Temel planın durumu (ör. etkin olup olmadığı). Taslak ve etkin olmayan temel planlar etkinleştirilebilir veya silinebilir. Etkin temel planlar devre dışı bırakılabilir. Etkin olmayan temel planlar iptal edilebilir. Bu alan, kaynak güncellenerek değiştirilemez. Bunun yerine özel uç noktaları kullanın. |
regionalConfigs[] |
Bu temel planın bölgeye özgü bilgileri. |
offerTags[] |
Bu temel plan için en fazla 20 özel etiket içeren ve faturalandırma kitaplığı üzerinden uygulamaya döndürülen apks.list. Bu temel plana yönelik abonelik teklifleri, faturalandırma kitaplığında da bu teklif etiketlerini alır. |
otherRegionsConfig |
Play'in gelecekte kullanıma sunulacağı tüm yeni konumlar için fiyatlandırma bilgileri. Atlanırsa Temel Plan, Play'in gelecekte kullanıma sunabileceği yeni yerler için otomatik olarak kullanılamaz. |
Birlik alanı base_plan_type . Bu temel planın türü. Tam olarak bir tane ayarlanmalıdır. base_plan_type aşağıdakilerden yalnızca biri olabilir: |
|
autoRenewingBasePlanType |
Temel planın düzenli aralıklarla otomatik olarak yenileneceği zamanı ayarlayın. |
prepaidBasePlanType |
Temel planın, fatura döneminin sonunda otomatik olarak yenilenme zamanını ayarlayın. |
Eyalet
Temel planın mevcut durumu.
Sıralamalar | |
---|---|
STATE_UNSPECIFIED |
Belirtilmemiş durum. |
DRAFT |
Temel plan şu anda taslak halindedir ve etkinleştirilmemiştir. Bu noktada güvenle silinebilir. |
ACTIVE |
Temel plan etkin ve yeni aboneler tarafından kullanılabilir. |
INACTIVE |
Temel plan etkin değildir ve yalnızca mevcut aboneler tarafından kullanılabilir. |
Otomatik Yenileme Temel Plan Türü
Abonelik döneminin sonunda otomatik olarak yenilenen temel planı temsil eder.
JSON gösterimi |
---|
{ "billingPeriodDuration": string, "gracePeriodDuration": string, "resubscribeState": enum ( |
Alanlar | |
---|---|
billingPeriodDuration |
Zorunlu. ISO 8601 biçiminde belirtilen abonelik dönemi. Kabul edilebilir fatura dönemlerinin listesi için yardım merkezine bakın. |
gracePeriodDuration |
ISO 8601 biçiminde belirtilen ek yayınlanma süresi. Kabul edilebilir değerler P0D (sıfır gün), P3D (3 gün), P7D (7 gün), P14D (14 gün) ve P30D (30 gün). Belirtilmezse yinelenen süre süresine göre varsayılan bir değer kullanılır. |
resubscribeState |
Kullanıcıların Google Play yüzeylerinde bu temel plana yeniden abone olup olamayacağı. Belirtilmezse varsayılan olarak RESUBSCRIBE_State_ACTIVE olur. |
prorationMode |
Temel planın oran modu, bir kullanıcı başka bir temel plandan bu plana geçtiğinde ne olacağını belirler. Bu değer belirtilmediğinde varsayılan olarak CHARGE_ON_NEXT_BILLING_DATE değerine ayarlanır. |
legacyCompatible |
Yenilenen temel planın geriye dönük uyumlu olup olmadığı. Geriye dönük uyumlu temel plan, Google Play Faturalandırma Kitaplığı'nın kullanımdan kaldırılan querySkuDetailsAsync() yöntemi tarafından döndürülür. Belirli bir abonelik için yalnızca bir yenilenen temel plan eski sürümle uyumlu olarak işaretlenebilir. |
legacyCompatibleSubscriptionOfferId |
Eski sürümle uyumlu abonelik teklifi kimliği. Geriye dönük abonelik teklifi, Google Play Faturalandırma Kitaplığı'nın kullanımdan kaldırılan querySkuDetailsAsync() yöntemi tarafından döndürülür. Belirli bir yenilenen temel plan için yalnızca bir abonelik teklifi eski sürümle uyumlu olarak işaretlenebilir. Eski sürümle uyumlu bir Abonelik teklifi bulunmaması için bu alanı boş dize olarak ayarlayın. |
Yeniden Abone Olma Durumu
Temel planın yeniden abone olma durumu.
Sıralamalar | |
---|---|
RESUBSCRIBE_STATE_UNSPECIFIED |
Belirtilmemiş durum. |
RESUBSCRIBE_STATE_ACTIVE |
Yeniden abone olma etkin. |
RESUBSCRIBE_STATE_INACTIVE |
Yeniden abone olma etkin değil. |
Abonelik Oranı modu
Temel planların yenilenmesi için kullanılan oran modu.
Sıralamalar | |
---|---|
SUBSCRIPTION_PRORATION_MODE_UNSPECIFIED |
Belirtilmemiş mod. |
SUBSCRIPTION_PRORATION_MODE_CHARGE_ON_NEXT_BILLING_DATE |
Geçerli fatura dönemi sona erdikten sonra kullanıcılardan yeni temel plan için ödeme alınır. |
SUBSCRIPTION_PRORATION_MODE_CHARGE_FULL_PRICE_IMMEDIATELY |
Kullanıcılar yeni temel plan için hemen ve tam olarak ücretlendirilir. Mevcut aboneliklerinin kalan süresi yeni faturalandırma planının süresini uzatmak için kullanılır. |
Ön Ödemeli Temel Plan Türü
Temel planın sonunda otomatik olarak yenilenmeyen ve kullanıcı tarafından manuel olarak yenilenmesi gereken temel planı temsil eder.
JSON gösterimi |
---|
{
"billingPeriodDuration": string,
"timeExtension": enum ( |
Fields | |
---|---|
billingPeriodDuration |
Zorunlu. ISO 8601 biçiminde belirtilen abonelik dönemi. Kabul edilebilir fatura dönemlerinin listesi için yardım merkezine bakın. |
timeExtension |
Kullanıcıların bu ön ödemeli temel planı Google Play yüzeylerinde genişletip genişletemeyeceği. Belirtilmezse varsayılan olarak TIME_EXTENSION_ACTIVE değerine ayarlanır. |
Süre Uzantısı
Temel plan zaman uzantısı.
Sıralamalar | |
---|---|
TIME_EXTENSION_UNSPECIFIED |
Belirtilmemiş durum. |
TIME_EXTENSION_ACTIVE |
Zaman uzantısı etkin. Kullanıcılar ön ödemeli planlarına para ekleyebilir veya planlarını uzatabilir. |
TIME_EXTENSION_INACTIVE |
Zaman uzantısı etkin değil. Kullanıcılar ön ödemeli planlarına para ekleyemez veya uzatamaz. |
RegionalBasePlanConfig
Bölgeye özgü bir temel plan için yapılandırma.
JSON gösterimi |
---|
{
"regionCode": string,
"newSubscriberAvailability": boolean,
"price": {
object ( |
Alanlar | |
---|---|
regionCode |
Zorunlu. ISO 3166-2'de tanımlandığı gibi bu yapılandırmanın geçerli olduğu bölge kodu (ör. "US&); |
newSubscriberAvailability |
Belirtilen bölgedeki temel planın yeni aboneler için kullanılabilir olup olmadığı. Bu değer false olarak ayarlanırsa mevcut abonelerin aboneliği iptal edilmez. Belirtilmezse varsayılan olarak false (yanlış) değeri kullanılır. |
price |
Temel planın belirtilen bölgedeki fiyatı. Temel plan yeni abonelere sunuluyorsa ayarlanmalıdır. Belirtilen bölgeye bağlı para biriminde ayarlanmalıdır. |
DiğerRegionsBasePlanConfig
Play'in kullanıma sunulabileceği tüm yeni konumlar için fiyatlandırma bilgileri.
JSON gösterimi |
---|
{ "usdPrice": { object ( |
Alanlar | |
---|---|
usdPrice |
Zorunlu. Play'in kullanıma sunulacağı tüm yeni yerlerde kullanılmak üzere ABD doları cinsinden fiyat. |
eurPrice |
Zorunlu. Play'in kullanıma sunulacağı tüm yeni yerlerde kullanılmak üzere Euro cinsinden fiyat. |
newSubscriberAvailability |
Temel planın Play'in kullanıma sunulabileceği yeni bölgelerdeki yeni abonelere sunulup sunulmayacağı. Belirtilmezse varsayılan olarak false (yanlış) değeri kullanılır. |
Abonelik Listeleme
Bir aboneliğin tüketici tarafından görülebilir meta verileri.
JSON gösterimi |
---|
{ "languageCode": string, "title": string, "benefits": [ string ], "description": string } |
Alanlar | |
---|---|
languageCode |
Zorunlu. Bu girişin dili, BCP-47 tarafından tanımlandığı haliyle, ör. "en-US" |
title |
Zorunlu. Bu aboneliğin bu girişteki dilde başlığı. Düz metin. |
benefits[] |
Kullanıcıya, Play Store gibi platformlarda ve bu girişin dilinde geri yükleme akışlarında gösterilen avantajların listesi. Düz metin. En fazla dört avantajın sıralı listesi. |
description |
Bu aboneliğin bu girişteki dilde açıklaması. Maksimum uzunluk - 80 karakter. Düz metin. |
Yöntemler |
|
---|---|
|
Aboneliği arşivler. |
|
Yeni abonelik oluşturur. |
|
Aboneliği siler. |
|
Tek bir aboneliği okur. |
|
Belirli bir uygulama altındaki tüm abonelikleri listeler. |
|
Mevcut bir aboneliği günceller. |