Method: categories.list

비즈니스 카테고리의 목록을 반환합니다. 검색은 카테고리 이름과 일치하지만 카테고리 ID와는 일치하지 않습니다.

검색은 카테고리 이름의 앞부분과만 일치합니다. 즉, '음식'은 '푸드 코트'는 반환하지만 '패스트푸드 음식점'은 반환하지 않습니다.

HTTP 요청

GET https://mybusinessbusinessinformation.googleapis.com/v1/categories

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

쿼리 매개변수

매개변수
regionCode

string

필수 항목입니다. ISO 3166-1 alpha-2 국가 코드입니다.
languageCode

string

필수 항목입니다. BCP 47 언어 코드입니다.
filter

string

선택사항입니다. 사용자의 필터 문자열입니다. 지원되는 유일한 필드는 displayName입니다. 예: filter=displayName=foo
pageSize

integer

선택사항입니다. 페이지당 가져올 카테고리 수입니다. 기본값은 100, 최소는 1, 최대 페이지 크기는 100입니다.
pageToken

string

선택사항입니다. 지정하면 카테고리의 다음 페이지를 가져옵니다.
view

enum (CategoryView)

필수 항목입니다. 응답에서 반환되어야 하는 카테고리 리소스의 부분을 지정합니다.

요청 본문

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

응답 본문

BusinessCategories.ListCategories의 응답 메시지입니다.

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

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

object (Category)

요청된 매개변수를 기준으로 한 일치하는 카테고리입니다.
nextPageToken

string

카테고리 수가 요청된 페이지 크기를 초과하면 이 필드는 categories.list에 대한 후속 호출에서 다음 카테고리 페이지를 가져오는 토큰으로 채워집니다.

승인 범위

다음 OAuth 범위가 필요합니다.

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

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