REST Resource: people

Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

{
  "sources": [
    {
      object (Source)
    }
  ],
  "previousResourceNames": [
    string
  ],
  "linkedPeopleResourceNames": [
    string
  ],
  "deleted": boolean,
  "objectType": enum (ObjectType)
}

object (Source)

Die Datenquellen für die Person.

string

Nur Ausgabe. Alle früheren Ressourcennamen dieser Person. Wird nur für people.connections.list-Anfragen ausgefüllt, die ein Synchronisierungstoken enthalten.

Der Ressourcenname kann sich ändern, wenn Felder hinzugefügt oder entfernt werden, die einen Kontakt und ein Profil verknüpfen, z. B. eine bestätigte E-Mail-Adresse, bestätigte Telefonnummer oder Profil-URL.

string

Nur Ausgabe. Ressourcennamen von Personen, die mit dieser Ressource verknüpft sind.

boolean

Nur Ausgabe. Wahr, wenn die Personenressource gelöscht wurde. Wird nur für people.connections.list- und otherContacts.list-Synchronisierungsanfragen ausgefüllt.

enum (ObjectType)

Nur Ausgabe. EINGESTELLT (Bitte verwende stattdessen person.metadata.sources.profileMetadata.objectType.)

Der Typ des Personenobjekts.

{
  "type": enum (SourceType),
  "id": string,
  "etag": string,
  "updateTime": string,

  // Union field metadata can be only one of the following:
  "profileMetadata": {
    object (ProfileMetadata)
  }
  // End of list of possible types for union field metadata.
}

enum (SourceType)

Der Quelltyp.

string

Die eindeutige Kennung innerhalb des vom Server generierten Quelltyps.

string

Nur in person.metadata.sources ausgefüllt.

Das HTTP-Entitäts-Tag der Quelle. Wird für die Web-Cache-Validierung verwendet.

string (Timestamp format)

Nur Ausgabe. Nur in person.metadata.sources ausgefüllt.

Zeitstempel der letzten Aktualisierung dieser Quelle.

Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".

object (ProfileMetadata)

Nur Ausgabe. Nur in person.metadata.sources ausgefüllt.

Metadaten zu einer Quelle vom Typ PROFILE.

{
  "objectType": enum (ObjectType),
  "userTypes": [
    enum (UserType)
  ]
}

enum (ObjectType)

Nur Ausgabe. Der Objekttyp des Profils.

enum (UserType)

Nur Ausgabe. Die Nutzereingabe.

{
  "metadata": {
    object (FieldMetadata)
  },
  "formattedValue": string,
  "type": string,
  "formattedType": string,
  "poBox": string,
  "streetAddress": string,
  "extendedAddress": string,
  "city": string,
  "region": string,
  "postalCode": string,
  "country": string,
  "countryCode": string
}

object (FieldMetadata)

Metadaten zur Adresse.

string

Der unstrukturierte Wert der Adresse. Wird sie nicht vom Nutzer festgelegt, wird sie automatisch aus strukturierten Werten erstellt.

string

Der Typ der Adresse. Beim Typ kann es sich um einen benutzerdefinierten Wert oder einen der folgenden vordefinierten Werte handeln:

• home
• work
• other

string

Nur Ausgabe. Der Typ der Adresse, die in der Sprache des Kontos des Betrachters oder der Sprache des HTTP-Headers Accept-Language übersetzt und formatiert wurde.

string

Das P.O. der Adresse ein.

string

Die Adresse.

string

Die erweiterte Adresse der Adresse zum Beispiel die Wohnungsnummer.

string

Die Stadt der Adresse.

string

Die Region der Adresse z. B. das Bundesland oder die Provinz.

string

Die Postleitzahl der Adresse.

string

Das Land der Adresse.

string

Der Ländercode der Adresse nach ISO 3166-1 alpha-2.

{
  "primary": boolean,
  "sourcePrimary": boolean,
  "verified": boolean,
  "source": {
    object (Source)
  }
}

boolean

