Die People API bietet Ihnen folgende Möglichkeiten:
- Kontakte des authentifizierten Nutzers lesen und verwalten
- Weitere Kontakte des authentifizierten Nutzers lesen und kopieren
- Profilinformationen für authentifizierte Nutzer und ihre Kontakte lesen
- Domainprofile und Kontakte lesen
Angenommen, der authentifizierte Nutzer Jen hat Fabian und Ranjith in ihren privaten Kontakten. Wenn Ihre App people.connections.list aufruft, um eine Liste ihrer Verbindungen zu lesen, wird Jens ein Zustimmungsbildschirm angezeigt, in dem sie gebeten wird, der App Zugriff auf die Liste zu gewähren. Wenn Jen zustimmt, liest die App eine Liste mit person resources für Fabian und Ranjith vor.
Wenn die App Informationen zu einer bestimmten Person benötigt, kann sie people.get aufrufen und einen Ressourcennamen übergeben, um das person resource-Objekt für diese Person abzurufen.
Die App kann auch Kontakte verwalten, indem sie neue Kontakte mit people.createContact erstellt, vorhandene Kontakte, die sie aus people.connections.list gelesen hat, mit people.updateContact aktualisieren und Kontakte mit people.deleteContact löschen kann.
Google Workspace-Nutzer können ihre Verzeichnisdomainprofile und Domainkontakte auch mit people.listDirectoryPeople auflisten oder mit people.searchDirectoryPeople suchen.
Eine zusammengeführte Ansicht mit 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 für domainbezogene Daten aktiviert und der Bereich 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. |
Informationen zu zusammengeführten Personendaten
Die Daten einer 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 verbunden sind. So kann sich eine Person zusammensetzen:
| Hauptquelle | Kontakte | 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 für das Google-Konto eines anderen Nutzers abgerufen wird. |
| Domainkontakt | 0+ | 0 | 0 | 1 | Zurückgegeben in people.listDirectoryPeople oder people.searchDirectoryPeople. |
Nur Personen, die auf Kontakten basieren, können durch Mutationsendpunkte geändert werden. Mutationen von Profilen und Domainkontakten werden nicht unterstützt.