Method: users.messages.batchModify

Zmienia etykiety wybranych wiadomości.

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
userId

string

Adres e-mail użytkownika. Wartość specjalna me może służyć do wskazywania uwierzytelnionego użytkownika.

Treść żądania

Treść żądania zawiera dane o następującej strukturze:

Zapis JSON
{
  "ids": [
    string
  ],
  "addLabelIds": [
    string
  ],
  "removeLabelIds": [
    string
  ]
}
Pola
ids[]

string

Identyfikatory wiadomości, które chcesz zmodyfikować. Obowiązuje limit 1000 identyfikatorów na żądanie.

addLabelIds[]

string

Lista identyfikatorów etykiet do dodania do wiadomości.

removeLabelIds[]

string

Lista identyfikatorów etykiet do usunięcia z wiadomości.

Treść odpowiedzi

W przypadku powodzenia treść odpowiedzi jest pusta.

Zakresy autoryzacji

Wymaga jednego z tych zakresów OAuth:

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

Więcej informacji znajdziesz w przewodniku dotyczącym autoryzacji.