이제 Business Profile Performance API가 출시되었습니다. 마이그레이션 작업이 필요합니다.
지원 중단 일정 및 이전 지원 중단된 v4 API에서 새 v1 API로 마이그레이션하는 방법을 검토하세요.
설문조사를 통해 음식 메뉴 환경을 개선할 수 있도록 지원하는 판매자와 관련해 제공할 수 있는 장소, 메뉴, 음식 속성을 알려주세요.

Method: accounts.locations.reviews.list

컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

지정된 위치의 페이지로 나눈 리뷰 목록을 반환합니다. 이 작업은 지정된 위치가 인증된 경우에만 유효합니다.

HTTP 요청

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

URL은 gRPC 트랜스코딩 구문을 사용합니다.

경로 매개변수

매개변수
parent

string

리뷰를 가져올 위치의 이름입니다.

쿼리 매개변수

매개변수
pageSize

integer

페이지당 가져올 리뷰 수입니다. 최대 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

리뷰 수가 요청된 페이지 크기를 초과하는 경우 이 필드는 이후 review.list를 호출할 때 다음 리뷰 페이지를 가져오는 토큰으로 채워집니다. 리뷰가 더 이상 없으면 응답에 이 필드가 표시되지 않습니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

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

자세한 내용은 OAuth 2.0 개요를 참고하세요.