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 modificación para el mismo usuario deben enviarse de forma secuencial para evitar aumentos de 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 del grupo que se muestran. La configuración predeterminada es metadata, groupType y name si no se configura o se establece como vacío. Los campos válidos son los siguientes:

  • clientData
  • groupType
  • metadatos
  • 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.