Method: accounts.list

인증된 사용자의 모든 계정을 나열합니다. 여기에는 사용자가 소유한 모든 계정 및 사용자가 관리 권한이 있는 모든 계정이 포함됩니다.

HTTP 요청

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

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

쿼리 매개변수

매개변수
pageSize

integer

페이지당 가져올 계정 수입니다. 기본값은 20, 최소는 2, 최대 페이지 크기는 20입니다.

pageToken

string

지정하면 계정의 다음 페이지가 검색됩니다. accounts.list 호출이 요청된 페이지 크기에 넣을 수 있는 것보다 더 많은 결과를 반환하는 경우 pageToken이 반환됩니다.

name

string

직접 액세스할 수 있는 계정 목록을 가져올 계정의 리소스 이름입니다. 이는 조직 및 사용자 그룹에만 해당됩니다. 비어 있으면 인증된 사용자에 대해 accounts.list를 반환합니다.

filter

string

반환할 계정을 제한하는 필터입니다. 응답에는 필터와 일치하는 항목만 포함됩니다. filter가 비어 있으면 제약 조건이 적용되지 않으며 요청된 계정에 대해 페이지로 나눈 모든 계정이 검색됩니다.

예를 들어 type=USER_GROUP 필터가 포함된 요청은 사용자 그룹만 반환합니다.

요청 본문

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

응답 본문

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

accounts.ListAccounts에 대한 응답 메시지입니다.

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

object (Account)

사용자가 액세스할 수 있는 계정의 모음입니다. 필터링되지 않는 한 쿼리를 수행하는 사용자의 개인 계정이 항상 결과의 첫 번째 항목이 됩니다.

nextPageToken

string

계정 수가 요청된 페이지 크기를 초과하면 accounts.list에 대한 후속 호출에서 다음 계정 페이지를 가져오는 토큰으로 이 필드가 채워집니다. 계정이 더 이상 없는 경우 이 필드는 응답에 표시되지 않습니다.

승인 범위

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

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

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