- Solicitud HTTP
- Parámetros de búsqueda
- Cuerpo de la solicitud
- Cuerpo de la respuesta
- Alcances de la autorización
- Pruébala
Enumera todos los grupos de contactos que pertenecen al usuario autenticado. No se propagan los miembros de los grupos de contactos.
Solicitud HTTP
GET https://people.googleapis.com/v1/contactGroups
La URL usa la sintaxis de la transcodificación gRPC.
Parámetros de consulta
Parámetros | |
---|---|
pageToken |
Opcional. El valor de nextPageToken que se muestra de una llamada anterior a contactGroups.list. Solicita la siguiente página de recursos. |
pageSize |
Opcional. La cantidad máxima de recursos que se mostrarán. Los valores válidos se encuentran entre 1 y 1,000, inclusive. El valor predeterminado es 30 si no se establece o se establece en 0. |
syncToken |
Opcional. Un token de sincronización que muestra una llamada anterior a |
groupFields |
Opcional. Una máscara de campo que restringe los campos del grupo que se muestran. La configuración predeterminada es
|
Cuerpo de la solicitud
El cuerpo de la solicitud debe estar vacío.
Cuerpo de la respuesta
Respuesta a una solicitud de lista de grupos de contactos.
Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:
Representación JSON |
---|
{
"contactGroups": [
{
object ( |
Campos | |
---|---|
contactGroups[] |
La lista de grupos de contactos. No se propagan los miembros de los grupos de contactos. |
totalItems |
La cantidad total de elementos de la lista sin paginación. |
nextPageToken |
El token que se puede usar para recuperar la siguiente página de resultados. |
nextSyncToken |
El token que se puede usar para recuperar cambios desde la última solicitud. |
Permisos de autorización
Se necesita uno de los siguientes alcances de OAuth:
https://www.googleapis.com/auth/contacts
https://www.googleapis.com/auth/contacts.readonly
Para obtener más información, consulta la guía de autorización.