People API'yi kullanarak şunları yapabilirsiniz:
- Kimliği doğrulanmış kullanıcının Kişiler'ini okuma ve yönetme
- Kimliği doğrulanmış kullanıcının "Diğer kişiler" bölümünü okuyup kopyalayın
- Kimliği doğrulanmış kullanıcılara ve kişilerine ait profil bilgilerini okuma
- Alan profillerini ve kişileri okuma
Örneğin, kimliği doğrulanmış kullanıcının (Cihan) özel kişilerinde Fabian ve Ranjith olduğunu varsayalım. Uygulamanız, bağlantılarının listesini okumak için people.connections.list çağırdığında Jen'e, uygulamaya listeye erişim izni isteyen bir izin ekranı sunulur. Jen izin verirse uygulama, Fabian ve Ranjith için person resources içeren bir liste okur.
Uygulama, belirli bir kişi için bilgiye ihtiyaç duyarsa kaynak adını ileterek people.get yöntemini çağırabilir ve ardından bu kişinin person resource bilgisini alır.
Ayrıca uygulama, kişileri people.createContact kullanarak yeni kişi oluşturarak yönetebilir, people.connections.list üzerinden okuduğu mevcut kişileri people.updateContact kullanarak güncelleyebilir ve kişileri people.deleteContact kullanarak silebilir.
Google Workspace kullanıcıları ayrıca, dizin alanlarını ve alan kişilerini people.listDirectoryPeople kullanarak veya people.searchDirectoryPeople kullanarak arayabilir.
Kişi bilgilerinin birleştirilmiş bir görünümü
People API'nin okuduğu kişi bilgileri, aşağıdaki koşullara bağlı olarak çeşitli kaynaklardan birleştirilir:
| Kaynak | Durum |
|---|---|
| Herkese açık Google profil verileri | Her Zaman'a dokunun. |
| Google Workspace alan profili verileri | Alan yöneticisi, alan kapsamlı verilerin harici kişi ve profil paylaşımını etkinleştirdi ve directory.readonly kapsamı verildi |
| Kimliği doğrulanmış kullanıcının gizli profil bilgileri | profile
kapsamlardan birine izin verildi. |
| Kimliği doğrulanmış kullanıcının kişileri | contacts
kapsamı verildi. |
Birleştirilmiş Kişi Verilerini Anlama
Bir kişinin verileri tek bir ana kaynak türünden elde edilir. Kaynaklar doğrulanmış e-posta adresleri, telefon numaraları veya profil URL'leri aracılığıyla bağlanmışsa diğer kaynaklardan gelen veriler bu verilerle birleştirilir. Bir kişi şu şekillerde oluşturulabilir:
| Ana Kaynak | Kişiler | Profiller | Google Workspace Alan Profilleri | Google Workspace Alandaki Kişiler | Kullanım |
|---|---|---|---|---|---|
| İletişim | 1 | 0+ | 0+ | 0+ | Çoğu uç nokta için döndürüldü |
| Profil | 0+ | 1 | 0 veya 1 | 0 | Oturum açmış kullanıcının kimliğini veya başka bir kullanıcının Google Hesabı'nı almak için kullanıldığında people.get'da iade edilir. |
| Alandaki Kişi | 0+ | 0 | 0 | 1 | people.listDirectoryPeople veya people.searchDirectoryPeople içinde iade edildi. |
Mutasyon uç noktaları ile yalnızca kişi tabanlı kişiler değiştirilebilir. Profil ve alan iletişim mutasyonları desteklenmez.