REST Resource: monetization.subscriptions

{
  "packageName": string,
  "productId": string,
  "basePlans": [
    {
      object (BasePlan)
    }
  ],
  "listings": [
    {
      object (SubscriptionListing)
    }
  ],
  "archived": boolean,
  "taxAndComplianceSettings": {
    object (SubscriptionTaxAndComplianceSettings)
  },
  "restrictedPaymentCountries": {
    object (RestrictedPaymentCountries)
  }
}

string

Immutabile. Nome del pacchetto dell'app principale.

string

Immutabile. ID prodotto univoco del prodotto. È univoco all'interno dell'app principale. Gli ID prodotto devono essere composti da lettere minuscole (a-z), numeri (0-9), trattini bassi (_) e punti (.). Deve iniziare con una lettera minuscola o un numero e avere una lunghezza compresa tra 1 e 40 caratteri (inclusi).

object (BasePlan)

L'insieme di piani base per questo abbonamento. Rappresenta i prezzi e la durata dell'abbonamento nel caso in cui non siano applicabili altre offerte.

object (SubscriptionListing)

Obbligatorio. Elenco di schede localizzate per questo abbonamento. Deve contenere almeno una voce per la lingua predefinita dell'app principale.

boolean

Solo output. Deprecato: l'archiviazione degli abbonamenti non è supportata.

object (SubscriptionTaxAndComplianceSettings)

Dettagli sulle imposte e sulla conformità legale.

object (RestrictedPaymentCountries)

(Facoltativo) Paesi in cui l'acquisto di questo abbonamento è limitato ai metodi di pagamento registrati nello stesso paese. Se viene lasciato vuoto, non vengono applicate limitazioni relative alle località di pagamento.

{
  "basePlanId": string,
  "state": enum (State),
  "regionalConfigs": [
    {
      object (RegionalBasePlanConfig)
    }
  ],
  "offerTags": [
    {
      object (OfferTag)
    }
  ],
  "otherRegionsConfig": {
    object (OtherRegionsBasePlanConfig)
  },

  // Union field base_plan_type can be only one of the following:
  "autoRenewingBasePlanType": {
    object (AutoRenewingBasePlanType)
  },
  "prepaidBasePlanType": {
    object (PrepaidBasePlanType)
  },
  "installmentsBasePlanType": {
    object (InstallmentsBasePlanType)
  }
  // End of list of possible types for union field base_plan_type.
}

string

Obbligatorio. Immutabile. L'identificatore univoco di questo piano base. Deve essere univoco all'interno dell'abbonamento ed essere conforme a RFC-1034. Ciò significa che questo ID può contenere solo lettere minuscole (a-z), numeri (0-9) e trattini (-) e può contenere al massimo 63 caratteri.

enum (State)

Solo output. Lo stato del piano base, ad esempio se è attivo. I piani base in versione bozza e inattivi possono essere attivati o eliminati. I piani base attivi possono essere disattivati. I piani base non attivi possono essere annullati. Questo campo non può essere modificato aggiornando la risorsa. Usa invece gli endpoint dedicati.

object (RegionalBasePlanConfig)

Informazioni specifiche per regione per questo piano base.

object (OfferTag)

Elenco di massimo 20 tag personalizzati specificati per questo piano base e restituiti all'app tramite la Libreria Fatturazione. Anche le offerte di abbonamento per questo piano base riceveranno questi tag nella Libreria Fatturazione.

object (OtherRegionsBasePlanConfig)

Informazioni sui prezzi per eventuali nuove località in cui Google Play potrebbe essere lanciato in futuro. Se omesso, il Base Plan non sarà automaticamente disponibile nelle nuove località in cui Google Play potrebbe essere lanciato in futuro.

object (AutoRenewingBasePlanType)

Imposta il momento in cui il piano base si rinnova automaticamente a intervalli regolari.

object (PrepaidBasePlanType)

Imposta quando il piano base non si rinnova automaticamente alla fine del periodo di fatturazione.

object (InstallmentsBasePlanType)

Impostati per i piani base a rate in cui un utente si impegna a raggiungere un numero specifico di pagamenti.

{
  "billingPeriodDuration": string,
  "gracePeriodDuration": string,
  "accountHoldDuration": string,
  "resubscribeState": enum (ResubscribeState),
  "prorationMode": enum (SubscriptionProrationMode),
  "legacyCompatible": boolean,
  "legacyCompatibleSubscriptionOfferId": string
}

string

Obbligatorio. Periodo di abbonamento, specificato nel formato ISO 8601. Per un elenco dei periodi di fatturazione accettabili, consulta il Centro assistenza.

string

Periodo di tolleranza dell'abbonamento, specificato nel formato ISO 8601. I valori accettati sono P0D (zero giorni), P3D (3 giorni), P7D (7 giorni), P14D (14 giorni) e P30D (30 giorni). Se non specificato, verrà utilizzato un valore predefinito in base alla durata del periodo ricorrente.

string

(Facoltativo) Il periodo di sospensione dell'account dell'abbonamento, specificato nel formato ISO 8601. I valori accettati devono essere in DAYS e compresi tra P0D (zero giorni) e P30D (30 giorni). Se non specificato, il valore predefinito è P30D (30 giorni).

enum (ResubscribeState)

Indica se gli utenti devono essere in grado di riabbonarsi a questo piano base sulle piattaforme Google Play. Se non specificato, il valore predefinito è RESUBSCRIBE_STATE_ACTIVE.

enum (SubscriptionProrationMode)

