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 el aumento de la latencia y las 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 para restringir los campos del grupo que se muestran. El valor predeterminado es metadata, groupType y name si no se establece o si está vacío. Los campos válidos son los siguientes:

  • clientData
  • groupType
  • metadatos
  • nombre

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.