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.