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 pagamento 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 è il 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. La chiave della mappa è la lingua dei dati localizzati, come definita da BCP-47, ad esempio "it-IT".

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 es. "it-IT".

subscriptionPeriod

string

Periodo di abbonamento, specificato nel formato ISO 8601. I valori accettati 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 quando il pagamento per il nuovo periodo di ricorrenza viene rifiutato. I valori accettati 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 sulle imposte e sulla conformità legale. Valido solo per i prodotti in abbonamento.

managedProductTaxesAndComplianceSettings

object (ManagedProductTaxAndComplianceSettings)

Dettagli sulle imposte e sulla conformità legale. Il problema riguarda solo i prodotti gestiti.

Stato

Lo stato di un prodotto in-app.

Enum
statusUnspecified Stato non specificato.
active Il prodotto è pubblicato e attivo nello store.
inactive Il prodotto non è pubblicato e, di conseguenza, non è attivo nello store.

PurchaseType

Il tipo di prodotto.

Enum
purchaseTypeUnspecified Tipo di acquisto non specificato.
managedUser Il tipo di prodotto predefinito: acquisto una tantum.
subscription Prodotto in-app con 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 relativi a un abbonamento.

ManagedProductTaxAndComplianceSettings

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

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

enum (WithdrawalRightType)

Classificazione di servizi o contenuti digitali 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 parametro "CLDR" di Unicode.

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

isTokenizedDigitalAsset

boolean

Se il prodotto in-app viene 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

Ottiene 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

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

update

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