- Solicitud HTTP
- Parámetros de ruta de acceso
- Parámetros de consulta
- Cuerpo de la solicitud
- Cuerpo de la respuesta
- Alcances de la autorización
- PageSelection
- Pruébala
Enumera las compras que se cancelaron, se reembolsaron o se devolvieron los cargos.
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 |
Es el nombre del paquete de la aplicación para la que se deben devolver las compras anuladas (por ejemplo, "com.algo.algo"). |
Parámetros de consulta
Parámetros | |
---|---|
pageSelection.maxResults |
Define cuántos resultados debe mostrar la operación de lista. El número predeterminado depende de la colección de recursos. |
pageSelection.startIndex |
Define el índice del primer elemento que se mostrará. Solo se puede usar si está habilitada la paginación indexada. |
pageSelection.token |
Define el token de la página que se mostrará, por lo general, tomado de TokenPagination. Solo se puede usar si está habilitada la paginación de tokens. |
startTime |
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 el que nuestros sistemas consideran que se anuló el registro y no en el tiempo que se anuló realmente en la respuesta. |
endTime |
Indica el tiempo (en milisegundos desde el ciclo de entrenamiento) 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 el que nuestros sistemas consideran que se anuló el registro y no en el tiempo que se anuló realmente en la respuesta. |
type |
Indica el tipo de compras anuladas que quieres ver en la respuesta. Los valores posibles son 0. En la respuesta, solo se devolverán las compras anuladas de productos integrados en la aplicación. Este es el valor predeterminado. 1. En la respuesta, se mostrarán las compras directas desde la aplicación y las compras de suscripciones anuladas. Nota: Antes de solicitar la recepción de compras de suscripciones anuladas, debes usar orderId en la respuesta, ya que identifica de forma única las compras y suscripciones ú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. |
includeQuantityBasedPartialRefund |
Opcional. Indica si se deben incluir compras anuladas de reembolsos parciales basados en la cantidad, que se aplican solo a las compras de varias cantidades. Si es verdadero, las compras anuladas adicionales se pueden devolver con voidedQuantity, que indica la cantidad de reembolsos de un reembolso parcial basado en la cantidad. El valor predeterminado es falso. |
Cuerpo de la solicitud
El cuerpo de la solicitud debe estar vacío.
Cuerpo de la respuesta
Respuesta para 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 ( |
Campos | |
---|---|
pageInfo |
Información general sobre paginación |
tokenPagination |
Información de paginación para la paginación de tokens |
voidedPurchases[] |
|
Permisos de autorización
Requiere el siguiente alcance de OAuth:
https://www.googleapis.com/auth/androidpublisher
PageSelection
Es el tipo del parámetro de solicitud pageSelection que define qué resultados debe mostrar una operación voidedpurchases.list y cuántos resultados debe mostrar.
Representación JSON |
---|
{ "maxResults": integer, "startIndex": integer, "token": string } |
Campos | |
---|---|
maxResults |
Define cuántos resultados debe mostrar la operación de lista. El número predeterminado depende de la colección de recursos. |
startIndex |
Define el índice del primer elemento que se mostrará. Solo se puede usar si está habilitada la paginación indexada. |
token |
Define el token de la página que se mostrará, por lo general, tomado de TokenPagination. Solo se puede usar si está habilitada la paginación de tokens. |