REST Resource: accounts.locations.reviews

Recurso: Review

Apenas saída. Representa uma avaliação de um local.

Representação JSON
{
  "name": string,
  "reviewId": string,
  "reviewer": {
    object (Reviewer)
  },
  "starRating": enum (StarRating),
  "comment": string,
  "createTime": string,
  "updateTime": string,
  "reviewReply": {
    object (ReviewReply)
  },
  "reviewMediaItems": [
    {
      object (ReviewMediaItem)
    }
  ]
}
Campos
name

string

O nome do recurso. Para a revisão, ele está no formato accounts/{accountId}/locations/{locationId}/reviews/{reviewId}.

reviewId

string

O identificador exclusivo criptografado.

reviewer

object (Reviewer)

É o autor da avaliação.

starRating

enum (StarRating)

A nota da avaliação.

comment

string

O corpo da avaliação como texto simples com marcações.

createTime

string (Timestamp format)

O carimbo de data/hora em que a avaliação foi escrita.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de "Z", outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".

updateTime

string (Timestamp format)

O carimbo de data/hora da última modificação da avaliação.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de "Z", outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".

reviewReply

object (ReviewReply)

A resposta do proprietário/gerente deste local a esta avaliação.

reviewMediaItems[]

object (ReviewMediaItem)

Apenas saída. Os itens de mídia associados à avaliação.

Revisor

Representa o autor da avaliação.

Representação JSON
{
  "profilePhotoUrl": string,
  "displayName": string,
  "isAnonymous": boolean
}
Campos
profilePhotoUrl

string

O link da foto do perfil do avaliador. Preenchido apenas se isAnonymous for falso.

displayName

string

O nome do avaliador. Preenchido apenas com o nome real do avaliador se isAnonymous for falso.

isAnonymous

boolean

Indica se o avaliador optou por permanecer anônimo.

StarRating

A nota de até cinco estrelas, em que cinco é a mais alta.

Tipos enumerados
STAR_RATING_UNSPECIFIED Não especificado.
ONE Uma estrela de, no máximo, cinco.
TWO Duas estrelas de, no máximo, cinco.
THREE Três estrelas de, no máximo, cinco.
FOUR Quatro estrelas de, no máximo, cinco.
FIVE A nota máxima.

ReviewReply

Representa a resposta do proprietário/gerente do local a uma avaliação.

Representação JSON
{
  "comment": string,
  "updateTime": string,
  "reviewReplyState": enum (State),
  "policyViolation": enum (PolicyViolation)
}
Campos
comment

string

O corpo da resposta como texto simples com marcações. O comprimento máximo é de 4096 bytes.

updateTime

string (Timestamp format)

Apenas saída. O carimbo de data/hora da última modificação da resposta.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de "Z", outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".

reviewReplyState

enum (State)

Apenas saída. O estado da resposta à avaliação.

policyViolation

enum (PolicyViolation)

Opcional. Apenas saída. A violação da política que resultou na rejeição. Preenchido apenas se "reviewReplyState" for "REJECTED".

Estado

Representa o estado de moderação de uma resposta a uma avaliação.

Tipos enumerados
REVIEW_REPLY_STATE_UNSPECIFIED Indica que o estado não foi especificado.
PENDING Indica que a resposta está pendente de moderação.
REJECTED Indica que a resposta foi rejeitada.
APPROVED Indica que a resposta foi aprovada.

PolicyViolation

Representa violações de política padronizadas. Novos valores podem ser adicionados no futuro. Os clientes precisam estar preparados para processar valores desconhecidos.

