Method: people.getBatchGet

Fornisce informazioni su un elenco di persone specifiche specificando un elenco dei nomi delle risorse richiesti. 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/people:batchGet

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri di ricerca

Parametri
resourceNames[]

string

Obbligatoria. I nomi delle risorse delle persone su 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 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.

Sono consentiti al massimo 200 nomi di risorse.
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 ogni 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_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 relativa a un elenco di persone per 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 di risorsa richiesto.

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.