Method: people.get

Fornisce informazioni su una persona specificando il nome di una risorsa. Utilizza people/me per indicare l'utente autenticato.

La richiesta restituisce un errore 400 se "personFields" non è specificato.

Richiesta HTTP

GET https://people.googleapis.com/v1/{resourceName=people/*}

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
resourceName

string

Obbligatoria. Il nome della risorsa sulla persona su cui fornire informazioni.

  • Per ottenere informazioni sull'utente autenticato, specifica people/me.
  • Per visualizzare informazioni su un Account Google, specifica people/{account_id}.
  • Per ottenere informazioni su un contatto, specifica il nome della risorsa che identifica il contatto come restituito da people.connections.list.

Parametri di ricerca

Parametri
requestMask
(deprecated)

object (RequestMask)

OBSOLETO (utilizza invece personFields)

Una maschera per limitare i risultati a un sottoinsieme di campi persona.
personFields

string (FieldMask format)

Obbligatoria. Una maschera di campo per limitare i campi restituiti per la persona. È possibile specificare più campi separandoli con virgole. I valori validi sono:

  • addresses
  • ageRanges
  • biografie
  • compleanni
  • calendarUrls
  • clientData
  • coverPhotos
  • emailAddresses
  • eventi
  • externalIds
  • generi
  • imClients
  • interessi
  • locales
  • posizioni
  • memberships
  • metadati
  • miscKeywords
  • names
  • nickname
  • occupazioni
  • organizations
  • phoneNumbers
  • foto
  • relazioni
  • sipAddresses
  • grandi imprese
  • urls
  • userDefined
sources[]

enum (ReadSourceType)

Campo facoltativo. Una maschera dei tipi di origine da restituire. Se non viene configurato, il valore predefinito è READ_SOURCE_TYPE_PROFILE e READ_SOURCE_TYPE_CONTACT.

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene un'istanza di Person.

Ambiti di autorizzazione

Non è richiesta alcuna autorizzazione per accedere ai dati pubblici. Per i dati privati, è richiesto uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/contacts
  • https://www.googleapis.com/auth/contacts.readonly
  • https://www.googleapis.com/auth/contacts.other.readonly
  • https://www.googleapis.com/auth/directory.readonly
  • https://www.googleapis.com/auth/profile.agerange.read
  • https://www.googleapis.com/auth/profile.emails.read
  • https://www.googleapis.com/auth/profile.language.read
  • https://www.googleapis.com/auth/user.addresses.read
  • https://www.googleapis.com/auth/user.birthday.read
  • https://www.googleapis.com/auth/user.emails.read
  • https://www.googleapis.com/auth/user.gender.read
  • https://www.googleapis.com/auth/user.organization.read
  • https://www.googleapis.com/auth/user.phonenumbers.read
  • https://www.googleapis.com/auth/userinfo.email
  • https://www.googleapis.com/auth/userinfo.profile
  • https://www.googleapis.com/auth/profile.language.read

Per ulteriori informazioni, consulta la guida all'autorizzazione.