계정 데이터 사용

이 가이드에서는 계정 데이터를 사용하는 방법을 보여줍니다. My Business Account Management API를 사용하면 다음과 작업을 처리할 수 있습니다.

  • 모든 계정의 목록 생성
  • 특정 계정 반환
  • 계정 업데이트

시작하기 전에

My Business Account Management API를 사용하기 전에 애플리케이션을 등록하고 OAuth 2.0 사용자 인증 정보를 획득해야 합니다.

Business Profile API를 시작하는 방법에 관한 자세한 내용은 기본 설정을 참고하세요.

모든 계정의 목록 생성

인증된 사용자와 연결된 계정의 유효성을 검사하는 좋은 방법은 모든 계정의 목록을 생성하는 것입니다. accounts.list API를 사용하여 사용자와 연결된 모든 계정의 목록을 생성합니다.

인증된 사용자의 모든 계정을 목록으로 생성하려면 다음 코드를 사용합니다.

HTTP
$ GET https://mybusinessaccountmanagement.googleapis.com/v1/accounts

특정 계정 반환

인증된 사용자의 특정 계정에 관한 정보만 확인하고자 하는 경우가 있습니다. accounts.get API를 사용하여 특정 계정을 반환하고 추가 계정 세부정보를 검토합니다.

이름으로 특정 계정을 반환하려면 다음 코드를 사용합니다.

HTTP
$ GET https://mybusinessaccountmanagement.googleapis.com/v1/accounts/{accountId}

계정 업데이트

계정 이름 변경은 기본적인 관리 작업입니다. accounts.update API를 사용하여 계정 이름을 변경합니다.

이름으로 특정 계정을 업데이트하려면 다음 코드를 사용합니다.

HTTP
$ PUT https://mybusinessaccountmanagement.googleapis.com/v1/accounts/{accountId}

{
  "account": {
    "accountName": "Anne Droyd"
  },
  "languageCode": "en",
  "validateOnly": "true"
}

제한사항

  • 계정에서 수정할 수 있는 유일한 필드는 accountName입니다. 전달된 다른 필드는 무시됩니다.
  • BUSINESS 유형의 계정만 이러한 방식으로 업데이트할 수 있습니다.