Method: purchases.voidedpurchases.list

Enumera las compras que se cancelaron, reembolsaron o se reembolsaron.

Solicitud HTTP

GET https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/purchases/voidedpurchases

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

Parámetros de ruta de acceso

Parámetros
packageName

string

Es el nombre del paquete de la aplicación para la que se deben devolver las compras anuladas (por ejemplo, "com.algo").

Parámetros de consulta

Parámetros
pageSelection.maxResults

integer (uint32 format)

Define cuántos resultados debe mostrar la operación de lista. La cantidad predeterminada depende de la colección de recursos.

pageSelection.startIndex

integer (uint32 format)

Define el índice del primer elemento que se mostrará. Solo se puede usar si la paginación indexada está habilitada.

pageSelection.token

string

Define el token de la página que se mostrará, que generalmente se toma de TokenPagination. Solo se puede usar si la paginación del token está habilitada.

startTime

string (int64 format)

Indica el tiempo (en milisegundos desde la época) de la compra anulada más antigua que quieras ver en la respuesta. El valor de este parámetro no puede tener más de 30 días y se ignora si se configura un token de paginación. El valor predeterminado es la hora actual menos 30 días. Nota: Este filtro se aplica en el momento en que nuestros sistemas consideran que el registro anuló, y no el tiempo de anulación real que se muestra en la respuesta.

endTime

string (int64 format)

Indica el tiempo (en milisegundos desde la época) de la compra anulada más reciente que quieres ver en la respuesta. El valor de este parámetro no puede ser mayor que la hora actual y se ignora si se configura un token de paginación. El valor predeterminado es la hora actual. Nota: Este filtro se aplica en el momento en que nuestros sistemas consideran que el registro anuló, y no el tiempo de anulación real que se muestra en la respuesta.

type

integer

Es el tipo de compras anuladas que quieres ver en la respuesta. Los valores posibles son: 0. En la respuesta, solo se mostrarán las compras de productos integrados en la aplicación que se hayan anulado. Este es el valor predeterminado. 1. En la respuesta se mostrarán tanto las compras directas desde la aplicación como las compras de suscripción anuladas.

Nota: Antes de solicitar la recepción de compras de suscripciones anuladas, debes cambiar a orderId en la respuesta, ya que identifica las suscripciones y compras únicas. De lo contrario, recibirás varios pedidos de suscripción con el mismo PurchaseToken, ya que los pedidos de renovación de suscripciones comparten el mismo PurchaseToken.

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de la respuesta

Respuesta de la API de voidedpurchases.list.

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

Representación JSON
{
  "pageInfo": {
    object (PageInfo)
  },
  "tokenPagination": {
    object (TokenPagination)
  },
  "voidedPurchases": [
    {
      object (VoidedPurchase)
    }
  ]
}
Campos
pageInfo

object (PageInfo)

Información de paginación general

tokenPagination

object (TokenPagination)

Información de paginación para la paginación del token.

voidedPurchases[]

object (VoidedPurchase)

Permisos de autorización

Requiere el siguiente alcance de OAuth:

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

Selección de página

Tipo del parámetro de solicitud pageSelection que define cuál y cuántos resultados debe mostrar una operación voidedpurchases.list.

Representación JSON
{
  "maxResults": integer,
  "startIndex": integer,
  "token": string
}
Campos
maxResults

integer (uint32 format)

Define cuántos resultados debe mostrar la operación de lista. La cantidad predeterminada depende de la colección de recursos.

startIndex

integer (uint32 format)

Define el índice del primer elemento que se mostrará. Solo se puede usar si la paginación indexada está habilitada.

token

string

Define el token de la página que se mostrará, que generalmente se toma de TokenPagination. Solo se puede usar si la paginación del token está habilitada.