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. Ta wyświetlana nazwa może być już używana w przypadku istniejącego pokoju w organizacji Google Workspace.

Obsługuje te typy uwierzytelniania:

  • Uwierzytelnianie aplikacji z zatwierdzoną przez administratora w wersji dla deweloperów i jednym z tych zakresów autoryzacji:

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

  • Uwierzytelnianie użytkownika za pomocą jednego z tych zakresów autoryzacji:

    • https://www.googleapis.com/auth/chat.spaces
    • https://www.googleapis.com/auth/chat.import (tylko pokoje w trybie importowania)
    • Uwierzytelnianie użytkownika przyznaje uprawnienia administratora, gdy konto administratora uwierzytelnia, useAdminAccess to true, a używane są te zakresy autoryzacji:
      • https://www.googleapis.com/auth/chat.admin.spaces

Żą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 przypisany do pokoju 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. Obsługuje maksymalnie 150 znaków.

displayName: obsługuje tylko aktualizowanie wyświetlanej nazwy 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. Ta wyświetlana nazwa może być już używana w przypadku istniejącego pokoju w organizacji Google Workspace.

spaceType: obsługuje tylko zmianę typu pokoju GROUP_CHAT na SPACE. Upewnij się, że w masce aktualizacji znajduje się opcja displayName oraz spaceType, a wybrana przestrzeń ma niepustą nazwę i typ 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: aktualizuje ustawienia historii pokoju, włączając lub wyłączając historię 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, które określa, 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 istniejący pokój ma grupę odbiorców, możesz ją usunąć i ograniczyć dostęp do pokoju, pomijając wartość w polu maski. Aby zaktualizować ustawienia dostępu do pokoju, uwierzytelniający użytkownik musi być menedżerem pokoju i nie może pominąć żadnych pól w prośbie. Nie możesz zaktualizować tego pola, jeśli pokój jest w trybie importowania. Więcej informacji znajdziesz w artykule Udostępnianie pokoju określonym użytkownikom. Funkcja accessSettings.audience nie jest obsługiwana w przypadku useAdminAccess.

permissionSettings: umożliwia zmianę 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. Funkcja permissionSettings nie jest obsługiwana w przypadku 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 true, metoda jest wykonywana z uprawnieniami administratora Google Workspace.

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.