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, mevcut müşteriyi belirtmek için benzersiz customerId veya my_customer olabilir.

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

Başarılı bir yanıt HTTP 200 durum kodunu 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": "yuri@example.com",
  "id": "C03xgje4y",
  "customerDomain": "example.com",
  "postalAddress": {
    "organizationName": "Example.com",
    "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 isteğini kullanın ve İstekleri yetkilendirme bölümünde açıklanan yetkilendirme jetonunu ekleyin. customerKey, müşterinin benzersiz customerId 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 kodunu döndürür. JSON yanıtı, durum koduyla birlikte yeni güncellenen müşteri bilgilerini içerir:

{
  "etag": "\"spqlTgq5LGeoin0BH1d0f4rpI98/LnbnRK_ZWu_omowg36CZgTKECrY\"",
  "kind": "admin#directory#customer",
  "alternateEmail": "yuri@example.com",
  "id": "C03xgje4y",
  "customerDomain": "example.com",
  "postalAddress": {
    "organizationName": "Example.com",
    "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 isteğini kullanın ve İstekleri yetkilendirme bölümünde açıklanan yetkilendirme jetonunu ekleyin. customerKey, benzersiz customerId 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": "yuri@example.com",
  "customerDomain": "example.com",
  "language": "EN",
  "postalAddress": {
    "organizationName": "Example.com",
    "phoneNumber": "+15558675309"
  }
}