Directory API: Müşterileri Yönetme

Müşterilerinizi programatik olarak yönetmek için Directory API'yi kullanabilirsiniz. Bu API'deki yöntemler, Google Workspace alanınızdaki iletişim bilgilerini güncellemenize ve örneğinizin birincil alanını değiştirmenize olanak tanır.

Müşteri alma

Mevcut bir müşteriyi almak için aşağıdaki GET HTTP isteğini kullanın ve İstekleri yetkilendirme bölümünde açıklanan yetkilendirme jetonunu ekleyin. customerKey, benzersiz customerId olabilir veya my_customer, mevcut müşteriyi belirtmek için kullanılabilir.

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

Başarılı bir yanıt HTTP 200 durum kodu döndürür. JSON yanıtı, durum koduyla birlikte müşterinin bilgilerini içerir:

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

Mevcut bir müşteriyi güncelleme

Mevcut bir müşteriyi güncellemek için aşağıdaki PUT HTTP isteğini kullanın ve İstekleri yetkilendirme bölümünde açıklanan yetkilendirme jetonunu ekleyin. customerKey, müşterinin benzersiz customerId'si veya mevcut müşteriyi belirtmek için my_customer olabilir.

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

Başarılı bir yanıt HTTP 200 durum kodu döndürür. JSON yanıtı, durum koduyla birlikte yeni güncellenen müşteri bilgilerini içerir:

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

Başarılı bir yanıt HTTP 200 durum kodu döndürür. JSON yanıtı, durum koduyla birlikte müşterinin bilgilerini içerir:

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

Müşterinin birincil alan adını değiştirme

Bir müşterinin birincil alanını değiştirmek için aşağıdaki PUT HTTP isteğini kullanın ve İstekleri yetkilendirme bölümünde açıklanan yetkilendirme jetonunu ekleyin. customerKey, benzersiz müşteri kimliği veya my_customer olmalıdır.

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

JSON istek gövdesi, yeni customerDomain değerini içermelidir:

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

Başarılı bir yanıt HTTP 200 durum kodu döndürür. JSON yanıtı, durum koduyla birlikte müşterinin bilgilerini içerir:

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