REST Resource: people

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

object (Source)

Die Datenquellen der Person.

string

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

Der Ressourcenname kann sich ändern, wenn Sie Felder hinzufügen oder entfernen, die einen Kontakt und ein Profil enthalten, z. B. eine bestätigte E-Mail-Adresse, Telefonnummer oder Profil-URL.

string

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

boolean

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

enum (ObjectType)

Nur Ausgabe. Eingestellt (nutzen Sie stattdessen person.metadata.sources.profileMetadata.objectType)

Der Typ des Person-Objekts.

{
  "type": enum (SourceType),
  "id": string,
  "etag": string,
  "updateTime": string,
  "profileMetadata": {
    object (ProfileMetadata)
  }
}

enum (SourceType)

Der Quelltyp.

string

Die eindeutige Kennung innerhalb des vom Server generierten Quelltyps.

string

Wird nur in person.metadata.sources ausgefüllt.

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

string (Timestamp format)

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

Zeitstempel der letzten Aktualisierung dieser Quelle.

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

object (ProfileMetadata)

Nur Ausgabe. Wird 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 Profilobjekttyp.

enum (UserType)

Nur Ausgabe. Der Nutzer tippt.

{
  "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. Wenn der Nutzer dies nicht festlegt, wird es automatisch aus strukturierten Werten erstellt.

string

Der Typ der Adresse. Es kann ein benutzerdefinierter Typ oder einer der folgenden vordefinierten Werte sein:

• home
• work
• other

string

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

string

Das Postfach der Adresse.

string

Die Adresse.

string

Die erweiterte Adresse der Adresse, z. B. die Wohnungsnummer.

string

Die Stadt der Adresse.

string

Die Region der Adresse, z. B. das Bundesland.

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. Wahr, wenn das Feld das primäre Feld für alle Quellen in der Person ist. Jede Person hat maximal ein Feld, in dem primary auf „true“ gesetzt ist.

boolean

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

boolean

Nur Ausgabe. Der Wert ist „true“, wenn das Feld bestätigt ist, und „false“, wenn das Feld nicht bestätigt ist. Ein bestätigtes Feld ist in der Regel ein Name, eine E-Mail-Adresse, eine Telefonnummer oder eine Website, für die die Person 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 Geburtsdatums.

string

Verwenden Sie das Feld date, falls festgelegt.

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. Der Wert muss zwischen 1 und 9999 oder 0 liegen, wenn ein Datum ohne Jahr angegeben werden soll.

integer

Monat eines Jahres. Der Wert muss zwischen 1 und 12 oder 0 liegen, damit ein Jahr ohne Monat und Tag angegeben werden kann.

integer

Tag eines Monats. Der Wert muss zwischen 1 und 31 liegen und für das Jahr und den Monat gültig sein. Sie kann auch 0 sein, um nur ein Jahr oder ein Jahr und einen Monat anzugeben, bei denen der Tag keine Bedeutung hat.

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

object (FieldMetadata)

Metadaten zu "Dies und Das".

string

Das prahlen, 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

Der Typ der Kalender-URL. Es kann ein benutzerdefinierter Typ oder einer der folgenden vordefinierten Werte sein:

• home
• freeBusy
• work

string

Nur Ausgabe. Die Art der Kalender-URL, die in der Sprache des Kontos des Betrachters übersetzt oder formatiert ist, oder der Sprache des Accept-Language-HTTP-Headers.

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

object (FieldMetadata)

Metadaten zu den Kundendaten.

string

Der vom Client angegebene Schlüssel der Clientdaten.

string

Der vom Client angegebene Wert der Clientdaten.

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

object (FieldMetadata)

Metadaten zum Titelbild.

string

Die URL des Titelbilds.

boolean

„True“, wenn das Hintergrundbild das Standardtitelbild ist; „False“, wenn es 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. Es kann ein benutzerdefinierter Typ oder einer der folgenden vordefinierten Werte sein:

• home
• work
• other

string

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

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. Es kann ein benutzerdefinierter Typ oder einer der folgenden vordefinierten Werte sein:

• anniversary
• other

string

Nur Ausgabe. Die Art des Ereignisses, die in der Sprache des Kontos des Betrachters übersetzt oder formatiert ist, oder in der Sprache des Accept-Language-HTTP-Headers.

{
  "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. Es kann ein benutzerdefinierter Typ oder einer der folgenden vordefinierten Werte sein:

• account
• customer
• loginId
• network
• organization

string

Nur Ausgabe. Die Art des Ereignisses, die in der Sprache des Kontos des Betrachters übersetzt oder formatiert ist, oder in der Sprache des Accept-Language-HTTP-Headers.

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

object (FieldMetadata)

Metadaten über die Datei-as.

string

Der Wert unter „file-as“

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

object (FieldMetadata)

Metadaten zum Geschlecht.

string

Das Geschlecht für die Person. Das Geschlecht kann benutzerdefiniert sein oder einen der folgenden vordefinierten Werte haben:

• male
• female
• unspecified

string

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

string

Textfeld im freien Format für Pronomen, mit dem die Person angesprochen werden soll. Häufige Werte:

• 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 User-Name.

string

Der Typ des IM-Clients. Es kann ein benutzerdefinierter Typ oder einer der folgenden vordefinierten Werte sein:

• home
• work
• other

string

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

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, der in der Sprache des Kontokontos des Nutzers oder der Accept-Language-HTTP-Header-Sprache formatiert ist.

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

object (FieldMetadata)

Metadaten zum Interesse.

string

Das Interesse, z. B. stargazing.

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

object (FieldMetadata)

Metadaten zum Gebietsschema.

string

Das wohlgeformte IETF BCP 47-Sprachtag, das die Sprache darstellt.

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

object (FieldMetadata)

Metadaten zum Standort.

string

Der Wert im freien Format des Standorts.

string

Der Typ des Standorts. Es kann ein benutzerdefinierter Typ oder einer der folgenden vordefinierten Werte sein:

• desk
• grewUp

boolean

Gibt an, ob der Standort der aktuelle Standort ist.

string

Die Gebäude-ID.

string

Name oder Nummer der Etage

string

Der Etagenabschnitt in floor_name.

string

Der individuelle Arbeitsplatz.

{
  "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 der Kontaktgruppe.

object (DomainMembership)

Nur Ausgabe. Die Domainmitgliedschaft.

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

string

Nur Ausgabe. Die Kontaktgruppen-ID für die Mitgliedschaft in der Kontaktgruppe.

string

Der Ressourcenname für die Kontaktgruppe, der vom Server zugewiesen wurde. Ein ASCII-String im Format contactGroups/{contactGroupId}. Nur contactGroupResourceName kann zum Ändern von Mitgliedschaften verwendet werden. Jede Kontaktgruppenmitgliedschaft kann entfernt werden, es können jedoch nur Nutzergruppen oder Mitglieder aus „myContacts“ oder „markierte“ Systemgruppen hinzugefügt werden. Ein Kontakt muss immer mindestens eine Kontaktgruppenmitgliedschaft haben.

{
  "inViewerDomain": boolean
}

boolean

Dieser Wert ist „True“, 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 diversen Keyword.

string

Der Wert des anderen Keywords.

enum (KeywordType)

Der Keyword-Typ „Sonstiges“.

string

Nur Ausgabe. Der Typ des Keywords, das in der Sprache des Kontos des Betrachters übersetzt oder formatiert ist, oder der Sprache des Accept-Language-HTTP-Headers.

{
  "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 gemäß dem im Konto des Betrachters angegebenen Gebietsschema oder dem Accept-Language-HTTP-Header formatiert ist.

string

Nur Ausgabe. Der Anzeigename mit dem letzten Namen, der zuerst gemäß dem im Konto des Nutzers angegebenen Gebietsschema oder dem Accept-Language-HTTP-Header formatiert ist.

string

Der Wert für das kostenlose Format.

string

Der Familienname.

string

Der angegebene Name.

string

Zweiter Vorname

string

Die wichtigsten Präfixe, z. B. Mrs. oder Dr.

string

Ehrliche Suffixe, z. B. Jr.

string

Der vollständige Name, wie er buchstabiert wird.

string

Der Schreibweise des Familiennamens.

string

Der angegebene Name wird so geschrieben, wie es klingt.

string

Der zweite Vorname in der Schreibweise.

string

Die Präfixe werden nach ihrem Klang buchstabiert.

string

Die heiligen Suffixe, die so buchstabiert werden, wie sie klingen.

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

object (FieldMetadata)

Metadaten zum Alias.

string

Das Alias.

enum (NicknameType)

Der Typ des Alias.

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

object (FieldMetadata)

Metadaten zur Tätigkeit.

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

Der Typ der Organisation. Es kann ein benutzerdefinierter Typ oder einer der folgenden vordefinierten Werte sein:

• work
• school

string

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

object (Date)

Das Startdatum der Person, die 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 die Organisation eine frühere Organisation ist.

string

Der Name der Organisation

string

Der phonetische Name der Organisation.

string

Die Abteilung der Person in der Organisation.

string

Die Berufsbezeichnung der Person in der Organisation.

string

Die Stellenbeschreibung der Person in der Organisation.

string

Das mit der Organisation verknüpfte Symbol, z. B. ein Börsentickersymbol, 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

Die Kostenstelle der Person in der Organisation.

integer

Vollzeitbeschäftigung der Person in Millisekunden innerhalb 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. Die kanonische ITU-T E.164-Form der Telefonnummer.

string

Der Typ der Telefonnummer. Es kann ein benutzerdefinierter Typ oder einer der folgenden vordefinierten Werte sein:

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

string

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

{
  "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 am Ende der URL einen Suchparameter sz={size} anhängen, wobei {size} die Größe in Pixeln ist. Beispiel: https://lh3.googleusercontent.com/-T_wVWLlmg7w/AAAAAAAAAAI/AAAAAAAABa8/00gzXvDBYqw/s100/photo.jpg?sz=50

boolean

Der Wert ist „true“, wenn das Foto ein Standardfoto ist, und „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. Es kann ein benutzerdefinierter Typ oder einer der folgenden vordefinierten Werte sein:

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

string

Nur Ausgabe. Die Art der Beziehung, die in der Sprache des Kontoinhabers oder 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, die die Person sucht. Der Wert kann benutzerdefiniert oder einer der folgenden vordefinierten Werte sein:

• friend
• date
• relationship
• networking

string

Nur Ausgabe. Der Wert des Beziehungsinteresses, der in der Sprache des Kontos des Nutzers oder der im HTTP-Header „Accept-Language“ angegebenen Sprache formatiert und formatiert ist.

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

object (FieldMetadata)

Metadaten zum Beziehungsstatus.

string

Der Beziehungsstatus. Der Wert kann benutzerdefiniert 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 Kontos des Betrachters übersetzt oder formatiert ist, oder in der Sprache des Accept-Language-HTTP-Headers.

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

object (FieldMetadata)

Metadaten zur Residenz.

string

Die Adresse des Wohnsitzes.

boolean

„Wahr“, wenn der Wohnsitz der aktuelle Wohnsitz der Person ist; „falsch“, wenn der Wohnsitz in der Vergangenheit liegt.

{
  "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. Der Typ kann benutzerdefiniert oder einer der folgenden vordefinierten Werte sein:

• home
• work
• mobile
• other

string

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

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

object (FieldMetadata)

Metadaten zum Skill.

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. Es kann ein benutzerdefinierter Typ oder einer der folgenden vordefinierten Werte sein:

• 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 Kontoinhabers übersetzt oder formatiert wurde, oder der Sprache des Accept-Language-HTTP-Headers.

{
  "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.