People API aşağıdakileri yapmanıza olanak tanır:
- Kimliği doğrulanan kullanıcının Kişiler'ini okuma ve yönetme
- Kimliği doğrulanan kullanıcının "Diğer kişiler" bilgisini okuyup kopyalayın.
- Kimliği doğrulanmış kullanıcılar ve kişileri için profil bilgilerini okuma
- Alan profillerini ve kişilerini okuma
Örneğin, kimliği doğrulanmış kullanıcı olan Jen'in özel kişileri arasında Fabian ve Ranjith'in bulunduğunu varsayalım. Uygulamanız, bağlantılarının listesini okumak için people.connections.list numaralı telefonu aradığında Jen'e, uygulamanın listeye erişmesi için izin vermelerini isteyen bir izin ekranı gösterilir. Jen izin verirse uygulama Fabian ve Ranjith için person resources içeren bir listeyi okur.
Uygulama, belirli bir kişi için bilgiye ihtiyaç duyarsa kaynak adı ileterek people.get yöntemini çağırarak bu kişi için person resource alabilir.
Uygulama ayrıca people.createContact ile yeni kişiler oluşturarak kişileri yönetebilir, people.connections.list ile okuduğu mevcut kişileri people.updateContact ile güncelleyebilir ve people.deleteContact kullanarak kişileri silebilir.
Google Workspace kullanıcıları ayrıca, dizin alanı profillerini ve alandaki kişilerini people.listDirectoryPeople kullanarak listeleyebilir veya people.searchDirectoryPeople ile arayabilir.
Kişi bilgilerinin birleştirilmiş 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 | Koşul |
|---|---|
| Herkese açık Google profil verileri | Her Zaman'a dokunun. |
| Google Workspace alan profili verileri | Alan yöneticisi, alan kapsamındaki veriler için harici kişi ve profil paylaşımını etkinleştirdi ve directory.readonly kapsamı sunuldu. |
| Kimliği doğrulanan kullanıcının gizli profil bilgileri, | profile kapsamlarından biri onaylandı. |
| Kimliği doğrulanmış kullanıcının kişileri | contacts kapsamı verildi. |
Birleştirilmiş Kişi Verilerini Anlama
Bir kişiye ait veriler tek bir ana kaynak türünden türetilir. Kaynaklar doğrulanmış e-posta adresleri, telefon numaraları veya profil URL'leri aracılığıyla bağlıysa diğer kaynaklardan gelen veriler bu verilerle birleştirilir. Bir kişinin içerik oluşturma yöntemleri şunlardır:
| Ana Kaynak | Kişiler | Profiller | Google Workspace Alan Profilleri | Google Workspace Alanı Kişileri | 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 ilgili kişiye ulaşmak veya başka bir kullanıcının Google Hesabı için kişi almak için kullanıldığında people.get içinde döndürülür. |
| Alan İlgili Kişisi | 0+ | 0 | 0 | 1 | people.listDirectoryPeople veya people.searchDirectoryPeople içinde geri verildi. |
Yalnızca kişi tabanlı kişiler mutasyon uç noktaları tarafından değiştirilebilir. Profil ve alan kişisi değişiklikleri desteklenmez.