REST Resource: monetization.onetimeproducts

Kaynak: OneTimeProduct

Bir uygulama için tek bir tek seferlik ürün.

JSON gösterimi 
{
  "packageName": string,
  "productId": string,
  "listings": [
    {
      object (OneTimeProductListing)
    }
  ],
  "taxAndComplianceSettings": {
    object (OneTimeProductTaxAndComplianceSettings)
  },
  "purchaseOptions": [
    {
      object (OneTimeProductPurchaseOption)
    }
  ],
  "restrictedPaymentCountries": {
    object (RestrictedPaymentCountries)
  },
  "offerTags": [
    {
      object (OfferTag)
    }
  ],
  "regionsVersion": {
    object (RegionsVersion)
  }
}
Alanlar
packageName

string

Zorunlu. Değişmez. Üst uygulamanın paket adı.
productId

string

Zorunlu. Değişmez. Ürünün benzersiz ürün kimliği. Üst uygulamada benzersiz olmalıdır. Ürün kimlikleri bir rakam veya küçük harfle başlamalıdır. Rakam (0-9), küçük harf (a-z), alt çizgi (_) ve noktadan (.) oluşabilirler.
listings[]

object (OneTimeProductListing)

Zorunlu. Yerelleştirilmiş başlık ve açıklama verileri kümesi. Aynı languageCode ile yinelenen girişler olmamalıdır.
taxAndComplianceSettings

object (OneTimeProductTaxAndComplianceSettings)

Vergiler ve yasal uygunlukla ilgili ayrıntılar.
purchaseOptions[]

object (OneTimeProductPurchaseOption)

Zorunlu. Bu tek seferlik ürün için satın alma seçenekleri grubu.
restrictedPaymentCountries

object (RestrictedPaymentCountries)

İsteğe bağlıdır. Bu tek seferlik ürünün satın alımının, aynı ülkede kayıtlı ödeme yöntemleriyle sınırlandırıldığı ülkeler. Boş bırakılırsa ödeme konumu kısıtlaması uygulanmaz.
offerTags[]

object (OfferTag)

İsteğe bağlıdır. Bu tek seferlik ürün için belirtilen ve faturalandırma kitaplığı aracılığıyla uygulamaya döndürülen 20'ye kadar özel etiketin listesi. Bu ürünle ilgili satın alma seçenekleri ve teklifler de faturalandırma kitaplığında bu etiketleri alır.
regionsVersion

object (RegionsVersion)

Yalnızca çıkış. Tek seferlik ürün oluşturulurken kullanılan bölge yapılandırması sürümü.

OneTimeProductListing

Tek seferlik bir ürün için bölgesel mağaza girişi.

JSON gösterimi 
{
  "languageCode": string,
  "title": string,
  "description": string
}
Alanlar
languageCode

string

