Method: accounts.listRecommendGoogleLocations

지정된 비즈니스 프로필 계정에 추천된 모든 GoogleLocation를 나열합니다. 추천은 개인 계정 및 위치 그룹에만 제공되며, 다른 모든 계정 유형을 요청하면 오류가 발생합니다. 위치 그룹에 대한 추천은 해당 그룹에 있는 위치를 기반으로 합니다.

개인 계정을 위한 추천은 사용자가 비즈니스 프로필에서 액세스할 수 있는 모든 위치 (위치 그룹을 통해 액세스할 수 있는 위치 포함)를 기반으로 하며 사용자에게 생성된 모든 추천의 상위 집합입니다.

HTTP 요청

GET https://mybusiness.googleapis.com/v4/{name=accounts/*}:recommendGoogleLocations

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

경로 매개변수

매개변수
name

string

추천 Google 위치를 가져올 계정 리소스의 이름입니다.

쿼리 매개변수

매개변수
pageSize

integer

페이지당 가져올 위치 수입니다. 기본값은 25, 최소는 1, 최대 페이지 크기는 100입니다.

pageToken

string

지정하면 위치의 다음 페이지가 검색됩니다.

요청 본문

요청 본문은 비어 있어야 합니다.

응답 본문

성공할 경우 응답 본문에 다음 구조의 데이터가 포함됩니다.

GoogleLocations.ListRecommendedGoogleLocations에 대한 응답 메시지입니다.

또한 이 비즈니스 프로필 계정에 마지막으로 추천된 이후 다른 비즈니스 프로필 사용자가 소유권을 주장한 위치도 포함되어 있습니다.

JSON 표현
{
  "googleLocations": [
    {
      object (GoogleLocation)
    }
  ],
  "totalSize": integer,
  "nextPageToken": string
}
필드
googleLocations[]

object (GoogleLocation)

비즈니스 프로필 계정에 추천된 위치입니다. 각각은 지도에 있는 GoogleLocation를 나타냅니다. 위치는 비즈니스 프로필 계정과의 관련성에 따라 내림차순으로 정렬됩니다.

totalSize

integer

페이지로 나누기와 관계없이 이 비즈니스 프로필 계정의 총 추천 위치 수입니다.

nextPageToken

string

페이지로 나누는 동안 다음 페이지에서 가져올 수 있는 위치가 더 있으면 이 필드는 후속 호출에서 다음 위치 페이지를 가져오는 토큰으로 채워집니다. 더 이상 가져올 위치가 없으면 이 필드는 응답에 표시되지 않습니다.

승인 범위

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

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

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