Method: purchases.subscriptionsv2.revoke

subscriptionsv2.revoke a subscription purchase for the user.

Solicitud HTTP

POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/purchases/subscriptionsv2/tokens/{token}:revoke

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

Parámetros de ruta de acceso

Parámetros
packageName

string

Obligatorio. Es el paquete de la aplicación para la que se compró la suscripción (por ejemplo, "com.algo.algo").
token

string

Obligatorio. Es el token que se proporcionó al dispositivo del usuario cuando se compró la suscripción.

Cuerpo de la solicitud

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

Representación JSON 
{
  "revocationContext": {
    object (RevocationContext)
  }
}
Campos
revocationContext

object (RevocationContext)

Obligatorio. Detalles adicionales sobre la revocación de la suscripción.

Cuerpo de la respuesta

Si se ejecuta correctamente, el cuerpo de la respuesta está vacío.

Muestra

La siguiente es una solicitud de ejemplo:

curl -X POST \
  'https://androidpublisher.googleapis.com/androidpublisher/v3/applications/com.example.myapp/purchases/subscriptionsv2/tokens/sample_purchase_token:revoke' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "revocationContext": {
      "proratedRefund": {}
    }
  }'

Permisos de autorización

Requiere el siguiente alcance de OAuth:

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

RevocationContext

Contexto de revocación de la API de purchases.subscriptionsv2.revoke.

Representación JSON 
{

  // Union field RefundType can be only one of the following:
  "fullRefund": {
    object (FullRefund)
  },
  "proratedRefund": {
    object (ProratedRefund)
  },
  "itemBasedRefund": {
    object (ItemBasedRefund)
  }
  // End of list of possible types for union field RefundType.
}
Campos
Campo de unión RefundType. Determina el tipo de reembolso que se debe otorgar. Se debe especificar un tipo de reembolso como parte de una solicitud válida. Las direcciones (RefundType) solo pueden ser una de las siguientes opciones:
fullRefund

object (FullRefund)

Opcional. Se usa cuando los usuarios deben recibir un reembolso del importe total del cargo más reciente de cada artículo de la suscripción.
proratedRefund

object (ProratedRefund)

Opcional. Se utiliza cuando los usuarios tienen que recibir un reembolso de un importe prorrateado que pagaron por su suscripción en función del tiempo restante de la suscripción.
itemBasedRefund

object (ItemBasedRefund)

Opcional. Se usa cuando se debe reembolsar un elemento específico en una suscripción con elementos complementarios.

FullRefund

Este tipo no tiene campos.

Se usa para determinar si el tipo de reembolso de RevocationContext es un reembolso total.

ProratedRefund

Este tipo no tiene campos.

Se usa para determinar si el tipo de reembolso de RevocationContext es prorrateado.

ItemBasedRefund

Se usa para determinar qué elemento específico se debe revocar en una suscripción con varios elementos.

Representación JSON 
{
  "productId": string
}
Campos
productId

string

Obligatorio. Si la suscripción tiene complementos, el ID del producto del elemento de la suscripción que se revocará