Einführung

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.