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 geri almak için aşağıdaki GET HTTP isteğini kullanın ve istek yetkilendirme bölümünde açıklanan yetkilendirme jetonunu ekleyin. customerKey, benzersiz customerId 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ıt, bir 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 istek yetkilendirme bölümünde açıklanan yetkilendirme jetonunu ekleyin. customerKey, müşterinin benzersiz müşteri kimliği 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, bir 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, bir 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 istek 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 isteğinin 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, bir 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"
}