Method: contactGroups.members.modify

Modificar os membros de um grupo de contatos pertencente ao usuário autenticado.

Os únicos grupos de contatos do sistema que podem ter participantes são contactGroups/myContacts e contactGroups/starred. Outros grupos de contatos do sistema foram descontinuados e só podem ter contatos removidos.

Solicitação HTTP

POST https://people.googleapis.com/v1/{resourceName=contactGroups/*}/members:modify

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

Parâmetros de caminho

Parâmetros
resourceName

string

Obrigatório. O nome do recurso do grupo de contatos a ser modificado.

Corpo da solicitação

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

Representação JSON
{
  "resourceNamesToAdd": [
    string
  ],
  "resourceNamesToRemove": [
    string
  ]
}
Campos
resourceNamesToAdd[]

string

Opcional. Os nomes dos recursos das pessoas de contato a serem adicionadas no formato people/{person_id}. O número total de nomes de recursos em resourceNamesToAdd e resourceNamesToRemove precisa ser menor ou igual a 1.000.

resourceNamesToRemove[]

string

Opcional. Os nomes dos recursos das pessoas de contato que serão removidas no formato people/{person_id}. O número total de nomes de recursos em resourceNamesToAdd e resourceNamesToRemove precisa ser menor ou igual a 1.000.

Corpo da resposta

A resposta a uma solicitação de modificação de membros do grupo de contato.

Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:

Representação JSON
{
  "notFoundResourceNames": [
    string
  ],
  "canNotRemoveLastContactGroupResourceNames": [
    string
  ]
}
Campos
notFoundResourceNames[]

string

Os nomes dos recursos de contatos não encontrados.

canNotRemoveLastContactGroupResourceNames[]

string

Os nomes de recursos de pessoas de contato que não podem ser removidos do último grupo de contatos.

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.