La modalità di ripartizione del piano base determina cosa succede quando un utente passa a questo piano da un altro piano base. Se non specificato, il valore predefinito è CHARGE_ON_NEXT_BILLING_DATE.

boolean

Indica se il piano base di rinnovo è compatibile con le versioni precedenti.

Il piano base compatibile con le versioni precedenti viene restituito dal metodo deprecato querySkuDetailsAsync() della Libreria Fatturazione Google Play.

Per un determinato abbonamento puoi contrassegnare come compatibile con la versione precedente un solo piano base rinnovato.

string

ID offerta di abbonamento compatibile con la versione precedente.

L'offerta di abbonamento compatibile con le versioni precedenti viene restituita dal metodo deprecato querySkuDetailsAsync() della Libreria Fatturazione Google Play.

È possibile contrassegnare una sola offerta di abbonamento come compatibile con la versione precedente per un determinato piano base che si rinnova.

Per non avere un'offerta di abbonamento come compatibile con la versione precedente, imposta questo campo come stringa vuota.

{
  "billingPeriodDuration": string,
  "timeExtension": enum (TimeExtension)
}

string

Obbligatorio. Periodo di abbonamento, specificato nel formato ISO 8601. Per un elenco dei periodi di fatturazione accettabili, consulta il Centro assistenza.

enum (TimeExtension)

Indica se gli utenti devono essere in grado di estendere questo piano base prepagato sulle piattaforme Google Play. Se non specificato, il valore predefinito è TIME_EXTENSION_ACTIVE.

{
  "billingPeriodDuration": string,
  "committedPaymentsCount": integer,
  "renewalType": enum (RenewalType),
  "gracePeriodDuration": string,
  "accountHoldDuration": string,
  "resubscribeState": enum (ResubscribeState),
  "prorationMode": enum (SubscriptionProrationMode)
}

string

Obbligatorio. Periodo di abbonamento, specificato nel formato ISO 8601. Per un elenco dei periodi di fatturazione accettabili, consulta il Centro assistenza.

integer

Obbligatorio. Il numero di pagamenti a cui l'utente è impegnato.

enum (RenewalType)

Obbligatorio. Tipo di rinnovo del piano base delle rate. Determina il comportamento alla fine dell'impegno iniziale.

string

Periodo di tolleranza dell'abbonamento, specificato nel formato ISO 8601. I valori accettati sono P0D (zero giorni), P3D (3 giorni), P7D (7 giorni), P14D (14 giorni) e P30D (30 giorni). Se non specificato, verrà utilizzato un valore predefinito in base alla durata del periodo ricorrente.

string

(Facoltativo) Il periodo di sospensione dell'account dell'abbonamento, specificato esclusivamente in giorni e nel formato ISO 8601. I valori accettati sono da P0D (zero giorni) a P30D (30 giorni). Se non specificato, il valore predefinito è P30D (30 giorni).

enum (ResubscribeState)

Indica se gli utenti devono essere in grado di riabbonarsi a questo piano base sulle piattaforme Google Play. Se non specificato, il valore predefinito è RESUBSCRIBE_STATE_ACTIVE.

enum (SubscriptionProrationMode)

La modalità di ripartizione del piano base determina cosa succede quando un utente passa a questo piano da un altro piano base. Se non specificato, il valore predefinito è CHARGE_ON_NEXT_BILLING_DATE.

{
  "regionCode": string,
  "newSubscriberAvailability": boolean,
  "price": {
    object (Money)
  }
}

string

Obbligatorio. Codice regione a cui si applica questa configurazione, come definito dallo standard ISO 3166-2, ad esempio "Stati Uniti".

boolean

Indica se il piano base nella regione specificata è disponibile per i nuovi abbonati. Se questo valore viene impostato su false, gli abbonati esistenti non verranno annullati. Se non specificato, il valore predefinito è false.

object (Money)

Il prezzo del piano base nella regione specificata. Deve essere impostato se il piano base è disponibile per nuovi abbonati. Deve essere impostata nella valuta collegata alla regione specificata.

{
  "usdPrice": {
    object (Money)
  },
  "eurPrice": {
    object (Money)
  },
  "newSubscriberAvailability": boolean
}

object (Money)

Obbligatorio. Il prezzo in USD da utilizzare per eventuali nuove località in cui potrebbe essere lanciato Google Play.

object (Money)

Obbligatorio. Prezzo in euro da utilizzare per eventuali nuove località in cui potrebbe essere lanciato Google Play.

boolean

Indica se il piano base è disponibile per i nuovi abbonati in nuove località in cui potrebbe essere lanciato Google Play. Se non specificato, il valore predefinito è false.

{
  "languageCode": string,
  "title": string,
  "benefits": [
    string
  ],
  "description": string
}

string

Obbligatorio. La lingua di questa scheda, come definita da BCP-47, ad esempio "it-IT".

string

Obbligatorio. Il titolo dell'abbonamento nella lingua di questa scheda. Testo normale.

string

Un elenco dei vantaggi mostrato all'utente su piattaforme come il Play Store e nei flussi di ripristino nella lingua di questa scheda. Testo normale. Elenco ordinato di al massimo quattro vantaggi.

string

La descrizione dell'abbonamento nella lingua di questa scheda. Lunghezza massima: 80 caratteri. Testo normale.

{
  "regionCodes": [
    string
  ]
}

string

Obbligatorio. Codici regionali per i quali imporre restrizioni di pagamento, come definito dallo standard ISO 3166-2, ad esempio "Stati Uniti".