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, poiché 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 pari a zero, poiché 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 di dati di titoli e descrizioni localizzati. La chiave mappa è la lingua dei dati localizzati, come definito 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 es. "en-US".

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 in 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 su tasse e conformità alle normative. Applicabile solo ai prodotti in abbonamento.

managedProductTaxesAndComplianceSettings

object (ManagedProductTaxAndComplianceSettings)

Dettagli su tasse e conformità alle normative. 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 quindi 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 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 su fiscalità 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 nello Spazio economico europeo (SEE). Le condizioni di recesso previste dalle leggi a tutela dei consumatori del SEE dipendono 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 di 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

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

Metodi

batchDelete

Consente di eliminare 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 (abbonamenti o prodotti gestiti).

delete

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

get

Recupera 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).