Directory API: Müşterileri Yönetme

Müşterilerinizi programatik olarak yönetmek için Directory API'yi kullanabilirsiniz. Bu API'deki yöntemler, G Suite 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 istekleri yetkilendirme bölümünde açıklanan yetkilendirme jetonunu ekleyin. customerKey, benzersiz customerId olabilir veya mevcut müşteriyi belirtmek için my_customer olabilir.

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

Başarılı bir yanıtta HTTP 200 durum kodu döndürülü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 istekleri yetkilendirme bölümünde açıklanan yetkilendirme jetonunu ekleyin. customerKey, müşterinin benzersiz customerId değeri 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ıtta HTTP 200 durum kodu döndürülür. JSON yanıtı, durum kodunun yanı sıra yeni güncellenen müşteri bilgilerini de 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ıtta HTTP 200 durum kodu döndürülü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 istekleri 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": "marty.mcfly@gmail.com",
  "customerDomain": "fluxcapacitor.com",
  "language": "EN",
  "postalAddress": {
    "organizationName": "A Match Made in Space, LLC",
    "phoneNumber": "+15558675309"
  }
}

Başarılı bir yanıtta HTTP 200 durum kodu döndürülür. JSON yanıtı, durum kodunun yanı sıra müşterinin bilgilerini de 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"
}