REST Resource: reviews

Recurso: Review

A avaliação de um app Android.

Representação JSON 
{
  "reviewId": string,
  "authorName": string,
  "comments": [
    {
      object (Comment)
    }
  ]
}
Campos
reviewId

string

Identificador exclusivo para essa avaliação.
authorName

string

O nome do usuário que escreveu a avaliação.
comments[]

object (Comment)

Um campo repetido com os comentários para a avaliação.

Comentário

Uma entrada da conversa entre o usuário e o desenvolvedor.

Representação JSON 
{

  // Union field comment can be only one of the following:
  "userComment": {
    object (UserComment)
  },
  "developerComment": {
    object (DeveloperComment)
  }
  // End of list of possible types for union field comment.
}
Campos

Campo de união comment.

comment pode ser apenas de um dos tipos a seguir:
userComment

object (UserComment)

Um comentário de um usuário.
developerComment

object (DeveloperComment)

Um comentário do desenvolvedor.

UserComment

Entrada do usuário da conversa dele com o desenvolvedor.

Representação JSON 
{
  "text": string,
  "lastModified": {
    object (Timestamp)
  },
  "starRating": integer,
  "reviewerLanguage": string,
  "device": string,
  "androidOsVersion": integer,
  "appVersionCode": integer,
  "appVersionName": string,
  "thumbsUpCount": integer,
  "thumbsDownCount": integer,
  "deviceMetadata": {
    object (DeviceMetadata)
  },
  "originalText": string
}
Campos
text

string

O conteúdo do comentário, ou seja, texto da avaliação. Em alguns casos, os usuários escrevem a avaliação com título e texto separados, que são concatenados e separados por um caractere de tabulação.
lastModified

object (Timestamp)

A data e hora em que esse comentário foi atualizado pela última vez.
starRating

integer

A nota associada à avaliação, de 1 a 5.
reviewerLanguage

string

Código do idioma de quem fez a avaliação. Essa informação é extraída das configurações do dispositivo, então nem sempre corresponde ao idioma da avaliação. Pode estar ausente.
device

string

O codinome do dispositivo do avaliador, como klte e flounder. Pode estar ausente.
androidOsVersion

integer

Número inteiro que corresponde à versão do SDK do Android no dispositivo do usuário quando a avaliação foi escrita, por exemplo, 23 é Marshmallow. Pode estar ausente.
appVersionCode

integer

Número inteiro que corresponde ao código da versão do app instalado quando a avaliação foi escrita. Pode estar ausente.
appVersionName

string

Nome da versão da string do app conforme instalado quando a avaliação foi escrita. Pode estar ausente.
thumbsUpCount

integer

Número de usuários que gostaram da avaliação.
thumbsDownCount

integer

Número de usuários que não gostaram da avaliação.
deviceMetadata

object (DeviceMetadata)

Informações sobre as características do dispositivo do usuário.
originalText

string

Texto não traduzido da avaliação, quando há tradução. Caso contrário, esse campo fica em branco.

Carimbo de data/hora

O recurso Timestamp representa um ponto no tempo independente de qualquer fuso horário ou calendário local, codificado como um número de segundos e frações de segundos com resolução de nanossegundos. O número se refere a uma época em 1º de janeiro de 1970, à meia-noite no horário UTC.

Representação JSON 
{
  "seconds": string,
  "nanos": integer
}
Campos
seconds

string (int64 format)

Representa segundos do horário UTC desde a época Unix.
nanos

integer

Frações não negativas de um segundo com resolução de nanossegundos. O valor precisa ser de 0 a 999.999.999 (inclusive).

DeviceMetadata

Características do dispositivo do usuário.

Representação JSON 
{
  "productName": string,
  "manufacturer": string,
  "deviceClass": string,
  "screenWidthPx": integer,
  "screenHeightPx": integer,
  "nativePlatform": string,
  "screenDensityDpi": integer,
  "glEsVersion": integer,
  "cpuModel": string,
  "cpuMake": string,
  "ramMb": integer
}
Campos
productName

string

Nome do modelo do dispositivo (por exemplo, Droid).
manufacturer

string

Fabricante do dispositivo (por exemplo, Motorola).
deviceClass

string

Classe do dispositivo (por exemplo, tablet).
screenWidthPx

integer

Largura da tela em pixels.
screenHeightPx

integer

Altura da tela em pixels.
nativePlatform

string

Lista separada por vírgulas de plataformas nativas (por exemplo, "arm", "arm7")
screenDensityDpi

integer

Densidade da tela em DPI.
glEsVersion

integer

Versão do OpenGL
cpuModel

string

Modelo de CPU do dispositivo, por exemplo, MSM8974.
cpuMake

string

Marca da CPU do dispositivo, por exemplo, Qualcomm.
ramMb

integer

RAM do dispositivo em megabytes, por exemplo, 2048.

DeveloperComment

Entrada do desenvolvedor da conversa dele com o usuário.

Representação JSON 
{
  "text": string,
  "lastModified": {
    object (Timestamp)
  }
}
Campos
text

string

O conteúdo do comentário, ou seja, texto da resposta.
lastModified

object (Timestamp)

A data e hora em que esse comentário foi atualizado pela última vez.

Métodos

get

 Recebe uma única avaliação.

list

 Lista todas as avaliações.

reply

 Responde a uma única avaliação ou atualiza uma resposta.

Códigos de erro

As operações desse recurso retornam os seguintes códigos de erro HTTP:

Código do erro Motivo Descrição Resolução
400 invalidValue Um valor inválido foi fornecido na solicitação. Geralmente, isso é retornado para um token de compra malformado ou inválido. Corrija o valor do campo inválido no corpo ou nos parâmetros da solicitação com base na referência da API.
400 required Um campo ou parâmetro obrigatório está faltando na solicitação. Consulte a documentação da API para garantir que todos os campos e parâmetros obrigatórios estejam incluídos.
403 userInsufficientPermission O usuário não tem permissão suficiente para realizar a operação solicitada. Confira se o usuário autenticado tem as permissões necessárias no Google Play Console. Consulte Como usar uma conta de serviço para mais detalhes.
404 notFound Não foi possível encontrar o recurso solicitado. Verifique se os identificadores (por exemplo, token de compra, nome do pacote, ID do produto, ID da assinatura) estão corretos.
409 concurrentUpdate Houve uma tentativa de atualizar um objeto que está sendo atualizado simultaneamente. Tente de novo com uma espera exponencial. Evite modificações simultâneas no mesmo recurso.
5xx Generic error Erro genérico no servidor do Google Play. Tente fazer a solicitação novamente.

Se o problema persistir, entre em contato com seu gerente de contas do Google Play ou envie uma solicitação de suporte. Confira o Painel de status do Google Play para saber se há falhas conhecidas.