Zorunlu. BCP-47 tarafından tanımlandığı şekilde bu girişin dili (ör. "en-US".
title

string

Zorunlu. Bu ürünün, bu listelemenin dilindeki başlığı. En çok 55 karakterden oluşabilir.
description

string

Zorunlu. Bu ürünün, bu listelemenin dilindeki açıklaması. En çok 200 karakterden oluşabilir.

OneTimeProductTaxAndComplianceSettings

Tek seferlik ürünlerle ilgili vergilendirme, Google Play politikası ve yasal uygunluk hakkında ayrıntılar.

JSON gösterimi 
{
  "regionalTaxConfigs": [
    {
      object (RegionalTaxConfig)
    }
  ],
  "isTokenizedDigitalAsset": boolean
}
Alanlar
regionalTaxConfigs[]

object (RegionalTaxConfig)

Bölgesel vergi yapılandırması.
isTokenizedDigitalAsset

boolean

Bu tek seferlik ürünün, token atanmış bir dijital varlığı temsil eden bir ürün olarak beyan edilip edilmediği.

RegionalTaxConfig

Belirli bir coğrafi bölgedeki vergilendirme hakkında ayrıntılar.

JSON gösterimi 
{
  "regionCode": string,
  "taxTier": enum (TaxTier),
  "eligibleForStreamingServiceTaxRate": boolean,
  "streamingTaxType": enum (StreamingTaxType)
}
Alanlar
regionCode

string

Zorunlu. Bu yapılandırmanın geçerli olduğu bölge kodu (ISO 3166-2'de tanımlandığı gibi), örneğin "US".
taxTier

enum (TaxTier)

İndirimli vergi oranını belirtmek için vergi sınıfı. Çeşitli bölgelerde dijital haber, dergi, gazete, kitap veya sesli kitap satan geliştiricilerin indirimli vergi oranlarından yararlanma hakkı olabilir.

Daha fazla bilgi edinin.
eligibleForStreamingServiceTaxRate

boolean

ABD'de eyalet ve yerel satış vergisi ödemelerinin alınmasında hata olmaması için uygulamanızın akış ürünü içerip içermediğini bize bildirmeniz gerekir. Alan yalnızca ABD'de desteklenir.
streamingTaxType

enum (StreamingTaxType)

Amerika Birleşik Devletleri'nde iletişim veya eğlence vergilerini tahsil etmek için uygun vergi kategorisini seçin.

Daha fazla bilgi edinin.

OneTimeProductPurchaseOption

Tek seferlik ürün için tek bir satın alma seçeneği.

JSON gösterimi 
{
  "purchaseOptionId": string,
  "state": enum (State),
  "regionalPricingAndAvailabilityConfigs": [
    {
      object (RegionalPricingAndAvailabilityConfig)
    }
  ],
  "newRegionsConfig": {
    object (OneTimeProductPurchaseOptionNewRegionsConfig)
  },
  "offerTags": [
    {
      object (OfferTag)
    }
  ],
  "taxAndComplianceSettings": {
    object (PurchaseOptionTaxAndComplianceSettings)
  },

  // Union field purchase_option_type can be only one of the following:
  "buyOption": {
    object (OneTimeProductBuyPurchaseOption)
  },
  "rentOption": {
    object (OneTimeProductRentPurchaseOption)
  }
  // End of list of possible types for union field purchase_option_type.
}
Alanlar
purchaseOptionId

string

Zorunlu. Değişmez. Bu satın alma seçeneğinin benzersiz tanımlayıcısı. Tek seferlik ürün içinde benzersiz olmalıdır. Rakam veya küçük harfle başlamalıdır. Yalnızca küçük harfler (a-z), rakamlar (0-9) ve kısa çizgi (-) içerebilir. Maksimum uzunluk 63 karakterdir.
state

enum (State)

Yalnızca çıkış. Satın alma seçeneğinin durumu (ör. etkin olup olmadığı). Bu alan, kaynak güncellenerek değiştirilemez. Bunun yerine özel uç noktaları kullanın.
regionalPricingAndAvailabilityConfigs[]

object (RegionalPricingAndAvailabilityConfig)

Bu satın alma seçeneği için bölgesel fiyatlandırma ve stok durumu bilgileri.
newRegionsConfig

object (OneTimeProductPurchaseOptionNewRegionsConfig)

Play'in gelecekte kullanıma sunabileceği yeni konumlarla ilgili fiyatlandırma bilgileri. Belirtilmezse satın alma seçeneği, Play'in gelecekte kullanıma sunulabileceği yeni konumlarda otomatik olarak kullanılamaz.
offerTags[]

object (OfferTag)

İsteğe bağlıdır. Bu satın alma seçeneği için belirtilen ve faturalandırma kitaplığı aracılığıyla uygulamaya döndürülen 20 adede kadar özel etiketin listesi. Bu satın alma seçeneği için geçerli teklifler, faturalandırma kitaplığında da bu etiketleri alır.
taxAndComplianceSettings

object (PurchaseOptionTaxAndComplianceSettings)

İsteğe bağlıdır. Vergiler ve yasal uygunlukla ilgili ayrıntılar.
Birleştirme alanı purchase_option_type. Bu satın alma seçeneğinin türü. Tam olarak bir tane ayarlanmalıdır. purchase_option_type yalnızca aşağıdakilerden biri olabilir:
buyOption

object (OneTimeProductBuyPurchaseOption)

Satın alınabilecek bir satın alma seçeneği.
rentOption

object (OneTimeProductRentPurchaseOption)

Kiralanabilen bir satın alma seçeneği.

Eyalet

Satın alma seçeneğinin mevcut durumu.

Sıralamalar
STATE_UNSPECIFIED Varsayılan değerdir ve asla kullanılmamalıdır.
DRAFT Satın alma seçeneği kullanıcılar tarafından kullanılamaz ve hiçbir zaman kullanılamamıştır.
ACTIVE Satın alma seçeneği kullanıcılar tarafından kullanılabilir.
INACTIVE Satın alma seçeneği artık kullanıcılar tarafından kullanılamaz.
INACTIVE_PUBLISHED Satın alma seçeneği artık satın alınamıyor ancak geriye dönük uyumluluk için teklifini Play Faturalandırma Kitaplığı üzerinden sunmaya devam ediyoruz. Bu durumda yalnızca otomatik olarak taşınan satın alma seçenekleri olabilir.

OneTimeProductBuyPurchaseOption

Satın alınabilecek bir satın alma seçeneği.

JSON gösterimi 
{
  "legacyCompatible": boolean,
  "multiQuantityEnabled": boolean
}
Alanlar
legacyCompatible

boolean

İsteğe bağlıdır. Bu satın alma seçeneğinin, tek seferlik ürün modelini desteklemeyen eski PBL akışlarında kullanılıp kullanılamayacağı.

En fazla bir "satın alma" satın alma seçeneği geriye dönük uyumlu olarak işaretlenebilir.
multiQuantityEnabled

boolean

İsteğe bağlıdır. Bu satın alma seçeneğinin çoklu miktara izin verip vermediği. Çoklu miktar özelliği, alıcının tek bir ödeme işleminde birden fazla öğe satın almasına olanak tanır.

OneTimeProductRentPurchaseOption

Kiralanabilen bir satın alma seçeneği.

JSON gösterimi 
{
  "rentalPeriod": string,
  "expirationPeriod": string
}
Alanlar
rentalPeriod

string

Zorunlu. Kullanıcının hakka sahip olduğu süre. Satın alma akışı tamamlandığında başlar. ISO 8601 biçiminde belirtilir.
expirationPeriod

string

İsteğe bağlıdır. Kullanıcının, yararlanma hakkını kullanmaya başladıktan sonra iptal edilmeden önce sahip olduğu süre. ISO 8601 biçiminde belirtilir.

RegionalPricingAndAvailabilityConfig

Satın alma seçeneği için bölgesel fiyatlandırma ve stok durumu yapılandırması.

JSON gösterimi 
{
  "regionCode": string,
  "price": {
    object (Money)
  },
  "availability": enum (Availability)
}
Alanlar
regionCode

string

Zorunlu. Bu yapılandırmanın geçerli olduğu bölge kodu (ISO 3166-2'de tanımlandığı gibi), örneğin: "US".
price

object (Money)

Belirtilen bölgedeki satın alma seçeneğinin fiyatı. Belirtilen bölgeye bağlı para biriminde ayarlanmalıdır.
availability

enum (Availability)

Satın alma seçeneğinin kullanılabilirliği.

Kullanılabilirlik

Satın alma seçeneğinin kullanılabilirliği.

Sıralamalar
AVAILABILITY_UNSPECIFIED Belirtilmemiş stok durumu. Kullanılmamalıdır.
AVAILABLE Satın alma seçeneği kullanıcılar tarafından kullanılabilir.
NO_LONGER_AVAILABLE Satın alma seçeneği artık kullanıcılar tarafından kullanılamaz. Bu değer yalnızca stok durumu daha önce STOKTA olarak ayarlanmışsa kullanılabilir.
AVAILABLE_IF_RELEASED Satın alma seçeneği başlangıçta kullanılamaz ancak yayınlanan bir ön sipariş teklifiyle kullanılabilir hale gelir.

OneTimeProductPurchaseOptionNewRegionsConfig

Play'in gelecekte kullanıma sunabileceği yeni bölgeler için fiyatlandırma bilgileri.

JSON gösterimi 
{
  "usdPrice": {
    object (Money)
  },
  "eurPrice": {
    object (Money)
  },
  "availability": enum (Availability)
}
Alanlar
usdPrice

object (Money)

Zorunlu. Play'in kullanıma sunabileceği yeni bölgelerde kullanılacak ABD doları cinsinden fiyat.
eurPrice

object (Money)

Zorunlu. Play'in kullanıma sunabileceği yeni bölgelerde kullanılacak avro cinsinden fiyat.
availability

enum (Availability)

Zorunlu. Yeni bölgeler yapılandırmasının bölgesel kullanılabilirliği. KULLANILABİLİR olarak ayarlandığında, fiyatlandırma bilgileri Play'in gelecekte kullanıma sunabileceği tüm yeni bölgeler için kullanılır.

Kullanılabilirlik

Yeni bölgeler yapılandırmasının kullanılabilirliği

Sıralamalar
AVAILABILITY_UNSPECIFIED Belirtilmemiş stok durumu. Kullanılmamalıdır.
AVAILABLE Yapılandırma, Play'in gelecekte kullanıma sunabileceği tüm yeni bölgelerde kullanılır.
NO_LONGER_AVAILABLE Yapılandırma artık kullanılamıyor ve Play'in gelecekte kullanıma sunabileceği yeni bölgelerde kullanılmayacak. Bu değer yalnızca stok durumu daha önce STOKTA olarak ayarlanmışsa kullanılabilir.

PurchaseOptionTaxAndComplianceSettings

Tek seferlik ürün satın alma seçenekleriyle ilgili vergilendirme, Google Play politikası ve yasal uygunluk hakkında ayrıntılar.

JSON gösterimi 
{
  "withdrawalRightType": enum (WithdrawalRightType)
}
Alanlar
withdrawalRightType

enum (WithdrawalRightType)

İsteğe bağlıdır. Uygun bölgelerdeki kullanıcılara dağıtılan ürünler için dijital içerik veya hizmet sınıflandırması.

Ayarlanmazsa varsayılan olarak WITHDRAWAL_RIGHT_DIGITAL_CONTENT olur.

Daha fazla bilgi için Yardım Merkezi makalesini inceleyin.

Yöntemler

batchDelete

 Bir veya daha fazla tek seferlik ürünü siler.

batchGet

 Bir veya daha fazla tek seferlik ürün okur.

batchUpdate

 Bir veya daha fazla tek seferlik ürün oluşturur ya da günceller.

delete

 Tek seferlik bir ürünü siler.

get

 Tek bir tek seferlik ürünü okur.

list

 Belirli bir uygulama altındaki tüm tek seferlik ürünleri listeler.

patch

 Tek seferlik ürün oluşturur veya günceller.