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. Unico 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. Set di dati localizzati per titolo e descrizione. Non devono essere presenti voci duplicate con lo stesso languageCode.
taxAndComplianceSettings

object (OneTimeProductTaxAndComplianceSettings)

Dettagli su tasse e conformità legale.
purchaseOptions[]

object (OneTimeProductPurchaseOption)

Obbligatorio. Il set di opzioni di acquisto per questo prodotto una tantum.
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 vuoto, non vengono imposte limitazioni relative alle località di pagamento.
offerTags[]

object (OfferTag)

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

object (RegionsVersion)

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

OneTimeProductListing

Scheda del negozio 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 es. "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
}
Campi
regionalTaxConfigs[]

object (RegionalTaxConfig)

Configurazione delle imposte regionali.
isTokenizedDigitalAsset

boolean

Se questo prodotto a pagamento singolo è dichiarato come prodotto che rappresenta un asset digitale tokenizzato.

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 da ISO 3166-2, ad esempio "US".
taxTier

enum (TaxTier)

Livello imposta 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

Un'unica 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)
  },

  // Union field purchase_option_type can be only one of the following:
  "buyOption": {
    object (OneTimeProductBuyPurchaseOption)
  },
  "rentOption": {
    object (OneTimeProductRentPurchaseOption)
  }
  // End of list of possible types for union field purchase_option_type.
}
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 le nuove località in cui Google Play potrebbe essere lanciato in futuro. Se omessa, l'opzione di acquisto non sarà disponibile automaticamente 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 di fatturazione. Anche le offerte per questa opzione di acquisto riceveranno questi tag nella libreria di fatturazione.
taxAndComplianceSettings

object (PurchaseOptionTaxAndComplianceSettings)

(Facoltativo) Dettagli su tasse e conformità legale.
Campo unione purchase_option_type. Il tipo di questa opzione di acquisto. Deve essere impostato esattamente un valore. purchase_option_type può essere solo uno dei seguenti:
buyOption

object (OneTimeProductBuyPurchaseOption)

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

object (OneTimeProductRentPurchaseOption)

Un'opzione di acquisto che può essere noleggiata.

Stato

Lo stato attuale dell'opzione di acquisto.

Enum
STATE_UNSPECIFIED Valore predefinito, non deve mai essere utilizzato.
DRAFT L'opzione di acquisto 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, ma continuiamo a esporre 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) Se questa opzione di acquisto sarà disponibile nei flussi PBL legacy che non supportano il modello di prodotti una tantum.

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

boolean

(Facoltativo) Se questa opzione di acquisto consente più quantità. La funzionalità multi-quantità 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. Specificato nel formato ISO 8601.
expirationPeriod

string

(Facoltativo) Il tempo a disposizione dell'utente dopo l'inizio della fruizione del diritto prima che venga revocato. Specificato nel formato ISO 8601.

RegionalPricingAndAvailabilityConfig

Configurazione di prezzi e 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 da ISO 3166-2, ad es. "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 DISPONIBILE.
AVAILABLE_IF_RELEASED L'opzione di acquisto inizialmente non è disponibile, ma viene resa disponibile tramite un'offerta di prenotazione pubblicata.

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 dollari statunitensi da utilizzare per le nuove regioni in cui Play potrebbe essere lanciato.
eurPrice

object (Money)

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

enum (Availability)

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

Disponibilità

La disponibilità della nuova configurazione delle regioni.

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

PurchaseOptionTaxAndComplianceSettings

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

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

enum (WithdrawalRightType)

(Facoltativo) Classificazione come servizi 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 questo 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 in una determinata app.

patch

 Crea o aggiorna un prodotto a pagamento singolo.