Nur Ausgabe. „True“, wenn das Feld das primäre Feld für alle Quellen in der Person ist. Jede Person hat höchstens ein Feld, für das primary auf „true“ gesetzt ist.

boolean

"True", wenn das Feld das primäre Feld für source ist. Jede Quelle darf höchstens ein Feld haben, für das sourcePrimary auf „true“ gesetzt ist.

boolean

Nur Ausgabe. "True", wenn das Feld verifiziert ist false, wenn das Feld ungeprüft ist. Ein bestätigtes Feld ist in der Regel ein Name, eine E-Mail-Adresse, eine Telefonnummer oder eine Website, deren Inhaber bestätigt wurde.

object (Source)

Die Quelle des Felds.

{
  "metadata": {
    object (FieldMetadata)
  },
  "ageRange": enum (AgeRange)
}

object (FieldMetadata)

Metadaten zur Altersgruppe.

enum (AgeRange)

Die Altersgruppe.

{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string,
  "contentType": enum (ContentType)
}

object (FieldMetadata)

Metadaten zur Biografie.

string

Die kurze Biografie.

enum (ContentType)

Der Inhaltstyp der Biografie.

{
  "metadata": {
    object (FieldMetadata)
  },
  "date": {
    object (Date)
  },
  "text": string
}

object (FieldMetadata)

Metadaten zum Geburtstag.

object (Date)

Das strukturierte Datum des Geburtstags.

string

Falls festgelegt, wird bevorzugt das Feld date verwendet.

Ein String im freien Format, der das Geburtsdatum des Nutzers darstellt. Dieser Wert ist nicht validiert.

{
  "year": integer,
  "month": integer,
  "day": integer
}

integer

Jahr des Datums. Muss zwischen 1 und 9999 liegen oder 0, um ein Datum ohne Jahr anzugeben.

integer

Monat eines Jahres. Muss zwischen 1 und 12 liegen oder 0, um ein Jahr ohne Monat und Tag anzugeben.

integer

Tag im Monat. Muss zwischen 1 und 31 liegen und für das Jahr und den Monat gültig sein, oder 0, um ein Jahr allein oder ein Jahr und Monat anzugeben, wenn der Tag nicht von Bedeutung ist.

{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string
}

object (FieldMetadata)

Metadaten zum Angeben.

string

Angeben, z. B. climbed mount everest.

{
  "metadata": {
    object (FieldMetadata)
  },
  "url": string,
  "type": string,
  "formattedType": string
}

object (FieldMetadata)

Metadaten zur Kalender-URL.

string

Die Kalender-URL.

string

Typ der Kalender-URL. Beim Typ kann es sich um einen benutzerdefinierten Wert oder einen der folgenden vordefinierten Werte handeln:

• home
• freeBusy
• work

string

Nur Ausgabe. Der Typ der Kalender-URL, die in der Sprache des Zuschauers oder in der Accept-Language-HTTP-Header-Sprache übersetzt und formatiert wurde.

{
  "metadata": {
    object (FieldMetadata)
  },
  "key": string,
  "value": string
}

object (FieldMetadata)

Metadaten zu den Kundendaten.

string

Der vom Kunden angegebene Schlüssel der Kundendaten.

string

Der vom Kunden angegebene Wert für die Kundendaten.

{
  "metadata": {
    object (FieldMetadata)
  },
  "url": string,
  "default": boolean
}

object (FieldMetadata)

Metadaten zum Titelbild.

string

Die URL des Titelbilds.

boolean

„True“, wenn das Titelbild das Standardtitelbild ist false, wenn das Titelbild ein vom Nutzer bereitgestelltes Hintergrundbild ist.

{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string,
  "type": string,
  "formattedType": string,
  "displayName": string
}

object (FieldMetadata)

Metadaten zur E-Mail-Adresse.

string

Die E-Mail-Adresse.

string

Der Typ der E-Mail-Adresse. Beim Typ kann es sich um einen benutzerdefinierten Wert oder einen der folgenden vordefinierten Werte handeln:

