REST Resource: monetization.onetimeproducts

Recurso: OneTimeProduct

Es un solo producto único de una app.

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

string

Obligatorio. Inmutable. Es el nombre del paquete de la app principal.
productId

string

Obligatorio. Inmutable. Es el ID único del producto. Único en la app principal. Los IDs de producto deben comenzar con un número o una letra minúscula, y pueden contener números (0-9), letras minúsculas (a-z), guiones bajos (_) y puntos (.).
listings[]

object (OneTimeProductListing)

Obligatorio. Es un conjunto de los datos de la descripción y el título localizados. No debe tener entradas duplicadas con el mismo valor de languageCode.
taxAndComplianceSettings

object (OneTimeProductTaxAndComplianceSettings)

Detalles sobre los impuestos y el cumplimiento legal.
purchaseOptions[]

object (OneTimeProductPurchaseOption)

Obligatorio. Es el conjunto de opciones de compra para este producto único.
restrictedPaymentCountries

object (RestrictedPaymentCountries)

Opcional. Son los países donde la compra de este producto único está restringida a las formas de pago registradas en el mismo país. Si este campo está vacío, no se imponen restricciones por ubicación de pago.
offerTags[]

object (OfferTag)

Opcional. Es una lista de hasta 20 etiquetas personalizadas especificadas para este producto único, que se devuelven a la app a través de la biblioteca de facturación. Las ofertas y opciones de compra de este producto también recibirán estas etiquetas en la biblioteca de facturación.
regionsVersion

object (RegionsVersion)

Solo salida. Es la versión de la configuración de regiones que se usó para generar el producto único.

OneTimeProductListing

Es la ficha de Play Store regional de un producto único.

Representación JSON 
{
  "languageCode": string,
  "title": string,
  "description": string
}
Campos
languageCode

string

Obligatorio. Es el idioma de esta ficha, según se define en BCP-47, p.ej., "en-US".
title

string

Obligatorio. Es el título de este producto en el idioma de la ficha. La longitud máxima es de 55 caracteres.
description

string

Obligatorio. Es la descripción de este producto en el idioma de la ficha. La longitud máxima es de 200 caracteres.

OneTimeProductTaxAndComplianceSettings

Son detalles sobre impuestos, la política de Google Play y el cumplimiento legal de productos únicos.

Representación JSON 
{
  "regionalTaxConfigs": [
    {
      object (RegionalTaxConfig)
    }
  ],
  "isTokenizedDigitalAsset": boolean
}
Campos
regionalTaxConfigs[]

object (RegionalTaxConfig)

Es la configuración impositiva regional.
isTokenizedDigitalAsset

boolean

Indica si se declara que este producto único es un producto que representa un activo digital tokenizado.

RegionalTaxConfig

Son detalles sobre impuestos en una región geográfica determinada.

Representación JSON 
{
  "regionCode": string,
  "taxTier": enum (TaxTier),
  "eligibleForStreamingServiceTaxRate": boolean,
  "streamingTaxType": enum (StreamingTaxType)
}
Campos
regionCode

string

Obligatorio. Es el código de región al que se aplica esta configuración, según lo define la norma ISO 3166-2, p.ej., "US".
taxTier

enum (TaxTier)

Tipo impositivo para especificar una tasa impositiva reducida. Los desarrolladores que venden revistas, periódicos, libros, audiolibros o noticias digitales en distintas regiones pueden cumplir los requisitos para obtener reducciones en las tasas impositivas.

Obtén más información.
eligibleForStreamingServiceTaxRate

boolean

Debes indicarnos si la app contiene productos de transmisión para cobrar correctamente los impuestos sobre las ventas locales y estatales de EE.UU. Este campo solo se admite en Estados Unidos.
streamingTaxType

enum (StreamingTaxType)

Para recaudar impuestos sobre comunicaciones o entretenimiento en Estados Unidos, elige la categoría fiscal adecuada.

Obtén más información.

OneTimeProductPurchaseOption

Es una sola opción de compra para un producto único.

Representación 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.
}
Campos
purchaseOptionId

string

Obligatorio. Inmutable. Es el identificador único de esta opción de compra. Debe ser único dentro del producto único. Debe comenzar con un número o una letra minúscula, y solo puede contener letras minúsculas (a-z), números (0-9) y guiones (-). La longitud máxima es de 63 caracteres.
state

enum (State)

Solo salida. Es el estado de la opción de compra, es decir, si está activa. Este campo no se puede modificar actualizando el recurso. En cambio, se usan los endpoints específicos.
regionalPricingAndAvailabilityConfigs[]

object (RegionalPricingAndAvailabilityConfig)

Es el precio regional y la información de disponibilidad para esta opción de compra.
newRegionsConfig

object (OneTimeProductPurchaseOptionNewRegionsConfig)

Es la información de precios de ubicaciones nuevas en las que Play podría lanzar la opción en el futuro. Si se omite, la opción de compra no estará disponible automáticamente en las ubicaciones nuevas en que Play la lance en el futuro.
offerTags[]

object (OfferTag)

Opcional. Es una lista de hasta 20 etiquetas personalizadas especificadas para esta opción de compra, que se devuelven a la app a través de la biblioteca de facturación. Las ofertas de esta opción de compra también recibirán estas etiquetas en la biblioteca de facturación.
taxAndComplianceSettings

object (PurchaseOptionTaxAndComplianceSettings)

Opcional. Detalles sobre los impuestos y el cumplimiento legal.
Campo de unión purchase_option_type. Es el tipo de esta opción de compra. Se debe establecer exactamente uno. Las direcciones (purchase_option_type) solo pueden ser una de las siguientes opciones:
buyOption

