REST Resource: people

Risorsa: persona

Informazioni su una persona unite da varie origini dati, come i contatti e i dati del profilo dell'utente autenticato.

La maggior parte dei campi può avere più elementi. Gli elementi in un campo non hanno un ordine garantito, ma per ogni campo non vuoto è garantito che sia presente un solo campo con metadata.primary impostato su true.

Rappresentazione JSON 
{
  "resourceName": string,
  "etag": string,
  "metadata": {
    object (PersonMetadata)
  },
  "addresses": [
    {
      object (Address)
    }
  ],
  "ageRange": enum (AgeRange),
  "ageRanges": [
    {
      object (AgeRangeType)
    }
  ],
  "biographies": [
    {
      object (Biography)
    }
  ],
  "birthdays": [
    {
      object (Birthday)
    }
  ],
  "braggingRights": [
    {
      object (BraggingRights)
    }
  ],
  "calendarUrls": [
    {
      object (CalendarUrl)
    }
  ],
  "clientData": [
    {
      object (ClientData)
    }
  ],
  "coverPhotos": [
    {
      object (CoverPhoto)
    }
  ],
  "emailAddresses": [
    {
      object (EmailAddress)
    }
  ],
  "events": [
    {
      object (Event)
    }
  ],
  "externalIds": [
    {
      object (ExternalId)
    }
  ],
  "fileAses": [
    {
      object (FileAs)
    }
  ],
  "genders": [
    {
      object (Gender)
    }
  ],
  "imClients": [
    {
      object (ImClient)
    }
  ],
  "interests": [
    {
      object (Interest)
    }
  ],
  "locales": [
    {
      object (Locale)
    }
  ],
  "locations": [
    {
      object (Location)
    }
  ],
  "memberships": [
    {
      object (Membership)
    }
  ],
  "miscKeywords": [
    {
      object (MiscKeyword)
    }
  ],
  "names": [
    {
      object (Name)
    }
  ],
  "nicknames": [
    {
      object (Nickname)
    }
  ],
  "occupations": [
    {
      object (Occupation)
    }
  ],
  "organizations": [
    {
      object (Organization)
    }
  ],
  "phoneNumbers": [
    {
      object (PhoneNumber)
    }
  ],
  "photos": [
    {
      object (Photo)
    }
  ],
  "relations": [
    {
      object (Relation)
    }
  ],
  "relationshipInterests": [
    {
      object (RelationshipInterest)
    }
  ],
  "relationshipStatuses": [
    {
      object (RelationshipStatus)
    }
  ],
  "residences": [
    {
      object (Residence)
    }
  ],
  "sipAddresses": [
    {
      object (SipAddress)
    }
  ],
  "skills": [
    {
      object (Skill)
    }
  ],
  "taglines": [
    {
      object (Tagline)
    }
  ],
  "urls": [
    {
      object (Url)
    }
  ],
  "userDefined": [
    {
      object (UserDefined)
    }
  ]
}
Campi
resourceName

string

Il nome della risorsa per la persona, assegnato dal server. Una stringa ASCII nel formato people/{person_id}.
etag

string

Il tag entità HTTP della risorsa. Utilizzato per la convalida della cache web.
metadata

object (PersonMetadata)

Solo output. Metadati sulla persona.
addresses[]

object (Address)

Gli indirizzi della persona.
ageRange
(deprecated)

enum (AgeRange)

Solo output. OBSOLETO (utilizza invece person.ageRanges)

La fascia d'età della persona.
ageRanges[]

object (AgeRangeType)

Solo output. Le fasce d'età della persona.
biographies[]

object (Biography)

Le biografie della persona. Questo campo è un singleton per le origini dei contatti.
birthdays[]

object (Birthday)

I compleanni della persona. Questo campo è un singleton per le origini dei contatti.
braggingRights[]
(deprecated)

object (BraggingRights)

OBSOLETO: non verranno restituiti dati relativi alle imprese memorabili della persona.
calendarUrls[]

object (CalendarUrl)

Gli URL del calendario della persona.
clientData[]

object (ClientData)

I dati del cliente dell'utente.
coverPhotos[]

object (CoverPhoto)

Solo output. Le foto di copertina della persona.
emailAddresses[]

object (EmailAddress)

