REST Resource: inappproducts

Recurso: InAppProduct

Es un producto integrado en la aplicación. Es el recurso para InappproductsService.

Representación JSON
{
  "packageName": string,
  "sku": string,
  "status": enum (Status),
  "purchaseType": enum (PurchaseType),
  "defaultPrice": {
    object (Price)
  },
  "prices": {
    string: {
      object (Price)
    },
    ...
  },
  "listings": {
    string: {
      object (InAppProductListing)
    },
    ...
  },
  "defaultLanguage": string,
  "subscriptionPeriod": string,
  "trialPeriod": string,
  "gracePeriod": string,

  // Union field TaxAndComplianceType can be only one of the following:
  "subscriptionTaxesAndComplianceSettings": {
    object (SubscriptionTaxAndComplianceSettings)
  },
  "managedProductTaxesAndComplianceSettings": {
    object (ManagedProductTaxAndComplianceSettings)
  }
  // End of list of possible types for union field TaxAndComplianceType.
}
Campos
packageName

string

Es el nombre del paquete de la app principal.

sku

string

Es el código de artículo (SKU) del producto, que es único en una app.

status

enum (Status)

Estado del producto, p.ej., si está activo.

purchaseType

enum (PurchaseType)

Tipo de producto, p.ej., una suscripción recurrente.

defaultPrice

object (Price)

Precio predeterminado. No puede ser cero, ya que los productos integrados en la aplicación nunca son gratuitos. Siempre se expresa en la moneda del comercio que establece el desarrollador para el proceso de compra.

prices

map (key: string, value: object (Price))

Son los precios por región del comprador. Ninguno de estos valores puede ser cero, ya que los productos integrados en la aplicación nunca son gratuitos. La clave del mapa es el código de región, según se define en ISO 3166-2.

Es un objeto que contiene una lista de pares "key": value. Ejemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

listings

map (key: string, value: object (InAppProductListing))

Lista inappproducts.list de los datos de la descripción y el título localizados. La clave del mapa es el idioma de los datos localizados, según se define en BCP-47, p.ej., "en-US".

Es un objeto que contiene una lista de pares "key": value. Ejemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

defaultLanguage

string

Idioma predeterminado de los datos localizados, según se define en BCP-47, p. ej., "en-US".

subscriptionPeriod

string

Período de suscripción, especificado en formato ISO 8601. Los valores que se aceptan son P1W (una semana), P1M (un mes), P3M (tres meses), P6M (seis meses) y P1Y (un año).

trialPeriod

string

Período de prueba, especificado en formato ISO 8601. Se admite cualquier valor entre P7D (siete días) y P999D (999 días).

gracePeriod

string

Es el período de gracia de la suscripción, especificado en formato ISO 8601. Permite a los desarrolladores ofrecer a los suscriptores un período de gracia para cuando se rechace el pago del nuevo período recurrente. Los valores que se aceptan son P0D (cero días), P3D (tres días), P7D (siete días), P14D (14 días) y P30D (30 días).

Campo de unión TaxAndComplianceType.

TaxAndComplianceType puede ser una de las siguientes opciones:

subscriptionTaxesAndComplianceSettings

object (SubscriptionTaxAndComplianceSettings)

Detalles sobre los impuestos y el cumplimiento legal. Solo se aplica a los productos de suscripción.

managedProductTaxesAndComplianceSettings

object (ManagedProductTaxAndComplianceSettings)

Detalles sobre los impuestos y el cumplimiento legal. Solo se aplica a los productos administrados.

Estado

Es el estado de un producto integrado en la aplicación.

Enums
statusUnspecified Indica que no se especificó el estado.
active El producto está publicado y activo en la tienda.
inactive El producto no está publicado y, por lo tanto, no está activo en la tienda.

PurchaseType

El tipo de producto.

Enums
purchaseTypeUnspecified Tipo de compra sin especificar.
managedUser Tipo de producto predeterminado, en una compra única.
subscription Producto integrado en la aplicación con un período recurrente.

InAppProductListing

Es la ficha de Play Store de un solo producto integrado en la aplicación.

Representación JSON
{
  "title": string,
  "description": string,
  "benefits": [
    string
  ]
}
Campos
title

string

Título de la ficha de Play Store.

description

string

Es la descripción de la ficha de Play Store.

benefits[]

string

Son los beneficios localizados de los derechos de una suscripción.

ManagedProductTaxAndComplianceSettings

Detalles sobre los impuestos y el cumplimiento legal para productos administrados.

Representación JSON
{
  "eeaWithdrawalRightType": enum (WithdrawalRightType),
  "taxRateInfoByRegionCode": {
    string: {
      object (RegionalTaxRateInfo)
    },
    ...
  },
  "isTokenizedDigitalAsset": boolean
}
Campos
eeaWithdrawalRightType

enum (WithdrawalRightType)

Clasificación de servicio o contenido digital para productos que se distribuyen a usuarios del Espacio Económico Europeo (EEE). El régimen de rescisión en virtud de las leyes de protección al consumidor del EEE depende de esta clasificación. Consulta el artículo del Centro de ayuda para obtener más información.

taxRateInfoByRegionCode

map (key: string, value: object (RegionalTaxRateInfo))

Es una asignación del código de región a los detalles de la tasa impositiva. Las claves son códigos de región según se definen en el "CLDR" de Unicode.

Es un objeto que contiene una lista de pares "key": value. Ejemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

isTokenizedDigitalAsset

boolean

Indica si este producto integrado en la aplicación está declarado como un producto que representa un activo digital tokenizado.

Métodos

batchDelete

Borra productos integrados en la aplicación (productos administrados o suscripciones).

batchGet

Lee varios productos integrados en la aplicación, que pueden ser productos administrados o suscripciones.

batchUpdate

Actualiza o inserta uno o más productos integrados en la aplicación (productos administrados o suscripciones).

delete

Borra un producto integrado en la aplicación (un producto administrado o una suscripción).

get

Obtiene un producto integrado en la aplicación, que puede ser un producto administrado o una suscripción.

insert

Crea un producto integrado en la aplicación (un producto administrado o una suscripción).

list

Enumera todos los productos integrados en la aplicación (tanto productos administrados como suscripciones).

patch

Aplica parches a un producto integrado en la aplicación (un producto administrado o una suscripción).

update

Actualiza un producto integrado en la aplicación (un producto administrado o una suscripción).

Códigos de error

Las operaciones de este recurso devuelven los siguientes códigos de error HTTP:

Código de error Motivo Solución
5xx Error genérico en el servidor de Google Play. Vuelve a intentar enviar tu solicitud.

Si el problema persiste, comunícate con tu administrador de cuentas de Google Play o envía una solicitud de asistencia. Considera consultar el Panel de estado de Play para ver si hay interrupciones conocidas.

409 Se produjo un error de actualización de simultaneidad.

Se intentó actualizar un objeto que ya se estaba actualizando. Por ejemplo, una compra se confirma llamando al método acknowledgePurchase() de la Biblioteca de Facturación Play y llamando al purchases.products.acknowledge de la API de Play Developer al mismo tiempo.

Vuelve a intentar enviar tu solicitud.