REST Resource: people

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

object (Source)

Sources des données de la personne.

string

Uniquement en sortie. Tous les anciens noms de ressources que cette personne a eus. Renseigné uniquement pour les requêtes people.connections.list qui incluent un jeton de synchronisation.

Le nom de la ressource peut changer lorsque vous ajoutez ou supprimez des champs qui associent un contact à un profil, comme une adresse e-mail validée, un numéro de téléphone validé ou une URL de profil.

string

Uniquement en sortie. Noms de ressources des personnes associées à cette ressource.

boolean

Uniquement en sortie. "True" si la ressource de personne a été supprimée. Renseigné uniquement pour les requêtes de synchronisation people.connections.list et otherContacts.list.

enum (ObjectType)

Uniquement en sortie. OBSOLÈTE (Veuillez utiliser person.metadata.sources.profileMetadata.objectType à la place.)

Type de l'objet personne.

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

Type de source.

string

Identifiant unique du type de source généré par le serveur.

string

Renseigné uniquement dans person.metadata.sources.

Tag d'entité HTTP de la source. Utilisé pour la validation du cache Web.

string (Timestamp format)

Uniquement en sortie. Renseigné uniquement dans person.metadata.sources.

Code temporel de la dernière mise à jour de cette source.

Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".

object (ProfileMetadata)

Uniquement en sortie. Renseigné uniquement dans person.metadata.sources.

Métadonnées sur une source de type PROFILE.

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

enum (ObjectType)

Uniquement en sortie. Type d'objet de profil.

enum (UserType)

Uniquement en sortie. L'utilisateur saisit.

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

Métadonnées sur l'adresse.

string

Valeur non structurée de l'adresse. Si cette valeur n'est pas définie par l'utilisateur, elle sera automatiquement créée à partir de valeurs structurées.

string

Type d'adresse. Le type peut être personnalisé ou l'une des valeurs prédéfinies suivantes:

• home
• work
• other

string

Uniquement en sortie. Type de l'adresse traduite et mise en forme dans les paramètres régionaux du compte de l'utilisateur ou dans les paramètres régionaux de l'en-tête HTTP Accept-Language.

string

Le P.O. de l'adresse.

string

Adresse postale.

string

Adresse étendue de l'adresse par exemple, le numéro d'appartement.

string

Ville de l'adresse.

string

Région de l'adresse par exemple l'État ou la province.

string

Code postal de l'adresse.

string

Pays de l'adresse.

string

Code pays ISO 3166-1 alpha-2 de l'adresse.

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

boolean

Uniquement en sortie. "True" si le champ est le champ principal pour toutes les sources de la personne. Chaque personne disposera au maximum d'un champ pour lequel primary sera défini sur "true".

boolean

"True" si le champ est le champ principal de source. Chaque source doit comporter au maximum un champ pour lequel sourcePrimary est défini sur "true".

boolean

Uniquement en sortie. "True" si le champ est validé. "false" si le champ n'est pas validé. Un champ validé correspond généralement à un nom, une adresse e-mail, un numéro de téléphone ou un site Web dont l'appartenance à la personne a été confirmée.

object (Source)

Source du champ.

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

object (FieldMetadata)

Métadonnées sur la tranche d'âge.

enum (AgeRange)

Tranche d'âge.

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

object (FieldMetadata)

Métadonnées sur la biographie.

string

Brève biographie.

enum (ContentType)

Type de contenu de la biographie.

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

object (FieldMetadata)

Métadonnées sur l'anniversaire.

object (Date)

Date structurée de l'anniversaire.

string

Il est préférable d'utiliser le champ date s'il est défini.

Chaîne au format libre représentant la date de naissance de l'utilisateur. Cette valeur n'est pas validée.

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

integer

Année de la date. Doit être comprise entre 1 et 9999, ou 0 pour indiquer une date sans année.

integer

Mois de l'année. La valeur doit être comprise entre 1 et 12, ou égale à 0 pour spécifier une année sans mois ni jour.

integer

Jour du mois. Doit être compris entre 1 et 31, et valide pour l'année et le mois, ou 0 pour indiquer une année seule, ou une année et un mois où le jour n'est pas significatif.

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

object (FieldMetadata)

Métadonnées sur vos plus belles réussites.

string

Les plus belles réussites Exemple : climbed mount everest.

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

