Method: monetization.subscriptions.basePlans.batchUpdateStates

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

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

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. La app superior (nombre del paquete) de los planes básicos actualizados.

productId

string

Obligatorio. Es el ID del producto de la suscripción superior, si todos los planes básicos actualizados pertenecen a la misma suscripción. Si esta actualización por lotes abarca varias suscripciones, establece este campo en "-". Se debe establecer.

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

Mensaje de respuesta para basePlans.KeyStates.

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)

Lista de suscripciones actualizadas. Esta lista hará coincidir las solicitudes una a una, en el mismo orden.

Alcances de autorización

Requiere el siguiente alcance de OAuth:

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

UpdateBasePlanStateRequest

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. El 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. Una vez activados, los planes básicos estarán disponibles para suscriptores nuevos.

deactivateBasePlanRequest

object (DeactivateBasePlanRequest)

Desactiva un plan básico. Una vez desactivado, el plan básico dejará de estar disponible para nuevos suscriptores, pero los existentes mantendrán su suscripción.

ActivateBasePlanRequest

Mensaje de solicitud para ActivateBasePlan.

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

string

Obligatorio. La app superior (nombre del paquete) del plan básico que se activará.

productId

string

Obligatorio. Es la suscripción superior (ID) del plan básico que se activará.

basePlanId

string

Obligatorio. El ID único del plan básico que se activará.

latencyTolerance

enum (ProductUpdateLatencyTolerance)

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

DeactivateBasePlanRequest

Mensaje de solicitud para basePlans.deactivate.

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

string

Obligatorio. La app superior (nombre del paquete) del plan básico que se desactivará.

productId

string

Obligatorio. La suscripción superior (ID) del plan básico que se desactivará.

basePlanId

string

Obligatorio. El ID único del plan básico que se desactivará.

latencyTolerance

enum (ProductUpdateLatencyTolerance)

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