Gli indirizzi email della persona. Per people.connections.list e otherContacts.list il numero di indirizzi email è limitato a 100. Se una persona ha più indirizzi email, è possibile recuperare l'intero set chiamando il numero people.getBatchGet.
events[]

object (Event)

Gli eventi della persona.
externalIds[]

object (ExternalId)

Gli ID esterni della persona.
fileAses[]

object (FileAs)

I file-ase della persona.
genders[]

object (Gender)

Il genere della persona. Questo campo è un singleton per le origini dei contatti.
imClients[]

object (ImClient)

I client di messaggistica immediata dell'utente.
interests[]

object (Interest)

Gli interessi della persona.
locales[]

object (Locale)

Le preferenze internazionali della persona.
locations[]

object (Location)

La posizione della persona.
memberships[]

object (Membership)

Le iscrizioni ai gruppi della persona.
miscKeywords[]

object (MiscKeyword)

Parole chiave varie dell'utente.
names[]

object (Name)

I nomi della persona. Questo campo è un singleton per le origini dei contatti.
nicknames[]

object (Nickname)

I nickname della persona.
occupations[]

object (Occupation)

Le professioni della persona.
organizations[]

object (Organization)

Le organizzazioni passate o attuali della persona.
phoneNumbers[]

object (PhoneNumber)

I numeri di telefono della persona. Per people.connections.list e otherContacts.list il numero di numeri di telefono è limitato a 100. Se una persona ha più numeri di telefono, è possibile ottenere l'intero set chiamando il numero people.getBatchGet.
photos[]

object (Photo)

Solo output. Le foto della persona.
relations[]

object (Relation)

Le relazioni della persona.
relationshipInterests[]
(deprecated)

object (RelationshipInterest)

Solo output. OBSOLETO. Non verranno restituiti dati sugli interessi sentimentali della persona.
relationshipStatuses[]
(deprecated)

object (RelationshipStatus)

Solo output. OBSOLETO: non verranno restituiti dati sugli stati della relazione della persona.
residences[]
(deprecated)

object (Residence)

OBSOLETO: (utilizza invece person.locations) Residenze della persona.
sipAddresses[]

object (SipAddress)

Gli indirizzi SIP della persona.
skills[]

object (Skill)

Le competenze della persona.
taglines[]
(deprecated)

object (Tagline)

Solo output. OBSOLETO: non verranno restituiti dati per gli slogan della persona.
urls[]

object (Url)

Gli URL associati dell'utente.
userDefined[]

object (UserDefined)

I dati definiti dall'utente della persona.

PersonMetadata

I metadati di una persona.

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

object (Source)

Le fonti di dati della persona.
previousResourceNames[]

string

Solo output. I nomi precedenti di risorse di questa persona. Il campo viene compilato solo per le richieste people.connections.list che includono un token di sincronizzazione.

Il nome della risorsa può cambiare quando aggiungi o rimuovi campi che collegano un contatto e un profilo, ad esempio un indirizzo email verificato, un numero di telefono verificato o l'URL del profilo.
linkedPeopleResourceNames[]

string

Solo output. Nomi delle persone collegate a questa risorsa.
deleted

boolean

Solo output. True se la risorsa persona è stata eliminata. Compilato solo per le richieste di sincronizzazione people.connections.list e otherContacts.list.
objectType
(deprecated)

enum (ObjectType)

Solo output. OBSOLETO (utilizza invece person.metadata.sources.profileMetadata.objectType)

Il tipo di oggetto persona.

Origine

L'origine di un campo.

Rappresentazione JSON 
{
  "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.
}
Campi
type

enum (SourceType)

Il tipo di origine.
id

string

L'identificatore univoco all'interno del tipo di origine generato dal server.
etag

string

Compilato solo in person.metadata.sources.

Il tag entità HTTP dell'origine. Utilizzato per la convalida della cache web.
updateTime

string (Timestamp format)

Solo output. Compilato solo in person.metadata.sources.

Timestamp dell'ultimo aggiornamento di questa fonte.

Un timestamp in formato "Zulu" RFC3339 UTC, con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

Campo di unione metadata. Compilato solo in person.metadata.sources.

Metadati sulla fonte. metadata può essere solo uno dei seguenti:
profileMetadata

