REST Resource: accounts.locations.reviews
コレクションでコンテンツを整理
必要に応じて、コンテンツの保存と分類を行います。
リソース: Review
JSON 表現 |
{
"name": string,
"reviewId": string,
"reviewer": {
object (Reviewer )
},
"starRating": enum (StarRating ),
"comment": string,
"createTime": string,
"updateTime": string,
"reviewReply": {
object (ReviewReply )
}
} |
フィールド |
name |
string
リソース名。レビューの場合は accounts/{accountId}/locations/{locationId}/reviews/{reviewId} の形式です。
|
reviewId |
string
暗号化された一意の識別子。
|
reviewer |
object (Reviewer )
レビューを書いた人です。
|
starRating |
enum (StarRating )
クチコミの評価です。
|
createTime |
string (Timestamp format)
クチコミが投稿されたときのタイムスタンプです。 RFC3339 UTC「Zulu」形式のタイムスタンプ。精度はナノ秒まで、小数点以下は最大 9 桁。例: "2014-10-02T15:01:23Z" 、"2014-10-02T15:01:23.045123456Z" 。
|
updateTime |
string (Timestamp format)
クチコミが最後に変更されたときのタイムスタンプです。 RFC3339 UTC「Zulu」形式のタイムスタンプ。精度はナノ秒まで、小数点以下は最大 9 桁。例: "2014-10-02T15:01:23Z" 、"2014-10-02T15:01:23.045123456Z" 。
|
reviewReply |
object (ReviewReply )
このクチコミに対するビジネスのオーナーまたは管理者による返信です。
|
審査担当者
JSON 表現 |
{
"profilePhotoUrl": string,
"displayName": string,
"isAnonymous": boolean
} |
フィールド |
profilePhotoUrl |
string
クチコミ投稿者のプロフィール写真へのリンクです。isAnonymous が false の場合にのみ入力されます。
|
displayName |
string
クチコミ投稿者の名前です。isAnonymous が false の場合にのみクチコミ投稿者の実名が入力されます。
|
isAnonymous |
boolean
クチコミ投稿者が匿名のままにするよう設定しているかどうかを表します。
|
StarRating
列挙型 |
STAR_RATING_UNSPECIFIED |
指定されていません。 |
ONE |
最高で星 5 つのうちの 1 つ星です。 |
TWO |
最高で星 5 つのうちの 2 つ星です。 |
THREE |
最高で星 5 つのうちの 3 つ星です。 |
FOUR |
最高で星 5 つのうちの 4 つ星です。 |
FIVE |
最高評価です。 |
ReviewReply
クチコミに対するビジネスのオーナーまたは管理者による返信を表します。
JSON 表現 |
{
"comment": string,
"updateTime": string
} |
フィールド |
updateTime |
string (Timestamp format)
出力専用。返信が最後に変更されたときのタイムスタンプです。 RFC3339 UTC「Zulu」形式のタイムスタンプ。精度はナノ秒まで、小数点以下は最大 9 桁。例: "2014-10-02T15:01:23Z" 、"2014-10-02T15:01:23.045123456Z" 。
|
メソッド |
|
指定したクチコミへの返信を削除します。 |
|
指定したクチコミを返します。 |
|
指定したビジネスに関するクチコミのページ分けされたリストを返します。 |
|
指定したクチコミへの返信を更新します。 |
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンスにより使用許諾されます。コードサンプルは Apache 2.0 ライセンスにより使用許諾されます。詳しくは、Google Developers サイトのポリシーをご覧ください。Java は Oracle および関連会社の登録商標です。
最終更新日 2025-07-25 UTC。
[null,null,["最終更新日 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. |"]]