Method: accounts.locations.batchGetReviews

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

HTTP 요청

POST https://mybusiness.googleapis.com/v4/{name=accounts/*}/locations:batchGetReviews

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

경로 매개변수

매개변수
name

string

여러 위치에서 리뷰 목록을 가져올 계정의 이름입니다.

요청 본문

요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.

JSON 표현
{
  "locationNames": [
    string
  ],
  "pageSize": integer,
  "pageToken": string,
  "orderBy": string,
  "ignoreRatingOnlyReviews": boolean
}
필드
locationNames[]

string

이름으로 지정된 리뷰를 가져올 위치 모음입니다.

pageSize

integer

페이지당 가져올 리뷰 수입니다. 기본값은 50개입니다.

pageToken

string

지정하면 리뷰의 다음 페이지를 가져옵니다.

orderBy

string

선택사항입니다. 리뷰를 정렬할 필드를 지정합니다. 지정하지 않으면 반환되는 리뷰 순서가 기본적으로 updateTime desc로 설정됩니다. 정렬할 수 있는 유효한 순서는 rating, rating desc, updateTime desc입니다. rating은 리뷰를 오름차순으로 반환합니다. updateTime(즉, 오름차순)은 지원되지 않습니다.

ignoreRatingOnlyReviews
(deprecated)

boolean

평점만 있는 리뷰를 무시할지 여부입니다.

응답 본문

Reviews.BatchGetReviews의 응답 메시지입니다.

성공한 경우 응답 본문은 다음과 같은 구조의 데이터를 포함합니다.

JSON 표현
{
  "locationReviews": [
    {
      object (LocationReview)
    }
  ],
  "nextPageToken": string
}
필드
locationReviews[]

object (LocationReview)

위치 정보가 포함된 리뷰입니다.

nextPageToken

string

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

승인 범위

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

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

자세한 내용은 OAuth 2.0 Overview를 참조하세요.

LocationReview

위치 정보가 포함된 리뷰를 나타냅니다.

JSON 표현
{
  "name": string,
  "review": {
    object (Review)
  }
}
필드
name

string

위치 리소스 이름입니다.

review

object (Review)

위치의 리뷰입니다.