Method: purchases.voidedpurchases.list

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

Indica las compras que se cancelaron, reembolsaron o 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.alguna.cosa').

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á, generalmente tomado de TokenPagination. Solo se puede usar si la paginación de tokens 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 en el tiempo real anulado 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 quieras 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 en el tiempo real anulado 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 anuladas de productos integrados en la aplicación. Este es el valor predeterminado. 1. Tanto las compras directas desde la aplicación como las compras de suscripciones anuladas se mostrarán en la respuesta.

Nota: Antes de solicitar la recepción de compras de suscripciones anuladas, debes cambiar para usar orderId en la respuesta, que identifica exclusivamente 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 suscripción comparten el mismo PurchaseToken.

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de la respuesta

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

Respuesta de la API de voidedpurchases.list.

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

object (PageInfo)

Información general de paginación.

tokenPagination

object (TokenPagination)

Información de paginación para la paginación de tokens.

voidedPurchases[]

object (VoidedPurchase)

Alcances de la autorización

Requiere el siguiente alcance de OAuth:

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

Selección de página

Es el tipo de parámetro de solicitud pageSelection que define cuáles y cuántos resultados debe mostrar una operación apks.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á, generalmente tomado de TokenPagination. Solo se puede usar si la paginación de tokens está habilitada.