People API

Bietet Zugriff auf Informationen zu Profilen und Kontakten.

Dienst: people.googleapis.com

Um diesen Dienst aufzurufen, empfehlen wir die Verwendung der von Google bereitgestellten Clientbibliotheken. Wenn Ihre Anwendung Ihre eigenen Bibliotheken verwenden muss, um diesen Dienst aufzurufen, verwenden Sie die folgenden Informationen, wenn Sie die API-Anfragen stellen.

Discovery-Dokument

Ein Discovery-Dokument ist eine maschinenlesbare Spezifikation zum Beschreiben und Nutzen von REST APIs. Sie wird verwendet, um Clientbibliotheken, IDE-Plug-ins und andere Tools zu erstellen, die mit Google APIs interagieren. Ein Dienst kann mehrere Discovery-Dokumente haben. Der Dienst bietet das folgende Discovery-Dokument:

Dienstendpunkt

Ein Dienstendpunkt ist eine Basis-URL, die die Netzwerkadresse eines API-Dienstes angibt. Ein Dienst kann mehrere Dienstendpunkte haben. Dieser Dienst hat den folgenden Dienstendpunkt und alle nachstehenden URIs beziehen sich auf ihn:

  • https://people.googleapis.com

REST-Ressource: v1.contactGroups

Methoden
batchGet GET /v1/contactGroups:batchGet
Sie können eine Liste der Kontaktgruppen abrufen, die dem authentifizierten Nutzer gehören. Geben Sie dazu eine Liste der Ressourcennamen der Kontaktgruppe an.
create POST /v1/contactGroups
Erstellen Sie eine neue Kontaktgruppe, die dem authentifizierten Nutzer gehört.
delete DELETE /v1/{resourceName=contactGroups/*}
Löschen Sie eine vorhandene Kontaktgruppe, die dem authentifizierten Nutzer gehört, indem Sie einen Ressourcennamen für die Kontaktgruppe angeben.
get GET /v1/{resourceName=contactGroups/*}
Rufen Sie durch Angabe eines Ressourcennamens für die Kontaktgruppe eine bestimmte Kontaktgruppe ab, die dem authentifizierten Nutzer gehört.
list GET /v1/contactGroups
Listet alle Kontaktgruppen auf, die dem authentifizierten Nutzer gehören.
update PUT /v1/{contactGroup.resourceName=contactGroups/*}
Aktualisieren Sie den Namen einer vorhandenen Kontaktgruppe, die dem authentifizierten Nutzer gehört.

REST-Ressource: v1.contactGroups.members

Methoden
modify POST /v1/{resourceName=contactGroups/*}/members:modify
Sie können die Mitglieder einer Kontaktgruppe ändern, die dem authentifizierten Nutzer gehört.

REST-Ressource: v1.otherContacts

Methoden
copyOtherContactToMyContactsGroup POST /v1/{resourceName=otherContacts/*}:copyOtherContactToMyContactsGroup

Kopiert einen anderen Kontakt in einen neuen Kontakt in der Gruppe "myContacts" des Nutzers.

Änderungsanfragen für denselben Nutzer sollten nacheinander gesendet werden, um erhöhte Latenz und Fehler zu vermeiden.
list GET /v1/otherContacts
Listet alle weiteren Kontakte auf, d. h. Kontakte, die nicht zu einer Kontaktgruppe gehören.
search GET /v1/otherContacts:search
Stellt eine Liste der Kontakte des authentifizierten Nutzers in den anderen Kontakten bereit, die mit der Suchanfrage übereinstimmen.

REST-Ressource: v1.people

Methoden
batchCreateContacts POST /v1/people:batchCreateContacts

Erstellen Sie einen Stapel neuer Kontakte und geben Sie die PersonResponses für die neuen

Änderungsanfragen für denselben Nutzer sollten nacheinander gesendet werden, um erhöhte Latenz und Fehler zu vermeiden.
batchDeleteContacts POST /v1/people:batchDeleteContacts
Löschen Sie einen Batch-Kontakt.
batchUpdateContacts POST /v1/people:batchUpdateContacts
Aktualisiert einen Batch von Kontakten und gibt für die aktualisierten Kontakte eine Zuordnung der Ressourcennamen an PersonResponse zurück.
createContact POST /v1/people:createContact
Erstellen Sie einen neuen Kontakt und geben Sie die Personenressource für diesen Kontakt zurück.
deleteContact DELETE /v1/{resourceName=people/*}:deleteContact
Eine Kontaktperson löschen.
deleteContactPhoto DELETE /v1/{resourceName=people/*}:deleteContactPhoto
Hiermit können Sie das Foto eines Kontakts löschen.
get GET /v1/{resourceName=people/*}
Liefert durch Angabe eines Ressourcennamens Informationen zu einer Person.
getBatchGet GET /v1/people:batchGet
Liefert Informationen zu einer Liste bestimmter Personen durch Angabe einer Liste angeforderter Ressourcennamen.
listDirectoryPeople GET /v1/people:listDirectoryPeople
Stellt eine Liste der Domainprofile und Domainkontakte im Domainverzeichnis des authentifizierten Nutzers bereit.
searchContacts GET /v1/people:searchContacts
Stellt eine Liste der Kontakte in den gruppierten Kontakten des authentifizierten Nutzers bereit, die der Suchanfrage entsprechen.
searchDirectoryPeople GET /v1/people:searchDirectoryPeople
Stellt eine Liste der Domainprofile und Domainkontakte im Domainverzeichnis des authentifizierten Nutzers bereit, die der Suchanfrage entsprechen.
updateContact PATCH /v1/{person.resourceName=people/*}:updateContact
Kontaktdaten für eine vorhandene Kontaktperson aktualisieren.
updateContactPhoto PATCH /v1/{resourceName=people/*}:updateContactPhoto
Aktualisieren Sie das Foto eines Kontakts.

REST-Ressource: v1.people.connections

Methoden
list GET /v1/{resourceName=people/*}/connections
Stellt eine Liste der Kontakte des authentifizierten Nutzers bereit.