Tipos enumerados
POLICY_VIOLATION_UNSPECIFIED Representa uma violação de política não especificada.
ACCOUNT_RESTRICTED_AND_SUSPENDED Uma Conta do Google associada a este Perfil da Empresa foi restrita, resultando na suspensão do perfil.
ACCOUNT_RESTRICTED_AND_EDIT_REJECTED Uma Conta do Google associada a este Perfil da Empresa foi restrita, o que fez com que as edições fossem rejeitadas. Ao contrário de ACCOUNT_RESTRICTED_AND_SUSPENDED, o Perfil da Empresa permanece ativo e não é suspenso.
ASSOCIATED_ACCOUNT_SUSPENDED Uma Conta do Google associada a este Perfil da Empresa está em situação irregular. Os perfis vinculados a ela foram suspensos.
BUSINESS_INELIGIBLE Sua empresa não pode ter um Perfil da Empresa.
OWNERSHIP_REVOKED Outra Conta do Google reivindicou este Perfil da Empresa. Não é mais possível gerenciar esse perfil.
LOCATION_SUSPENDED Este Perfil da Empresa foi suspenso.
LOCATION_DISABLED Este Perfil da Empresa foi desativado.
LOCATION_VERIFICATION_REQUIRED Este Perfil da Empresa não foi verificado.
PO_BOX Seu Perfil da Empresa foi suspenso porque o endereço comercial não pode ser uma caixa postal.
GOOGLE_PAY_SUSPENSION Os Perfis de Empresas associados ao seu perfil para pagamentos foram suspensos.
EDITING_RESTRICTION No momento, este Perfil da Empresa não pode receber atualizações públicas. O Google desativou a edição para esse local para evitar conteúdo que viola a política.
ILLEGAL_BUSINESS_HOURS_EDIT Não é possível editar o horário de funcionamento da sua categoria de negócios.
FAKE_ENGAGEMENT Não é permitido publicar conteúdo que viole nossa política contra engajamento falso. Isso inclui conteúdo incentivado, conteúdo com a intenção de manipular a classificação de um lugar e outros tipos de conteúdo que não representam uma experiência autêntica.
ADULT_THEMED Não é permitido publicar materiais que violem nossa política sobre conteúdo adulto. Os temas adultos incluem conteúdo sexual não explícito e outros tipos de conteúdo para maiores.
SEXUALLY_EXPLICIT Não é permitido publicar materiais que violem nossa política sobre conteúdo sexualmente explícito. Isso inclui nudez genital, representações ou descrições de atos sexuais.
ADVERTISING_AND_SOLICITATION Não é permitido publicar conteúdo que viole nossa política de publicidade ou solicitação. Isso inclui material promocional ou comercial ou postado em troca de benefícios.
DANGEROUS Não é permitido publicar materiais que violem nossa política sobre conteúdo perigoso. Isso inclui promover, facilitar ou incentivar atos nocivos.
GIBBERISH_AND_REPETITIVE Não é permitido publicar materiais que violem nossa política contra conteúdo confuso ou repetitivo. Isso inclui diluir as informações úteis que estão disponíveis no Google.
REPETITIVE Não é permitido publicar materiais que violem nossa política contra conteúdo repetitivo. Nesse sentido, está incluído o envio de material idêntico ou similar várias vezes por uma ou mais contas.
UNCLEAR Não é permitido publicar materiais que violem nossa política contra conteúdo confuso. Isso inclui caracteres aleatórios ou outro material sem significado.
ILLEGAL Não é permitido publicar materiais que violem nossa política sobre conteúdo ilegal.
OFF_TOPIC Não é permitido publicar materiais que violem nossa política sobre conteúdo sem relação com o tema. Isso inclui comentários gerais, políticos ou sociais e reclamações pessoais.
OFFENSIVE Não é permitido publicar materiais que violem nossa política sobre conteúdo ofensivo. ou seja, que pode suscitar, de forma razoável, raiva, ofensa ou desrespeito a outras pessoas.
VIOLENCE_AND_GORE Não é permitido publicar conteúdo que viole nossa política contra violência ou imagens sangrentas. Isso inclui conteúdo que mostra pessoas ou animais de forma explícita e retrata atos realistas de violência, sangue, partes do corpo ou vísceras.
CHILD_SAFETY Não é permitido publicar conteúdo que viole nossa política sobre segurança infantil. Isso inclui material que coloque em risco, explore ou assedie crianças, ou use os Serviços do Google para colocar crianças em risco.
HARASSMENT Não é permitido publicar conteúdo que viole nossa política de assédio. Isso inclui intimidar, ameaçar, sexualizar ou fazer com que uma pessoa tema pela própria segurança.
HATE_SPEECH Não é permitido publicar conteúdo que viole nossa política sobre discurso de ódio. Isso inclui promover ou tolerar violência, discriminação ou depreciação ou incitar o ódio com base em uma característica protegida ou outras características associadas à marginalização ou discriminação sistêmica.
IMPERSONATION Não é permitido publicar conteúdo que viole nossa política de falsificação de identidade. ou seja, assumir uma identidade falsa para enganar as pessoas ou ter benefícios indevidos.
MISINFORMATION Não é permitido publicar conteúdo que viole nossa política de desinformação. Isso inclui informação falsa ou incorreta que pode causar danos significativos a indivíduos, a empresas ou à sociedade.
MISREPRESENTATION Não é permitido publicar conteúdo que viole nossa política sobre deturpação. Isso inclui declarações enganosas ou omissões para conseguir benefícios indevidos.
OBSCENITY_AND_PROFANITY Não é permitido publicar conteúdo que viole nossa política sobre obscenidade ou linguagem obscena. Isso inclui palavras ou gestos considerados localmente ofensivos ou vulgares.
PERSONAL_INFO Não é permitido publicar conteúdo que viole nossa política sobre informações pessoais. Isso inclui informações particulares ou confidenciais, como detalhes do cartão de crédito, históricos médicos ou documento de identidade oficial, sejam seus ou de outra pessoa.
REGULATED_GOODS_AND_SERVICES Não é permitido publicar conteúdo que viole nossa política sobre produtos e serviços regulamentados. Isso inclui calls-to-action ou ofertas para a venda de produtos ou serviços sujeitos à legislação local.
GENERIC_VANDALISM Não é permitido publicar conteúdo que viole nossas políticas contra conteúdo abusivo ou de baixa qualidade.
GENERIC_FRAUD Não permitimos conteúdo que viole nossas políticas sobre conteúdo e comportamento enganosos. ou seja, que confunda intencionalmente as pessoas.
PHOTOS_AND_VIDEOS_CRITERIA Não é permitido publicar conteúdo que viole nossos requisitos de foto e vídeo.
MODERATION_ERROR Ocorreu um erro ao processar seu conteúdo.
PRIVACY Não é permitido publicar materiais que violem a Política de Privacidade sobre conteúdo de contribuições de usuários do Maps.
GENERIC_VIOLATION Seu conteúdo não é permitido porque viola nossas políticas.
GENERIC_QUALITY Não é permitido publicar conteúdo que viole nossas políticas sobre conteúdo de baixa qualidade.
IDENTITY_CHANGE A mudança feita por você é muito diferente da empresa criada. Isso viola nossa política.
GEOGRAPHIC_LOCATION_CHANGE Indica que a localização geográfica física (endereço ou latitude/longitude) da empresa mudou significativamente desde a criação do perfil.

ReviewMediaItem

Representa um item de mídia (foto ou vídeo) associado a uma avaliação.

Representação JSON
{
  "thumbnailUrl": string,
  "thumbnailLabel": string,
  "videoUrl": string
}
Campos
thumbnailUrl

string

Apenas saída. URL do FIFE para a foto ou miniatura do vídeo, se videoUrl estiver presente.

thumbnailLabel

string

Apenas saída. Rótulo fornecido pelo autor para o thumbnailUrl.

videoUrl

string

Apenas saída. URL de vídeo reproduzível.

Métodos

deleteReply

Exclui a resposta à avaliação especificada.

get

Retorna a avaliação especificada.

list

Retorna a lista paginada de avaliações do local especificado.

updateReply

Atualiza a resposta à avaliação especificada.