REST Resource: monetization.onetimeproducts

Resource: OneTimeProduct

Satu produk sekali beli untuk suatu aplikasi.

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

string

Wajib. Tidak dapat diubah. Nama paket aplikasi induk.
productId

string

Wajib. Tidak dapat diubah. ID produk unik produk tersebut. Unik di dalam aplikasi induk. ID produk harus diawali dengan angka atau huruf kecil dan dapat terdiri dari angka (0-9), huruf kecil (a-z), garis bawah (_), dan titik (.).
listings[]

object (OneTimeProductListing)

Wajib. Kumpulan data judul dan deskripsi yang dilokalkan. Tidak boleh memiliki entri duplikat dengan languageCode yang sama.
taxAndComplianceSettings

object (OneTimeProductTaxAndComplianceSettings)

Detail tentang pajak dan kepatuhan hukum.
purchaseOptions[]

object (OneTimeProductPurchaseOption)

Wajib. Kumpulan opsi pembelian untuk produk sekali beli ini.
restrictedPaymentCountries

object (RestrictedPaymentCountries)

Opsional. Negara yang membatasi pembelian produk sekali beli ini ke metode pembayaran yang terdaftar di negara yang sama. Jika kosong, tidak ada batasan lokasi pembayaran yang diberlakukan.
offerTags[]

object (OfferTag)

Opsional. Daftar hingga 20 tag kustom yang ditentukan untuk produk sekali beli ini, dan ditampilkan pada aplikasi melalui Billing Library. Opsi pembelian dan penawaran untuk produk ini juga akan menerima tag ini di billing library.
regionsVersion

object (RegionsVersion)

Hanya output. Versi konfigurasi wilayah yang digunakan untuk membuat produk sekali beli.

OneTimeProductListing

Listingan Google Play Store regional untuk produk sekali beli.

Representasi JSON 
{
  "languageCode": string,
  "title": string,
  "description": string
}
Kolom
languageCode

string

Wajib. Bahasa listingan ini, sebagaimana didefinisikan oleh BCP-47, misalnya, "en-US".
title

string

Wajib. Judul produk ini dalam bahasa listingan ini. Panjang maksimumnya adalah 55 karakter.
description

string

Wajib. Deskripsi produk ini dalam bahasa listingan ini. Panjang maksimumnya adalah 200 karakter.

OneTimeProductTaxAndComplianceSettings

Detail tentang perpajakan, kebijakan Google Play, dan kepatuhan hukum untuk produk sekali beli.

Representasi JSON 
{
  "regionalTaxConfigs": [
    {
      object (RegionalTaxConfig)
    }
  ],
  "isTokenizedDigitalAsset": boolean
}
Kolom
regionalTaxConfigs[]

object (RegionalTaxConfig)

Konfigurasi pajak regional.
isTokenizedDigitalAsset

boolean

Apakah produk sekali beli ini dinyatakan sebagai produk yang mewakili aset digital berupa token.

RegionalTaxConfig

Detail tentang perpajakan di wilayah geografis tertentu.

Representasi JSON 
{
  "regionCode": string,
  "taxTier": enum (TaxTier),
  "eligibleForStreamingServiceTaxRate": boolean,
  "streamingTaxType": enum (StreamingTaxType)
}
Kolom
regionCode

string

Wajib. Kode wilayah yang berlaku untuk konfigurasi ini, seperti yang ditentukan oleh ISO 3166-2, misalnya "US".
taxTier

enum (TaxTier)

Tingkatan pajak untuk menentukan pengurangan tarif pajak. Developer yang menjual berita, majalah, koran, buku, atau buku audio digital di berbagai wilayah mungkin memenuhi syarat untuk menerima pengurangan tarif pajak.

Pelajari lebih lanjut.
eligibleForStreamingServiceTaxRate

boolean

Anda harus memberi tahu kami apakah aplikasi Anda berisi produk streaming agar kami dapat menagih pajak penjualan setempat dan negara bagian AS dengan benar. Kolom ini hanya didukung di Amerika Serikat.
streamingTaxType

enum (StreamingTaxType)

Untuk memungut pajak komunikasi atau hiburan di Amerika Serikat, pilih kategori pajak yang sesuai.