object (ProfileMetadata)

Solo output. Compilato solo in person.metadata.sources.

Metadati relativi a un'origine di tipo PROFILE.

SourceType

Il tipo di origine.

Enum
SOURCE_TYPE_UNSPECIFIED Non specificato.
ACCOUNT Account Google.
PROFILE Profilo Google. Puoi visualizzare il profilo all'indirizzo https://profiles.google.com/{id}, dove {id} è l'ID origine.
DOMAIN_PROFILE Profilo del dominio Google Workspace.
CONTACT Contatto Google. Puoi visualizzare il contatto all'indirizzo https://contact.google.com/{id}, dove {id} è l'ID origine.
OTHER_CONTACT Google "Altro contatto".
DOMAIN_CONTACT Contatto condiviso del dominio Google Workspace.

ProfileMetadata

I metadati relativi a un profilo.

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

enum (ObjectType)

Solo output. Il tipo di oggetto del profilo.
userTypes[]

enum (UserType)

Solo output. L'utente digita.

ObjectType

Il tipo di oggetto "persona".

Enum
OBJECT_TYPE_UNSPECIFIED Non specificato.
PERSON Persona.
PAGE Pagina Currents.

UserType

Il tipo di utente.

Enum
USER_TYPE_UNKNOWN Il tipo di utente non è noto.
GOOGLE_USER L'utente è un utente Google.
GPLUS_USER L'utente è un utente di Currents.
GOOGLE_APPS_USER L'utente è un utente di Google Workspace.

Indirizzo

L'indirizzo fisico di una persona. Può essere una casella postale o un indirizzo. Tutti i campi sono facoltativi.

Rappresentazione JSON 
{
  "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
}
Campi
metadata

object (FieldMetadata)

Metadati sull'indirizzo.
formattedValue

string

Il valore non strutturato dell'indirizzo. Se non viene impostato dall'utente, verrà creato automaticamente a partire da valori strutturati.
type

string

Il tipo di indirizzo. Il tipo può essere personalizzato o uno di questi valori predefiniti:

  • home
  • work
  • other
formattedType

string

Solo output. Il tipo dell'indirizzo tradotto e formattato nelle impostazioni internazionali dell'account del visualizzatore o delle impostazioni internazionali dell'intestazione HTTP Accept-Language.
poBox

string

La casella postale dell'indirizzo.
streetAddress

string

L'indirizzo fisico.
extendedAddress

string

L'indirizzo esteso dell'indirizzo, ad esempio il numero dell'interno.
city

string

La città dell'indirizzo.
region

string

La regione dell'indirizzo, ad esempio stato o provincia.
postalCode

string

Il codice postale dell'indirizzo.
country

string

Il paese dell'indirizzo.
countryCode

string

Il codice paese ISO 3166-1 alpha-2 dell'indirizzo.

FieldMetadata

Metadati relativi a un campo.

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

boolean

Solo output. True se il campo è il campo principale per tutte le origini nell'utente. Per ogni persona sarà presente al massimo un campo con primary impostato su true.
sourcePrimary

boolean

True se il campo è il campo principale per source. Ogni origine deve avere al massimo un campo con sourcePrimary impostato su true.
verified

boolean

Solo output. True se il campo è verificato; false se il campo non è verificato. Un campo verificato è in genere un nome, un indirizzo email, un numero di telefono o un sito web di cui è stata confermata la proprietà della persona.
source

object (Source)

L'origine del campo.

AgeRange

OBSOLETO (utilizza invece person.ageRanges)

La fascia d'età di una persona.

Enum
AGE_RANGE_UNSPECIFIED Non specificato.
LESS_THAN_EIGHTEEN Ha meno di diciotto anni.
EIGHTEEN_TO_TWENTY Tra i diciotto e i venti.
TWENTY_ONE_OR_OLDER A partire da 21 anni.

AgeRangeType

La fascia d'età di una persona.

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

object (FieldMetadata)

Metadati sulla fascia d'età.
ageRange

enum (AgeRange)

La fascia d'età.

Biografia

La breve biografia di una persona.

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

object (FieldMetadata)

Metadati sulla biografia.
value

string

La breve biografia.
contentType

enum (ContentType)

Il tipo di contenuti della biografia.

ContentType

Il tipo di contenuti.

