Method: contactGroups.create

Crea un nuevo grupo de contactos que pertenezca al usuario autenticado.

Los nombres de los grupos de contactos creados deben ser únicos para los grupos de contactos de los usuarios. Si intentas crear un grupo con un nombre duplicado, se mostrará un error HTTP 409.

Las solicitudes de mutación del mismo usuario se deben enviar de forma secuencial para evitar una mayor latencia y fallas.

Solicitud HTTP

POST https://people.googleapis.com/v1/contactGroups

La URL usa la sintaxis de la transcodificación gRPC.

Cuerpo de la solicitud

El cuerpo de la solicitud contiene datos con la siguiente estructura:

Representación JSON 
{
  "contactGroup": {
    object (ContactGroup)
  },
  "readGroupFields": string
}
Campos
contactGroup

object (ContactGroup)

Obligatorio. El grupo de contactos que se creará
readGroupFields

string (FieldMask format)

Opcional. Una máscara de campo que restringe los campos que se muestran en el grupo. La configuración predeterminada es metadata, groupType y name si no se configura o se deja vacía. Los campos válidos son los siguientes:

  • datosdelcliente
  • TipoDeGrupo
  • metadata
  • name

Cuerpo de la respuesta

Si el proceso se realiza de forma correcta, el cuerpo de la respuesta contiene una instancia recién creada de ContactGroup.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

  • https://www.googleapis.com/auth/contacts

Para obtener más información, consulta la guía de autorización.