Zbiorcza zmiana ról użytkowników i zespołów na tablicy

Dwie nowe mutacje pozwalają ustawić rolę wielu użytkowników lub zespołów na tablicy za pomocą jednego wywołania: update_users_board_role i update_teams_board_role. Obie wymagają zakresu boards:write.

• update_users_board_role przyjmuje board_id, role_name i maksymalnie 200 wartości user_ids.
• update_teams_board_role przyjmuje board_id, role_name i maksymalnie 50 wartości team_ids.

Użytkownicy i zespoły muszą już być subskrybentami tablicy. Te mutacje zmieniają rolę, ale nie przyznają dostępu do tablicy. Aby najpierw dodać ich jako subskrybentów, użyj add_users_to_board lub add_teams_to_board.

role_name przyjmuje wartość typu BoardBasicRoleName: editor (może edytować strukturę i zawartość tablicy), contributor (może edytować tylko zawartość) lub viewer (ma dostęp tylko do odczytu). update_users_board_role przyjmuje również wartość member (domyślna rola na tablicy), ale tylko w przypadku użytkowników typu agent. update_teams_board_role jej nie przyjmuje. Wartość assigned_contributor nie jest jeszcze obsługiwana.

Każda mutacja zwraca wynik dla każdego ID. UpdateUsersBoardRoleResponse i UpdateTeamsBoardRoleResponse zawierają listę zaktualizowanych ID (successful_user_ids lub successful_team_ids) oraz listę niepowodzeń (failed_users lub failed_teams). Każda pozycja na liście niepowodzeń zawiera ID i komunikat error. Po każdym wywołaniu sprawdź listę niepowodzeń.

mutation {
  update_users_board_role(
    board_id: 1234567890
    user_ids: [111, 222]
    role_name: viewer
  ) {
    successful_user_ids
    failed_users {
      user_id
      error
    }
  }
}

Pełne tabele argumentów i pól znajdziesz w dokumentacji Boards: Update users board role i Update teams board role.