Method: people.getBatchGet

Fornisce informazioni su un elenco di persone specifiche specificando un elenco di nomi di risorse richiesti. Utilizza people/me per indicare l'utente autenticato.

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

Richiesta HTTP

GET https://people.googleapis.com/v1/people:batchGet

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri di query

Parametri
resourceNames[]

string

Obbligatorio. I nomi delle risorse delle persone di cui fornire informazioni. È ripetibile. Il parametro di query dell'URL deve essere

resourceNames=<name1>&resourceNames=<name2>&...

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

È consentito un massimo di 200 nomi di risorse.
requestMask
(deprecated)

object (RequestMask)

OBSOLETO (utilizza personFields)

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

string (FieldMask format)

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

  • indirizzi
  • ageRanges
  • biografie
  • compleanni
  • calendarUrls
  • clientData
  • coverPhotos
  • emailAddresses
  • eventi
  • externalIds
  • generi
  • imClients
  • interessi
  • locales
  • posizioni
  • memberships
  • metadati
  • miscKeywords
  • nomi
  • nickname
  • professioni
  • organizzazioni
  • phoneNumbers
  • foto
  • relazioni
  • sipAddresses
  • grandi imprese
  • Url
  • userDefined
sources[]

enum (ReadSourceType)

(Facoltativo) Una maschera dei tipi di origine da restituire. Se non viene impostato, il valore predefinito è READ_SOURCE_TYPE_CONTACT e READ_SOURCE_TYPE_PROFILE.

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

La risposta a una richiesta get per un elenco di persone in base al nome della risorsa.

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "responses": [
    {
      object (PersonResponse)
    }
  ]
}
Campi
responses[]

object (PersonResponse)

La risposta per ogni nome della risorsa richiesta.

Ambiti di autorizzazione

Non è richiesta alcuna autorizzazione per accedere ai dati pubblici. Per i dati privati, è obbligatorio 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.