Method: accounts.locations.reviews.list

指定したビジネスに対するクチコミのページ化されたリストを返します。この操作は、指定したビジネスのオーナー確認が済んでいる場合にのみ有効です。

HTTP リクエスト

GET https://mybusiness.googleapis.com/v4/{parent=accounts/*/locations/*}/reviews

この URL は gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
parent

string

クチコミを取得するビジネスの名前です。

クエリ パラメータ

パラメータ
pageSize

integer

1 ページあたりで取得するクチコミ数です。pageSize の最大数は 50 です。
pageToken

string

指定すると、クチコミの次のページが取得されます。
orderBy

string

クチコミの並べ替えの基準とするフィールドを指定します。指定されていない場合、返されるクチコミの順序はデフォルトの updateTime desc になります。並べ替えで有効な順序は rating、rating desc、updateTime desc です。

リクエスト本文

リクエストの本文は空にする必要があります。

レスポンスの本文

成功すると、レスポンスの本文に次の構造のデータが含まれます。

Reviews.ListReviews に対するレスポンス メッセージです。

JSON 表現 
{
  "reviews": [
    {
      object (Review)
    }
  ],
  "averageRating": number,
  "totalReviewCount": integer,
  "nextPageToken": string
}
フィールド
reviews[]

object (Review)

クチコミです。
averageRating

number

このビジネスに対するすべてのクチコミの平均評価を 1 ～ 5 で示し、5 が最高評価です。
totalReviewCount

integer

このビジネスのクチコミの合計数。
nextPageToken

string

クチコミの数がリクエストしたページサイズを超えた場合、このフィールドには、後続の reviews.list の呼び出しでクチコミの次のページを取得するためのトークンが入力されます。取得するクチコミがそれ以上ない場合、このフィールドはレスポンスに含められません。

認可スコープ

次の OAuth スコープのいずれかが必要です。

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

詳細については、OAuth 2.0 の概要をご覧ください。