Method: people.get

Gibt Informationen zu einer Person an, indem ein Ressourcenname angegeben wird. Verwenden Sie people/me, um den authentifizierten Nutzer anzugeben.

Die Anfrage gibt einen 400-Fehler zurück, wenn „personFields“ nicht angegeben ist.

HTTP-Anfrage

GET https://people.googleapis.com/v1/{resourceName=people/*}

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
resourceName

string

Erforderlich. Der Ressourcenname der Person, zu der Informationen bereitgestellt werden sollen.

  • Geben Sie people/me an, um Informationen zum authentifizierten Nutzer abzurufen.
  • Geben Sie people/{account_id} an, um Informationen zu einem Google-Konto abzurufen.
  • Um Informationen zu einem Kontakt abzurufen, geben Sie den Ressourcennamen an, der den Kontakt als von people.connections.list zurückgegeben identifiziert.

Abfrageparameter

Parameter
requestMask
(deprecated)

object (RequestMask)

Eingestellt (nutzen Sie stattdessen personFields)

Eine Maske, die Ergebnisse auf eine Teilmenge von Personenfeldern beschränkt.
personFields

string (FieldMask format)

Erforderlich. Eine Feldmaske zur Einschränkung der zurückgegebenen Felder der Person. Sie können mehrere Felder angeben, indem Sie sie durch Kommas trennen. Gültige Werte sind:

  • addresses
  • Altersbereiche
  • Biografien
  • Geburtstage
  • calendarUrls
  • Kundendaten
  • Cover Photos
  • emailAddresses
  • Veranstaltungen
  • Externe IDs
  • geschlechter
  • Kunden
  • interessen
  • locales
  • Standorte
  • mitgliedschaft
  • metadata
  • Sonstige Keywords
  • names
  • Spitznamen
  • Berufe
  • organizations
  • phoneNumbers
  • fotos
  • Beziehungen
  • sipAdressen
  • skills
  • URLs
  • Benutzerdefiniert
sources[]

enum (ReadSourceType)

Optional. Eine Maske, welche Quelltypen zurückgegeben werden sollen. Wenn kein Wert festgelegt ist, werden standardmäßig READ_SOURCE_TYPE_PROFILE und READ_SOURCE_TYPE_CONTACT verwendet.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext eine Instanz von Person.

Autorisierungsbereiche

Für den Zugriff auf öffentliche Daten ist keine Autorisierung erforderlich. Für private Daten ist einer der folgenden OAuth-Bereiche erforderlich:

  • https://www.googleapis.com/auth/contacts
  • https://www.googleapis.com/auth/contacts.readonly
  • https://www.googleapis.com/auth/directory.readonly
  • https://www.googleapis.com/auth/profile.agerange.read
  • https://www.googleapis.com/auth/profile.emails.read
  • https://www.googleapis.com/auth/profile.language.read
  • https://www.googleapis.com/auth/user.addresses.read
  • https://www.googleapis.com/auth/user.birthday.read
  • https://www.googleapis.com/auth/user.emails.read
  • https://www.googleapis.com/auth/user.gender.read
  • https://www.googleapis.com/auth/user.organization.read
  • https://www.googleapis.com/auth/user.phonenumbers.read
  • https://www.googleapis.com/auth/userinfo.email
  • https://www.googleapis.com/auth/userinfo.profile

Weitere Informationen finden Sie im Autorisierungsleitfaden.