Method: people.get
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
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/contactshttps://www.googleapis.com/auth/contacts.readonlyhttps://www.googleapis.com/auth/contacts.other.readonlyhttps://www.googleapis.com/auth/directory.readonlyhttps://www.googleapis.com/auth/profile.agerange.readhttps://www.googleapis.com/auth/profile.emails.readhttps://www.googleapis.com/auth/profile.language.readhttps://www.googleapis.com/auth/user.addresses.readhttps://www.googleapis.com/auth/user.birthday.readhttps://www.googleapis.com/auth/user.emails.readhttps://www.googleapis.com/auth/user.gender.readhttps://www.googleapis.com/auth/user.organization.readhttps://www.googleapis.com/auth/user.phonenumbers.readhttps://www.googleapis.com/auth/userinfo.emailhttps://www.googleapis.com/auth/userinfo.profilehttps://www.googleapis.com/auth/profile.language.read
Per ulteriori informazioni, consulta la guida all'autorizzazione.
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2024-08-06 UTC.
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Mancano le informazioni di cui ho bisogno","missingTheInformationINeed","thumb-down"],["Troppo complicato/troppi passaggi","tooComplicatedTooManySteps","thumb-down"],["Obsoleti","outOfDate","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Problema relativo a esempi/codice","samplesCodeIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 2024-08-06 UTC."],[[["Retrieves information about a person, including the authenticated user using `people/me` or by specifying a resource name."],["Requires the `personFields` query parameter to specify which fields to include in the response, otherwise, it returns a 400 error."],["Allows filtering the source of the data using the `sources[]` parameter and supports various authorization scopes for accessing private data."],["Uses a `GET` request to the `https://people.googleapis.com/v1/{resourceName=people/*}` endpoint with optional query parameters."],["Response includes a [Person](/people/api/rest/v1/people#Person) object containing the requested information if successful."]]],["This outlines how to retrieve person information via a `GET` request to `https://people.googleapis.com/v1/{resourceName=people/*}`. The `resourceName` path parameter specifies the person (e.g., `people/me` for the authenticated user). The `personFields` query parameter is mandatory and dictates the data returned. The request body must be empty. A successful request returns a `Person` resource. Authorization is needed for private data. A `400` error is returned if `personFields` is not specified.\n"]]