Enum
CONTENT_TYPE_UNSPECIFIED Non specificato.
TEXT_PLAIN Testo normale.
TEXT_HTML Testo HTML.

Compleanno

Il compleanno di una persona. È stato specificato almeno uno dei campi date e text. I campi date e text in genere rappresentano la stessa data, ma non ne è garantito. I clienti devono sempre impostare il campo date quando modificano i compleanni.

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

object (FieldMetadata)

Metadati sulla data di nascita.
date

object (Date)

La data strutturata della data di nascita.
text
(deprecated)

string

Preferisco utilizzare il campo date, se impostato.

Una stringa in formato libero che rappresenta la data di nascita dell'utente. Questo valore non è convalidato.

Data

Rappresenta una data di calendario intera o parziale, ad esempio un compleanno. L'ora del giorno e il fuso orario sono specificati altrove o non sono significativi. La data è relativa al calendario gregoriano. Può rappresentare uno dei seguenti elementi:

  • Una data completa, con valori di anno, mese e giorno diversi da zero.
  • Un mese e un giorno con zero anno (ad esempio, un anniversario).
  • Un anno a sé, con un mese e uno zero.
  • Un anno e un mese, con un giorno zero (ad esempio, la data di scadenza di una carta di credito).

Tipi correlati:

Rappresentazione JSON 
{
  "year": integer,
  "month": integer,
  "day": integer
}
Campi
year

integer

Anno della data. Il valore deve essere compreso tra 1 e 9999 oppure 0 per specificare una data senza anno.
month

integer

Mese di un anno. Il valore deve essere compreso tra 1 e 12 oppure 0 per specificare un anno senza giorno e mese.
day

integer

Giorno di un mese. Il valore deve essere compreso tra 1 e 31 ed essere valido per l'anno e il mese oppure 0 per specificare un anno e un mese in cui il giorno non sia significativo.

BraggingRights

OBSOLETO: non verranno restituiti dati sulle imprese memorabili di una persona.

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

object (FieldMetadata)

Metadati sulle imprese memorabili.
value

string

Imprese memorabili; ad esempio, climbed mount everest.

CalendarUrl

L'URL del calendario di una persona.

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

object (FieldMetadata)

Metadati sull'URL del calendario.
url

string

L'URL del calendario.
type

string

Il tipo di URL del calendario. Il tipo può essere personalizzato o uno di questi valori predefiniti:

  • home
  • freeBusy
  • work
formattedType

string

Solo output. Il tipo di URL del calendario tradotto e formattato nelle impostazioni internazionali dell'account del visualizzatore o nelle impostazioni internazionali dell'intestazione HTTP Accept-Language.

ClientData

Dati arbitrari del client compilati dai client. Sono consentiti valori e chiavi duplicati.

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

object (FieldMetadata)

Metadati sui dati del client.
key

string

La chiave specificata dal client per i dati del client.
value

string

Il valore specificato dal cliente dei dati del cliente.

CoverPhoto

La foto di copertina di una persona. Un'immagine di grandi dimensioni mostrata nella pagina del profilo di una persona che rappresenta la sua persona o i suoi interessi.

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

object (FieldMetadata)

Metadati sulla foto di copertina.
url

string

L'URL della foto di copertina.
default

boolean

True se la foto di copertina è la foto di copertina predefinita; false se la foto di copertina è una foto di copertina fornita dall'utente.

EmailAddress

L'indirizzo email di una persona.

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

object (FieldMetadata)

Metadati sull'indirizzo email.
value

string

L'indirizzo email.
type

string

Il tipo di indirizzo email. Il tipo può essere personalizzato o uno di questi valori predefiniti:

  • home
  • work
  • other
formattedType

string

Solo output. Il tipo di indirizzo email tradotto e formattato nelle impostazioni internazionali dell'account del visualizzatore o nelle impostazioni internazionali dell'intestazione HTTP Accept-Language.
displayName

string

Il nome visualizzato dell'email.

Evento

Un evento correlato a questa persona.

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

object (FieldMetadata)

Metadati sull'evento.
date

object (Date)

La data dell'evento.
type

string

Il tipo di evento. Il tipo può essere personalizzato o uno di questi valori predefiniti:

  • anniversary
  • other
formattedType

