- Kaynak: Abonelik
- BasePlan
- Durum
- AutoRenewingBasePlanType
- ResubscribeState
- SubscriptionProrationMode
- PrepaidBasePlanType
- TimeExtension
- InstallmentsBasePlanType
- RenewalType
- RegionalBasePlanConfig
- OtherRegionsBasePlanConfig
- SubscriptionListing
- RestrictedPaymentCountries
- Yöntemler
Kaynak: Abonelik
Bir uygulama için tek bir abonelik.
JSON gösterimi |
---|
{ "packageName": string, "productId": string, "basePlans": [ { object ( |
Alanlar | |
---|---|
packageName |
Sabit. Üst uygulamanın paket adı. |
productId |
Sabit. Ürünün benzersiz ürün kimliği. Üst uygulamada benzersizdir. Ürün kimlikleri küçük harf (a-z), rakam (0-9), alt çizgi (_) ve noktalardan (.) oluşmalıdır. Küçük harf veya rakamla başlamalı ve 1 ila 40 (dahil) karakter uzunluğunda olmalıdır. |
basePlans[] |
Bu abonelikle ilgili temel plan grubu. Başka teklif yoksa aboneliğin fiyatlarını ve süresini gösterir. |
listings[] |
Zorunlu. Bu abonelik için yerelleştirilmiş girişlerin listesi. Üst uygulamanın varsayılan dili için en az bir giriş içermelidir. |
archived |
Yalnızca çıkış. Kullanımdan kaldırıldı: Abonelik arşivleme desteklenmiyor. |
taxAndComplianceSettings |
Vergiler ve yasalara uygunlukla ilgili ayrıntılar. |
restrictedPaymentCountries |
İsteğe bağlı. Bu aboneliğin satın alınmasının yalnızca aynı ülkede kayıtlı ödeme yöntemleriyle sınırlı olduğu ülkeler. Boş bırakılırsa ödeme konumuyla ilgili herhangi bir kısıtlama uygulanmaz. |
BasePlan
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ıdır. Abonelik içinde benzersiz olmalı ve RFC-1034 ile uyumlu olmalıdır. Yani bu kimlik yalnızca küçük harf (a-z), rakam (0-9) ve kısa çizgi (-) içerebilir ve en fazla 63 karakterden oluşabilir. |
state |
Yalnızca çıkış. Temel planın durumu (etkin olup olmadığı) Taslak halindeki 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 için bölgeye özel bilgiler. |
offerTags[] |
Bu temel plan için belirtilen ve faturalandırma kitaplığı üzerinden uygulamaya döndürülen en fazla 20 özel etiketin listesi. Bu temel plandaki abonelik teklifleri, bu fırsat etiketlerini faturalandırma kitaplığına da alır. |
otherRegionsConfig |
Play'in yeni konumlarla ilgili fiyatlandırma bilgileri ileride kullanıma sunulabilir. Atlanırsa Temel Plan, Play'in gelecekte kullanıma sunacağı yeni konumlarda otomatik olarak kullanılamayacaktır. |
Birleştirme alanı base_plan_type . Bu temel planın türü. Tam olarak bir tane ayarlanmalıdır. base_plan_type şunlardan yalnızca biri olabilir: |
|
autoRenewingBasePlanType |
Temel plan düzenli aralıklarla otomatik olarak yenileneceği zamanı ayarlayın. |
prepaidBasePlanType |
Temel planın, fatura döneminin sonunda otomatik olarak yenilenmediği zamanı ayarlayın. |
installmentsBasePlanType |
Kullanıcının belirli sayıda ödeme yapmayı taahhüt ettiği taksitli temel planlar için ayarlanır. |
Eyalet
Temel planın mevcut durumu.
Sıralamalar | |
---|---|
STATE_UNSPECIFIED |
Belirtilmemiş durum. |
DRAFT |
Temel plan şu anda taslak durumunda ve etkinleştirilmedi. Bu aşamada verileri güvenle silebilirsiniz. |
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. |
AutoRenewingBasePlanType
Abonelik döneminin sonunda otomatik olarak yenilenen bir temel planı temsil eder.
JSON gösterimi |
---|
{ "billingPeriodDuration": string, "gracePeriodDuration": string, "accountHoldDuration": string, "resubscribeState": enum ( |
Alanlar | |
---|---|
billingPeriodDuration |
Zorunlu. Abonelik süresi, ISO 8601 biçiminde belirtilir. Kabul edilebilir fatura dönemlerinin listesi için yardım merkezine bakın. |
gracePeriodDuration |
Aboneliğin ek yayınlanma süresi, ISO 8601 biçiminde belirtilir. Kabul edilebilir değerler P0D (sıfır gün), P3D (3 gün), P7D (7 gün), P14D (14 gün) ve P30D'dir (30 gün). Belirtilmezse, yinelenen dönem süresine göre varsayılan bir değer kullanılır. |
accountHoldDuration |
İsteğe bağlı. Aboneliğin hesabı askıya alma süresi (ISO 8601 biçiminde belirtilir). Kabul edilebilir değerler DAYS içinde olmalı ve P0D (sıfır gün) - P30D (30 gün) aralığında olmalıdır. Herhangi bir değer belirtilmediyse varsayılan değer P30D'dir (30 gün). |
resubscribeState |
Kullanıcıların Google Play yüzeylerinde bu temel plana yeniden abone olup olmayacağı. Belirtilmezse varsayılan olarak RESUBSCRIBE_STATE_ACTIVE olur. |
prorationMode |
Temel planın kullanıma oranlı ücretlendirme modu, kullanıcı başka bir temel plandan bu plana geçiş yaptığında ne olacağını belirler. Belirtilmemesi halinde varsayılan olarak CHARGE_ON_NEXT_BILLING_DATE değeri kullanılı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 uyumlu abonelik fırsatı, 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. Abonelik teklifinin eski sürümle uyumlu olarak olmaması için bu alanı boş dize olarak ayarlayın. |
ResubscribeState
Temel plan 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. |
SubscriptionProrationMode
Temel planları yenilemek için kullanılan kullanıma oranlama modu.
Sıralamalar | |
---|---|
SUBSCRIPTION_PRORATION_MODE_UNSPECIFIED |
Belirtilmemiş mod. |
SUBSCRIPTION_PRORATION_MODE_CHARGE_ON_NEXT_BILLING_DATE |
Kullanıcılardan mevcut fatura dönemlerinin sonunda yeni temel planlarının ödemesi alınır. |
SUBSCRIPTION_PRORATION_MODE_CHARGE_FULL_PRICE_IMMEDIATELY |
Kullanıcılar yeni temel planlarının ödemesi anında ve tam olarak alınır. Mevcut aboneliğin kalan süreleri, yeni faturalandırma planının süresini uzatmak için kullanılır. |
PrepaidBasePlanType
Temel planın sonunda otomatik olarak yenilenmeyen ve kullanıcı tarafından manuel olarak yenilenmesi gereken bir temel planı temsil eder.
JSON gösterimi |
---|
{
"billingPeriodDuration": string,
"timeExtension": enum ( |
Alanlar | |
---|---|
billingPeriodDuration |
Zorunlu. Abonelik süresi, ISO 8601 biçiminde belirtilir. Kabul edilebilir fatura dönemlerinin listesi için yardım merkezine bakın. |
timeExtension |
Kullanıcıların Google Play yüzeylerinde bu ön ödemeli temel plan süresini uzatıp uzatamayacağı Belirtilmezse varsayılan olarak TIME_EXTENSION_ACTIVE değerine ayarlanır. |
TimeExtension
Temel planın süre uzatılması.
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ın süresini uzatabilir. |
TIME_EXTENSION_INACTIVE |
Zaman uzantısı etkin değil. Kullanıcılar ön ödemeli planlarına para ekleyemez veya planlarının süresini uzatamaz. |
InstallmentsBasePlanType
Kullanıcının belirli bir sayıda ödeme yapmayı taahhüt ettiği taksit temel planını temsil eder.
JSON gösterimi |
---|
{ "billingPeriodDuration": string, "committedPaymentsCount": integer, "renewalType": enum ( |
Alanlar | |
---|---|
billingPeriodDuration |
Zorunlu. Abonelik süresi, ISO 8601 biçiminde belirtilir. Kabul edilebilir fatura dönemlerinin listesi için yardım merkezine bakın. |
committedPaymentsCount |
Zorunlu. Kullanıcının taahhüt ettiği ödemelerin sayısı. |
renewalType |
Zorunlu. Taksitli temel plan yenileme türü. İlk taahhüdün sonundaki davranışı belirler. |
gracePeriodDuration |
Aboneliğin ek yayınlanma süresi, ISO 8601 biçiminde belirtilir. Kabul edilebilir değerler P0D (sıfır gün), P3D (3 gün), P7D (7 gün), P14D (14 gün) ve P30D'dir (30 gün). Belirtilmezse, yinelenen dönem süresine göre varsayılan bir değer kullanılır. |
accountHoldDuration |
İsteğe bağlı. Aboneliğin, özel olarak gün cinsinden ve ISO 8601 biçiminde belirtilen, hesabı askıya alma süresi. Kabul edilebilir değerler P0D (sıfır gün) ile P30D (30 gün) arasındadır. Herhangi bir değer belirtilmediyse varsayılan değer P30D'dir (30 gün). |
resubscribeState |
Kullanıcıların Google Play yüzeylerinde bu temel plana yeniden abone olup olmayacağı. Belirtilmezse varsayılan olarak RESUBSCRIBE_STATE_ACTIVE olur. |
prorationMode |
Temel planın kullanıma oranlı ücretlendirme modu, kullanıcı başka bir temel plandan bu plana geçiş yaptığında ne olacağını belirler. Belirtilmemesi halinde varsayılan olarak CHARGE_ON_NEXT_BILLING_DATE değeri kullanılır. |
RenewalType
Taksitli temel plan yenileme türü. İlk taahhüdün sonundaki davranışı belirler.
Sıralamalar | |
---|---|
RENEWAL_TYPE_UNSPECIFIED |
Belirtilmemiş durum. |
RENEWAL_TYPE_RENEWS_WITHOUT_COMMITMENT |
Taahhütte bulunmadan fatura dönemi boyunca düzenli olarak yenilenir. |
RENEWAL_TYPE_RENEWS_WITH_COMMITMENT |
İlkiyle aynı süre taahhüdüyle yenilenir. |
RegionalBasePlanConfig
Bir bölgeye özel temel plan yapılandırmasıdır.
JSON gösterimi |
---|
{
"regionCode": string,
"newSubscriberAvailability": boolean,
"price": {
object ( |
Alanlar | |
---|---|
regionCode |
Zorunlu. ISO 3166-2 ile tanımlanan şekilde bu yapılandırmanın geçerli olduğu bölge kodu, ör. "US". |
newSubscriberAvailability |
Belirtilen bölgedeki temel planın yeni abonelere sunulup sunulmayacağı. Bu değer false olarak ayarlanırsa mevcut abonelerin abonelikleri iptal edilmez. Belirtilmezse varsayılan olarak false (yanlış) değerini alır. |
price |
Temel planın belirtilen bölgedeki fiyatıdır. Temel plan yeni aboneler tarafından kullanılabiliyorsa ayarlanmalıdır. Belirtilen bölgeye bağlı para biriminde ayarlanmalıdır. |
OtherRegionsBasePlanConfig
Play'in kullanıma sunacağı yeni konumlarla ilgili fiyatlandırma bilgileri.
JSON gösterimi |
---|
{ "usdPrice": { object ( |
Alanlar | |
---|---|
usdPrice |
Zorunlu. Play'in kullanıma sunulacağı yeni konumlarda kullanılacak ABD doları cinsinden fiyat. |
eurPrice |
Zorunlu. Play'in kullanıma sunulacağı yeni konumlarda kullanılacak avro cinsinden fiyat. |
newSubscriberAvailability |
Temel planın Play'in kullanıma sunulabileceği yeni konumlardaki yeni abonelere sunulup sunulmayacağı. Belirtilmezse varsayılan olarak false (yanlış) değerini alır. |
SubscriptionListing
Bir aboneliğin tüketici tarafından görülebilen meta verileri.
JSON gösterimi |
---|
{ "languageCode": string, "title": string, "benefits": [ string ], "description": string } |
Alanlar | |
---|---|
languageCode |
Zorunlu. Bu girişin BCP-47 tarafından tanımlandığı şekilde dili, ör. "en-US". |
title |
Zorunlu. Bu aboneliğin, bu girişin dilindeki başlığı. Düz metin. |
benefits[] |
Bu girişin dilinde kullanıcıya Play Store gibi platformlarda ve geri yükleme akışlarında gösterilen avantajların listesi. Düz metin. En fazla dört avantajdan oluşan sıralı liste. |
description |
Bu aboneliğin, bu girişin dilindeki açıklaması. Maksimum uzunluk - 80 karakter. Düz metin. |
RestrictedPaymentCountries
Bu ürünün satın alınmasının, aynı ülkede kayıtlı ödeme yöntemleriyle sınırlı olduğu ülkeler. Boş bırakılırsa ödeme konumuyla ilgili herhangi bir kısıtlama uygulanmaz.
JSON gösterimi |
---|
{ "regionCodes": [ string ] } |
Alanlar | |
---|---|
regionCodes[] |
Zorunlu. ISO 3166-2 ile tanımlanan şekilde ödeme kısıtlamalarının uygulanacağı bölge kodları, ör. "US". |
Yöntemler |
|
---|---|
(deprecated) |
Kullanımdan kaldırıldı: Abonelik arşivleme desteklenmiyor. |
|
Bir veya daha fazla aboneliği okur. |
|
Abonelik grubunu günceller. |
|
Yeni bir abonelik oluşturur. |
|
Bir aboneliği siler. |
|
Tek bir aboneliği okur. |
|
Belirli bir uygulama altındaki tüm abonelikleri listeler. |
|
Mevcut bir aboneliği günceller. |