Method: contactGroups.create

Crie um novo grupo de contatos de propriedade do usuário autenticado.

Os nomes dos grupos de contatos criados devem ser exclusivos para os grupos de contato dos usuários. A tentativa de criar um grupo com um nome duplicado retornará um erro HTTP 409.

As solicitações de modificação para o mesmo usuário devem ser enviadas em sequência para evitar o aumento da latência e as falhas.

Solicitação HTTP

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

O URL usa a sintaxe de transcodificação gRPC.

Corpo da solicitação

O corpo da solicitação contém dados com a seguinte estrutura:

Representação JSON 
{
  "contactGroup": {
    object (ContactGroup)
  },
  "readGroupFields": string
}
Campos
contactGroup

object (ContactGroup)

Obrigatório. O grupo de contatos a ser criado.
readGroupFields

string (FieldMask format)

Opcional. Uma máscara de campo para restringir quais campos do grupo são retornados. Se não for definido ou for definido como vazio, o padrão será metadata, groupType e name. Os campos válidos são:

  • clientData
  • groupType
  • metadados
  • name

Corpo da resposta

Se a solicitação for bem-sucedida, o corpo da resposta incluirá uma instância de ContactGroup.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte o Guia de autorização.