Method: purchases.voidedpurchases.list

Lista as compras que foram canceladas, reembolsadas ou estornadas.

Solicitação HTTP

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

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
packageName

string

O nome do pacote do app para o qual as compras anuladas precisam ser retornadas (por exemplo, "com.alguma.coisa").

Parâmetros de consulta

Parâmetros
pageSelection.maxResults

integer (uint32 format)

Define quantos resultados a operação de lista retornará. O número padrão depende da coleção de recursos.

pageSelection.startIndex

integer (uint32 format)

Define o índice do primeiro elemento a ser retornado. Só poderá ser usado se a paginação indexada estiver ativada.

pageSelection.token

string

Define o token da página a ser retornada, normalmente obtido da TokenPagination. Só poderá ser usado se a paginação de tokens estiver ativada.

startTime

string (int64 format)

A hora, em milésimos de segundo, desde a época, da compra anulada mais antiga que você quer ver na resposta. O valor desse parâmetro não pode ser anterior a 30 dias e será ignorado se um token de paginação for definido. O valor padrão é o horário atual menos 30 dias. Observação: esse filtro é aplicado no momento em que o registro é visto como anulado por nossos sistemas, e não no tempo anulado real retornado na resposta.

endTime

string (int64 format)

A hora, em milésimos de segundo, desde a época, da compra anulada mais recente que você quer ver na resposta. O valor desse parâmetro não pode ser maior que o horário atual e será ignorado se um token de paginação for definido. O valor padrão é o horário atual. Observação: esse filtro é aplicado no momento em que o registro é visto como anulado por nossos sistemas, e não no tempo anulado real retornado na resposta.

type

integer

O tipo de compras anuladas que você quer ver na resposta. Os valores possíveis são: 0. Somente compras de produtos no app anuladas serão retornadas na resposta. Esse é o valor padrão. 1. Tanto compras no app quanto compras de assinaturas anuladas serão retornadas na resposta.

Observação: antes de solicitar o recebimento de compras de assinatura anuladas, é necessário mudar para o orderId na resposta, que identifica exclusivamente compras e assinaturas únicas. Caso contrário, você receberá vários pedidos de assinatura com o mesmo PurchaseToken, porque os pedidos de renovação de assinatura compartilham o mesmo PurchaseToken.

includeQuantityBasedPartialRefund

boolean

Opcional. Indica se as compras anuladas de reembolsos parciais com base na quantidade serão incluídas, que são aplicáveis somente a compras de quantidade múltipla. Se verdadeiro, outras compras anuladas podem ser retornadas com "voidedQuantity", que indica a quantidade de reembolso de um reembolso parcial com base na quantidade. O valor padrão é falso.

Corpo da solicitação

O corpo da solicitação precisa estar vazio.

Corpo da resposta

Resposta para a API voidedpurchases.list.

Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:

Representação JSON
{
  "pageInfo": {
    object (PageInfo)
  },
  "tokenPagination": {
    object (TokenPagination)
  },
  "voidedPurchases": [
    {
      object (VoidedPurchase)
    }
  ]
}
Campos
pageInfo

object (PageInfo)

Informações gerais de paginação.

tokenPagination

object (TokenPagination)

Informações de paginação para a paginação de tokens.

voidedPurchases[]

object (VoidedPurchase)

Escopos de autorização

Requer o seguinte escopo OAuth:

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

PageSelection

Tipo do parâmetro de solicitação pageSelection que define quais e quantos resultados uma operação voidedpurchases.list deve retornar.

Representação JSON
{
  "maxResults": integer,
  "startIndex": integer,
  "token": string
}
Campos
maxResults

integer (uint32 format)

Define quantos resultados a operação de lista retornará. O número padrão depende da coleção de recursos.

startIndex

integer (uint32 format)

Define o índice do primeiro elemento a ser retornado. Só poderá ser usado se a paginação indexada estiver ativada.

token

string

Define o token da página a ser retornada, normalmente obtido da TokenPagination. Só poderá ser usado se a paginação de tokens estiver ativada.