Pelajari lebih lanjut.

OneTimeProductPurchaseOption

Opsi pembelian tunggal untuk produk sekali beli.

Representasi JSON 
{
  "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.
}
Kolom
purchaseOptionId

string

Wajib. Tidak dapat diubah. ID unik opsi pembelian ini. Harus unik dalam produk sekali beli. Harus diawali dengan angka atau huruf kecil, dan hanya boleh berisi huruf kecil (a-z), angka (0-9), dan tanda hubung (-). Panjang maksimalnya adalah 63 karakter.
state

enum (State)

Hanya output. Status opsi pembelian, yaitu apakah aktif. Kolom ini tidak dapat diubah dengan memperbarui resource. Gunakan endpoint khusus sebagai gantinya.
regionalPricingAndAvailabilityConfigs[]

object (RegionalPricingAndAvailabilityConfig)

Informasi harga dan ketersediaan regional untuk opsi pembelian ini.
newRegionsConfig

object (OneTimeProductPurchaseOptionNewRegionsConfig)

Informasi harga untuk lokasi baru tempat Play mungkin akan melakukan peluncuran pada masa mendatang. Jika dihilangkan, opsi pembelian tidak akan secara otomatis tersedia di lokasi baru tempat Play mungkin akan melakukan peluncuran pada masa mendatang.
offerTags[]

object (OfferTag)

Opsional. Mencantumkan hingga 20 tag kustom yang ditentukan untuk opsi pembelian ini, dan ditampilkan pada aplikasi melalui Billing Library. Penawaran untuk opsi pembelian ini juga akan menerima tag ini di billing library.
taxAndComplianceSettings

object (PurchaseOptionTaxAndComplianceSettings)

Opsional. Detail tentang pajak dan kepatuhan hukum.
Kolom union purchase_option_type. Jenis opsi pembelian ini. Tepatnya satu yang harus ditetapkan. purchase_option_type hanya dapat berupa salah satu dari berikut:
buyOption

object (OneTimeProductBuyPurchaseOption)

Opsi pembelian yang bisa dibeli.
rentOption

object (OneTimeProductRentPurchaseOption)

Opsi pembelian yang dapat disewa.

Negara Bagian

Status opsi pembelian saat ini.

Enum
STATE_UNSPECIFIED Nilai default, tidak boleh digunakan.
DRAFT Opsi pembelian tidak dan tidak pernah tersedia bagi pengguna.
ACTIVE Opsi pembelian tersedia untuk pengguna.
INACTIVE Opsi pembelian tidak lagi tersedia untuk pengguna.
INACTIVE_PUBLISHED Opsi pembelian tidak lagi tersedia untuk dibeli, tetapi kami terus mengekspos penawarannya melalui Play Billing Library untuk kompatibilitas mundur. Hanya opsi pembelian yang dimigrasikan secara otomatis yang dapat berada dalam status ini.

OneTimeProductBuyPurchaseOption

Opsi pembelian yang bisa dibeli.

Representasi JSON 
{
  "legacyCompatible": boolean,
  "multiQuantityEnabled": boolean
}
Kolom
legacyCompatible

boolean

Opsional. Apakah opsi pembelian ini akan tersedia di alur PBL lama yang tidak mendukung model produk sekali beli.

Hingga satu opsi pembelian "beli" dapat ditandai sebagai kompatibel dengan versi lama.
multiQuantityEnabled

boolean

Opsional. Apakah opsi pembelian ini mengizinkan multi-kuantitas. Multikuantitas memungkinkan pembeli membeli lebih dari satu item dalam satu checkout.

OneTimeProductRentPurchaseOption

Opsi pembelian yang dapat disewa.

Representasi JSON 
{
  "rentalPeriod": string,
  "expirationPeriod": string
}
Kolom
rentalPeriod

string

Wajib. Durasi waktu pengguna memiliki hak. Dimulai saat alur pembelian selesai. Ditentukan dalam format ISO 8601.
expirationPeriod

string

Opsional. Durasi waktu yang dimiliki pengguna setelah mulai menggunakan hak sebelum hak tersebut dicabut. Ditentukan dalam format ISO 8601.

