Bu kılavuzda, Google Workspace kullanıcıları için kişi yetkilendirilmiş kullanıcılarının nasıl oluşturulacağı, listeleneceği ve silineceği açıklanmaktadır.
Google Workspace kullanıcıları, alanlarındaki diğer kullanıcılara kişilerine erişme ve kişilerini yönetme izni verebilir. Yetki verilmiş bu kullanıcılar yeni kişiler ekleyebilir ve mevcut kişilerinizi ad, telefon numarası ve adres gibi bilgilerle güncelleyebilirler.
Bu kılavuz, kişilere erişim yetkisi verme ile ilgilidir. Gmail'e erişim yetkisi vermek için Yetki verme ve e-posta üzerinde ortak çalışma başlıklı makaleyi inceleyin.
Ön koşullar
Contact Delegation API'sini kullanmadan önce aşağıdaki koşulları karşıladığınızdan emin olun:
- Kişi paylaşımını etkinleştirme: Dizin yöneticisinin, Yönetici Konsolu'nda kişi paylaşımını etkinleştirmesi gerekir. Daha fazla bilgi için Kişi paylaşımını etkinleştirme veya devre dışı bırakma başlıklı makaleyi inceleyin.
- Yönetici ayrıcalıkları: Diğer kullanıcılar için yetki verilmiş kullanıcıları yönetmek üzere "Kişiler" yönetici ayrıcalığına sahip olmanız gerekir.
- Alan kısıtlaması: Yalnızca aynı Google Workspace kuruluşundaki kullanıcılar arasında kişilere yetki verebilirsiniz.
- OAuth kapsamı: Uygulamanız aşağıdaki OAuth kapsamını kullanmalıdır:
https://www.googleapis.com/auth/admin.contact.delegation.
Temsilci oluşturma
Bir kullanıcı için temsilci oluşturmak üzere, yetki verenin e-posta adresiyle birlikte bir POST isteği gönderin:
POST https://admin.googleapis.com/admin/contacts/v1/users/USER_EMAIL/delegates
USER_EMAIL yerine yetki veren kullanıcının e-posta adresini girin.
İstek gövdesinde, temsilcinin e-posta adresini belirtin:
{
"email": "DELEGATE_EMAIL"
}
DELEGATE_EMAIL yerine yetkilinin e-posta adresini girin.
Başarılı bir yanıt, HTTP 200 durum kodunu ve yeni temsilcinin e-posta adresini döndürür:
{
"email": "DELEGATE_EMAIL"
}
Yetkilileri listeleme
Bir kullanıcının kişileri için temsilcileri listelemek üzere, söz konusu kullanıcının e-posta adresiyle bir GET isteği gönderin:
GET https://admin.googleapis.com/admin/contacts/v1/users/USER_EMAIL/delegates
USER_EMAIL yerine kullanıcının e-posta adresini girin.
Başarılı bir yanıt, HTTP 200 durum kodu ve temsilci e-posta adreslerinin bir listesini döndürür:
{
"delegates": [
{
"email": "DELEGATE_EMAIL_1"
},
{
"email": "DELEGATE_EMAIL_2"
}
]
}
Yetki verilmiş bir kullanıcıyı silme
Bir kullanıcının kişileri için yetkiliyi silmek üzere aşağıdaki adımları uygulayın:
- Kaldırılacak temsilciyi belirleyin. Belirli bir yetkilinin e-posta adresini bulmak için List delegates (Yetkilileri listele) yöntemini kullanın.
Yetki veren ve yetki verilen kullanıcının e-posta adreslerini içeren bir
DELETEisteği gönderin:DELETE https://admin.googleapis.com/admin/contacts/v1/users/USER_EMAIL/delegates/DELEGATE_EMAIL
USER_EMAIL yerine yetki verenin e-posta adresini, DELEGATE_EMAIL yerine ise yetki verilen kullanıcının e-posta adresini girin.
Başarılı bir yanıt, HTTP 200 durum kodu döndürür.