Directory API: Kullanıcı Takma Adları

Kullanıcı takma adı oluşturma

Bir kullanıcının takma adı, kullanıcının birincil e-posta adresiniz olmalıdır. Bir kullanıcı takma adı, bundan farklı bir hesap alan adıyla ilişkilendirilebilir. kullanıcının birincil e-posta adresinin kullandığı alan adı. Kullanıcı, 24 saat içinde (genellikle daha erken) e-posta alırsınız. API, Alanın sahipliğinin onaylanması .

Kullanıcı takma adı oluşturmak için aşağıdaki POST isteğini kullanın ve İstekleri yetkilendirme başlıklı makalede açıklanan yetkilendirmeyi dahil edin. userKey, kullanıcının birincil e-posta adresi, id kullanıcısı veya kullanıcı takma adlarından herhangi biri olabilir. e-postalar. İstek ve yanıt özellikleri için API Referansı'na bakın:

POST https://admin.googleapis.com/admin/directory/v1/users/userKey/aliases

JSON isteği

Aşağıdaki JSON isteğinde, kullanıcı takma adı oluşturmaya yönelik örnek bir istek gösterilmektedir. Kullanıcı burcin@example.com, takma ad da Chica@example.com'dur:

POST https://admin.googleapis.com/admin/directory/v1/users/liz@example.com/aliases
. İstek gövdesi, yeni takma ad bilgilerine sahiptir:
{  
 "alias": "chica@example.com"
}

Başarılı bir yanıt, HTTP 201 durum kodu döndürür. Yanıt, durum koduyla birlikte yeni kullanıcı takma adına ilişkin özellikleri döndürür.

Kullanıcının tüm takma adlarını alma

Bir kullanıcının tüm takma adlarını almak için aşağıdaki GET isteğini kullanın ve İstekleri yetkilendirme başlıklı makalede açıklanan yetkilendirmeyi dahil edin. userKey, kullanıcının birincil e-posta adresi, id kullanıcısı veya kullanıcı takma adlarından herhangi biri olabilir. e-postalar. İstek ve yanıt özellikleri için API Referansı'na bakın:

GET https://admin.googleapis.com/admin/directory/v1/users/userKey/aliases
. Örneğin, şu istek URI'sı kullaniciKeyfi için tüm takma adları (liz@example.com) döndürür:
GET https://admin.googleapis.com/admin/directory/v1/users/liz@example.com/aliases

Tüm kullanıcı takma adları alfabetik sırayla döndürülür. maxResults sorgu dizesi veya "Tüm takma adları al" için kullanılan sayfalara ayırma gibi bir sayfa boyutu yok. tıklayın.

JSON yanıtı

Başarılı bir yanıt, HTTP 200 durum kodu döndürür. Yanıt, durum koduyla birlikte kullanıcının takma adlarını alfabetik sırayla döndürür. Bu takma ad alanları, birincil alan ve hesaptaki diğer birden çok alan adıdır:

{
"kind": "directory#user#aliases",
"aliases": [
 {
  "kind": "directory#user#alias",
  "id": "the unique user id",
  "primary_email": "liz@example.com",
  "alias": "chica@example.com"
 },
 {
  "kind": "directory#user#alias",
  "id": "the unique user id",
  "primary_email": "liz@example.com",
  "alias": "support@example.com"
 },
 {
  "kind": "directory#user#alias",
  "id": "the unique user id",
  "primary_email": "liz@example.com",
  "alias": "help@hr.example.com"
 },
 {
  "kind": "directory#user#alias",
  "id": "the unique user id",
  "primary_email": "liz@example.com",
  "alias": "tickets@jumboinc.com"
 }
]
}

Kullanıcı takma adını silme

Bir kullanıcı takma adını silmek için aşağıdaki DELETE isteğini kullanın ve yetki belgesinin bu bölümünde İstekleri yetkilendirin. Bir 24 saat içinde tamamlanır. İlgili içeriği oluşturmak için kullanılan userKey, kullanıcının birincil e-posta adresi, id adlı kullanıcı veya aşağıdakilerden herhangi biri olabilir kullanıcı takma adlarının e-postalar. Ayrıca aliasId, takma addır. olan e-posta adresi silindi. İstek ve yanıt özellikleri için API referansı.

DELETE https://admin.googleapis.com/admin/directory/v1/users/userKey/aliases/aliasId
. Örneğin, bu DELETE isteği kullanıcıKeyi (liz@example.com) için cacia@example.com takma adını siler:
DELETE https://admin.googleapis.com/admin/directory/v1/users/liz@example.com/aliases/chica@example.com

Başarılı bir yanıt, HTTP 200 durum kodu döndürür.