Method: contactGroups.members.modify

Modifique os membros de um grupo de contatos do usuário autenticado.

Os únicos grupos de contatos do sistema que podem ter participantes adicionados 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 de recursos dos contatos a serem adicionados na forma de 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 de recursos dos contatos a serem removidos na forma de 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 para uma solicitação de modificação de membros do grupo de contatos.

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 de recursos de pessoas para contato que não foram encontrados.
canNotRemoveLastContactGroupResourceNames[]

string

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

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.