REST Resource: monetization.onetimeproducts

Risorsa: OneTimeProduct

Un singolo prodotto a pagamento singolo per un'app.

Rappresentazione JSON 
{
  "packageName": string,
  "productId": string,
  "listings": [
    {
      object (OneTimeProductListing)
    }
  ],
  "taxAndComplianceSettings": {
    object (OneTimeProductTaxAndComplianceSettings)
  },
  "purchaseOptions": [
    {
      object (OneTimeProductPurchaseOption)
    }
  ],
  "restrictedPaymentCountries": {
    object (RestrictedPaymentCountries)
  },
  "offerTags": [
    {
      object (OfferTag)
    }
  ],
  "regionsVersion": {
    object (RegionsVersion)
  }
}
Campi
packageName

string

Obbligatorio. Immutabile. Nome del pacchetto dell'app principale.
productId

string

Obbligatorio. Immutabile. ID prodotto univoco del prodotto. Univoco all'interno dell'app principale. Gli ID prodotto devono iniziare con un numero o una lettera minuscola e possono contenere numeri (0-9), lettere minuscole (a-z), trattini bassi (_) e punti (.).
listings[]

object (OneTimeProductListing)

Obbligatorio. Insieme di dati relativi a titolo e descrizione localizzati. Non deve contenere voci duplicate con lo stesso languageCode.
taxAndComplianceSettings

object (OneTimeProductTaxAndComplianceSettings)

Dettagli su imposte e conformità legale.
purchaseOptions[]

object (OneTimeProductPurchaseOption)

Obbligatorio. L'insieme di opzioni di acquisto per questo prodotto a pagamento singolo.
restrictedPaymentCountries

object (RestrictedPaymentCountries)

Facoltativo. Paesi in cui l'acquisto di questo prodotto a pagamento singolo è limitato ai metodi di pagamento registrati nello stesso paese. Se il campo è vuoto, non vengono imposte limitazioni relative alle località di pagamento.
offerTags[]

object (OfferTag)

Facoltativo. Elenco di un massimo di 20 tag personalizzati specificati per questo prodotto a pagamento singolo e restituiti all'app tramite la Libreria Fatturazione. Anche le opzioni di acquisto e le offerte per questo prodotto riceveranno questi tag nella Libreria Fatturazione.
regionsVersion

object (RegionsVersion)

Solo output. La versione della configurazione delle regioni utilizzata per generare il prodotto a pagamento singolo.

OneTimeProductListing

Scheda dello Store regionale per un prodotto a pagamento singolo.

Rappresentazione JSON 
{
  "languageCode": string,
  "title": string,
  "description": string
}
Campi
languageCode

string

Obbligatorio. La lingua di questa scheda, come definita da BCP-47, ad esempio "en-US".
title

string

Obbligatorio. Il titolo di questo prodotto nella lingua di questa scheda. La lunghezza massima è di 55 caratteri.
description

string

Obbligatorio. La descrizione di questo prodotto nella lingua di questa scheda. La lunghezza massima è di 200 caratteri.

OneTimeProductTaxAndComplianceSettings

Dettagli su tassazione, norme di Google Play e conformità legale per i prodotti a pagamento singolo.

Rappresentazione JSON 
{
  "regionalTaxConfigs": [
    {
      object (RegionalTaxConfig)
    }
  ],
  "isTokenizedDigitalAsset": boolean,
  "regionalProductAgeRatingInfos": [
    {
      object (RegionalProductAgeRatingInfo)
    }
  ],
  "productTaxCategoryCode": string
}
Campi
regionalTaxConfigs[]

object (RegionalTaxConfig)

Configurazione delle imposte regionali.
isTokenizedDigitalAsset

boolean

Se questo prodotto a pagamento singolo è 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 a pagamento singolo. La categoria fiscale del prodotto determina le aliquote dell'imposta sulla transazione applicate al prodotto. Per saperne di più, consulta l'articolo del Centro assistenza.

RegionalTaxConfig

Dettagli sulla tassazione in una determinata regione geografica.

Rappresentazione JSON 
{
  "regionCode": string,
  "taxTier": enum (TaxTier),
  "eligibleForStreamingServiceTaxRate": boolean,
  "streamingTaxType": enum (StreamingTaxType)
}
Campi
regionCode

string

Obbligatorio. Codice regione a cui si applica questa configurazione, come definito dallo standard ISO 3166-1 alpha-2, ad esempio "US".
taxTier

enum (TaxTier)

Aliquota per specificare l'aliquota fiscale ridotta. Gli sviluppatori che vendono audiolibri, libri, giornali, riviste o notizie digitali in diverse regioni potrebbero avere diritto a usufruire di aliquote fiscali ridotte.

Ulteriori informazioni.
eligibleForStreamingServiceTaxRate

boolean

