Giriş

Koleksiyonlar ile düzeninizi koruyun İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.

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.