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 | 
                
                   
 Adres e-mail użytkownika. Wartość specjalna   | 
              
Treść żądania
Treść żądania zawiera dane o następującej strukturze:
| Zapis JSON | 
|---|
{ "ids": [ string ], "addLabelIds": [ string ], "removeLabelIds": [ string ] }  | 
                
| Pola | |
|---|---|
ids[] | 
                  
                     
 Identyfikatory wiadomości, które chcesz zmodyfikować. Obowiązuje limit 1000 identyfikatorów na żądanie.  | 
                
addLabelIds[] | 
                  
                     
 Lista identyfikatorów etykiet do dodania do wiadomości.  | 
                
removeLabelIds[] | 
                  
                     
 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.