Devi comunicarci se la tua app contiene prodotti di streaming per addebitare correttamente l'imposta sulle vendite statale e locale degli Stati Uniti. Campo supportato solo negli Stati Uniti.
streamingTaxType

enum (StreamingTaxType)

Per riscuotere le imposte sulle comunicazioni o sull'intrattenimento negli Stati Uniti, scegli la categoria fiscale appropriata.

Ulteriori informazioni.

OneTimeProductPurchaseOption

Una singola opzione di acquisto per un prodotto a pagamento singolo.

Rappresentazione JSON 
{
  "purchaseOptionId": string,
  "state": enum (State),
  "regionalPricingAndAvailabilityConfigs": [
    {
      object (RegionalPricingAndAvailabilityConfig)
    }
  ],
  "newRegionsConfig": {
    object (OneTimeProductPurchaseOptionNewRegionsConfig)
  },
  "offerTags": [
    {
      object (OfferTag)
    }
  ],
  "taxAndComplianceSettings": {
    object (PurchaseOptionTaxAndComplianceSettings)
  },

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "buyOption": {
    object (OneTimeProductBuyPurchaseOption)
  },
  "rentOption": {
    object (OneTimeProductRentPurchaseOption)
  }
  // End of mutually exclusive fields.
}
Campi
purchaseOptionId

string

Obbligatorio. Immutabile. L'identificatore univoco di questa opzione di acquisto. Deve essere univoco all'interno del prodotto a pagamento singolo. Deve iniziare con un numero o una lettera minuscola e può contenere solo lettere minuscole (a-z), numeri (0-9) e trattini (-). La lunghezza massima è di 63 caratteri.
state

enum (State)

Solo output. Lo stato dell'opzione di acquisto, ovvero se è attiva. Questo campo non può essere modificato aggiornando la risorsa. Utilizza invece gli endpoint dedicati.
regionalPricingAndAvailabilityConfigs[]

object (RegionalPricingAndAvailabilityConfig)

Informazioni su prezzi e disponibilità a livello regionale per questa opzione di acquisto.
newRegionsConfig

object (OneTimeProductPurchaseOptionNewRegionsConfig)

Informazioni sui prezzi per eventuali nuove località che Play potrebbe lanciare in futuro. Se omessa, l'opzione di acquisto non sarà automaticamente disponibile in nessuna nuova località in cui Play potrebbe essere lanciato in futuro.
offerTags[]

object (OfferTag)

Facoltativo. Elenco di un massimo di 20 tag personalizzati specificati per questa opzione di acquisto e restituiti all'app tramite la Libreria Fatturazione Play. Anche le offerte per questa opzione di acquisto riceveranno questi tag nella Libreria Fatturazione Play.
taxAndComplianceSettings

object (PurchaseOptionTaxAndComplianceSettings)

Facoltativo. Dettagli su imposte e conformità legale.
Il tipo di questa opzione di acquisto. È necessario impostarne esattamente uno. Di seguito è riportato un elenco di campi che si escludono a vicenda. In una risposta verrà impostato al massimo uno dei campi:
buyOption

object (OneTimeProductBuyPurchaseOption)

Un'opzione di acquisto che può essere acquistata.
rentOption

object (OneTimeProductRentPurchaseOption)

Un'opzione di acquisto che può essere noleggiata.
Fine dei campi che si escludono a vicenda.

Stato

Lo stato attuale dell'opzione di acquisto.

Enum
STATE_UNSPECIFIED Valore predefinito, non deve mai essere utilizzato.
DRAFT L'opzione di acquisto non è e non è mai stata disponibile per gli utenti.
ACTIVE L'opzione di acquisto è disponibile per gli utenti.
INACTIVE L'opzione di acquisto non è più disponibile per gli utenti.
INACTIVE_PUBLISHED L'opzione di acquisto non è più disponibile per l'acquisto, ma continuiamo a mostrare la sua offerta tramite la Libreria Fatturazione Play per la compatibilità con le versioni precedenti. Solo le opzioni di acquisto di cui è stata eseguita la migrazione automatica possono trovarsi in questo stato.

OneTimeProductBuyPurchaseOption

Un'opzione di acquisto che può essere acquistata.

Rappresentazione JSON 
{
  "legacyCompatible": boolean,
  "multiQuantityEnabled": boolean
}
Campi
legacyCompatible

boolean

Facoltativo. Indica se questa opzione di acquisto sarà disponibile nei flussi della Libreria Fatturazione Play legacy che non supportano il modello di prodotti a pagamento singolo.

È possibile contrassegnare come compatibile con le versioni precedenti un'opzione di acquisto "Acquista".
multiQuantityEnabled

boolean

Facoltativo. Indica se questa opzione di acquisto consente più quantità. La funzionalità Quantità multiple consente all'acquirente di acquistare più di un articolo in un unico pagamento.

OneTimeProductRentPurchaseOption