object (OneTimeProductBuyPurchaseOption)

Es una opción de compra que se puede adquirir.
rentOption

object (OneTimeProductRentPurchaseOption)

Es una opción de compra que se puede alquilar.

Estado

Es el estado actual de la opción de compra.

Enumeraciones
STATE_UNSPECIFIED Es un valor predeterminado que no se debe usar nunca.
DRAFT Indica que la opción de compra no está disponible para los usuarios y nunca lo estuvo.
ACTIVE Indica que la opción de compra está disponible para los usuarios.
INACTIVE Indica que la opción de compra ya no está disponible para los usuarios.
INACTIVE_PUBLISHED Indica que la opción de compra ya no se puede adquirir, pero seguimos exponiendo su oferta a través de la Biblioteca de Facturación Play por motivos de retrocompatibilidad. Solo las opciones de compra migradas automáticamente pueden tener este estado.

OneTimeProductBuyPurchaseOption

Es una opción de compra que se puede adquirir.

Representación JSON 
{
  "legacyCompatible": boolean,
  "multiQuantityEnabled": boolean
}
Campos
legacyCompatible

boolean

Opcional. Indica si esta opción de compra estará disponible en flujos de PBL heredados que no admiten el modelo de productos únicos.

Se puede marcar hasta una opción de compra "buy" como retrocompatible.
multiQuantityEnabled

boolean

Opcional. Indica si esta opción de compra permite varias cantidades. La opción de varias cantidades permite que el comprador adquiera más de un artículo en una sola confirmación de compra.

OneTimeProductRentPurchaseOption

Es una opción de compra que se puede alquilar.

Representación JSON 
{
  "rentalPeriod": string,
  "expirationPeriod": string
}
Campos
rentalPeriod

string

Obligatorio. Es la cantidad de tiempo durante la que el usuario tiene el derecho. Comienza cuando se completa el flujo de compra. Se especifica en formato ISO 8601.
expirationPeriod

string

Opcional. Es la cantidad de tiempo que tiene el usuario después de comenzar a consumir el derecho antes de que se revoque. Se especifica en formato ISO 8601.

RegionalPricingAndAvailabilityConfig

Es la configuración regional de precios y disponibilidad para una opción de compra.

Representación JSON 
{
  "regionCode": string,
  "price": {
    object (Money)
  },
  "availability": enum (Availability)
}
Campos
regionCode

string

Obligatorio. Código de región al que se aplica esta configuración, según la norma ISO 3166-2, p.ej., "US".
price

object (Money)

Es el precio de la opción de compra en la región especificada. Se debe establecer en la moneda vinculada con la región especificada.
availability

enum (Availability)

Es la disponibilidad de la opción de compra.

Disponibilidad

Es la disponibilidad de la opción de compra.

Enumeraciones
AVAILABILITY_UNSPECIFIED Disponibilidad sin especificar. No se debe usar.
AVAILABLE Indica que la opción de compra está disponible para los usuarios.
NO_LONGER_AVAILABLE Indica que la opción de compra ya no está disponible para los usuarios. Este valor solo se puede usar si la disponibilidad se configuró anteriormente como AVAILABLE.
AVAILABLE_IF_RELEASED Indica que la opción de compra no está disponible inicialmente, pero se habilita a través de una oferta de pedido por adelantado lanzada.

OneTimeProductPurchaseOptionNewRegionsConfig

Es la información de precios de regiones nuevas en las que Play podría lanzar la opción en el futuro.

Representación JSON 
{
  "usdPrice": {
    object (Money)
  },
  "eurPrice": {
    object (Money)
  },
  "availability": enum (Availability)
}
Campos
usdPrice

object (Money)

Obligatorio. Es el precio en USD que se usará para las regiones nuevas en las que Play podría lanzar la opción.
eurPrice

object (Money)

Obligatorio. Es el precio en EUR que se usará para las regiones nuevas en las que Play podría lanzar la opción.
availability

enum (Availability)

Obligatorio. Es la disponibilidad regional de la configuración de regiones nuevas. Si se establece como AVAILABLE, se usará la información de precios para las regiones nuevas en las que Play podría lanzar la opción en el futuro.

Disponibilidad

Es la disponibilidad de la configuración de regiones nuevas.

Enumeraciones
AVAILABILITY_UNSPECIFIED Disponibilidad sin especificar. No se debe usar.
AVAILABLE Indica que la configuración se usará para las regiones nuevas en las que Play podría lanzar la opción en el futuro.
NO_LONGER_AVAILABLE Indica que la configuración ya no está disponible y no se usará para regiones nuevas en las que Play podría lanzar la opción en el futuro. Este valor solo se puede usar si la disponibilidad se configuró anteriormente como AVAILABLE.

PurchaseOptionTaxAndComplianceSettings

Son detalles sobre impuestos, la política de Google Play y el cumplimiento legal de opciones de compra de productos únicos.

Representación JSON 
{
  "withdrawalRightType": enum (WithdrawalRightType)
}
Campos
withdrawalRightType

enum (WithdrawalRightType)

Opcional. Clasificación de servicio o contenido digital para productos que se distribuyen a usuarios de regiones aptas.

Si no se configura, el valor predeterminado es WITHDRAWAL_RIGHT_DIGITAL_CONTENT.

Consulta el artículo del Centro de ayuda para obtener más información.

Métodos

batchDelete

 Borra uno o más productos únicos.

batchGet

 Lee uno o más productos únicos.

batchUpdate

 Crea o actualiza uno o más productos únicos.

delete

 Borra un producto único.

get

 Lee un solo producto único.

list

 Enumera todos los productos únicos de una app determinada.

patch

 Crea o actualiza un producto único.