• home
• work
• other

string

Nur Ausgabe. Der Typ der E-Mail-Adresse, die in der Sprache des Zuschauers oder in der Accept-Language-HTTP-Header-Sprache übersetzt und formatiert wurde.

string

Der Anzeigename der E-Mail.

{
  "metadata": {
    object (FieldMetadata)
  },
  "date": {
    object (Date)
  },
  "type": string,
  "formattedType": string
}

object (FieldMetadata)

Metadaten zum Ereignis.

object (Date)

Das Datum des Ereignisses.

string

Der Typ des Ereignisses. Beim Typ kann es sich um einen benutzerdefinierten Wert oder einen der folgenden vordefinierten Werte handeln:

• anniversary
• other

string

Nur Ausgabe. Der Typ des Ereignisses, das in der Sprache des Zuschauers oder in der Sprache des HTTP-Headers Accept-Language übersetzt und formatiert wurde.

{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string,
  "type": string,
  "formattedType": string
}

object (FieldMetadata)

Metadaten zur externen ID.

string

Der Wert der externen ID.

string

Der Typ der externen ID. Beim Typ kann es sich um einen benutzerdefinierten Wert oder einen der folgenden vordefinierten Werte handeln:

• account
• customer
• loginId
• network
• organization

string

Nur Ausgabe. Der Typ des Ereignisses, das in der Sprache des Zuschauers oder in der Sprache des HTTP-Headers Accept-Language übersetzt und formatiert wurde.

{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string
}

object (FieldMetadata)

Metadaten zu „file-as“.

string

Der Wert „file-as“

{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string,
  "formattedValue": string,
  "addressMeAs": string
}

object (FieldMetadata)

Metadaten zum Geschlecht.

string

Das Geschlecht der Person. Das Geschlecht kann benutzerdefiniert sein oder einer der folgenden vordefinierten Werte:

• male
• female
• unspecified

string

Nur Ausgabe. Der Wert des Geschlechts, der in der Sprache des Zuschauers oder im HTTP-Header „Accept-Language“ übersetzt und formatiert wurde. Nicht angegebene oder benutzerdefinierte Werte sind nicht lokalisiert.

string

Textfeld in freiem Format für Pronomen, mit dem die Person angesprochen werden soll. Gängige Werte sind:

• he/him
• she/her
• they/them

{
  "metadata": {
    object (FieldMetadata)
  },
  "username": string,
  "type": string,
  "formattedType": string,
  "protocol": string,
  "formattedProtocol": string
}

object (FieldMetadata)

Metadaten zum IM-Client.

string

Der im IM-Client verwendete Nutzername.

string

Der Typ des IM-Clients. Beim Typ kann es sich um einen benutzerdefinierten Wert oder einen der folgenden vordefinierten Werte handeln:

• home
• work
• other

string

Nur Ausgabe. Der Typ des IM-Clients, der in die Sprache des Zuschauers oder für den HTTP-Header „Accept-Language“ übersetzt und formatiert wurde.

string

Das Protokoll des IM-Clients. Das Protokoll kann benutzerdefiniert oder einer der folgenden vordefinierten Werte sein:

• aim
• msn
• yahoo
• skype
• qq
• googleTalk
• icq
• jabber
• netMeeting

string

Nur Ausgabe. Das Protokoll des IM-Clients, formatiert in der Sprache des Zuschauers oder im HTTP-Header-Gebiet Accept-Language.

{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string
}

object (FieldMetadata)

Metadaten zum Interesse.

string

Das Interesse z. B. stargazing.

{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string
}

object (FieldMetadata)

Metadaten zur Sprache.

string

Das korrekt formatierte Sprach-Tag IETF BCP 47 für die Sprache.

{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string,
  "type": string,
  "current": boolean,
  "buildingId": string,
  "floor": string,
  "floorSection": string,
  "deskCode": string
}

object (FieldMetadata)

Metadaten zum Standort.

string

Wert des Standorts im freien Format