object (FieldMetadata)

Métadonnées sur l'URL de l'agenda.

string

URL de l'agenda.

string

Type d'URL de l'agenda. Le type peut être personnalisé ou l'une des valeurs prédéfinies suivantes:

• home
• freeBusy
• work

string

Uniquement en sortie. Type d'URL d'agenda traduit et formaté dans les paramètres régionaux du compte de l'utilisateur ou dans les paramètres régionaux de l'en-tête HTTP Accept-Language.

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

object (FieldMetadata)

Métadonnées sur les données client.

string

Clé des données du client spécifiée par le client.

string

Valeur des données client spécifiée par le client.

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

object (FieldMetadata)

Métadonnées de la photo de couverture.

string

URL de la photo de couverture.

boolean

"True" si la photo de couverture est la photo de couverture par défaut. "false" si la photo de couverture est fournie par l'utilisateur.

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

object (FieldMetadata)

Métadonnées sur l'adresse e-mail.

string

Adresse e-mail.

string

Type d'adresse e-mail. Le type peut être personnalisé ou l'une des valeurs prédéfinies suivantes:

• home
• work
• other

string

Uniquement en sortie. Type d'adresse e-mail traduit et formaté dans les paramètres régionaux du compte de l'utilisateur ou dans les paramètres régionaux de l'en-tête HTTP Accept-Language.

string

Nom à afficher de l'e-mail.

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

object (FieldMetadata)

Métadonnées sur l'événement.

object (Date)

Date de l'événement.

string

Le type d'événement. Le type peut être personnalisé ou l'une des valeurs prédéfinies suivantes:

• anniversary
• other

string

Uniquement en sortie. Type d'événement traduit et formaté dans les paramètres régionaux du compte de l'utilisateur ou dans les paramètres régionaux de l'en-tête HTTP Accept-Language.

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

object (FieldMetadata)

Métadonnées sur l'ID externe.

string

Valeur de l'ID externe.

string

Type de l'ID externe. Le type peut être personnalisé ou l'une des valeurs prédéfinies suivantes:

• account
• customer
• loginId
• network
• organization

string

Uniquement en sortie. Type d'événement traduit et formaté dans les paramètres régionaux du compte de l'utilisateur ou dans les paramètres régionaux de l'en-tête HTTP Accept-Language.

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

object (FieldMetadata)

Métadonnées sur le fichier "file-as".

string

Valeur de fichier en tant que

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

object (FieldMetadata)

Métadonnées sur le genre.

string

Genre de la personne. Il peut s'agir d'un critère de sexe personnalisé ou de l'une des valeurs prédéfinies suivantes:

• male
• female
• unspecified

string

Uniquement en sortie. Valeur du sexe traduite et mise en forme dans les paramètres régionaux du compte de l'utilisateur ou dans les paramètres régionaux de l'en-tête HTTP Accept-Language. Les valeurs non spécifiées ou personnalisées ne sont pas localisées.

string

Champ de texte libre pour les pronoms à utiliser pour s'adresser à la personne. Les valeurs les plus courantes sont les suivantes:

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

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

object (FieldMetadata)

Métadonnées sur le client de messagerie instantanée.

string

Nom d'utilisateur utilisé dans le client de messagerie instantanée.

string

Type du client de messagerie instantanée. Le type peut être personnalisé ou l'une des valeurs prédéfinies suivantes:

• home
• work
• other

string

Uniquement en sortie. Type de client de messagerie instantanée traduit et formaté dans les paramètres régionaux du compte de l'utilisateur ou dans les paramètres régionaux de l'en-tête HTTP Accept-Language.

string

Protocole du client de messagerie instantanée. Le protocole peut être personnalisé ou l'une des valeurs prédéfinies suivantes:

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

string

Uniquement en sortie. Protocole du client de messagerie instantanée formaté dans les paramètres régionaux du compte de l'utilisateur ou dans les paramètres régionaux de l'en-tête HTTP Accept-Language.

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

object (FieldMetadata)

Métadonnées sur le centre d'intérêt.

string

L'intérêt ; Exemple : stargazing.

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

object (FieldMetadata)

Métadonnées sur les paramètres régionaux.

string

Balise de langue IETF BCP 47 correctement formatée représentant les paramètres régionaux.

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

