REST Resource: monetization.subscriptions

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

string

Inmutable. Nombre del paquete de la app superior.

string

Inmutable. Es el ID único del producto. Es único dentro de la app principal. Los ID del producto deben incluir letras en minúscula (a-z), números (0-9), guiones bajos (_) y puntos (.). Debe comenzar con una letra o un número en minúscula, y tener entre 1 y 40 caracteres (inclusive).

object (BasePlan)

Es el conjunto de planes básicos para esta suscripción. Representa los precios y la duración de la suscripción si no se aplican otras ofertas.

object (SubscriptionListing)

Obligatorio. Se trata de apks.list de fichas localizadas para esta suscripción. Debe contener al menos una entrada para el idioma predeterminado de la app principal.

boolean

Solo salida. Indica si esta suscripción está archivada. Las suscripciones archivadas ya no están disponibles para ningún suscriptor, no se pueden actualizar y no se muestran en las solicitudes de lista, a menos que se pase la marca de archivado del programa.

object (SubscriptionTaxAndComplianceSettings)

Detalles sobre los impuestos y el cumplimiento legal.

{
  "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)
  }
  // End of list of possible types for union field base_plan_type.
}

string

Obligatorio. Inmutable. El identificador único de este plan básico. Debe ser único en la suscripción y cumplir con RFC-1034. Es decir, este ID solo puede contener letras minúsculas (a-z), números (0-9) y guiones (-), y tener un máximo de 63 caracteres.

enum (State)

Solo salida. El estado del plan básico, es decir, si está activo. Los borradores y los planes básicos inactivos se pueden activar o borrar. Los planes básicos activos pueden quedar inactivos. Los planes básicos inactivos se pueden cancelar. Este campo no se puede cambiar mediante la actualización del recurso. En su lugar, usa los extremos dedicados.

object (RegionalBasePlanConfig)

Información específica de la región para este plan básico.

object (OfferTag)

apks.list de hasta 20 etiquetas personalizadas especificadas para este plan básico y que regresa a la app mediante la biblioteca de facturación. Las ofertas de suscripción para este plan básico también recibirán estas etiquetas de ofertas en la biblioteca de facturación.

object (OtherRegionsBasePlanConfig)

La información sobre los precios de las nuevas ubicaciones que Play pueda lanzar en el futuro. Si se omite, el Plan básico no estará disponible automáticamente en las ubicaciones nuevas que Play pueda lanzar en el futuro.

object (AutoRenewingBasePlanType)

Se establece cuando el plan básico se renueva automáticamente a intervalos regulares.

object (PrepaidBasePlanType)

Se establece cuando el plan básico no se renueva automáticamente al final del período de facturación.

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

string

Obligatorio. Período de suscripción especificado en formato ISO 8601. Para obtener una lista de los períodos de facturación aceptables, consulta el Centro de ayuda.

string

Período de gracia de la suscripción, especificado en formato ISO 8601. Los valores aceptables son P0D (cero días), P3D (3 días), P7D (7 días), P14D (14 días) y P30D (30 días). Si no se especifica, se usará un valor predeterminado según la duración del período recurrente.

enum (ResubscribeState)

Indica si los usuarios deben poder volver a suscribirse a este plan básico en las plataformas de Google Play. La configuración predeterminada es RESUBSCRIBE_STATE_ACTIVE si no se especifica.

enum (SubscriptionProrationMode)

El modo de prorrateo para el plan básico determina qué sucede cuando un usuario cambia a este plan desde otro plan básico. Si no se especifica, el valor predeterminado es CHARGE_ON_NEXT_BILLING_DATE.

boolean

Si el plan básico renovado es retrocompatible.

El método base querySkuDetailsAsync() muestra la versión anterior de la Biblioteca de Facturación Google Play.

Solo se puede marcar un plan básico con renovación como heredado para una suscripción determinada.

string

ID de oferta de suscripción compatible con versiones heredadas.

La biblioteca de Facturación Google Play muestra el método obsoleto querySkuDetailsAsync().

Solo se puede marcar una oferta de suscripción como compatible con versiones heredadas para un plan básico renovado.

Para no tener ninguna oferta de suscripción como compatible heredada, establece este campo como una string vacía.

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

string

Obligatorio. Período de suscripción especificado en formato ISO 8601. Para obtener una lista de los períodos de facturación aceptables, consulta el Centro de ayuda.

enum (TimeExtension)

Indica si los usuarios deben poder extender este plan básico prepago en las plataformas de Google Play. La configuración predeterminada es TIME_EXTENSION_ACTIVE si no se especifica.

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

string

Obligatorio. Código de región al que se aplica esta configuración, según lo define la norma ISO 3166-2, p. ej., "US"

boolean

Si el plan básico en la región especificada está disponible para suscriptores nuevos. La suscripción no se cancelará si el valor se establece como falso. Si no se especifica, el valor predeterminado será “false”.

object (Money)

El precio del plan básico en la región especificada. Se debe configurar si el plan básico está disponible para suscriptores nuevos. Debe establecerse en la moneda vinculada a la región especificada.

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

object (Money)

Obligatorio. Precio en USD que se usará para cualquier ubicación nueva en la que Play pueda lanzarse.

object (Money)

Obligatorio. Precio en EUR que se usará para las nuevas ubicaciones en las que Play pueda lanzar contenido.

boolean

Si el plan básico está disponible para suscriptores nuevos en cualquier ubicación nueva en la que Play pueda lanzar contenido Si no se especifica, el valor predeterminado será “false”.

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

string

Obligatorio. El idioma de esta lista, según lo definido por BCP-47, p. ej., "en-US"

string

Obligatorio. El título de esta suscripción en el idioma de esta ficha. Texto sin formato

string

Es una lista de los beneficios que se muestran al usuario en plataformas como Play Store y en flujos de restablecimiento en el idioma de esta ficha. Texto sin formato Lista ordenada de cuatro beneficios como máximo.

string

Es la descripción de esta suscripción en el idioma de esta ficha. Longitud máxima: 80 caracteres Texto sin formato