Directory API: 고객 관리

Directory API를 사용하여 고객을 프로그래매틱 방식으로 관리할 수 있습니다. 이 API의 메서드를 사용하면 G Suite 도메인의 연락처 정보를 업데이트하고 인스턴스의 기본 도메인을 변경할 수 있습니다.

고객 검색

기존 고객을 가져오려면 다음 GET HTTP 요청을 사용하고 요청 승인에 설명된 승인 토큰을 포함합니다. customerKey는 고유한 customerId이거나 현재 고객을 나타내는 my_customer일 수 있습니다.

GET https://admin.googleapis.com/admin/directory/v1/customers/customerKey

응답이 성공하면 HTTP 200 상태 코드가 반환됩니다. JSON 응답에는 상태 코드와 함께 고객 정보가 포함됩니다.

{
  "etag": "\"spqlTgq5LGeoin0BH1d0f4rpI98/LnbnRK_ZWu_omowg36CZgTKECrY\"",
  "kind": "admin#directory#customer",
  "alternateEmail": "marty.mcfly@gmail.com",
  "id": "C03xgje4y",
  "customerDomain": "amatchmadeinspace.com",
  "postalAddress": {
    "organizationName": "A Match Made in Space, LLC",
    "countryCode": "US"
  },
  "customerCreationTime": "2015-10-21T20:42:35.224Z"
}

기존 고객 업데이트

기존 고객을 업데이트하려면 다음 PUT HTTP 요청을 사용하고 요청 승인에 설명된 승인 토큰을 포함합니다. customerKey는 고객의 고유한 customerId이거나 현재 고객을 나타내는 my_customer일 수 있습니다.

PUT https://admin.googleapis.com/admin/directory/v1/customers/customerKey

응답이 성공하면 HTTP 200 상태 코드가 반환됩니다. JSON 응답에는 상태 코드와 함께 새로 업데이트된 고객 정보가 포함됩니다.

{
  "alternateEmail": "marty.mcfly@gmail.com",
  "customerDomain": "amatchmadeinspace.com",
  "language": "EN",
  "postalAddress": {
    "organizationName": "A Match Made in Space, LLC",
    "phoneNumber": "+15558675309"
  }
}

응답이 성공하면 HTTP 200 상태 코드가 반환됩니다. JSON 응답에는 상태 코드와 함께 고객 정보가 포함됩니다.

{
  "etag": "\"spqlTgq5LGeoin0BH1d0f4rpI98/LnbnRK_ZWu_omowg36CZgTKECrY\"",
  "kind": "admin#directory#customer",
  "alternateEmail": "marty.mcfly@gmail.com",
  "id": "C03xgje4y",
  "customerDomain": "amatchmadeinspace.com",
  "postalAddress": {
    "organizationName": "A Match Made in Space, LLC",
    "phoneNumber": "+15558675309"
  },
  "customerCreationTime": "2015-10-21T20:42:35.224Z"
}

고객의 기본 도메인 이름 변경하기

고객의 기본 도메인을 변경하려면 다음 PUT HTTP 요청을 사용하고 요청 승인에 설명된 승인 토큰을 포함합니다. customerKey는 고유한 customerId 또는 my_customer여야 합니다.

PUT https://admin.googleapis.com/admin/directory/v1/customers/customerKey

JSON 요청 본문에는 새 customerDomain 값이 포함되어야 합니다.

{
  "alternateEmail": "marty.mcfly@gmail.com",
  "customerDomain": "fluxcapacitor.com",
  "language": "EN",
  "postalAddress": {
    "organizationName": "A Match Made in Space, LLC",
    "phoneNumber": "+15558675309"
  }
}

응답이 성공하면 HTTP 200 상태 코드가 반환됩니다. JSON 응답에는 상태 코드와 함께 고객 정보가 포함됩니다.

{
  "etag": "\"spqlTgq5LGeoin0BH1d0f4rpI98/LnbnRK_ZWu_omowg36CZgTKECrY\"",
  "kind": "admin#directory#customer",
  "alternateEmail": "marty.mcfly@gmail.com",
  "id": "C03xgje4y",
  "customerDomain": "fluxcapacitor.com",
  "postalAddress": {
    "organizationName": "A Match Made in Space, LLC",
    "phoneNumber": "+15558675309"
  },
  "customerCreationTime": "2015-10-21T20:42:35.224Z"
}