REST Resource: inappproducts

Risorsa: InAppProduct

Un prodotto in-app. La risorsa per InappproductsService.

Rappresentazione 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.
}
Campi
packageName

string

Nome del pacchetto dell'app principale.
sku

string

SKU (Stock Keeping Unit, articolo gestito a magazzino) del prodotto, univoco all'interno di un'app.
status

enum (Status)

Lo stato del prodotto, ad esempio se è attivo.
purchaseType

enum (PurchaseType)

Il tipo di prodotto, ad esempio un abbonamento ricorrente.
defaultPrice

object (Price)

Prezzo predefinito. Non può essere zero, in quanto i prodotti in-app non sono mai senza costi. Sempre nella valuta del commerciante di Checkout dello sviluppatore.
prices

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

Prezzi per regione dell'acquirente. Nessuno di questi può essere zero, in quanto i prodotti in-app non sono mai senza costi. La chiave della mappa è il codice regione, come definito da ISO 3166-2.

Un oggetto contenente un elenco di coppie "key": value. Esempio: { "name": "wrench", "mass": "1.3kg", "count": "3" }
listings

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

inappproducts.list of localized title and description data. La chiave della mappa è la lingua dei dati localizzati, come definita da BCP-47, ad esempio "en-US".

Un oggetto contenente un elenco di coppie "key": value. Esempio: { "name": "wrench", "mass": "1.3kg", "count": "3" }
defaultLanguage

string

Lingua predefinita dei dati localizzati, come definito da BCP-47. Ad esempio, "en-US".
subscriptionPeriod

string

Il periodo di abbonamento, specificato nel formato ISO 8601. I valori accettabili sono P1W (una settimana), P1M (un mese), P3M (tre mesi), P6M (sei mesi) e P1Y (un anno).
trialPeriod

string

Periodo di prova, specificato nel formato ISO 8601. I valori accettati sono compresi tra P7D (sette giorni) e P999D (999 giorni).
gracePeriod

string

Il periodo di tolleranza dell'abbonamento, specificato nel formato ISO 8601. Consente agli sviluppatori di concedere ai propri abbonati un periodo di tolleranza quando il pagamento per il nuovo periodo di ricorrenza viene rifiutato. I valori accettabili sono P0D (zero giorni), P3D (tre giorni), P7D (sette giorni), P14D (14 giorni) e P30D (30 giorni).

Campo unione TaxAndComplianceType.

TaxAndComplianceType può essere solo uno dei seguenti:
subscriptionTaxesAndComplianceSettings

object (SubscriptionTaxAndComplianceSettings)

Dettagli su tasse e conformità legale. Valido solo per i prodotti in abbonamento.
managedProductTaxesAndComplianceSettings

object (ManagedProductTaxAndComplianceSettings)

Dettagli su tasse e conformità legale. Applicabile solo ai prodotti gestiti.

Stato

Lo stato di un prodotto in-app.

Enum
statusUnspecified Stato non specificato.
active Il prodotto è pubblicato e attivo nel negozio.
inactive Il prodotto non è pubblicato e pertanto è inattivo nello store.

PurchaseType

Il tipo di prodotto.

Enum
purchaseTypeUnspecified Tipo di acquisto non specificato.
managedUser Il tipo di prodotto predefinito: acquisto singolo.
subscription Prodotto in-app con un periodo ricorrente.

InAppProductListing

Scheda dello Store di un singolo prodotto in-app.

Rappresentazione JSON 
{
  "title": string,
  "description": string,
  "benefits": [
    string
  ]
}
Campi
title

string

Titolo della scheda dello Store.
description

string

Descrizione della scheda dello Store.
benefits[]

string

Vantaggi relativi ai diritti localizzati per un abbonamento.

ManagedProductTaxAndComplianceSettings

Dettagli su tassazione e conformità legale per i prodotti gestiti.

Rappresentazione JSON 
{
  "eeaWithdrawalRightType": enum (WithdrawalRightType),
  "taxRateInfoByRegionCode": {
    string: {
      object (RegionalTaxRateInfo)
    },
    ...
  },
  "isTokenizedDigitalAsset": boolean
}
Campi
eeaWithdrawalRightType

enum (WithdrawalRightType)

Classificazione come servizi o contenuti digitali per i prodotti distribuiti agli utenti dello Spazio economico europeo (SEE). Il regime di recesso previsto dalle leggi a tutela dei consumatori del SEE dipende da questa classificazione. Per saperne di più, consulta questo articolo del Centro assistenza.
taxRateInfoByRegionCode

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

Una mappatura dal codice regione ai dettagli dell'aliquota fiscale. Le chiavi sono codici regione come definiti da "CLDR" di Unicode.

Un oggetto contenente un elenco di coppie "key": value. Esempio: { "name": "wrench", "mass": "1.3kg", "count": "3" }
isTokenizedDigitalAsset

boolean

Se questo prodotto in-app è dichiarato come prodotto che rappresenta un asset digitale tokenizzato.

Metodi

batchDelete

 Elimina i prodotti in-app (prodotti gestiti o abbonamenti).

batchGet

 Legge più prodotti in-app, che possono essere prodotti gestiti o abbonamenti.

batchUpdate

 Aggiorna o inserisce uno o più prodotti in-app (prodotti gestiti o abbonamenti).

delete

 Elimina un prodotto in-app (un prodotto gestito o un abbonamento).

get

 Riceve un prodotto in-app, che può essere un prodotto gestito o un abbonamento.

insert

 Crea un prodotto in-app (un prodotto gestito o un abbonamento).

list

 Elenca tutti i prodotti in-app, sia i prodotti gestiti che gli abbonamenti.

patch

 Applica una patch a un prodotto in-app (un prodotto gestito o un abbonamento).

update

 Aggiorna un prodotto in-app (un prodotto gestito o un abbonamento).

Codici di errore

Le operazioni di questa risorsa restituiscono i seguenti codici di errore HTTP:

Codice di errore Motivo Risoluzione
5xx Errore generico nel server Google Play. Riprova a inviare la richiesta.

Se il problema persiste, contatta il tuo Account Manager Google Play o invia una richiesta di assistenza. Ti consigliamo di controllare la dashboard dello stato di Play per eventuali interruzioni note.
409 Errore di aggiornamento della concorrenza.

È stato effettuato un tentativo di aggiornamento di un oggetto in fase di aggiornamento. Ad esempio, un acquisto viene confermato chiamando il metodo acknowledgePurchase() della libreria Fatturazione Play e chiamando contemporaneamente il metodo purchases.products.acknowledge dell'API Play Developer.

 Riprova a inviare la richiesta.