Method: users.messages.modify

Modifica os marcadores na mensagem especificada.

Solicitação HTTP

POST https://gmail.googleapis.com/gmail/v1/users/{userId}/messages/{id}/modify

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

Parâmetros de caminho

Parâmetros
userId

string

O endereço de e-mail do usuário. O valor especial me pode ser usado para indicar o usuário autenticado.

id

string

O ID da mensagem a ser modificada.

Corpo da solicitação

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

Representação JSON
{
  "addLabelIds": [
    string
  ],
  "removeLabelIds": [
    string
  ]
}
Campos
addLabelIds[]

string

Uma lista de IDs de marcadores para adicionar a esta mensagem. É possível adicionar até 100 marcadores em cada atualização.

removeLabelIds[]

string

Uma lista de IDs de marcadores a serem removidos desta mensagem. É possível remover até 100 marcadores em cada atualização.

Corpo da resposta

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

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

  • https://mail.google.com/
  • https://www.googleapis.com/auth/gmail.modify

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