string

Solo output. Il tipo di evento tradotto e formattato nelle impostazioni internazionali dell'account dello spettatore o delle impostazioni internazionali dell'intestazione HTTP Accept-Language.

ExternalId

Un identificatore di un'entità esterna correlata alla persona.

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

object (FieldMetadata)

Metadati sull'ID esterno.
value

string

Il valore dell'ID esterno.
type

string

Il tipo di ID esterno. Il tipo può essere personalizzato o uno di questi valori predefiniti:

  • account
  • customer
  • loginId
  • network
  • organization
formattedType

string

Solo output. Il tipo di evento tradotto e formattato nelle impostazioni internazionali dell'account dello spettatore o delle impostazioni internazionali dell'intestazione HTTP Accept-Language.

FileAs

Il nome da utilizzare per ordinare la persona in un elenco.

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

object (FieldMetadata)

I metadati relativi al file come.
value

string

Il valore File come

Genere

Il genere di una persona.

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

object (FieldMetadata)

Metadati sul genere.
value

string

Il genere della persona. Il genere può essere personalizzato o uno di questi valori predefiniti:

  • male
  • female
  • unspecified
formattedValue

string

Solo output. Il valore del genere tradotto e formattato nelle impostazioni internazionali dell'account dello spettatore o nelle impostazioni internazionali dell'intestazione HTTP Accept-Language. I valori non specificati o personalizzati non vengono localizzati.
addressMeAs

string

Campo di testo in formato libero per i pronomi da utilizzare per rivolgersi a una persona. I valori comuni sono:

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

ImClient

Il client di messaggistica immediata di una persona.

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

object (FieldMetadata)

Metadati sul client IM.
username

string

Il nome utente utilizzato nel client IM.
type

string

Il tipo di client IM. Il tipo può essere personalizzato o uno di questi valori predefiniti:

  • home
  • work
  • other
formattedType

string

Solo output. Il tipo di client IM tradotto e formattato nelle impostazioni internazionali dell'account del visualizzatore o nelle impostazioni internazionali dell'intestazione HTTP Accept-Language.
protocol

string

Il protocollo del client IM. Il protocollo può essere personalizzato o uno di questi valori predefiniti:

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

string

Solo output. Il protocollo del client IM formattato nelle impostazioni internazionali dell'account del visualizzatore o delle impostazioni internazionali dell'intestazione HTTP Accept-Language.

Interesse

Uno degli interessi della persona.

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

object (FieldMetadata)

Metadati sull'interesse.
value

string

L'interesse, ad esempio stargazing.

Impostazioni internazionali

La lingua preferita di una persona.

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

object (FieldMetadata)

I metadati sulle impostazioni internazionali.
value

string

Il tag lingua IETF BCP 47 ben formato che rappresenta l'impostazione internazionale.

Località

La posizione di una persona.

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

object (FieldMetadata)

I metadati sulla località.
value

string

Il valore in formato libero della località.
type

string

Il tipo di luogo. Il tipo può essere personalizzato o uno di questi valori predefiniti:

  • desk
  • grewUp
current

boolean

Se la posizione è quella attuale.
buildingId

string

L'identificatore dell'edificio.
floor

string

Il nome o il numero del piano.
floorSection

string

La sezione del piano in floor_name.
deskCode

string

La singola posizione della scrivania.

Appartenenza

L'appartenenza di una persona a un gruppo. È possibile modificare solo le iscrizioni ai gruppi di contatti.

Rappresentazione JSON 
{
  "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.
}
Campi
metadata

object (FieldMetadata)

Metadati sull'abbonamento.
Campo di unione membership. L'abbonamento. membership può essere solo uno dei seguenti:
contactGroupMembership

object (ContactGroupMembership)

L'appartenenza al gruppo di contatti.
domainMembership

object (DomainMembership)

Solo output. L'appartenenza al dominio.

ContactGroupMembership

Appartenenza a un gruppo di contatti Google.

Rappresentazione JSON 
{
  "contactGroupId": string,
  "contactGroupResourceName": string
}
Campi
contactGroupId
(deprecated)

string

Solo output. L'ID del gruppo di contatti per l'appartenenza al gruppo di contatti.
contactGroupResourceName

string

