Method: monetization.subscriptions.basePlans.batchUpdateStates

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

Establece el campo billingTolerance en las solicitudes anidadas en PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_TOLERANT para alcanzar la capacidad de procesamiento máxima de 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. La app principal (nombre del paquete) de los planes básicos actualizados.

productId

string

Obligatorio. 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. La lista de solicitud de actualización de hasta 100 elementos. Todas las solicitudes deben actualizar planes básicos diferentes.

Cuerpo de la respuesta

Mensaje de respuesta para basePlans.MethodStates.

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)

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

Permisos 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. Es el tipo de transición de estado que se debe aplicar. Se debe establecer exactamente una. Las direcciones (state_transition_type) solo pueden ser una de las siguientes opciones:
activateBasePlanRequest

object (ActivateBasePlanRequest)

Activa un plan básico. Cuando se activen, los planes básicos estarán disponibles para nuevos suscriptores.

deactivateBasePlanRequest

object (DeactivateBasePlanRequest)

Desactiva un plan básico. Una vez desactivado, el plan básico dejará de estar disponible para los suscriptores nuevos, pero los suscriptores 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 principal (nombre del paquete) del plan básico que se activará.

productId

string

Obligatorio. La suscripción principal (ID) 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. La tolerancia de latencia para la propagación de esta actualización del 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 principal (nombre del paquete) del plan básico que se desactivará.

productId

string

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

basePlanId

string

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

latencyTolerance

enum (ProductUpdateLatencyTolerance)

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