Mit der People API können Sie:
- Kontakte des authentifizierten Nutzers lesen und verwalten
- Weitere Kontakte des authentifizierten Nutzers lesen und kopieren
- Profilinformationen für authentifizierte Nutzer und deren Kontakte lesen
- Domainprofile und Kontakte lesen
Nehmen wir beispielsweise an, der authentifizierte Nutzer Jens hat in seinen privaten Kontakten Fabian und Ranjith. Wenn Ihre App people.connections.list
aufruft, um eine Liste ihrer Verbindungen zu lesen, wird Jens im Zustimmungsbildschirm aufgefordert, der App Zugriff auf die Liste zu gewähren. Wenn Jens zustimmt, liest die App eine Liste mit person resources
für Fabian und Ranjith.
Wenn die Anwendung Informationen für eine bestimmte Person benötigt, kann sie people.get
aufrufen und einen Ressourcennamen übergeben, um den person resource
für diese Person abzurufen.
Die App kann Kontakte auch verwalten, indem sie neue Kontakte mit people.createContact
erstellt, vorhandene Kontakte, die aus people.connections.list
gelesen wurden, mit people.updateContact
aktualisieren und Kontakte mit people.deleteContact
löschen.
Google Workspace-Nutzer können ihre Verzeichnisdomainprofile und Domainkontakte auch mit people.listDirectoryPeople
auflisten oder mit people.searchDirectoryPeople
suchen.
Zusammengeführte Ansicht von Personeninformationen
Die von der People API gelesenen Personeninformationen werden abhängig von den folgenden Bedingungen aus verschiedenen Quellen zusammengeführt:
Quelle | Bedingung |
---|---|
Öffentliche Google-Profildaten | Und zwar immer. |
Google Workspace-Domainprofildaten | Der Domainadministrator hat die externe Kontakt- und Profilfreigabe von domainbezogenen Daten aktiviert und der Umfang directory.readonly wurde gewährt. |
Die privaten Profilinformationen des authentifizierten Nutzers | Einer der profile -Bereiche wurde gewährt. |
Die Kontakte des authentifizierten Nutzers | Der Bereich contacts wurde gewährt. |
Zusammengeführte Daten
Die Daten für eine Person werden aus einem Hauptquellentyp abgeleitet. Daten aus anderen Quellen werden mit diesen Daten zusammengeführt, wenn die Quellen über bestätigte E-Mail-Adressen, Telefonnummern oder Profil-URLs miteinander verbunden sind. Dies kann die folgende Art der Zusammensetzung sein:
Hauptquelle | Kontakte | Google Profile | Google Workspace-Domainprofile | Google Workspace-Domainkontakte | Nutzung |
---|---|---|---|---|---|
Kontakt | 1 | 0+ | 0+ | 0+ | Für die meisten Endpunkte zurückgegeben |
Profil | 0+ | 1 | 0 oder 1 | 0 | Wird in people.get zurückgegeben, wenn damit die Person für den angemeldeten Nutzer oder eine Person für das Google-Konto eines anderen Nutzers abgerufen wird. |
Domainkontakt | 0+ | 0 | 0 | 1 | Wird in people.listDirectoryPeople oder people.searchDirectoryPeople zurückgegeben. |
Nur kontaktbasierte Personen können durch Mutationsendpunkte geändert werden. Mutationen in Profilen und Domains werden nicht unterstützt.