Il nome della risorsa per il gruppo di contatti, assegnato dal server. Una stringa ASCII nel formato contactGroups/{contactGroupId}. Per modificare le iscrizioni, è possibile utilizzare solo contactGroupResourceName. È possibile rimuovere qualsiasi appartenenza a un gruppo di contatti, ma è possibile aggiungere solo le iscrizioni ai gruppi utenti o ai gruppi di sistema "myContacts" o "speciali". Un contatto deve sempre avere almeno un'appartenenza a un gruppo di contatti.

DomainMembership

Un abbonamento a un dominio Google Workspace.

Rappresentazione JSON 
{
  "inViewerDomain": boolean
}
Campi
inViewerDomain

boolean

True se la persona fa parte del dominio Google Workspace del visualizzatore.

MiscKeyword

Parole chiave varie di una persona.

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

object (FieldMetadata)

Metadati sulle parole chiave varie.
value

string

Il valore della parola chiave varie.
type

enum (KeywordType)

Il tipo di parola chiave variegata.
formattedType

string

Solo output. Il tipo della parola chiave variegata tradotta e formattata nelle impostazioni internazionali dell'account del visualizzatore o delle impostazioni internazionali dell'intestazione HTTP Accept-Language.

KeywordType

Tipo di parola chiave variegata.

Enum
TYPE_UNSPECIFIED Non specificato.
OUTLOOK_BILLING_INFORMATION Campo Outlook per i dati di fatturazione.
OUTLOOK_DIRECTORY_SERVER Campo Outlook per il server di directory.
OUTLOOK_KEYWORD Campo Outlook per la parola chiave.
OUTLOOK_MILEAGE Campo Outlook per il chilometraggio.
OUTLOOK_PRIORITY Campo della priorità relativo a Outlook.
OUTLOOK_SENSITIVITY Campo Outlook per la sensibilità.
OUTLOOK_SUBJECT Campo dell'oggetto di Outlook.
OUTLOOK_USER Campo di Outlook per l'utente.
HOME Home.
WORK Lavoro.
OTHER Altro

Nome

Il nome di una persona. Se il nome è un nome d'arte, il nome della famiglia è vuoto.

Rappresentazione JSON 
{
  "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
}
Campi
metadata

object (FieldMetadata)

Metadati sul nome.
displayName

string

Solo output. Il nome visualizzato formattato in base alle impostazioni internazionali specificate dall'account dello spettatore o dall'intestazione HTTP Accept-Language.
displayNameLastFirst

string

Solo output. Il nome visualizzato con il cognome formattato in base alle impostazioni internazionali specificate dall'account del visualizzatore o dall'intestazione HTTP Accept-Language.
unstructuredName

string

Il valore del nome in formato libero.
familyName

string

Il cognome.
givenName

string

Il nome specificato.
middleName

string

I secondi nomi.
honorificPrefix

string

I prefissi onorifici, come Mrs. o Dr.
honorificSuffix

string

I suffissi onorari, ad esempio Jr.
phoneticFullName

string

Il nome completo scritto come si pronuncia.
phoneticFamilyName

string

Il nome della famiglia scritto come si pronuncia.
phoneticGivenName

string

Il nome scritto come sembra.
phoneticMiddleName

string

Il secondo nome o i secondi scritti così come vengono pronunciati.
phoneticHonorificPrefix

string

I prefissi onorifici si scrivono così come vengono pronunciati.
phoneticHonorificSuffix

string

I suffissi onorifici si scrivono così come vengono pronunciati.

Nickname

Il nickname di una persona.

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

object (FieldMetadata)

Metadati sul nickname.
value

string

Il nickname.
type

enum (NicknameType)

Il tipo di nickname.

NicknameType

Il tipo di nickname.

Enum
DEFAULT Nickname generico.
MAIDEN_NAME

Cognome da nubile o cognome di nascita. Categoria relativa a quando il cognome della persona è cambiato in seguito al matrimonio.
INITIALS

Iniziali.
GPLUS

Nickname del profilo Google+.
OTHER_NAME

Un'affiliazione professionale o un altro nome, ad esempio Dr. Smith.
ALTERNATE_NAME Il nome alternativo della persona è noto.
SHORT_NAME

Una versione più breve del nome della persona.

Professione

La professione di una persona.

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

