- Ressource: Person
- Représentation JSON
- PersonMetadata
- Source
- SourceType
- ProfileMetadata
- ObjectType
- UserType
- Adresse
- FieldMetadata
- AgeRange
- AgeRangeType
- Biographie
- ContentType
- Date de naissance
- Date
- BraggingRights
- CalendarUrl
- ClientData
- CoverPhoto
- EmailAddress
- Événement
- ExternalId
- FileAs
- Genre
- ImClient
- Intérêt
- Paramètres régionaux
- Zone géographique
- Adhésion
- ContactGroupMembership
- DomainMembership
- MiscKeyword
- KeywordType
- Nom
- Pseudo
- NicknameType
- Profession
- Organisation
- PhoneNumber
- Photo
- Relation
- RelationshipInterest
- RelationshipStatus
- Résidence
- SipAddress
- Compétence
- Slogan
- URL
- UserDefined
- Méthodes
Ressource: Person
Informations sur une personne fusionnées à partir de différentes sources de données telles que les contacts et les données de profil de l'utilisateur authentifié.
La plupart des champs peuvent comporter plusieurs éléments. L'ordre des articles d'un champ n'est pas garanti, mais chaque champ non vide contiendra forcément un seul champ avec la valeur metadata.primary
définie sur "true".
Représentation JSON |
---|
{ "resourceName": string, "etag": string, "metadata": { object ( |
Champs | |
---|---|
resourceName |
Nom de ressource de la personne, attribué par le serveur. Chaîne ASCII sous la forme |
etag |
Le tag d'entité HTTP de la ressource. Utilisé pour la validation du cache Web. |
metadata |
Uniquement en sortie. Métadonnées sur la personne. |
addresses[] |
Adresses postales de la personne |
ageRange |
Uniquement en sortie. OBSOLÈTE (Veuillez utiliser Tranche d'âge de la personne. |
ageRanges[] |
Uniquement en sortie. Tranches d'âge de la personne |
biographies[] |
Les biographies de la personne Ce champ est un singleton des sources de contact. |
birthdays[] |
Anniversaires de la personne. Ce champ est un singleton des sources de contact. |
braggingRights[] |
OBSOLÈTE: aucune donnée ne sera renvoyée. Droits de vantardise de la personne. |
calendarUrls[] |
URL d'agenda de la personne. |
clientData[] |
Données client de la personne. |
coverPhotos[] |
Uniquement en sortie. Photos de couverture de la personne. |
emailAddresses[] |
Adresses e-mail de la personne concernée. Pour |
events[] |
Événements de la personne. |
externalIds[] |
Identifiants externes de la personne. |
fileAses[] |
Éléments de fichier de la personne. |
genders[] |
Le genre de la personne. Ce champ est un singleton des sources de contact. |
imClients[] |
Clients de messagerie instantanée de la personne. |
interests[] |
Centres d'intérêt de la personne. |
locales[] |
Préférences régionales de la personne. |
locations[] |
Positions géographiques de la personne. |
memberships[] |
Les abonnements de la personne à des groupes. |
miscKeywords[] |
Mots clés divers de l'internaute |
names[] |
Noms de la personne. Ce champ est un singleton des sources de contact. |
nicknames[] |
Surnoms de la personne. |
occupations[] |
Professions de la personne. |
organizations[] |
Organisations passées ou actuelles de la personne. |
phoneNumbers[] |
Numéros de téléphone de la personne. Pour |
photos[] |
Uniquement en sortie. Photos de la personne |
relations[] |
Relations de la personne. |
relationshipInterests[] |
Uniquement en sortie. OBSOLÈTE: aucune donnée ne sera renvoyée concernant les intérêts dans la relation de la personne. |
relationshipStatuses[] |
Uniquement en sortie. OBSOLÈTE: aucune donnée ne sera renvoyée. |
residences[] |
OBSOLÈTE: (Veuillez utiliser |
sipAddresses[] |
Adresses SIP de la personne. |
skills[] |
Les compétences de la personne. |
taglines[] |
Uniquement en sortie. OBSOLÈTE: les slogans de la personne ne seront pas renvoyés. |
urls[] |
URL associées à la personne. |
userDefined[] |
Données définies par l'utilisateur de la personne |
PersonMetadata
Métadonnées sur une personne.
Représentation JSON |
---|
{ "sources": [ { object ( |
Champs | |
---|---|
sources[] |
Sources des données de la personne. |
previousResourceNames[] |
Uniquement en sortie. Ancien nom de ressource que cette personne a eu. Renseigné uniquement pour les requêtes Le nom de la ressource peut changer lors de l'ajout ou de la suppression de champs qui associent un contact et un profil (adresse e-mail validée, numéro de téléphone validé ou URL de profil, par exemple). |
linkedPeopleResourceNames[] |
Uniquement en sortie. Noms de ressources des personnes associées à cette ressource. |
deleted |
Uniquement en sortie. "True" si la ressource de personne a été supprimée. Renseigné uniquement pour les requêtes de synchronisation |
objectType |
Uniquement en sortie. OBSOLÈTE (Veuillez utiliser Type de l'objet personne. |
Source
Source d'un champ.
Représentation JSON |
---|
{ "type": enum ( |
Champs | |
---|---|
type |
Type de source. |
id |
Identifiant unique dans le type de source généré par le serveur. |
etag |
Renseigné uniquement dans Le tag d'entité HTTP de la source. Utilisé pour la validation du cache Web. |
updateTime |
Uniquement en sortie. Renseigné uniquement dans Code temporel de la dernière mise à jour de cette source. Code temporel au format RFC3339 UTC "Zulu", avec une résolution à la nanoseconde et jusqu'à neuf chiffres après la virgule. Exemples: |
Champ d'union Métadonnées sur la source. |
|
profileMetadata |
Uniquement en sortie. Renseigné uniquement dans Métadonnées sur une source de type PROFILE. |
SourceType
Type de source.
Enums | |
---|---|
SOURCE_TYPE_UNSPECIFIED |
URL indéterminée. |
ACCOUNT |
Un compte Google |
PROFILE |
Profil Google : Vous pouvez consulter votre profil à l'adresse https://profiles.google.com/{id}, où {id} correspond à l'ID de la source. |
DOMAIN_PROFILE |
Profil de domaine Google Workspace : |
CONTACT |
Contact Google : Vous pouvez consulter le contact à l'adresse https://contact.google.com/{id}, où {id} correspond à l'ID de la source. |
OTHER_CONTACT |
Google "Autre contact" : |
DOMAIN_CONTACT |
Contact partagé avec le domaine Google Workspace. |
ProfileMetadata
Métadonnées d'un profil.
Représentation JSON |
---|
{ "objectType": enum ( |
Champs | |
---|---|
objectType |
Uniquement en sortie. Type d'objet du profil. |
userTypes[] |
Uniquement en sortie. L'utilisateur saisit. |
ObjectType
Type d'un objet personne.
Enums | |
---|---|
OBJECT_TYPE_UNSPECIFIED |
URL indéterminée. |
PERSON |
Personne. |
PAGE |
Page Currents : |
UserType
Type d'utilisateur.
Enums | |
---|---|
USER_TYPE_UNKNOWN |
Le type d'utilisateur est inconnu. |
GOOGLE_USER |
L'utilisateur est un utilisateur Google. |
GPLUS_USER |
L'utilisateur est un utilisateur Currents. |
GOOGLE_APPS_USER |
L'utilisateur est un utilisateur Google Workspace. |
Adresse
Adresse physique d'une personne. Il peut s'agir d'une boîte postale ou d'une adresse postale. Tous les champs sont facultatifs.
Représentation JSON |
---|
{
"metadata": {
object ( |
Champs | |
---|---|
metadata |
Métadonnées sur l'adresse. |
formattedValue |
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. |
type |
Type d'adresse. Le type peut être personnalisé ou correspondre à l'une des valeurs prédéfinies suivantes:
|
formattedType |
Uniquement en sortie. Type d'adresse traduit et formaté dans les paramètres régionaux du compte du lecteur ou dans les paramètres régionaux de l'en-tête HTTP |
poBox |
Boîte postale de l'adresse |
streetAddress |
Adresse postale. |
extendedAddress |
Adresse étendue de l'adresse (par exemple, le numéro d'appartement). |
city |
Ville de l'adresse. |
region |
Région de l'adresse (par exemple, l'État ou la province). |
postalCode |
Code postal de l'adresse. |
country |
Pays de l'adresse. |
countryCode |
Code pays ISO 3166-1 alpha-2 de l'adresse. |
FieldMetadata
Métadonnées sur un champ.
Représentation JSON |
---|
{
"primary": boolean,
"sourcePrimary": boolean,
"verified": boolean,
"source": {
object ( |
Champs | |
---|---|
primary |
Uniquement en sortie. "True" si le champ est le champ principal de toutes les sources de la personne. Chaque personne disposera au maximum d'un champ avec la valeur |
sourcePrimary |
"True" si le champ est le champ principal de |
verified |
Uniquement en sortie. "True" si le champ est validé ; "false" si le champ n'est pas validé. Il s'agit généralement d'un nom, d'une adresse e-mail, d'un numéro de téléphone ou d'un site Web dont l'appartenance à la personne a été confirmée. |
source |
Source du champ. |
AgeRange
OBSOLÈTE (Veuillez utiliser person.ageRanges
à la place)
Tranche d'âge d'une personne.
Enums | |
---|---|
AGE_RANGE_UNSPECIFIED |
URL indéterminée. |
LESS_THAN_EIGHTEEN |
De moins de dix-huit ans. |
EIGHTEEN_TO_TWENTY |
Entre dix-huit et vingt. |
TWENTY_ONE_OR_OLDER |
21 et plus. |
AgeRangeType
Tranche d'âge d'une personne.
Représentation JSON |
---|
{ "metadata": { object ( |
Champs | |
---|---|
metadata |
Métadonnées sur la tranche d'âge. |
ageRange |
Tranche d'âge. |
Biographie
La courte biographie d'une personne.
Représentation JSON |
---|
{ "metadata": { object ( |
Champs | |
---|---|
metadata |
Métadonnées sur la biographie. |
value |
La courte biographie. |
contentType |
Type de contenu de la biographie. |
ContentType
Type de contenu.
Enums | |
---|---|
CONTENT_TYPE_UNSPECIFIED |
URL indéterminée. |
TEXT_PLAIN |
Texte brut. |
TEXT_HTML |
Texte HTML |
Anniversaire
Anniversaire d'une personne. Au moins l'un des champs date
et text
est spécifié. Les champs date
et text
représentent généralement la même date, mais ce n'est pas garanti. Les clients doivent toujours définir le champ date
lorsqu'ils modifient des anniversaires.
Représentation JSON |
---|
{ "metadata": { object ( |
Champs | |
---|---|
metadata |
Métadonnées sur l'anniversaire. |
date |
Date structurée de l'anniversaire. |
text |
Il est préférable d'utiliser le champ Chaîne au format libre représentant l'anniversaire de l'utilisateur. Cette valeur n'est pas validée. |
Date
Représente une date du calendrier entière ou partielle, par exemple un anniversaire. L'heure de la journée et le fuseau horaire sont spécifiés ailleurs ou ne sont pas significatifs. La date est relative au calendrier grégorien. Il peut s'agir de l'un des éléments suivants:
- Date complète, avec des valeurs d'année, de mois et de jour non nulles.
- Un mois et un jour, avec une année nulle (par exemple, un anniversaire).
- Une année seule, avec zéro mois et zéro jour.
- Année et mois, avec un jour zéro (par exemple, la date d'expiration d'une carte de crédit).
Types associés:
google.type.TimeOfDay
google.type.DateTime
google.protobuf.Timestamp
Représentation JSON |
---|
{ "year": integer, "month": integer, "day": integer } |
Champs | |
---|---|
year |
Année de la date. La valeur doit être comprise entre 1 et 9 999, ou valeur 0 si vous souhaitez indiquer une date sans année. |
month |
Mois de l'année. La valeur doit être comprise entre 1 et 12, ou 0 pour indiquer une année sans mois ni jour. |
day |
Jour du mois. La valeur doit être comprise entre 1 et 31, et valide pour l'année et le mois, ou la valeur 0 pour indiquer une année seule, ou une année et un mois où le jour n'est pas significatif. |
BraggingRights
OBSOLÈTE: aucune donnée ne vous sera renvoyée. Les droits de vantardise d'une personne.
Représentation JSON |
---|
{
"metadata": {
object ( |
Champs | |
---|---|
metadata |
Métadonnées sur les plus belles réussites. |
value |
Vos plus belles réussites ( |
CalendarUrl
URL d'agenda d'une personne.
Représentation JSON |
---|
{
"metadata": {
object ( |
Champs | |
---|---|
metadata |
Métadonnées sur l'URL de l'agenda. |
url |
URL de l'agenda |
type |
Type d'URL de l'agenda. Le type peut être personnalisé ou correspondre à l'une des valeurs prédéfinies suivantes:
|
formattedType |
Uniquement en sortie. Type d'URL d'agenda traduit et formaté dans les paramètres régionaux du compte du lecteur ou dans les paramètres régionaux de l'en-tête HTTP |
ClientData
Données de client arbitraires renseignées par les clients. Les clés et les valeurs en double sont autorisées.
Représentation JSON |
---|
{
"metadata": {
object ( |
Champs | |
---|---|
metadata |
Métadonnées sur les données client. |
key |
Clé des données client spécifiée par le client. |
value |
Valeur des données client spécifiée par le client. |
CoverPhoto
Photo de couverture d'une personne Grande image affichée sur la page de profil de la personne qui représente cette personne ou ce qui l'intéresse.
Représentation JSON |
---|
{
"metadata": {
object ( |
Champs | |
---|---|
metadata |
Métadonnées sur la photo de couverture. |
url |
URL de la photo de couverture. |
default |
"True" si la photo de couverture est la photo de couverture par défaut ; "false" si la photo de couverture est une photo fournie par l'utilisateur. |
EmailAddress
Adresse e-mail d'une personne.
Représentation JSON |
---|
{
"metadata": {
object ( |
Champs | |
---|---|
metadata |
Métadonnées sur l'adresse e-mail. |
value |
Adresse e-mail. |
type |
Type d'adresse e-mail. Le type peut être personnalisé ou correspondre à l'une des valeurs prédéfinies suivantes:
|
formattedType |
Uniquement en sortie. Type d'adresse e-mail traduit et formaté dans les paramètres régionaux du compte du lecteur ou dans les paramètres régionaux de l'en-tête HTTP |
displayName |
Nom à afficher pour l'e-mail. |
Événement
Événement lié à la personne.
Représentation JSON |
---|
{ "metadata": { object ( |
Champs | |
---|---|
metadata |
Métadonnées sur l'événement. |
date |
Date de l'événement. |
type |
Le type d'événement. Le type peut être personnalisé ou correspondre à l'une des valeurs prédéfinies suivantes:
|
formattedType |
Uniquement en sortie. Type d'événement traduit et mis en forme dans les paramètres régionaux du compte du lecteur ou dans les paramètres régionaux de l'en-tête HTTP |
ExternalId
Identifiant issu d'une entité externe liée à la personne.
Représentation JSON |
---|
{
"metadata": {
object ( |
Champs | |
---|---|
metadata |
Métadonnées sur l'ID externe. |
value |
Valeur de l'ID externe. |
type |
Type d'ID externe. Le type peut être personnalisé ou correspondre à l'une des valeurs prédéfinies suivantes:
|
formattedType |
Uniquement en sortie. Type d'événement traduit et mis en forme dans les paramètres régionaux du compte du lecteur ou dans les paramètres régionaux de l'en-tête HTTP |
FileAs
Nom à utiliser pour trier la personne dans une liste.
Représentation JSON |
---|
{
"metadata": {
object ( |
Champs | |
---|---|
metadata |
Métadonnées sur le fichier en tant que. |
value |
Valeur "Fichier en tant que" |
Gender
Genre d'une personne
Représentation JSON |
---|
{
"metadata": {
object ( |
Champs | |
---|---|
metadata |
Métadonnées sur le genre. |
value |
Genre de la personne. Le genre peut être personnalisé ou utiliser l'une des valeurs prédéfinies suivantes:
|
formattedValue |
Uniquement en sortie. Valeur du genre 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 |
addressMeAs |
Champ de texte libre pour les pronoms à utiliser pour s'adresser à la personne. Les valeurs courantes sont les suivantes:
|
ImClient
Client de messagerie instantanée d'une personne.
Représentation JSON |
---|
{
"metadata": {
object ( |
Champs | |
---|---|
metadata |
Métadonnées sur le client de messagerie instantanée. |
username |
Nom d'utilisateur utilisé dans le client de messagerie instantanée. |
type |
Type de client de messagerie instantanée. Le type peut être personnalisé ou correspondre à l'une des valeurs prédéfinies suivantes:
|
formattedType |
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 |
protocol |
Protocole du client de messagerie instantanée. Le protocole peut être personnalisé ou correspondre à l'une de ces valeurs prédéfinies:
|
formattedProtocol |
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 |
Intérêt
Un des intérêts de la personne.
Représentation JSON |
---|
{
"metadata": {
object ( |
Champs | |
---|---|
metadata |
Métadonnées sur le centre d'intérêt. |
value |
Le centre d'intérêt (par exemple, |
Paramètres régionaux
Préférences régionales d'une personne.
Représentation JSON |
---|
{
"metadata": {
object ( |
Champs | |
---|---|
metadata |
Métadonnées sur les paramètres régionaux. |
value |
Balise de langue IETF BCP 47 bien formatée représentant les paramètres régionaux. |
Emplacement
L'emplacement d'une personne.
Représentation JSON |
---|
{
"metadata": {
object ( |
Champs | |
---|---|
metadata |
Métadonnées sur l'établissement. |
value |
Valeur de forme libre de l'emplacement. |
type |
Type d'emplacement. Le type peut être personnalisé ou correspondre à l'une des valeurs prédéfinies suivantes:
|
current |
Indique si l'emplacement correspond à la position actuelle. |
buildingId |
Identifiant du bâtiment. |
floor |
Nom ou numéro de l'étage. |
floorSection |
Section d'étage dans |
deskCode |
Emplacement du bureau individuel. |
Abonnement
Appartenance d'une personne à un groupe. Seules les appartenances aux groupes de contacts peuvent être modifiées.
Représentation JSON |
---|
{ "metadata": { object ( |
Champs | |
---|---|
metadata |
Métadonnées sur l'adhésion. |
Champ d'union membership . L'abonnement. membership ne peut être qu'un des éléments suivants : |
|
contactGroupMembership |
Appartenance au groupe de contacts. |
domainMembership |
Uniquement en sortie. Appartenance au domaine. |
ContactGroupMembership
Appartenance à un groupe de contacts Google.
Représentation JSON |
---|
{ "contactGroupId": string, "contactGroupResourceName": string } |
Champs | |
---|---|
contactGroupId |
Uniquement en sortie. ID du groupe de contacts pour l'appartenance au groupe de contacts. |
contactGroupResourceName |
Nom de ressource du groupe de contacts, attribué par le serveur. Chaîne ASCII, sous la forme |
DomainMembership
Vous devez disposer d'un abonnement à un domaine Google Workspace.
Représentation JSON |
---|
{ "inViewerDomain": boolean } |
Champs | |
---|---|
inViewerDomain |
Vrai si l'utilisateur appartient au domaine Google Workspace du lecteur. |
MiscKeyword
Mot clé divers d'un utilisateur
Représentation JSON |
---|
{ "metadata": { object ( |
Champs | |
---|---|
metadata |
Métadonnées sur les mots clés divers. |
value |
Valeur du mot clé divers. |
type |
Type de mot clé "Divers". |
formattedType |
Uniquement en sortie. Type de mot clé divers traduit et mis en forme dans les paramètres régionaux du compte de l'utilisateur ou dans ceux de l'en-tête HTTP |
KeywordType
Type de mot clé divers.
Enums | |
---|---|
TYPE_UNSPECIFIED |
URL indéterminée. |
OUTLOOK_BILLING_INFORMATION |
Champ Outlook pour les informations de facturation. |
OUTLOOK_DIRECTORY_SERVER |
Champ Outlook pour le serveur d'annuaire. |
OUTLOOK_KEYWORD |
Champ "Outlook" pour le mot clé. |
OUTLOOK_MILEAGE |
Champ Outlook pour le kilométrage. |
OUTLOOK_PRIORITY |
champ Outlook pour la priorité. |
OUTLOOK_SENSITIVITY |
Champ Outlook pour la sensibilité. |
OUTLOOK_SUBJECT |
Champ Outlook pour l'objet. |
OUTLOOK_USER |
Champ Outlook pour l'utilisateur. |
HOME |
Écran d'accueil |
WORK |
Professionnel. |
OTHER |
Autre rôle |
Nom
Nom d'une personne. Si le nom est un mononyme, le nom de famille est vide.
Représentation JSON |
---|
{
"metadata": {
object ( |
Champs | |
---|---|
metadata |
Métadonnées sur le nom. |
displayName |
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 |
displayNameLastFirst |
Uniquement en sortie. Nom à afficher dont le nom a d'abord été formaté conformément aux paramètres régionaux spécifiés par le compte du lecteur ou dans l'en-tête HTTP |
unstructuredName |
Valeur du nom au format libre. |
familyName |
Nom de famille. |
givenName |
Nom donné. |
middleName |
Deuxième(s) prénom(s). |
honorificPrefix |
Préfixes honorifiques, tels que |
honorificSuffix |
Les suffixes honorifiques, tels que |
phoneticFullName |
Nom complet orthographié tel qu'il se prononce. |
phoneticFamilyName |
Nom de famille épelé comme son nom l'indique. |
phoneticGivenName |
Nom donné épelé comme son nom l'indique. |
phoneticMiddleName |
Deuxième prénom orthographié tel qu'il se prononce. |
phoneticHonorificPrefix |
Préfixes honorifiques orthographiés comme ils se prononcent. |
phoneticHonorificSuffix |
Les suffixes honorifiques sont épelés à leur voix. |
Pseudo
Pseudo d'une personne.
Représentation JSON |
---|
{ "metadata": { object ( |
Champs | |
---|---|
metadata |
Métadonnées sur le pseudo. |
value |
Pseudo. |
type |
Type de pseudo. |
NicknameType
Type de pseudo.
Enums | |
---|---|
DEFAULT |
Pseudo générique. |
MAIDEN_NAME |
Nom de jeune fille ou nom de famille de naissance. Utilisé lorsque le nom de famille de la personne a changé à la suite d'un mariage. |
INITIALS |
Initiales. |
GPLUS |
Pseudo du profil Google+. |
OTHER_NAME |
Affiliation professionnelle ou autre nom (par exemple, |
ALTERNATE_NAME |
Autre nom de la personne connue. |
SHORT_NAME |
Version plus courte du nom de la personne. |
Profession
Profession d'une personne.
Représentation JSON |
---|
{
"metadata": {
object ( |
Champs | |
---|---|
metadata |
Métadonnées sur la profession. |
value |
Profession (par exemple, |
Organisation
Organisation passée ou actuelle d'une personne. Les plages de dates peuvent se chevaucher.
Représentation JSON |
---|
{ "metadata": { object ( |
Champs | |
---|---|
metadata |
Métadonnées sur l'organisation. |
type |
Type d'organisation. Le type peut être personnalisé ou correspondre à l'une des valeurs prédéfinies suivantes:
|
formattedType |
Uniquement en sortie. Type d'organisation traduit et formaté dans les paramètres régionaux du compte du lecteur ou dans les paramètres régionaux de l'en-tête HTTP |
startDate |
Date de début à laquelle la personne a rejoint l'organisation. |
endDate |
Date de fin à laquelle la personne a quitté l'organisation. |
current |
"True" si l'organisation est l'organisation actuelle de la personne ; "false" si cette organisation est une ancienne organisation. |
name |
Nom de l'organisme. |
phoneticName |
Nom phonétique de l'organisation. |
department |
Le service dont dépend cette personne au sein de l'organisation. |
title |
Fonction de la personne au sein de l'organisation. |
jobDescription |
Description du poste de la personne au sein de l'organisation. |
symbol |
Symbole associé à l'organisation (par exemple, symbole boursier, abréviation ou acronyme). |
domain |
Nom de domaine associé à l'organisation (par exemple, |
location |
L'adresse du bureau de l'organisation dans lequel la personne travaille. |
costCenter |
Centre de coûts de la personne au sein de l'organisation. |
fullTimeEquivalentMillipercent |
Équivalent temps plein de la personne au sein de l'organisation (100 000 = 100%). |
PhoneNumber
Le numéro de téléphone d'une personne.
Représentation JSON |
---|
{
"metadata": {
object ( |
Champs | |
---|---|
metadata |
Métadonnées sur le numéro de téléphone. |
value |
Numéro de téléphone. |
canonicalForm |
Uniquement en sortie. Forme canonique ITU-T E.164 du numéro de téléphone. |
type |
Type de numéro de téléphone. Le type peut être personnalisé ou correspondre à l'une des valeurs prédéfinies suivantes:
|
formattedType |
Uniquement en sortie. Type de numéro de téléphone traduit et formaté dans les paramètres régionaux du compte du lecteur ou dans les paramètres régionaux de l'en-tête HTTP |
Photo
Photo d'une personne. Image affichée à côté du nom de la personne pour aider les autres utilisateurs à la reconnaître.
Représentation JSON |
---|
{
"metadata": {
object ( |
Champs | |
---|---|
metadata |
Métadonnées relatives à la photo. |
url |
URL de la photo. Vous pouvez modifier la taille souhaitée en ajoutant un paramètre de requête |
default |
"True" si la photo est une photo par défaut ; "false" s'il s'agit d'une photo fournie par un utilisateur. |
Relation
Lien d'une personne avec une autre personne.
Représentation JSON |
---|
{
"metadata": {
object ( |
Champs | |
---|---|
metadata |
Métadonnées sur la relation. |
person |
Nom de l'autre personne à laquelle cette relation fait référence. |
type |
Lien entre la personne et l'autre personne. Le type peut être personnalisé ou correspondre à l'une des valeurs prédéfinies suivantes:
|
formattedType |
Uniquement en sortie. Type de relation traduit et formaté dans les paramètres régionaux du compte du lecteur ou dans les paramètres régionaux spécifiés dans l'en-tête HTTP Accept-Language. |
RelationshipInterest
OBSOLÈTE: aucune donnée ne sera renvoyée concernant l'intérêt dans la relation d'une personne .
Représentation JSON |
---|
{
"metadata": {
object ( |
Champs | |
---|---|
metadata |
Métadonnées sur l'intérêt dans la relation. |
value |
Le type de relation que la personne recherche. Il peut s'agir d'une valeur personnalisée ou de l'une des valeurs prédéfinies suivantes:
|
formattedValue |
Uniquement en sortie. Valeur de la relation d'intérêt traduite et mise en forme dans les paramètres régionaux du compte de l'utilisateur ou dans les paramètres régionaux spécifiés dans l'en-tête HTTP Accept-Language. |
RelationshipStatus
OBSOLÈTE: aucune donnée ne sera renvoyée concernant la situation amoureuse d'une personne.
Représentation JSON |
---|
{
"metadata": {
object ( |
Champs | |
---|---|
metadata |
Métadonnées sur l'état de la relation. |
value |
État de la relation. Il peut s'agir d'une valeur personnalisée ou de l'une des valeurs prédéfinies suivantes:
|
formattedValue |
Uniquement en sortie. Valeur de l'état de la relation traduite et formatée dans les paramètres régionaux du compte du lecteur ou dans les paramètres régionaux de l'en-tête HTTP |
Résidence
OBSOLÈTE: veuillez utiliser person.locations
à la place. Résidence passée ou actuelle d'une personne.
Représentation JSON |
---|
{
"metadata": {
object ( |
Champs | |
---|---|
metadata |
Métadonnées sur la résidence. |
value |
Adresse de la résidence. |
current |
"True" si la résidence est la résidence actuelle de la personne ; "false" si elle est une résidence passée. |
SipAddress
Adresse SIP d'une personne. Les adresses Initial Protocol de session sont utilisées pour les communications VoIP afin de passer des appels vocaux ou vidéo sur Internet.
Représentation JSON |
---|
{
"metadata": {
object ( |
Champs | |
---|---|
metadata |
Métadonnées sur l'adresse SIP. |
value |
Adresse SIP au format SIP RFC 3261 19.1. |
type |
Type d'adresse SIP. Il peut s'agir d'un type personnalisé ou de l'une des valeurs prédéfinies suivantes:
|
formattedType |
Uniquement en sortie. Type d'adresse SIP traduit et formaté dans les paramètres régionaux du compte du lecteur ou dans les paramètres régionaux de l'en-tête HTTP |
Skill
Une compétence que la personne a.
Représentation JSON |
---|
{
"metadata": {
object ( |
Champs | |
---|---|
metadata |
Des métadonnées sur la compétence. |
value |
La compétence (par exemple, |
Tagline
OBSOLÈTE: aucune donnée ne sera renvoyée. Brève description de la personne en une ligne.
Représentation JSON |
---|
{
"metadata": {
object ( |
Champs | |
---|---|
metadata |
Métadonnées sur le slogan. |
value |
Le slogan. |
URL
URL associées à une personne
Représentation JSON |
---|
{
"metadata": {
object ( |
Champs | |
---|---|
metadata |
Métadonnées sur l'URL. |
value |
URL. |
type |
Type d'URL. Le type peut être personnalisé ou correspondre à l'une des valeurs prédéfinies suivantes:
|
formattedType |
Uniquement en sortie. Type d'URL traduit et formaté dans les paramètres régionaux du compte du lecteur ou dans les paramètres régionaux de l'en-tête HTTP |
UserDefined
Données utilisateur arbitraires renseignées par les utilisateurs finaux.
Représentation JSON |
---|
{
"metadata": {
object ( |
Champs | |
---|---|
metadata |
Métadonnées sur les données définies par l'utilisateur. |
key |
Clé des données définies par l'utilisateur spécifiée par l'utilisateur final. |
value |
Valeur spécifiée par l'utilisateur final pour les données définies par l'utilisateur. |
Méthodes |
|
---|---|
|
Créer un lot de nouveaux contacts et renvoyer les réponses PersonResponses pour la nouvelle Les requêtes de mutation pour un même utilisateur doivent être envoyées de manière séquentielle afin d'éviter une augmentation de la latence et des échecs. |
|
Supprimer un lot de contacts |
|
Mettre à jour un lot de contacts et renvoyer un mappage de noms de ressources vers PersonResponses pour les contacts mis à jour |
|
Créez un nouveau contact et renvoyez la ressource de personne pour ce contact. |
|
Supprimer un contact |
|
Supprimez la photo d'un contact. |
|
Fournit des informations sur une personne en spécifiant un nom de ressource. |
|
Fournit des informations sur une liste de personnes spécifiques en spécifiant une liste de noms de ressources demandés. |
|
Fournit une liste des profils de domaine et des contacts du domaine dans l'annuaire du domaine de l'utilisateur authentifié. |
|
Fournit la liste des contacts regroupés de l'utilisateur authentifié qui correspondent à la requête de recherche. |
|
Fournit une liste des profils de domaine et des contacts du domaine dans l'annuaire du domaine de l'utilisateur authentifié qui correspondent à la requête de recherche. |
|
Mettez à jour les données de contact d'un contact existant. |
|
mettre à jour la photo d'un contact ; |