Method: spaces.patch

Aktualizuje pokój. Przykład znajdziesz w artykule Aktualizowanie pokoju.

Jeśli podczas aktualizowania pola displayName pojawi się komunikat o błędzie ALREADY_EXISTS, spróbuj użyć innej wyświetlanej nazwy. Istniejący pokój w organizacji Google Workspace może już używać tej wyświetlanej nazwy.

Obsługuje te typy uwierzytelniania:

Żądanie HTTP

PATCH https://chat.googleapis.com/v1/{space.name=spaces/*}

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
space.name

string

Identyfikator. Nazwa zasobu pokoju.

Format: spaces/{space}

Gdzie {space} to identyfikator pokoju przypisany przez system. Identyfikator pokoju możesz uzyskać, wywołując metodę spaces.list() lub korzystając z adresu URL pokoju. Jeśli na przykład adres URL pokoju to https://mail.google.com/mail/u/0/#chat/space/AAAAAAAAA, jego identyfikator to AAAAAAAAA.

Parametry zapytania

Parametry
updateMask

string (FieldMask format)

Wymagane. zaktualizowane ścieżki pól, rozdzielone przecinkami, jeśli jest ich więcej niż 1.

Możesz zaktualizować te pola pokoju:

spaceDetails: zaktualizuje opis pokoju. Może mieć do 150 znaków.

displayName: obsługuje aktualizowanie wyświetlanej nazwy tylko w przypadku pokoi, w których pole spaceType ma wartość SPACE. Jeśli pojawi się komunikat o błędzie ALREADY_EXISTS, spróbuj użyć innej wartości. Istniejący pokój w organizacji Google Workspace może już używać tej wyświetlanej nazwy.

spaceType: obsługuje tylko zmianę typu pokoju GROUP_CHAT na SPACE. Uwzględnij w masce aktualizacji parametr displayName razem z atrybutem spaceType i upewnij się, że wskazane miejsce ma niepustą wyświetlaną nazwę i typ pokoju SPACE. Dodanie maski spaceType i typu SPACE w określonym pokoju podczas aktualizowania wyświetlanej nazwy jest opcjonalne, jeśli istniejący pokój ma już typ SPACE. Próba zaktualizowania typu pokoju w inny sposób powoduje błąd nieprawidłowego argumentu. Funkcja spaceType nie jest obsługiwana w przypadku useAdminAccess.

spaceHistoryState: zmienia ustawienia historii pokoju przez włączenie lub wyłączenie historii w pokoju. Obsługiwane tylko wtedy, gdy w organizacji Google Workspace są włączone ustawienia historii. Aby zaktualizować stan historii pokoju, musisz pominąć wszystkie inne maski pól w żądaniu. Funkcja spaceHistoryState nie jest obsługiwana w przypadku useAdminAccess.

accessSettings.audience: aktualizuje ustawienie dostępu, aby określić, kto może znaleźć pokój, dołączyć do niego i wyświetlić podgląd wiadomości w pokoju o nazwie, w którym pole spaceType ma wartość SPACE. Jeśli w istniejącym pokoju znajduje się grupa odbiorców, możesz ją usunąć i ograniczyć dostęp do pokoju, pomijając wartość tej maski pola. Aby zaktualizować ustawienia dostępu do pokoju, użytkownik uwierzytelniający musi być menedżerem pokoju i pominąć wszystkie inne maski pól w Twojej prośbie. Nie możesz zaktualizować tego pola, jeśli pokój jest w trybie importowania. Więcej informacji znajdziesz w artykule Ustawianie pokoju jako wykrywalnego dla określonych użytkowników. Pole accessSettings.audience nie jest obsługiwane w przypadku elementu useAdminAccess.

permissionSettings: umożliwia zmienianie ustawień uprawnień pokoju. Podczas aktualizowania ustawień uprawnień możesz określić tylko maski pól permissionSettings. Nie możesz jednocześnie aktualizować innych masek pól. Pole permissionSettings nie jest obsługiwane w przypadku elementu useAdminAccess. Obsługiwane maski pól:

  • permissionSettings.manageMembersAndGroups
  • permissionSettings.modifySpaceDetails
  • permissionSettings.toggleHistory
  • permissionSettings.useAtMentionAll
  • permissionSettings.manageApps
  • permissionSettings.manageWebhooks
  • permissionSettings.replyMessages
useAdminAccess

boolean

Opcjonalnie: Jeśli zasada jest true, metoda jest uruchamiana z uprawnieniami administratora Google Workspace użytkownika.

Użytkownik dzwoniący musi być administratorem Google Workspace z uprawnieniami do zarządzania czatem i rozmowami w pokojach.

Wymaga chat.admin.spaces zakresu OAuth 2.0.

Niektóre wartości FieldMask nie są obsługiwane przy użyciu dostępu administracyjnego. Więcej informacji znajdziesz w opisie updateMask.

Treść żądania

Treść żądania zawiera wystąpienie elementu Space.

Treść odpowiedzi

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

Zakresy autoryzacji

Wymaga jednego z tych zakresów OAuth:

  • https://www.googleapis.com/auth/chat.app.spaces
  • https://www.googleapis.com/auth/chat.admin.spaces
  • https://www.googleapis.com/auth/chat.import
  • https://www.googleapis.com/auth/chat.spaces

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