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 (codice identificativo dell'articolo) 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, perché i prodotti in-app non sono mai senza costi. Sempre nella valuta del commerciante di Google Checkout dello sviluppatore.

prices

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

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

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

listings

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

inappproducts.list di dati localizzati relativi a titoli e descrizioni. Il tasto della mappa è la lingua dei dati localizzati, come definito da BCP-47, ad esempio "en-US".

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

defaultLanguage

string

Lingua predefinita dei dati localizzati, come definita da BCP-47, ad esempio "en-US".

subscriptionPeriod

string

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

Periodo di tolleranza dell'abbonamento specificato nel formato ISO 8601. Consente agli sviluppatori di concedere ai propri abbonati un periodo di tolleranza nel caso in cui il pagamento del nuovo periodo ricorrente venga rifiutato. I valori accettati sono P0D (zero giorni), P3D (tre giorni), P7D (sette giorni), P14D (14 giorni) e P30D (30 giorni).

Campo di unione TaxAndComplianceType.

TaxAndComplianceType può essere solo uno dei seguenti:

subscriptionTaxesAndComplianceSettings

object (SubscriptionTaxAndComplianceSettings)

Dettagli sulle imposte e sulla conformità legale. Valido solo per i prodotti in abbonamento.

managedProductTaxesAndComplianceSettings

object (ManagedProductTaxAndComplianceSettings)

Dettagli sulle imposte e sulla conformità legale. Valido solo per i prodotti gestiti.

Stato

Lo stato di un prodotto in-app.

Enum
statusUnspecified Stato non specificato.
active Il prodotto è stato pubblicato ed è attivo nello store.
inactive Il prodotto non è pubblicato e pertanto non è attivo nello store.

PurchaseType

Il tipo di prodotto.

Enum
purchaseTypeUnspecified Tipo di acquisto non specificato.
managedUser Tipo di prodotto predefinito: acquisto una tantum.
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 dei diritti localizzati per un abbonamento.

ManagedProductTaxAndComplianceSettings

Dettagli fiscali e di conformità legale per i prodotti gestiti.

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

enum (WithdrawalRightType)

Classificazione dei contenuti digitali o dei servizi per prodotti distribuiti agli utenti nello Spazio economico europeo (SEE). Il regime di recesso previsto dalle leggi per il consumatore 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 dal "CLDR" di Unicode.

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

isTokenizedDigitalAsset

boolean

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

Metodi

batchDelete

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

batchGet

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

batchUpdate

Consente di aggiornare o inserire 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 prodotti gestiti sia abbonamenti.

patch

Patch per un prodotto in-app (un prodotto gestito o un abbonamento).

update

Consente di aggiornare un prodotto in-app (un prodotto gestito o un abbonamento).