Method: monetization.subscriptions.basePlans.batchUpdateStates

Activa o desactiva planes básicos en una o varias suscripciones.

Establece el campo latencyTolerance de las solicitudes anidadas en PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_TOLERANT para lograr la máxima capacidad de procesamiento de la actualización.

Solicitud HTTP

POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/subscriptions/{productId}/basePlans:batchUpdateStates

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
packageName

string

Obligatorio. Es el nombre de paquete de la app principal de los planes básicos actualizados.
productId

string

Obligatorio. Es el ID del producto de la suscripción principal si todos los planes básicos actualizados pertenecen a la misma suscripción. Si esta actualización por lotes abarca múltiples suscripciones, establece este campo como "-", ya que se debe definir un valor.

Cuerpo de la solicitud

El cuerpo de la solicitud contiene datos con la siguiente estructura:

Representación JSON 
{
  "requests": [
    {
      object (UpdateBasePlanStateRequest)
    }
  ]
}
Campos
requests[]

object (UpdateBasePlanStateRequest)

Obligatorio. Es la lista de solicitudes de actualización de hasta 100 elementos. Todas las solicitudes deben actualizar diferentes planes básicos.

Cuerpo de la respuesta

Es el mensaje de respuesta para basePlans.batchUpdateStates.

Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:

Representación JSON 
{
  "subscriptions": [
    {
      object (Subscription)
    }
  ]
}
Campos
subscriptions[]

object (Subscription)

Es la lista de suscripciones actualizadas. Esta lista coincidirá con las solicitudes una a una y en el mismo orden.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

  • https://www.googleapis.com/auth/androidpublisher

UpdateBasePlanStateRequest

Es un mensaje de solicitud para actualizar el estado de un plan básico de suscripción.

Representación JSON 
{

  // Union field state_transition_type can be only one of the following:
  "activateBasePlanRequest": {
    object (ActivateBasePlanRequest)
  },
  "deactivateBasePlanRequest": {
    object (DeactivateBasePlanRequest)
  }
  // End of list of possible types for union field state_transition_type.
}
Campos
Campo de unión state_transition_type. Tipo de transición de estado que se aplicará. Se debe establecer exactamente uno. Las direcciones (state_transition_type) solo pueden ser una de las siguientes opciones:
activateBasePlanRequest

object (ActivateBasePlanRequest)

Activa un plan básico. Cuando esto ocurre, los planes básicos quedan disponibles para suscriptores nuevos.
deactivateBasePlanRequest

object (DeactivateBasePlanRequest)

Desactiva un plan básico. Cuando esto ocurre, el plan básico deja de estar disponible para nuevos suscriptores, pero se mantienen las suscripciones existentes.

ActivateBasePlanRequest

Es el mensaje de solicitud para ActivateBasePlan.

Representación JSON 
{
  "packageName": string,
  "productId": string,
  "basePlanId": string,
  "latencyTolerance": enum (ProductUpdateLatencyTolerance)
}
Campos
packageName

string

Obligatorio. Es el nombre de paquete de la app principal del plan básico que se activará.
productId

string

Obligatorio. Es el ID de la suscripción principal del plan básico que se activará.
basePlanId

string

Obligatorio. Es el ID único del plan básico que se activará.
latencyTolerance

enum (ProductUpdateLatencyTolerance)

Opcional. Es la tolerancia de latencia para la propagación de esta actualización de producto. La configuración predeterminada es sensible a la latencia.

DeactivateBasePlanRequest

Es un mensaje de solicitud para basePlans.deactivate.

Representación JSON 
{
  "packageName": string,
  "productId": string,
  "basePlanId": string,
  "latencyTolerance": enum (ProductUpdateLatencyTolerance)
}
Campos
packageName

string

Obligatorio. Es el nombre de paquete de la app principal del plan básico que se desactivará.
productId

string

Obligatorio. Es el ID de la suscripción principal del plan básico que se desactivará.
basePlanId

string

Obligatorio. Es el ID único del plan básico que se desactivará.
latencyTolerance

enum (ProductUpdateLatencyTolerance)

Opcional. Es la tolerancia de latencia para la propagación de esta actualización de producto. La configuración predeterminada es sensible a la latencia.