- Solicitud HTTP
- Parámetros de búsqueda
- Cuerpo de la solicitud
- Cuerpo de la respuesta
- Alcances de la autorización
- Pruébala
Proporciona información sobre una lista de personas específicas mediante la especificación de una lista de nombres de recursos solicitados. Usa people/me
para indicar el usuario autenticado.
La solicitud muestra un error 400 si no se especifica “personFields”.
Solicitud HTTP
GET https://people.googleapis.com/v1/people:batchGet
La URL usa la sintaxis de la transcodificación gRPC.
Parámetros de consulta
Parámetros | |
---|---|
resourceNames[] |
Obligatorio. Los nombres de recursos de las personas a las que se les debe proporcionar información. Es repetible. El parámetro de búsqueda de URL debe ser
Hay un máximo de 200 nombres de recursos. |
requestMask |
OBSOLETO (en su lugar, usa Una máscara para restringir los resultados a un subconjunto de campos de personas. |
personFields |
Obligatorio. Una máscara de campo que restringe los campos que se muestran en cada persona. Se pueden especificar varios campos separándolos con comas. A continuación, se indican los valores válidos:
|
sources[] |
Opcional. Una máscara de los tipos de fuentes que se mostrarán La configuración predeterminada es |
Cuerpo de la solicitud
El cuerpo de la solicitud debe estar vacío.
Cuerpo de la respuesta
Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:
La respuesta a una solicitud get para una lista de personas por nombre de recurso.
Representación JSON |
---|
{
"responses": [
{
object ( |
Campos | |
---|---|
responses[] |
La respuesta para cada nombre de recurso solicitado. |
Alcances de la autorización
No se necesita autorización para acceder a los datos públicos. Para los datos privados, se requiere uno de los siguientes alcances de OAuth:
https://www.googleapis.com/auth/contacts
https://www.googleapis.com/auth/contacts.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
Para obtener más información, consulta la guía de autorización.