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,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "subscriptionTaxesAndComplianceSettings": {
    object (SubscriptionTaxAndComplianceSettings)
  },
  "managedProductTaxesAndComplianceSettings": {
    object (ManagedProductTaxAndComplianceSettings)
  }
  // End of mutually exclusive fields.
}
Campi
packageName

string

Nome del pacchetto dell'app principale.
sku

string

Codice identificativo dell'articolo (SKU) 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 pari a zero, in quanto 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 valori può essere pari a zero, poiché 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 coppie "key": value. Esempio: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
listings

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

inappproducts.list di dati relativi a titoli e descrizioni localizzati. La chiave della 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 definita da BCP-47, ad esempio "en-US".
subscriptionPeriod
(deprecated)

string

Ritirata: gli abbonamenti non sono più supportati nell'API InAppProducts. Utilizza invece l'API Subscriptions.
trialPeriod
(deprecated)

string

Ritirata: gli abbonamenti non sono più supportati nell'API InAppProducts. Utilizza invece l'API Subscriptions.
gracePeriod
(deprecated)

string

Ritirata: gli abbonamenti non sono più supportati nell'API InAppProducts. Utilizza invece l'API Subscriptions.
Di seguito è riportato un elenco di campi che si escludono a vicenda. In una risposta verrà impostato al massimo uno dei campi:
subscriptionTaxesAndComplianceSettings
(deprecated)

object (SubscriptionTaxAndComplianceSettings)

Ritirata: gli abbonamenti non sono più supportati nell'API InAppProducts. Utilizza invece l'API Subscriptions.
managedProductTaxesAndComplianceSettings

object (ManagedProductTaxAndComplianceSettings)

Dettagli su imposte e conformità legale. Applicabile solo ai prodotti gestiti.
Fine dei campi che si escludono a vicenda.

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 pertanto 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

Ritirata: gli abbonamenti non sono più supportati nell'API InAppProducts. Utilizza invece l'API Subscriptions.

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[]
(deprecated)

string

Ritirata: gli abbonamenti non sono più supportati nell'API InAppProducts. Utilizza invece l'API Subscriptions.

ManagedProductTaxAndComplianceSettings

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

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

enum (WithdrawalRightType)

Classificazione dei contenuti o dei servizi digitali per i 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 l'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 definiti dal "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 un prodotto che rappresenta un asset digitale tokenizzato.
regionalProductAgeRatingInfos[]

object (RegionalProductAgeRatingInfo)

Informazioni sulla classificazione per età regionale. Al momento questo campo è supportato solo per il codice regione US.
productTaxCategoryCode

string

Codice della categoria fiscale del prodotto da assegnare al prodotto in-app. La categoria fiscale del prodotto determina le aliquote fiscali sulle transazioni applicate al prodotto. Per saperne di più, consulta l'articolo del Centro assistenza.

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

 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 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 Descrizione Risoluzione