object (FieldMetadata)

Metadati sulla professione.
value

string

La professione; ad esempio, carpenter.

Organizzazione

L'organizzazione passata o attuale di una persona. Sono consentiti intervalli di date sovrapposti.

Rappresentazione JSON 
{
  "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
}
Campi
metadata

object (FieldMetadata)

Metadati sull'organizzazione.
type

string

Il tipo di organizzazione. Il tipo può essere personalizzato o uno di questi valori predefiniti:

  • work
  • school
formattedType

string

Solo output. Il tipo di organizzazione tradotto e formattato nelle impostazioni internazionali dell'account del visualizzatore o delle impostazioni internazionali dell'intestazione HTTP Accept-Language.
startDate

object (Date)

La data di inizio in cui la persona è entrata a far parte dell'organizzazione.
endDate

object (Date)

La data di fine in cui la persona ha lasciato l'organizzazione.
current

boolean

True se l'organizzazione è l'organizzazione attuale della persona; falso se l'organizzazione è un'organizzazione passata.
name

string

Il nome dell'organizzazione.
phoneticName

string

Il nome fonetico dell'organizzazione.
department

string

Il reparto della persona presso l'organizzazione.
title

string

Qualifica della persona presso l'organizzazione.
jobDescription

string

La descrizione del lavoro della persona presso l'organizzazione.
symbol

string

Il simbolo associato all'organizzazione, ad esempio un simbolo di borsa, un'abbreviazione o un acronimo.
domain

string

Il nome di dominio associato all'organizzazione; ad esempio, google.com.
location

string

La sede dell'ufficio dell'organizzazione in cui lavora.
costCenter

string

Il centro di costo della persona presso l'organizzazione.
fullTimeEquivalentMillipercent

integer

La percentuale equivalente a tempo pieno di una persona all'interno dell'organizzazione (100.000 = 100%).

PhoneNumber

Il numero di telefono di una persona.

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

object (FieldMetadata)

Metadati sul numero di telefono.
value

string

Il numero di telefono.
canonicalForm

string

Solo output. Il formato canonico ITU-T E.164 del numero di telefono.
type

string

Il tipo di numero di telefono. Il tipo può essere personalizzato o uno di questi valori predefiniti:

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

string

Solo output. Il tipo di numero di telefono tradotto e formattato nelle impostazioni internazionali dell'account dello spettatore o nelle impostazioni internazionali dell'intestazione HTTP Accept-Language.

Foto

La foto di una persona. Un'immagine mostrata accanto al suo nome per aiutare gli altri a riconoscerla.

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

object (FieldMetadata)

Metadati sulla foto.
url

string

L'URL della foto. Puoi modificare le dimensioni desiderate aggiungendo un parametro di ricerca sz={size} alla fine dell'URL, dove {size} indica la dimensione in pixel. Esempio: https://lh3.googleusercontent.com/-T_wVWLlmg7w/AAAAAAAAAAI/AAAAAAAABa8/00gzXvDBYqw/s100/photo.jpg?sz=50
default

boolean

True se la foto è predefinita; false se la foto è fornita dall'utente.

Relazione

La relazione di una persona con un'altra persona.

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

object (FieldMetadata)

Metadati sulla relazione.
person

string

Il nome dell'altra persona a cui si riferisce questa relazione.
type

string

La relazione della persona con l'altra persona. Il tipo può essere personalizzato o uno di questi valori predefiniti:

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

string

Solo output. Il tipo della relazione tradotta e formattata nelle impostazioni internazionali dell'account del visualizzatore o nelle impostazioni internazionali specificate nell'intestazione HTTP Accept-Language.

RelationshipInterest

OBSOLETO. Non verranno restituiti dati sull'interesse rapporto di una persona.

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

object (FieldMetadata)

Metadati sull'interesse nella relazione.
value

string

Il tipo di relazione che l'utente sta cercando. Il valore può essere personalizzato o uno di questi valori predefiniti:

  • friend
  • date
  • relationship
  • networking
formattedValue

string

Solo output. Il valore dell'interesse della relazione tradotto e formattato nelle impostazioni internazionali dell'account del visualizzatore o nelle impostazioni internazionali specificate nell'intestazione HTTP Accept-Language.

RelationshipStatus