object (FieldMetadata)

Métadonnées sur l'établissement.

string

Valeur au format libre du lieu.

string

Type de lieu. Le type peut être personnalisé ou l'une des valeurs prédéfinies suivantes:

• desk
• grewUp

boolean

Indique si la position correspond à la position actuelle.

string

Identifiant du bâtiment.

string

Nom ou numéro de l'étage.

string

Section de l'étage dans floor_name.

string

L'emplacement du bureau individuel.

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

Métadonnées sur l'appartenance.

object (ContactGroupMembership)

Appartenance au groupe de contacts.

object (DomainMembership)

Uniquement en sortie. L'appartenance au domaine.

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

string

Uniquement en sortie. ID du groupe de contacts correspondant à l'appartenance au groupe de contacts.

string

Nom de ressource du groupe de contacts, attribué par le serveur. Chaîne ASCII, au format contactGroups/{contactGroupId}. Seul contactGroupResourceName peut être utilisé pour modifier les adhésions. Tous les membres d'un groupe de contacts peuvent être supprimés, mais seuls le groupe d'utilisateurs ou "myContacts" sont supprimés. ou "ajoutés aux favoris" des adhésions à des groupes système peuvent être ajoutées. Un contact doit toujours avoir au moins un groupe de contacts.

{
  "inViewerDomain": boolean
}

boolean

Vrai si la personne fait partie du domaine Google Workspace de l'utilisateur.

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

object (FieldMetadata)

Métadonnées sur les mots clés "Divers".

string

Valeur du mot clé "divers".

enum (KeywordType)

Type de mot clé "Divers".

string

Uniquement en sortie. Type de mot clé divers traduit et formaté dans les paramètres régionaux du compte de l'utilisateur ou dans les paramètres régionaux de l'en-tête HTTP Accept-Language.

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

Métadonnées sur le nom.

string

Uniquement en sortie. Nom à afficher formaté selon les paramètres régionaux spécifiés par le compte du lecteur ou l'en-tête HTTP Accept-Language.

string

Uniquement en sortie. Nom à afficher dont le nom est d'abord mis en forme conformément aux paramètres régionaux spécifiés par le compte du spectateur ou l'en-tête HTTP Accept-Language.

string

Valeur du nom de format libre.

string

Nom de famille.

string

Nom donné.

string

Deuxième(s) prénom(s).

string

Les préfixes honorifiques tels que Mrs. ou Dr.

string

Suffixes honorifiques tels que Jr.

string

Nom complet tel qu'il est prononcé.

string

Nom de famille orthographié tel qu'il se prononce.

string

Nom saisi tel qu'il se prononce.

string

Le ou les deuxième(s) prénom(s) orthographié(s) tel qu'il sonne.

string

Préfixes honorifiques orthographiés tels qu'ils sonnent.

string

Suffixes honorifiques orthographiés tels qu'ils sonnent.

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

object (FieldMetadata)

Métadonnées sur le pseudo.

string

Pseudo.

enum (NicknameType)

Type de pseudo.

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

object (FieldMetadata)

Métadonnées sur la profession.

string

Profession ; Exemple : 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)

Métadonnées sur l'organisation.

string

Type d'organisation. Le type peut être personnalisé ou l'une des valeurs prédéfinies suivantes:

• work
• school

string

Uniquement en sortie. Type d'organisation traduit et formaté dans les paramètres régionaux du compte de l'utilisateur ou dans les paramètres régionaux de l'en-tête HTTP Accept-Language.

object (Date)

Date de début à laquelle la personne a rejoint l'organisation.

object (Date)

Date de fin à laquelle la personne a quitté l'organisation.

boolean

Vrai si l'organisation est l'organisation actuelle de la personne ; "false" si l'organisation est passée.

string

Nom de l'organisme.

string

Nom phonétique de l'organisation.

string

Le service de la personne dans l'organisation.

string

Fonction de la personne au sein de l'organisation.

string

Description du poste de la personne au sein de l'organisation.

string

Symbole associé à l'organisation. par exemple, un symbole boursier, une abréviation ou un acronyme.

string

Le nom de domaine associé à l'organisation Exemple : google.com.

string

Emplacement du bureau de l'organisation dans lequel la personne travaille.

string

Le centre de coûts de la personne au sein de l'entreprise

