Method: categories.list

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

HTTP 요청

GET https://mybusiness.googleapis.com/v4/categories

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

쿼리 매개변수

매개변수
regionCode

string

ISO 3166-1 alpha-2 국가 코드입니다.

languageCode

string

BCP 47 언어 코드입니다. 언어를 사용할 수 없는 경우 영어로 기본 설정됩니다.

searchTerm

string

사용자의 필터 문자열입니다(선택사항).

pageSize

integer

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

pageToken

string

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

view

enum (CategoryView)

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

요청 본문

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

응답 본문

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

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

object (Category)

카테고리 카테고리는 기본 보기입니다. ServiceType 정보는 포함되지 않습니다.

totalCategoryCount

integer

요청 매개변수의 총 카테고리 수입니다.

nextPageToken

string

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

승인 범위

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

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

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