string

Der Typ des Standorts. Beim Typ kann es sich um einen benutzerdefinierten Wert oder einen der folgenden vordefinierten Werte handeln:

• desk
• grewUp

boolean

Gibt an, ob es sich bei dem Standort um den aktuellen Standort handelt.

string

Die Gebäude-ID.

string

Der Name oder die Etage.

string

Der Etagenabschnitt in floor_name.

string

Der Standort des einzelnen Desktops.

{
  "metadata": {
    object (FieldMetadata)
  },

  // Union field membership can be only one of the following:
  "contactGroupMembership": {
    object (ContactGroupMembership)
  },
  "domainMembership": {
    object (DomainMembership)
  }
  // End of list of possible types for union field membership.
}

object (FieldMetadata)

Metadaten zur Mitgliedschaft.

object (ContactGroupMembership)

Die Mitgliedschaft in einer Kontaktgruppe.

object (DomainMembership)

Nur Ausgabe. Die Domainmitgliedschaft.

{
  "contactGroupId": string,
  "contactGroupResourceName": string
}

string

Nur Ausgabe. Die Kontaktgruppen-ID für die Kontaktgruppenmitgliedschaft.

string

Der vom Server zugewiesene Ressourcenname für die Kontaktgruppe. Ein ASCII-String im Format contactGroups/{contactGroupId}. Nur contactGroupResourceName kann zum Ändern von Mitgliedschaften verwendet werden. Jede Mitgliedschaft in Kontaktgruppe kann entfernt werden, aber nur die Nutzergruppe oder "myContacts" oder "markiert" Mitgliedschaften in Systemgruppen hinzugefügt werden können. Ein Kontakt muss immer mindestens eine Kontaktgruppenzugehörigkeit haben.

{
  "inViewerDomain": boolean
}

boolean

Dieser Wert ist auf „True“ gesetzt, wenn sich die Person in der Google Workspace-Domain des Betrachters befindet.

{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string,
  "type": enum (KeywordType),
  "formattedType": string
}

object (FieldMetadata)

Metadaten zum sonstigen Keyword

string

Der Wert des sonstigen Keywords.

enum (KeywordType)

Der Keyword-Typ „Sonstiges“.

string

Nur Ausgabe. Der Typ des Keywords, das für das Konto des Zuschauers übersetzt und formatiert wurde oder in der Accept-Language-HTTP-Header-Sprache übersetzt wurde.

{
  "metadata": {
    object (FieldMetadata)
  },
  "displayName": string,
  "displayNameLastFirst": string,
  "unstructuredName": string,
  "familyName": string,
  "givenName": string,
  "middleName": string,
  "honorificPrefix": string,
  "honorificSuffix": string,
  "phoneticFullName": string,
  "phoneticFamilyName": string,
  "phoneticGivenName": string,
  "phoneticMiddleName": string,
  "phoneticHonorificPrefix": string,
  "phoneticHonorificSuffix": string
}

object (FieldMetadata)

Metadaten zum Namen.

string

Nur Ausgabe. Der Anzeigename, der in der Sprache formatiert ist, die im Konto des Zuschauers oder im Accept-Language-HTTP-Header angegeben ist.

string

Nur Ausgabe. Der Anzeigename mit dem Nachnamen, der zuerst gemäß der Sprache formatiert ist, die im Konto des Zuschauers oder im Accept-Language-HTTP-Header angegeben ist.

string

Der Wert für den Namen im freien Format.

string

Der Familienname.

string

Der Vorname.

string

Zweiter Vorname(n).

string

Die Ehrenpräfixe wie Mrs. oder Dr.

string

Die ehrenamtlichen Suffixe wie Jr.

string

Der vollständige Name, wie er sich anhört.

string

Der Familienname, wie er klingt.

string

Der Vorname, wie er sich anhört.

string

Der oder die zweite(r) Vorname(n) wird so buchstabiert, wie sie klingen.

string

Die buchstabierten Präfixe, wie sie klingen.

string

