REST Resource: monetization.onetimeproducts

Kaynak: OneTimeProduct

Bir uygulama için 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ştirilemez. Üst uygulamanın paket adı.
productId

string

Zorunlu. Değiştirilemez. Ürünün benzersiz ürün kimliği. Üst uygulama içinde 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 değerine sahip yinelenen girişler olmamalıdır.
taxAndComplianceSettings

object (OneTimeProductTaxAndComplianceSettings)

Vergiler ve kanunlara ve kurallara uygunluk ile ilgili ayrıntılar.
purchaseOptions[]

object (OneTimeProductPurchaseOption)

Zorunlu. Bu tek seferlik ürünün satın alma seçenekleri.
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 en fazla 20 özel etiketin listesi. Bu ürünün satın alma seçenekleri ve fırsatları da faturalandırma kitaplığında bu etiketleri alır.
regionsVersion

object (RegionsVersion)

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

OneTimeProductListing

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

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

string

Zorunlu. Bu girişin BCP-47 tarafından tanımlanan dili (ör. "en-US").
title

string

Zorunlu. Bu ürünün, bu girişin dilindeki başlığı. Maksimum uzunluk 55 karakterdir.
description

string

Zorunlu. Bu ürünün, bu girişin dilindeki açıklaması. Maksimum uzunluk 200 karakterdir.

OneTimeProductTaxAndComplianceSettings

Tek seferlik ürünler için vergilendirme, Google Play politikası ve kanunlara ve kurallara uygunluk ile ilgili ayrıntılar.

JSON gösterimi 
{
  "regionalTaxConfigs": [
    {
      object (RegionalTaxConfig)
    }
  ],
  "isTokenizedDigitalAsset": boolean,
  "regionalProductAgeRatingInfos": [
    {
      object (RegionalProductAgeRatingInfo)
    }
  ],
  "productTaxCategoryCode": string
}
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.
regionalProductAgeRatingInfos[]

object (RegionalProductAgeRatingInfo)

Bölgesel yaş derecelendirmesi bilgileri. Şu anda bu alan yalnızca US bölge kodu için desteklenmektedir.
productTaxCategoryCode

string

Tek seferlik ürüne atanacak ürün vergisi kategorisi kodu. Ürün vergi kategorisi, ürüne uygulanan işlem vergisi oranlarını belirler. Daha fazla bilgi için Yardım Merkezi makalesine göz atın.

RegionalTaxConfig

Belirli bir coğrafi bölgedeki vergilendirmeyle ilgili 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-1 alfa-2 tarafından tanımlandığı şekilde, ör. "US").
taxTier

enum (TaxTier)

İndirimli vergi oranını belirten vergi dilimi. Ç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
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

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)
  },

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "buyOption": {
    object (OneTimeProductBuyPurchaseOption)
  },
  "rentOption": {
    object (OneTimeProductRentPurchaseOption)
  }
  // End of mutually exclusive fields.
}
Alanlar
purchaseOptionId

string

Zorunlu. Değiştirilemez. 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)

Google Play'in gelecekte kullanıma sunabileceği yeni konumlar için fiyatlandırma bilgileri. Bu seçenek atlanırsa satın alma seçeneği, Google 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 en fazla 20 özel etiketin listesi. Bu satın alma seçeneğiyle ilgili teklifler de faturalandırma kitaplığında bu etiketleri alır.
taxAndComplianceSettings

object (PurchaseOptionTaxAndComplianceSettings)

İsteğe bağlıdır. Vergiler ve kanunlara ve kurallara uygunluk ile ilgili ayrıntılar.
Bu satın alma seçeneğinin türü. Tam olarak bir tane ayarlanmalıdır. Aşağıda, birbirini dışlayan alanların listesi verilmiştir. Yanıtta en fazla bir alan ayarlanır:
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.
Birbirini hariç tutan alanların sonu.

Eyalet

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

Sıralamalar
STATE_UNSPECIFIED Varsayılan değerdir, hiçbir zaman kullanılmamalıdır.
DRAFT Satın alma seçeneği şu anda kullanıcılara sunulmuyor ve daha önce de sunulmadı.
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ınamaz ancak geriye dönük uyumluluk için Google Play Faturalandırma Kitaplığı üzerinden fırsatını göstermeye devam ederiz. Yalnızca otomatik olarak taşınan satın alma seçenekleri bu durumda 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ğını belirtir.

En fazla bir "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 birden fazla miktara izin verip vermediği. Çoklu miktar, alıcının tek bir ödeme işleminde birden fazla ürün 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 yararlanma hakkına sahip olduğu süre. Satın alma süreci 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, ISO 3166-1 alfa-2 tarafından tanımlanan bölge kodu (ör. "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 Stok durumu belirtilmemiş. 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ılara sunulmaz. Bu değer yalnızca stok durumu daha önce AVAILABLE 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ş fırsatı aracılığıyla kullanılabilir hale getirilir.
AVAILABLE_FOR_OFFERS_ONLY Satın alma seçeneği kullanılamıyor ancak bu seçeneğe bağlı teklifler (ör. Google Play Points teklifi) kullanılabiliyor.

OneTimeProductPurchaseOptionNewRegionsConfig

Google Play'in gelecekte kullanıma sunulabileceğ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. Google Play'in kullanıma sunulabileceği yeni bölgelerde kullanılacak ABD doları cinsinden fiyat.
eurPrice

object (Money)

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

enum (Availability)

Zorunlu. Yeni bölgeler yapılandırması için bölgesel stok durumu. KULLANILABİLİR olarak ayarlandığında fiyatlandırma bilgileri, Google 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 Stok durumu belirtilmemiş. Kullanılmamalıdır.
AVAILABLE Yapılandırma, Google Play'in gelecekte kullanıma sunulabileceği yeni bölgelerde kullanılacaktır.
NO_LONGER_AVAILABLE Yapılandırma artık kullanılamaz ve Google Play'in gelecekte kullanıma sunulabileceği yeni bölgelerde kullanılmaz. Bu değer yalnızca stok durumu daha önce AVAILABLE olarak ayarlanmışsa kullanılabilir.

PurchaseOptionTaxAndComplianceSettings

Tek seferlik ürün satın alma seçenekleri için vergilendirme, Google Play politikası ve kanunlara ve kurallara uygunluk ile ilgili 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 değerine ayarlanır.

Daha fazla bilgi için Yardım Merkezi makalesine göz atın.

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 uygulamadaki tüm tek seferlik ürünleri listeler.

patch

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

Hata kodları

Bu kaynağın işlemleri aşağıdaki HTTP hata kodlarını döndürür:

Hata kodu Neden Açıklama Çözünürlük