RegionalPricingAndAvailabilityConfig

Konfigurasi harga dan ketersediaan regional untuk opsi pembelian.

Representasi JSON 
{
  "regionCode": string,
  "price": {
    object (Money)
  },
  "availability": enum (Availability)
}
Kolom
regionCode

string

Wajib. Kode wilayah yang berlaku untuk konfigurasi ini, sebagaimana ditentukan oleh ISO 3166-2, misalnya, "US".
price

object (Money)

Harga opsi pembelian di wilayah yang ditentukan. Harus ditetapkan dalam mata uang yang terkait dengan wilayah tertentu.
availability

enum (Availability)

Ketersediaan opsi pembelian.

Ketersediaan

Ketersediaan opsi pembelian.

Enum
AVAILABILITY_UNSPECIFIED Ketersediaan tidak ditentukan. Tidak boleh digunakan.
AVAILABLE Opsi pembelian tersedia untuk pengguna.
NO_LONGER_AVAILABLE Opsi pembelian tidak lagi tersedia untuk pengguna. Nilai ini hanya dapat digunakan jika ketersediaan sebelumnya ditetapkan sebagai AVAILABLE.
AVAILABLE_IF_RELEASED Opsi pembelian awalnya tidak tersedia, tetapi tersedia melalui penawaran praorder yang dirilis.

OneTimeProductPurchaseOptionNewRegionsConfig

Informasi harga untuk wilayah baru tempat Play mungkin melakukan peluncuran pada masa mendatang.

Representasi JSON 
{
  "usdPrice": {
    object (Money)
  },
  "eurPrice": {
    object (Money)
  },
  "availability": enum (Availability)
}
Kolom
usdPrice

object (Money)

Wajib. Harga dalam USD untuk digunakan di wilayah baru tempat Play mungkin melakukan peluncuran.
eurPrice

object (Money)

Wajib. Harga dalam EUR untuk digunakan di wilayah baru tempat Play mungkin melakukan peluncuran.
availability

enum (Availability)

Wajib. Ketersediaan regional untuk konfigurasi wilayah baru. Jika ditetapkan ke AVAILABLE, informasi harga akan digunakan untuk wilayah baru tempat Play mungkin melakukan peluncuran pada masa mendatang.

Ketersediaan

Ketersediaan konfigurasi wilayah baru.

Enum
AVAILABILITY_UNSPECIFIED Ketersediaan tidak ditentukan. Tidak boleh digunakan.
AVAILABLE Konfigurasi ini akan digunakan untuk wilayah baru tempat Play melakukan peluncuran pada masa mendatang.
NO_LONGER_AVAILABLE Konfigurasi ini tidak tersedia lagi dan tidak akan digunakan di wilayah baru tempat Play mungkin melakukan peluncuran pada masa mendatang. Nilai ini hanya dapat digunakan jika ketersediaan sebelumnya ditetapkan sebagai AVAILABLE.

PurchaseOptionTaxAndComplianceSettings

Detail tentang perpajakan, kebijakan Google Play, dan kepatuhan hukum untuk opsi pembelian produk sekali beli.

Representasi JSON 
{
  "withdrawalRightType": enum (WithdrawalRightType)
}
Kolom
withdrawalRightType

enum (WithdrawalRightType)

Opsional. Klasifikasi konten digital atau layanan untuk produk yang didistribusikan kepada pengguna di wilayah yang memenuhi syarat.

Jika tidak disetel, setelan defaultnya adalah WITHDRAWAL_RIGHT_DIGITAL_CONTENT.

Lihat artikel Pusat Bantuan untuk mengetahui informasi selengkapnya.

Metode

batchDelete

 Menghapus satu atau beberapa produk sekali beli.

batchGet

 Membaca satu atau beberapa produk sekali beli.

batchUpdate

 Membuat atau mengupdate satu atau beberapa produk sekali beli.

delete

 Menghapus produk sekali beli.

get

 Membaca satu produk sekali beli.

list

 Mencantumkan semua produk sekali beli pada aplikasi tertentu.

patch

 Membuat atau memperbarui produk sekali beli.