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"
}