A API
Google Business Performance tem um
NOVO método de API que permite buscar várias "DailyMetrics" em uma única solicitação de API.
Confira a
programação de descontinuação e instruções para migrar do método de API reportInsights v4 para a API Google Business Profile Performance.
REST Resource: accounts.locations.reviews
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Recurso: revisão
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)
}
} |
| Campos |
name |
string
O nome do recurso. Para 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.
|
createTime |
string (Timestamp format)
O carimbo de data/hora de quando a avaliação foi escrita. Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
|
updateTime |
string (Timestamp format)
O carimbo de data/hora da última modificação da avaliação. Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
|
reviewReply |
object (ReviewReply)
O proprietário/gerente da resposta desse local a esta 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.
| Enums |
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
} |
| Campos |
updateTime |
string (Timestamp format)
Apenas saída. O carimbo de data/hora da última modificação da resposta. Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
|
Métodos |
|
|
Exclui a resposta da avaliação especificada. |
|
|
Retorna a avaliação especificada. |
|
|
Retorna a lista paginada de avaliações do local especificado. |
|
|
Atualiza a resposta à avaliação especificada. |
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-07-25 UTC.
[null,null,["Última atualização 2025-07-25 UTC."],[[["\u003cp\u003eThis document outlines the structure and properties of a Google My Business review, including details about the reviewer, star rating, and any replies.\u003c/p\u003e\n"],["\u003cp\u003eReviews can be retrieved, listed, and have their replies updated or deleted using the provided methods.\u003c/p\u003e\n"],["\u003cp\u003eReview data includes timestamps for creation and updates, as well as the review text and star rating.\u003c/p\u003e\n"],["\u003cp\u003eReviewers can choose to remain anonymous, impacting the visibility of their profile information.\u003c/p\u003e\n"],["\u003cp\u003eLocation owners/managers can reply to reviews, and these replies also have timestamps for tracking modifications.\u003c/p\u003e\n"]]],["This document details the structure of location reviews, including the review itself, the reviewer, and any replies. A review includes a `reviewId`, `starRating`, textual `comment`, and timestamps for creation and updates. The reviewer has a `displayName`, `profilePhotoUrl`, and anonymity status. The reply includes a `comment` and its last update time. The document also outlines methods to delete, get, list, and update replies to reviews.\n"],null,["# REST Resource: accounts.locations.reviews\n\n- [Resource: Review](#Review)\n - [JSON representation](#Review.SCHEMA_REPRESENTATION)\n- [Reviewer](#Reviewer)\n - [JSON representation](#Reviewer.SCHEMA_REPRESENTATION)\n- [StarRating](#StarRating)\n- [ReviewReply](#ReviewReply)\n - [JSON representation](#ReviewReply.SCHEMA_REPRESENTATION)\n- [Methods](#METHODS_SUMMARY)\n\nResource: Review\n----------------\n\nOutput only. Represents a review for a location.\n\n| JSON representation ||\n|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---|\n| ``` { \"name\": string, \"reviewId\": string, \"reviewer\": { object (/my-business/reference/rest/v4/accounts.locations.reviews#Reviewer) }, \"starRating\": enum (/my-business/reference/rest/v4/accounts.locations.reviews#StarRating), \"comment\": string, \"createTime\": string, \"updateTime\": string, \"reviewReply\": { object (/my-business/reference/rest/v4/accounts.locations.reviews#ReviewReply) } } ``` |\n\n| Fields ||\n|---------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `name` | `string` The resource name. For Review it is of the form `accounts/{accountId}/locations/{locationId}/reviews/{reviewId}` |\n| `reviewId` | `string` The encrypted unique identifier. |\n| `reviewer` | `object (`[Reviewer](/my-business/reference/rest/v4/accounts.locations.reviews#Reviewer)`)` The author of the review. |\n| `starRating` | `enum (`[StarRating](/my-business/reference/rest/v4/accounts.locations.reviews#StarRating)`)` The star rating of the review. |\n| `comment` | `string` The body of the review as plain text with markups. |\n| `createTime` | `string (`[Timestamp](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.Timestamp)` format)` The timestamp for when the review was written. A timestamp in RFC3339 UTC \"Zulu\" format, with nanosecond resolution and up to nine fractional digits. Examples: `\"2014-10-02T15:01:23Z\"` and `\"2014-10-02T15:01:23.045123456Z\"`. |\n| `updateTime` | `string (`[Timestamp](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.Timestamp)` format)` The timestamp for when the review was last modified. A timestamp in RFC3339 UTC \"Zulu\" format, with nanosecond resolution and up to nine fractional digits. Examples: `\"2014-10-02T15:01:23Z\"` and `\"2014-10-02T15:01:23.045123456Z\"`. |\n| `reviewReply` | `object (`[ReviewReply](/my-business/reference/rest/v4/accounts.locations.reviews#ReviewReply)`)` The owner/manager of this location's reply to this review. |\n\nReviewer\n--------\n\nRepresents the author of the review.\n\n| JSON representation ||\n|--------------------------------------------------------------------------------------|---|\n| ``` { \"profilePhotoUrl\": string, \"displayName\": string, \"isAnonymous\": boolean } ``` |\n\n| Fields ||\n|-------------------|------------------------------------------------------------------------------------------------------------|\n| `profilePhotoUrl` | `string` The profile photo link of the reviewer. Only populated if `isAnonymous` is false. |\n| `displayName` | `string` The name of the reviewer. Only populated with the reviewer's real name if `isAnonymous` is false. |\n| `isAnonymous` | `boolean` Indicates whether the reviewer has opted to remain anonymous. |\n\nStarRating\n----------\n\nThe star rating out of five, where five is the highest rated.\n\n| Enums ||\n|---------------------------|---------------------------------------|\n| `STAR_RATING_UNSPECIFIED` | Not specified. |\n| `ONE` | One star out of a maximum of five. |\n| `TWO` | Two stars out of a maximum of five. |\n| `THREE` | Three stars out of a maximum of five. |\n| `FOUR` | Four stars out of a maximum of five. |\n| `FIVE` | The maximum star rating. |\n\nReviewReply\n-----------\n\nRepresents the location owner/manager's reply to a review.\n\n| JSON representation ||\n|-----------------------------------------------------|---|\n| ``` { \"comment\": string, \"updateTime\": string } ``` |\n\n| Fields ||\n|--------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `comment` | `string` The body of the reply as plain text with markups. The maximum length is 4096 bytes. |\n| `updateTime` | `string (`[Timestamp](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.Timestamp)` format)` Output only. The timestamp for when the reply was last modified. A timestamp in RFC3339 UTC \"Zulu\" format, with nanosecond resolution and up to nine fractional digits. Examples: `\"2014-10-02T15:01:23Z\"` and `\"2014-10-02T15:01:23.045123456Z\"`. |\n\n| Methods ------- ||\n|------------------------------------------------------------------------------------------|-------------------------------------------------------------------|\n| ### [deleteReply](/my-business/reference/rest/v4/accounts.locations.reviews/deleteReply) | Deletes the response to the specified review. |\n| ### [get](/my-business/reference/rest/v4/accounts.locations.reviews/get) | Returns the specified review. |\n| ### [list](/my-business/reference/rest/v4/accounts.locations.reviews/list) | Returns the paginated list of reviews for the specified location. |\n| ### [updateReply](/my-business/reference/rest/v4/accounts.locations.reviews/updateReply) | Updates the reply to the specified review. |"]]
