계정 데이터 사용

이 가이드에서는 계정 데이터를 사용하는 방법을 보여줍니다. 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 유형의 계정만 이 방식으로 업데이트할 수 있습니다.