Die buchstabierten Suffixe, wie sie klingen.

{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string,
  "type": enum (NicknameType)
}

object (FieldMetadata)

Metadaten zum Alias.

string

Der Spitzname.

enum (NicknameType)

Der Typ des Alias.

{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string
}

object (FieldMetadata)

Metadaten zum Beruf.

string

Der Beruf: z. B. carpenter.

{
  "metadata": {
    object (FieldMetadata)
  },
  "type": string,
  "formattedType": string,
  "startDate": {
    object (Date)
  },
  "endDate": {
    object (Date)
  },
  "current": boolean,
  "name": string,
  "phoneticName": string,
  "department": string,
  "title": string,
  "jobDescription": string,
  "symbol": string,
  "domain": string,
  "location": string,
  "costCenter": string,
  "fullTimeEquivalentMillipercent": integer
}

object (FieldMetadata)

Metadaten zur Organisation.

string

Die Art der Organisation. Beim Typ kann es sich um einen benutzerdefinierten Wert oder einen der folgenden vordefinierten Werte handeln:

• work
• school

string

Nur Ausgabe. Der Typ der Organisation, der in der Sprache des Zuschauers oder in der Accept-Language-HTTP-Header-Sprache übersetzt und formatiert wurde.

object (Date)

Das Startdatum, an dem die Person der Organisation beigetreten ist.

object (Date)

Das Enddatum, an dem die Person die Organisation verlassen hat.

boolean

„True“, wenn die Organisation die aktuelle Organisation der Person ist false, wenn es sich bei der Organisation um eine frühere Organisation handelt.

string

Der Name der Organisation

string

Der phonetische Name der Organisation.

string

Die Abteilung der Person in der Organisation.

string

Die Berufsbezeichnung der Person im Unternehmen.

string

Die Stellenbeschreibung der Person in der Organisation.

string

Symbol für die Organisation beispielsweise ein Börsenkürzel, eine Abkürzung oder ein Akronym.

string

Der mit der Organisation verknüpfte Domainname z. B. google.com.

string

Der Standort des Unternehmens, in dem die Person arbeitet.

string

Kostenstelle der Person in der Organisation.

integer

Der Milliprozentsatz der Person in Vollzeit in der Organisation (100.000 = 100%).

{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string,
  "canonicalForm": string,
  "type": string,
  "formattedType": string
}

object (FieldMetadata)

Metadaten zur Telefonnummer.

string

Die Telefonnummer.

string

Nur Ausgabe. Das kanonische Format ITU-T E.164 der Telefonnummer.

string

Der Typ der Telefonnummer. Beim Typ kann es sich um einen benutzerdefinierten Wert oder einen der folgenden vordefinierten Werte handeln:

• home
• work
• mobile
• homeFax
• workFax
• otherFax
• pager
• workMobile
• workPager
• main
• googleVoice
• other

string

Nur Ausgabe. Der Typ der Telefonnummer, die in der Sprache des Zuschauers oder in der Accept-Language-HTTP-Header-Sprache übersetzt und formatiert ist.

{
  "metadata": {
    object (FieldMetadata)
  },
  "url": string,
  "default": boolean
}

object (FieldMetadata)

Metadaten zum Foto.

string

Die URL des Fotos. Sie können die gewünschte Größe ändern, indem Sie den Suchparameter sz={size} an das Ende der URL anhängen, wobei {size} für die Größe in Pixeln steht. Beispiel: https://lh3.googleusercontent.com/-T_wVWLlmg7w/AAAAAAAAAAI/AAAAAAAABa8/00gzXvDBYqw/s100/photo.jpg?sz=50

boolean

"True", wenn das Foto ein Standardfoto ist; false, wenn das Foto ein vom Nutzer bereitgestelltes Foto ist.

{
  "metadata": {
    object (FieldMetadata)
  },
  "person": string,
  "type": string,
  "formattedType": string
}

object (FieldMetadata)

Metadaten zur Beziehung.

string

