REST Resource: reviews

Recurso: Review

Opinión de una app para Android.

Representación JSON 
{
  "reviewId": string,
  "authorName": string,
  "comments": [
    {
      object (Comment)
    }
  ]
}
Campos
reviewId

string

Identificador único de esta opinión.
authorName

string

Nombre del usuario que escribió la opinión.
comments[]

object (Comment)

Es un campo repetido que contiene comentarios de la opinión.

Comentario

Es una entrada de conversación entre el usuario y el desarrollador.

Representación 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ón comment.

comment puede ser una de las siguientes opciones:
userComment

object (UserComment)

Comentario de un usuario.
developerComment

object (DeveloperComment)

Comentario de un desarrollador.

UserComment

Entrada del usuario en la conversación con el desarrollador.

Representación 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

Contenido del comentario, es decir, el cuerpo de la opinión. En algunos casos, los usuarios pueden escribir una opinión con un título y un cuerpo independientes. De ser así, el título y el cuerpo aparecen concatenados y los separa un carácter de tabulación.
lastModified

object (Timestamp)

Fecha y hora más reciente en la que se actualizó el comentario.
starRating

integer

Calificación por estrellas asociada a la opinión; varía de 1 a 5.
reviewerLanguage

string

Código de idioma para el usuario que deja la opinión. Esta información se obtiene de la configuración del dispositivo, por lo que no se garantiza que coincida con el idioma en que está escrita la opinión. Podría no estar presente.
device

string

Nombre interno del dispositivo del usuario que deja la opinión, p.ej., klte, flounder. Podría no estar presente.
androidOsVersion

integer

Versión del SDK de Android (número entero) del dispositivo del usuario en el momento en que se escribió la opinión, p.ej., 23 es Marshmallow. Podría no estar presente.
appVersionCode

integer

Código de la versión (número entero) de la app que estaba instalada en el momento en que se escribió la opinión. Podría no estar presente.
appVersionName

string

Nombre de la versión (cadena) de la app que estaba instalada en el momento en que se escribió la opinión. Podría no estar presente.
thumbsUpCount

integer

Cantidad de usuarios que indicaron que les gusta esta opinión.
thumbsDownCount

integer

Cantidad de usuarios que indicaron que no les gusta esta opinión.
deviceMetadata

object (DeviceMetadata)

Es información sobre las características del dispositivo del usuario.
originalText

string

Texto sin traducir de la opinión, en caso de que esta estuviera traducida. Si la opinión no se tradujo, este campo se deja vacío.

Marca de tiempo

Marca de tiempo que representa un punto en el tiempo independiente de cualquier zona horaria o calendario local, codificada como un recuento de segundos y fracciones de segundos con una resolución de nanosegundos. El recuento se basa en una época determinada a la medianoche (UTC) del 1 de enero de 1970.

Representación JSON 
{
  "seconds": string,
  "nanos": integer
}
Campos
seconds

string (int64 format)

Representa los segundos de la hora UTC desde la época de Unix.
nanos

integer

Fracciones no negativas de un segundo a una resolución de nanosegundos. Debe ser de 0 a 999,999,999 inclusive.

DeviceMetadata

Son las características del dispositivo del usuario.

Representación 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

Nombre del modelo del dispositivo (p.ej., Droid)
manufacturer

string

Fabricante del dispositivo (p.ej., Motorola)
deviceClass

string

Clase del dispositivo (p.ej., tablet)
screenWidthPx

integer

Ancho de la pantalla en píxeles
screenHeightPx

integer

Altura de la pantalla en píxeles
nativePlatform

string

Lista separada por comas de plataformas nativas (p. ej., "arm", "arm7").
screenDensityDpi

integer

Densidad de la pantalla en DPI
glEsVersion

integer

Versión de OpenGL
cpuModel

string

Modelo de CPU del dispositivo, p. ej., "MSM8974".
cpuMake

string

Marca de CPU del dispositivo, p. ej., "Qualcomm".
ramMb

integer

RAM en megabytes del dispositivo, p. ej., "2048".

DeveloperComment

Entrada del desarrollador en la conversación con el usuario.

Representación JSON 
{
  "text": string,
  "lastModified": {
    object (Timestamp)
  }
}
Campos
text

string

Contenido del comentario, es decir, el cuerpo de la respuesta.
lastModified

object (Timestamp)

Fecha y hora más reciente en la que se actualizó el comentario.

Métodos

get

 Obtiene una sola opinión.

list

 Enumera todas las opiniones.

reply

 Responde a una sola opinión o actualiza una respuesta existente.

Códigos de error

Las operaciones de este recurso devuelven los siguientes códigos de error HTTP:

Código de error Motivo Descripción Solución
400 invalidValue Se proporcionó un valor no válido en la solicitud. A menudo, se devuelve para un token de compra con formato incorrecto o no válido. Corrige el valor del campo no válido en el cuerpo o los parámetros de la solicitud según la referencia de la API.
400 required Falta un campo o parámetro obligatorio en la solicitud. Consulta la documentación de la API para asegurarte de que se incluyan todos los campos y parámetros obligatorios.
403 userInsufficientPermission El usuario no tiene permisos suficientes para realizar la operación solicitada. Asegúrate de que el usuario autenticado tenga los permisos necesarios en Google Play Console. Consulta Cómo usar una cuenta de servicio para obtener más detalles.
404 notFound No se encontró el recurso solicitado. Verifica que los identificadores (p.ej., token de compra, nombre del paquete, ID de producto, ID de suscripción) sean correctos.
409 concurrentUpdate Se intentó actualizar un objeto que se está actualizando de forma simultánea. Vuelve a intentarlo con una retirada exponencial. Evita las modificaciones simultáneas en el mismo recurso.
5xx Generic error Error genérico en el servidor de Google Play. Vuelve a intentar enviar tu solicitud.

Si el problema persiste, comunícate con tu administrador de cuentas de Google Play o envía una solicitud de asistencia. Considera consultar el Panel de estado de Play para ver si hay interrupciones conocidas.