Method: users.messages.modify

Modyfikuje etykiety i wartości etykiet klasyfikacji w określonej wiadomości. W przypadku administratorów modyfikujących wiadomości dla użytkowników w organizacji żądania wymagają autoryzacji za pomocą konta usługi, które ma uprawnienia do delegowania w całej domenie, aby podszywać się pod użytkowników w zakresie https://www.googleapis.com/auth/gmail.modify.restricted.

Żądanie HTTP

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

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.
id

string

Identyfikator wiadomości, którą chcesz zmodyfikować.

Treść żądania

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

Zapis JSON 
{
  "addLabelIds": [
    string
  ],
  "removeLabelIds": [
    string
  ],
  "addClassificationLabels": [
    {
      object (ClassificationLabelValue)
    }
  ],
  "removeClassificationLabelIds": [
    string
  ]
}
Pola
addLabelIds[]

string

Lista identyfikatorów etykiet do dodania do tej wiadomości. W ramach każdej aktualizacji możesz dodać maksymalnie 100 etykiet.
removeLabelIds[]

string

Lista identyfikatorów etykiet do usunięcia z tej wiadomości. W ramach jednej aktualizacji możesz usunąć maksymalnie 100 etykiet.
addClassificationLabels[]

object (ClassificationLabelValue)

Lista wartości etykiet klasyfikacji do dodania. Jeśli do wiadomości jest już zastosowana etykieta klasyfikacji o tym samym identyfikatorze, pola z istniejącymi identyfikatorami zostaną zaktualizowane, a pola z nowymi identyfikatorami zostaną dodane. Obowiązuje limit 20 wartości etykiety klasyfikacji na żądanie. Jeśli wiadomość jest już sklasyfikowana, a łączna liczba wartości etykiety klasyfikacji przekracza maksymalną dozwoloną liczbę wartości etykiety klasyfikacji na wiadomość, modyfikacja nie powiedzie się.
removeClassificationLabelIds[]

string

Lista wartości etykiet klasyfikacji do usunięcia z tej wiadomości.

Treść odpowiedzi

W przypadku powodzenia treść odpowiedzi obejmuje wystąpienie elementu Message.

Zakresy autoryzacji

Wymaga jednego z tych zakresów OAuth:

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

Więcej informacji znajdziesz w przewodniku po autoryzacji.