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 개요를 참고하세요.