People API

Bietet Zugriff auf Informationen zu Profilen und Kontakten.

Dienst: people.googleapis.com

Zum Aufrufen dieses Dienstes empfehlen wir die Verwendung der von Google bereitgestellten Clientbibliotheken. Wenn Ihre Anwendung zum Aufrufen dieses Dienstes Ihre eigenen Bibliotheken benötigt, 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, deren Inhaber der authentifizierte Nutzer ist, indem Sie eine Liste der Ressourcennamen der Kontaktgruppen angeben.
create POST /v1/contactGroups
Erstellen Sie eine neue Kontaktgruppe, deren Inhaber der authentifizierte Nutzer ist.
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/*}
Sie können eine bestimmte Kontaktgruppe abrufen, deren Inhaber der authentifizierte Nutzer ist, indem Sie den Ressourcennamen einer Kontaktgruppe angeben.
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 bestehenden Kontaktgruppe, die dem authentifizierten Nutzer gehört.

REST-Ressource: v1.contactGroups.members

Methoden
modify POST /v1/{resourceName=contactGroups/*}/members:modify
Mitglieder einer Kontaktgruppe des authentifizierten Nutzers ändern.

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

Mutate-Anfragen für denselben Nutzer sollten nacheinander gesendet werden, um erhöhte Latenz und Fehler zu vermeiden.

list GET /v1/otherContacts
Alle „Anderen Kontakte“ auflisten, also Kontakte, die keiner Gruppe angehören
search GET /v1/otherContacts:search
Stellt eine Liste der Kontakte in den anderen Kontakten des authentifizierten Nutzers bereit, die der Suchanfrage entsprechen.

REST-Ressource: v1.people

Methoden
batchCreateContacts POST /v1/people:batchCreateContacts

Erstellen Sie einen Batch neuer Kontakte und geben Sie die Personenantworten für die neu

Mutate-Anfragen für denselben Nutzer sollten nacheinander gesendet werden, um erhöhte Latenz und Fehler zu vermeiden.

batchDeleteContacts POST /v1/people:batchDeleteContacts
Löschen Sie mehrere Kontakte.
batchUpdateContacts POST /v1/people:batchUpdateContacts
Aktualisieren Sie einen Batch von Kontakten und geben Sie eine Zuordnung der Ressourcennamen an PersonResponses für die aktualisierten Kontakte zurück.
createContact POST /v1/people:createContact
Erstellen Sie einen neuen Kontakt und geben Sie die Ressource der Person für diesen Kontakt zurück.
deleteContact DELETE /v1/{resourceName=people/*}:deleteContact
Löschen Sie eine Kontaktperson.
deleteContactPhoto DELETE /v1/{resourceName=people/*}:deleteContactPhoto
Das Foto eines Kontakts löschen.
get GET /v1/{resourceName=people/*}
Stellt Informationen zu einer Person bereit, indem ein Ressourcenname angegeben wird.
getBatchGet GET /v1/people:batchGet
Stellt Informationen zu einer Liste bestimmter Personen bereit, indem eine Liste der angeforderten Ressourcennamen angegeben wird.
listDirectoryPeople GET /v1/people:listDirectoryPeople
Stellt eine Liste von Domainprofilen und Domainkontakten 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
Enthält eine Liste von Domainprofilen und Domainkontakten im Domainverzeichnis des authentifizierten Nutzers, die der Suchanfrage entsprechen.
updateContact PATCH /v1/{person.resourceName=people/*}:updateContact
Aktualisieren Sie die Kontaktdaten einer Kontaktperson.
updateContactPhoto PATCH /v1/{resourceName=people/*}:updateContactPhoto
Foto eines Kontakts aktualisieren

REST-Ressource: v1.people.connections

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