integer

Équivalent de temps plein en millipercent d'employés dans l'organisation (100 000 = 100%).

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

object (FieldMetadata)

Métadonnées sur le numéro de téléphone.

string

Numéro de téléphone.

string

Uniquement en sortie. Format canonique ITU-T E.164 du numéro de téléphone.

string

Type de numéro de téléphone. Le type peut être personnalisé ou l'une des valeurs prédéfinies suivantes:

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

string

Uniquement en sortie. Type de numéro de téléphone traduit et formaté dans les paramètres régionaux du compte de l'utilisateur ou dans les paramètres régionaux de l'en-tête HTTP Accept-Language.

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

object (FieldMetadata)

Métadonnées relatives à la photo.

string

URL de la photo. Vous pouvez modifier la taille souhaitée en ajoutant un paramètre de requête sz={size} à la fin de l'URL, où {size} est la taille en pixels. Exemple: https://lh3.googleusercontent.com/-T_wVWLlmg7w/AAAAAAAAAAI/AAAAAAAABa8/00gzXvDBYqw/s100/photo.jpg?sz=50

boolean

"True" si la photo est une photo par défaut. "false" si la photo est fournie par l'utilisateur.

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

object (FieldMetadata)

Métadonnées sur la relation.

string

Nom de l'autre personne à laquelle cette relation fait référence.

string

La relation entre la personne et l'autre personne Le type peut être personnalisé ou l'une des valeurs prédéfinies suivantes:

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

string

Uniquement en sortie. Type de relation traduit et mis en forme selon les paramètres régionaux du compte de l'utilisateur ou ceux spécifiés dans l'en-tête HTTP Accept-Language.

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

object (FieldMetadata)

Métadonnées sur l'intérêt de la relation.

string

Le type de relation que la personne recherche. La valeur peut être personnalisée ou l'une des valeurs prédéfinies suivantes:

• friend
• date
• relationship
• networking

string

Uniquement en sortie. Valeur de la relation d'intérêt traduite et mise en forme selon les paramètres régionaux du compte de l'utilisateur ou ceux spécifiés dans l'en-tête HTTP Accept-Language.

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

object (FieldMetadata)

Métadonnées sur l'état de la relation.

string

État de la relation. La valeur peut être personnalisée ou l'une des valeurs prédéfinies suivantes:

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

string

Uniquement en sortie. Valeur de l'état de la relation traduite et mise en forme dans les paramètres régionaux du compte de l'utilisateur ou dans les paramètres régionaux de l'en-tête HTTP Accept-Language.

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

object (FieldMetadata)

Métadonnées sur la résidence.

string

Adresse de la résidence.

boolean

Vrai si le lieu de résidence est le lieu de résidence actuel de la personne. "false" si la résidence est une résidence antérieure.

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

object (FieldMetadata)

Métadonnées sur l'adresse SIP.

string

Adresse SIP au format SIP URI RFC 3261 19.1.

string

Type de l'adresse SIP. Le type peut être personnalisé ou l'une des valeurs prédéfinies suivantes:

• home
• work
• mobile
• other

string

Uniquement en sortie. Type de l'adresse SIP traduite et mise en forme dans les paramètres régionaux du compte du spectateur ou dans les paramètres régionaux de l'en-tête HTTP Accept-Language.

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

object (FieldMetadata)

Métadonnées sur la compétence.

string

La compétence ; Exemple : underwater basket weaving.

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

object (FieldMetadata)

Métadonnées sur le slogan.

string

Le slogan

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

object (FieldMetadata)

Métadonnées sur l'URL.

string

L'URL.

string

Type d'URL. Le type peut être personnalisé ou l'une des valeurs prédéfinies suivantes:

• home
• work
• blog
• profile
• homePage
• ftp
• reservations
• appInstallPage: site Web d'une application Currents.
• other

string

Uniquement en sortie. Type d'URL traduit et formaté dans les paramètres régionaux du compte de l'utilisateur ou dans les paramètres régionaux de l'en-tête HTTP Accept-Language.

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

object (FieldMetadata)

Métadonnées sur les données définies par l'utilisateur.

string

Clé spécifiée par l'utilisateur final pour les données définies par l'utilisateur.

string

Valeur spécifiée par l'utilisateur final pour les données définies par l'utilisateur.