Der Name der anderen Person, auf die sich diese Beziehung bezieht.

string

Die Beziehung der Person zur anderen Person. Beim Typ kann es sich um einen benutzerdefinierten Wert oder einen der folgenden vordefinierten Werte handeln:

• spouse
• child
• mother
• father
• parent
• brother
• sister
• friend
• relative
• domesticPartner
• manager
• assistant
• referredBy
• partner

string

Nur Ausgabe. Der Typ der Beziehung, die in der Sprache des Zuschauers oder in der im HTTP-Header „Accept-Language“ angegebenen Sprache übersetzt und formatiert wurde.

{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string,
  "formattedValue": string
}

object (FieldMetadata)

Metadaten zum Beziehungsinteresse.

string

Die Art der Beziehung, nach der die Person sucht. Der Wert kann ein benutzerdefinierter Wert oder einer der folgenden vordefinierten Werte sein:

• friend
• date
• relationship
• networking

string

Nur Ausgabe. Der Wert des Beziehungsinteresses, der in der Sprache des Zuschauers oder in der im HTTP-Header „Accept-Language“ angegebenen Sprache übersetzt und formatiert wurde.

{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string,
  "formattedValue": string
}

object (FieldMetadata)

Metadaten zum Beziehungsstatus.

string

Der Beziehungsstatus. Der Wert kann ein benutzerdefinierter Wert oder einer der folgenden vordefinierten Werte sein:

• single
• inARelationship
• engaged
• married
• itsComplicated
• openRelationship
• widowed
• inDomesticPartnership
• inCivilUnion

string

Nur Ausgabe. Der Wert des Beziehungsstatus, der in der Sprache des Zuschauers oder im HTTP-Header „Accept-Language“ übersetzt und formatiert ist.

{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string,
  "current": boolean
}

object (FieldMetadata)

Metadaten zum Wohnsitz.

string

Die Adresse des Wohnsitzes.

boolean

Wahr, wenn es sich bei dem Wohnsitz um den derzeitigen Wohnsitz der Person handelt; false, wenn der Wohnsitz in der Vergangenheit war.

{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string,
  "type": string,
  "formattedType": string
}

object (FieldMetadata)

Metadaten zur SIP-Adresse.

string

Die SIP-Adresse im SIP-URI-Format RFC 3261 19.1.

string

Der Typ der SIP-Adresse. Beim Typ kann es sich um einen benutzerdefinierten Wert oder einen der folgenden vordefinierten Werte handeln:

• home
• work
• mobile
• other

string

Nur Ausgabe. Der Typ der SIP-Adresse, die in der Sprache des Zuschauers oder in der Accept-Language-HTTP-Header-Sprache übersetzt und formatiert ist.

{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string
}

object (FieldMetadata)

Metadaten zu der Fähigkeit.

string

Die Fähigkeit: z. B. underwater basket weaving.

{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string
}

object (FieldMetadata)

Metadaten zur Kurzinfo.

string

Die Kurzinfo.

{
  "metadata": {
    object (FieldMetadata)
  },
  "value": string,
  "type": string,
  "formattedType": string
}

object (FieldMetadata)

Metadaten zur URL.

string

Die URL.

string

Der Typ der URL. Beim Typ kann es sich um einen benutzerdefinierten Wert oder einen der folgenden vordefinierten Werte handeln:

• home
• work
• blog
• profile
• homePage
• ftp
• reservations
• appInstallPage: Website für eine Currents-Anwendung
• other

string

Nur Ausgabe. Der Typ der URL, die in der Sprache des Zuschauers oder in der Accept-Language-HTTP-Header-Sprache übersetzt und formatiert ist.

{
  "metadata": {
    object (FieldMetadata)
  },
  "key": string,
  "value": string
}

object (FieldMetadata)

Metadaten zu den benutzerdefinierten Daten.

string

Der vom Endnutzer angegebene Schlüssel der benutzerdefinierten Daten.

string

Der vom Endnutzer angegebene Wert der benutzerdefinierten Daten.