Un'opzione di acquisto che può essere noleggiata.

Rappresentazione JSON 
{
  "rentalPeriod": string,
  "expirationPeriod": string
}
Campi
rentalPeriod

string

Obbligatorio. Il periodo di tempo per cui un utente dispone del diritto. Inizia al completamento del flusso di acquisto. Specificata nel formato ISO 8601.
expirationPeriod

string

Facoltativo. Il periodo di tempo che l'utente ha a disposizione dopo aver iniziato a utilizzare il diritto prima che venga revocato. Specificata nel formato ISO 8601.

RegionalPricingAndAvailabilityConfig

Configurazione dei prezzi e della disponibilità a livello regionale per un'opzione di acquisto.

Rappresentazione JSON 
{
  "regionCode": string,
  "price": {
    object (Money)
  },
  "availability": enum (Availability)
}
Campi
regionCode

string

Obbligatorio. Codice regione a cui si applica questa configurazione, come definito dallo standard ISO 3166-1 alpha-2, ad esempio "US".
price

object (Money)

Il prezzo dell'opzione di acquisto nella regione specificata. Deve essere impostato nella valuta collegata alla regione specificata.
availability

enum (Availability)

La disponibilità dell'opzione di acquisto.

Disponibilità

La disponibilità dell'opzione di acquisto.

Enum
AVAILABILITY_UNSPECIFIED Disponibilità non specificata. Non deve essere utilizzato.
AVAILABLE L'opzione di acquisto è disponibile per gli utenti.
NO_LONGER_AVAILABLE L'opzione di acquisto non è più disponibile per gli utenti. Questo valore può essere utilizzato solo se la disponibilità è stata precedentemente impostata su AVAILABLE.
AVAILABLE_IF_RELEASED L'opzione di acquisto non è inizialmente disponibile, ma viene resa disponibile tramite un'offerta di pre-ordine pubblicata.
AVAILABLE_FOR_OFFERS_ONLY L'opzione di acquisto non è disponibile, ma le offerte collegate (ad es. l'offerta Play Points) sono disponibili.

OneTimeProductPurchaseOptionNewRegionsConfig

Informazioni sui prezzi per le nuove regioni in cui Play potrebbe essere lanciato in futuro.

Rappresentazione JSON 
{
  "usdPrice": {
    object (Money)
  },
  "eurPrice": {
    object (Money)
  },
  "availability": enum (Availability)
}
Campi
usdPrice

object (Money)

Obbligatorio. Prezzo in USD da utilizzare per le nuove regioni in cui Play potrebbe essere lanciato.
eurPrice

object (Money)

Obbligatorio. Prezzo in EUR da utilizzare per le nuove regioni in cui Play potrebbe essere lanciato.
availability

enum (Availability)

Obbligatorio. La disponibilità regionale per la configurazione delle nuove regioni. Se impostate su DISPONIBILE, le informazioni sui prezzi verranno utilizzate per tutte le nuove regioni che Play potrebbe lanciare in futuro.

Disponibilità

La disponibilità della configurazione delle nuove regioni.

Enum
AVAILABILITY_UNSPECIFIED Disponibilità non specificata. Non deve essere utilizzato.
AVAILABLE La configurazione verrà utilizzata per tutte le nuove regioni in cui Play potrebbe essere lanciato in futuro.
NO_LONGER_AVAILABLE La configurazione non è più disponibile e non verrà utilizzata per le nuove regioni in cui Play potrebbe essere lanciato in futuro. Questo valore può essere utilizzato solo se la disponibilità è stata precedentemente impostata su AVAILABLE.

PurchaseOptionTaxAndComplianceSettings

Dettagli su tassazione, norme di Google Play e conformità legale per le opzioni di acquisto di prodotti a pagamento singolo.

Rappresentazione JSON 
{
  "withdrawalRightType": enum (WithdrawalRightType)
}
Campi
withdrawalRightType

enum (WithdrawalRightType)

Facoltativo. Classificazione come servizio o contenuti digitali per i prodotti distribuiti agli utenti nelle regioni idonee.

Se non viene impostato, il valore predefinito è WITHDRAWAL_RIGHT_DIGITAL_CONTENT.

Per saperne di più, consulta l'articolo del Centro assistenza.

Metodi

batchDelete

 Elimina uno o più prodotti a pagamento singolo.

batchGet

 Legge uno o più prodotti a pagamento singolo.

batchUpdate

 Crea o aggiorna uno o più prodotti a pagamento singolo.

delete

 Elimina un prodotto a pagamento singolo.

get

 Legge un singolo prodotto a pagamento singolo.

list

 Elenca tutti i prodotti a pagamento singolo di una determinata app.

patch

 Crea o aggiorna un prodotto a pagamento singolo.

Codici di errore

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

Codice di errore Motivo Descrizione Risoluzione