OBSOLETO: non verranno restituiti dati sulla relazione di una persona.

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

object (FieldMetadata)

Metadati sullo stato della relazione.
value

string

Lo stato della relazione. Il valore può essere personalizzato o uno di questi valori predefiniti:

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

string

Solo output. Il valore dello stato della relazione tradotto e formattato nelle impostazioni internazionali dell'account del visualizzatore o nelle impostazioni internazionali dell'intestazione HTTP Accept-Language.

Residenza

OBSOLETO: utilizza person.locations. La residenza passata o attuale di una persona.

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

object (FieldMetadata)

Metadati sulla residenza.
value

string

L'indirizzo del residenza.
current

boolean

True se la residenza è l'attuale residenza della persona; falso se la residenza è una residenza passata.

SipAddress

L'indirizzo SIP di una persona. Gli indirizzi del protocollo iniziale della sessione vengono utilizzati per le comunicazioni VoIP per effettuare chiamate vocali o videochiamate su Internet.

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

object (FieldMetadata)

Metadati sull'indirizzo SIP.
value

string

L'indirizzo SIP nel formato URI SIP RFC 3261 19.1.
type

string

Il tipo di indirizzo SIP. Il tipo può essere personalizzato o uno di questi valori predefiniti:

  • home
  • work
  • mobile
  • other
formattedType

string

Solo output. Il tipo di indirizzo SIP tradotto e formattato nelle impostazioni internazionali dell'account del visualizzatore o a quelle dell'intestazione HTTP Accept-Language.

Skill

Una competenza che la persona possiede.

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

object (FieldMetadata)

Metadati sulla competenza.
value

string

La competenza, ad esempio underwater basket weaving.

Tagline

OBSOLETO: non verranno restituiti dati. Una breve descrizione di una riga della persona.

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

object (FieldMetadata)

Metadati sullo slogan.
value

string

Lo slogan.

URL

Gli URL associati di una persona.

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

object (FieldMetadata)

Metadati relativi all'URL.
value

string

L'URL.
type

string

Il tipo di URL. Il tipo può essere personalizzato o uno di questi valori predefiniti:

  • home
  • work
  • blog
  • profile
  • homePage
  • ftp
  • reservations
  • appInstallPage: sito web per un'applicazione Currents.
  • other
formattedType

string

Solo output. Il tipo di URL tradotto e formattato nelle impostazioni internazionali dell'account del visualizzatore o delle impostazioni internazionali dell'intestazione HTTP Accept-Language.

UserDefined

Dati utente arbitrari che vengono compilati dagli utenti finali.

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

object (FieldMetadata)

Metadati sui dati definiti dall'utente.
key

string

La chiave specificata dall'utente finale per i dati definiti dall'utente.
value

string

Il valore specificato dall'utente finale dei dati definiti dall'utente.

Metodi

batchCreateContacts

Creare un gruppo di nuovi contatti e restituire le risposte PersonResponse per i nuovi

Le richieste modificate per lo stesso utente devono essere inviate in sequenza per evitare un aumento della latenza e degli errori.

batchDeleteContacts

 Eliminare un gruppo di contatti.

batchUpdateContacts

 Aggiorna un gruppo di contatti e restituisci una mappa dei nomi delle risorse a PersonResponses per i contatti aggiornati.

createContact

 Crea un nuovo contatto e restituisci la risorsa persona per quel contatto.

deleteContact

 Eliminare un contatto.

deleteContactPhoto

 Eliminare la foto di un contatto.

get

 Fornisce informazioni su una persona specificando il nome di una risorsa.

getBatchGet

 Fornisce informazioni su un elenco di persone specifiche specificando un elenco dei nomi delle risorse richiesti.

listDirectoryPeople

 Fornisce un elenco dei profili e dei contatti del dominio nella directory del dominio dell'utente autenticato.

searchContacts

 Fornisce un elenco dei contatti raggruppati dell'utente autenticato che corrispondono alla query di ricerca.

searchDirectoryPeople

 Fornisce un elenco dei profili e dei contatti del dominio della directory del dominio dell'utente autenticato che corrispondono alla query di ricerca.

updateContact

 Aggiornare i dati di contatto di un contatto esistente.

updateContactPhoto

 Aggiornare la foto di un contatto.