Package google.chat.v1

ButtonList

Lista przycisków.

ResponseType

Tylko dane wejściowe. Typ odpowiedzi aplikacji Google Chat.

string

Tylko dane wejściowe. Adres URL, którego użytkownicy używają do uwierzytelniania lub konfigurowania. (Dotyczy tylko typów odpowiedzi REQUEST_CONFIG).

DialogAction

Tylko dane wejściowe. Odpowiedź na zdarzenie interakcji powiązane z oknem. Musi być dołączony ResponseType.Dialog.

UpdatedWidget

Tylko dane wejściowe. Odpowiedź zaktualizowanego widżetu.

SelectionItem

Tablica obiektów SelectionItem.

string

Identyfikator zaktualizowanego widżetu. Identyfikator musi być zgodny z identyfikatorem widżetu, który wywołał żądanie aktualizacji.

SelectionItems

Lista wyników autouzupełniania w widżetach

Code

Kod stanu.

string

Treść wiadomości, która ma być wysłana do użytkowników w związku ze stanem ich prośby. Jeśli nie jest ustawiony, wysyłana jest ogólna wiadomość na podstawie status_code.

AnnotationType

Typ adnotacji.

int32

Długość podciągu w treści wiadomości w postaci zwykłego tekstu, do której odnosi się ta adnotacja.

int32

Indeks początkowy (w postaci 0, włącznie) w treści wiadomości tekstowej, której odpowiada ta adnotacja.

UserMentionMetadata

Metadane wzmianki użytkownika.

SlashCommandMetadata

Metadane polecenia po ukośniku.

RichLinkMetadata

Metadane linku z elementami rozszerzonymi.

string

Tylko dane wyjściowe. Adres URL, pod którym znajduje się obraz GIF.

string

Nazwa zasobu załącznika, w formacie spaces/{space}/messages/{message}/attachments/{attachment}.

string

Tylko dane wyjściowe. Oryginalna nazwa pliku treści, a nie pełna ścieżka.

string

Tylko dane wyjściowe. Typ treści (typ MIME) pliku.

string

Tylko dane wyjściowe. Adres URL miniatury, który powinien być używany do wyświetlania podglądu załącznika użytkownikowi. Aplikacje do czatu nie powinny używać tego adresu URL do pobierania treści załączników.

string

Tylko dane wyjściowe. Adres URL do pobrania, który powinien być używany, aby umożliwić użytkownikowi pobranie załącznika. Aplikacje do czatu nie powinny używać tego adresu URL do pobierania treści załączników.

Source

Tylko dane wyjściowe. Źródło załącznika.

AttachmentDataRef

Odwołanie do danych załącznika. To pole jest używane przez interfejs Media API do pobierania danych załącznika.

DriveDataRef

Tylko dane wyjściowe. Odwołanie do załącznika z Dysku Google. To pole jest używane w interfejsie Google Drive API.

string

Nazwa zasobu danych załączników. To pole jest używane w ramach interfejsu Media API do pobierania danych załączonych.

string

Nieprzezroczysty token zawierający odwołanie do przesłanego załącznika. Traktowane przez klientów jako nieprzezroczysty ciąg znaków i używane do tworzenia lub aktualizowania wiadomości z Google Chat z załącznikami.

string

Wymagane, jeśli wiadomość zawiera wiele kart. Unikalny identyfikator karty w wiadomości.

Card

Kartę Maksymalny rozmiar to 32 KB.

string

Pokój powiązanego zasobu pokoju czatu.

Format: spaces/{space}

string

Wątek powiązanego zasobu pokoju czatu.

Format: spaces/{space}/threads/{thread}

string

Wiadomość z powiązanego zasobu pokoju czatu.

Format: spaces/{space}/messages/{message}

string

Wymagane. Nazwa zasobu pokoju trybu importu.

Format: spaces/{space}

Space

Obszar trybu importu.

CardHeader

Nagłówek karty. Nagłówek zwykle zawiera tytuł i obraz.

Section

Sekcje są rozdzielone linią.

CardAction

Czynności związane z tą kartą.

string

Nazwa karty.

string

Etykieta, która była wyświetlana w menu czynności.

OnClick

Działanie „onclick” dla tego działania.

string

Należy podać tytuł. Nagłówek ma stałą wysokość: jeśli określony jest tytuł i podtytuł, każdy z nich zajmuje jeden wiersz. Jeśli podany jest tylko tytuł, zajmuje on obie linie.

string

Podtytuł nagłówka karty.

ImageStyle

Typ obrazu (np. kwadratowe lub okrągłe obramowanie).

string

Adres URL obrazu w nagłówku karty.

string

Nagłówek sekcji. Tekst sformatowany jest obsługiwany. Więcej informacji o formatowaniu tekstu znajdziesz w artykułach Formatowanie tekstu w aplikacjach Google Chat i Formatowanie tekstu w dodatkach do Google Workspace.

WidgetMarkup

Sekcja musi zawierać co najmniej jeden widżet.

CustomEmoji

Wymagane. Niestandardowy emotikon do utworzenia.

string

Wymagane. Nazwa zasobu pokoju, dla którego chcesz utworzyć członkostwo.

Format: spaces/{space}

Membership

Wymagane. Relacja członkostwa do utworzenia.

Pole memberType musi zawierać użytkownika z wypełnionymi polami user.name i user.type. Serwer przypisze nazwę zasobu i zastąpi wszystkie inne podane nazwy.

Gdy aplikacja do czatu tworzy relację członkostwa dla użytkownika, musi użyć określonych zakresów autoryzacji i ustawić określone wartości w pewnych polach:

• Podczas uwierzytelniania jako użytkownik wymagany jest zakres autoryzacji chat.memberships.

• W przypadku uwierzytelniania jako aplikacji wymagany jest zakres autoryzacji chat.app.memberships. Uwierzytelnianie się jako aplikacja jest dostępne w tych usługach:

• Ustaw user.type na HUMAN, a user.name na format users/{user}, gdzie {user} może być adresem e-mail użytkownika. W przypadku użytkowników w tej samej organizacji Workspace {user} może być też id osoby z interfejsu People API lub id użytkownika w interfejsie Directory API. Jeśli na przykład identyfikator profilu osoby w interfejsie People API w aplikacji user@example.com to 123456789, możesz dodać użytkownika do pokoju, ustawiając membership.member.name na users/user@example.com lub users/123456789.

Gdy aplikacja do obsługi czatu tworzy własną relację członkostwa, musi uwierzytelnić się jako użytkownik] i użyć zakresu chat.memberships.app, ustawić user.type na BOT i user.name na users/app.

bool

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.memberships zakresu OAuth 2.0.

Przy użyciu dostępu administracyjnego nie można tworzyć subskrypcji w aplikacjach ani tworzyć subskrypcji dla użytkowników spoza organizacji Google Workspace administratora.

string

Wymagane. Nazwa zasobu pokoju, w którym ma zostać utworzona wiadomość.

Format: spaces/{space}

Message

Wymagane. Treść wiadomości.

string

Opcjonalnie: Wycofane: użyj w zastępstwie zasady thread.thread_key. Identyfikator wątku. Obsługuje maksymalnie 4000 znaków. Aby rozpocząć wątek lub dodać do niego wiadomość, utwórz wiadomość i określ threadKey lub thread.name. Przykładowe użycie: Rozpoczynanie wątku wiadomości lub odpowiadanie na niego.

string

Opcjonalnie: Unikalny identyfikator żądania dla tej wiadomości. Jeśli podasz identyfikator istniejącego żądania, zostanie zwrócona wiadomość utworzona z tym identyfikatorem, a nie nowa wiadomość.

MessageReplyOption

Opcjonalnie: Określa, czy wiadomość rozpoczyna wątek, czy odpowiada w nim. Obsługiwane tylko w przypadku nazwanych pokoi.

string

Opcjonalnie: Niestandardowy identyfikator wiadomości. Pozwala aplikacjom Google Chat na pobieranie, aktualizowanie i usuwanie wiadomości bez konieczności zapisywania identyfikatora przypisanego przez system w nazwie zasobu wiadomości (reprezentowanej w polu name wiadomości).

Wartość w tym polu musi spełniać te wymagania:

• Zaczyna się od client-. Na przykład client-custom-name jest prawidłowym identyfikatorem niestandardowym, ale custom-name już nie.
• Może zawierać maksymalnie 63 znaki i tylko małe litery, cyfry oraz łączniki.
• Jest unikalna w obrębie pokoju. Aplikacja do czatu nie może używać tego samego niestandardowego identyfikatora w różnych wiadomościach.

Szczegółowe informacje znajdziesz w sekcji Nadawanie nazwy wiadomościom.

string

Wymagane. Wiadomość, w której utworzono reakcję.

Format: spaces/{space}/messages/{message}

Reaction

Wymagane. Reakcja do utworzenia.

Space

Wymagane. Pola displayName i spaceType muszą być wypełnione. Obsługiwana jest tylko wartość SpaceType.SPACE.

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

Jeśli uczestniczysz w Programie testowania aktualizacji dla programistów, możesz używać SpaceType.GROUP_CHAT, jeśli importMode ma wartość prawda.

Przecinek name jest przypisany na serwerze, więc wszystko określone w tym polu zostanie zignorowane.

string

Opcjonalnie: Unikalny identyfikator tego żądania. Zalecamy losowy identyfikator UUID. Jeśli podasz identyfikator istniejącego żądania, zostanie zwrócony pokój utworzony z tym identyfikatorem, zamiast tworzyć nowy pokój. Podanie istniejącego identyfikatora prośby z tej samej aplikacji Google Chat, ale z innym uwierzytelnionym użytkownikiem spowoduje błąd.

string

Identyfikator. Nazwa zasobu niestandardowego emotikonu przypisanego przez serwer.

Format: customEmojis/{customEmoji}

string

Tylko dane wyjściowe. Unikalny klucz zasobu niestandardowych emotikonów.

string

Niezmienna. Podana przez użytkownika nazwa niestandardowego emotikona, która jest unikalna w organizacji.

Wymagane podczas tworzenia niestandardowego emotikonu, w przeciwnym razie tylko dane wyjściowe.

Nazwy emotikonów muszą zaczynać się i kończyć dwukropkiem, być małymi literami oraz mogą zawierać tylko znaki alfanumeryczne, łączniki i znaki podkreślenia. Łączniki i podkreślenia powinny być używane do oddzielania słów i nie mogą być używane jeden po drugim.

Przykład: :valid-emoji-name:

string

Tylko dane wyjściowe. Adres URL obrazu niestandardowego emotikonu, który jest ważny przez co najmniej 10 minut. Pamiętaj, że niestandardowe emotikony nie są wypełniane w odpowiedzi podczas tworzenia.

CustomEmojiPayload

Tylko dane wejściowe. Dane ładunku.

bytes

Wymagane. Tylko dane wejściowe. Obraz użyty w niestandardowym emotikonie.

Dane ładunku nie mogą przekraczać 256 KB, a rozmiar obrazu musi mieścić się w zakresie od 64 do 500 pikseli. Ograniczenia mogą się zmienić.

string

Wymagane. Tylko dane wejściowe. Nazwa pliku obrazu.

Obsługiwane rozszerzenia plików: .png, .jpg i .gif.

string

Wymagane. Nazwa zasobu niestandardowego emotikona do usunięcia.

Format: customEmojis/{customEmoji}

Możesz użyć nazwy emotikonu jako aliasu elementu {customEmoji}. Na przykład customEmojis/:example-emoji:, gdzie :example-emoji: to nazwa niestandardowego emotikonu.

string

Wymagane. Nazwa zasobu członkostwa, które chcesz usunąć. Aplikacje do czatu mogą usuwać członkostwa użytkowników lub własne. Aplikacje do obsługi czatu nie mogą usuwać innych aplikacji subskrypcji.

W przypadku usuwania członkostwa człowieka wymagany jest zakres chat.memberships i format spaces/{space}/members/{member}. Możesz użyć tego adresu e-mail jako aliasu dla {member}. Na przykład spaces/{space}/members/example@gmail.com, gdzie example@gmail.com to adres e-mail użytkownika Google Chat.

Podczas usuwania członkostwa w aplikacji wymagany jest zakres chat.memberships.app i format spaces/{space}/members/app.

Format: spaces/{space}/members/{member} lub spaces/{space}/members/app.

bool

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.memberships zakresu OAuth 2.0.

Usuwanie członkostwa w aplikacjach w pokoju nie jest możliwe w przypadku dostępu administracyjnego.

string

Wymagane. Nazwa zasobu wiadomości.

Format: spaces/{space}/messages/{message}

Jeśli masz ustawiony dla wiadomości niestandardowy identyfikator, możesz dla {message} użyć wartości z pola clientAssignedMessageId. Szczegółowe informacje znajdziesz w sekcji Nadawanie nazwy wiadomościom.

bool

Gdy true, usunięcie wiadomości powoduje też usunięcie odpowiedzi na niej. Nie uda się usunąć false, jeśli wiadomość ma odpowiedzi w wątkach.

Ma zastosowanie tylko podczas uwierzytelniania jako użytkownik. Nie ma wpływu na uwierzytelnianie jako aplikacja Google Chat.

string

Wymagane. Nazwa reakcji, którą chcesz usunąć.

Format: spaces/{space}/messages/{message}/reactions/{reaction}

string

Wymagane. Nazwa zasobu pokoju do usunięcia.

Format: spaces/{space}

bool

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

Wymaga chat.admin.delete zakresu OAuth 2.0.

DeletionType

Wskazuje, kto usunął wiadomość.

Card

Tylko dane wejściowe. Treść dialogu, który jest renderowany w oknie modalnym. Aplikacje Google Chat nie obsługują tych kart: DateTimePicker, OnChangeAction.

ActionStatus

Tylko dane wejściowe. Stan prośby o wywołanie lub przesłanie dialogu. W razie potrzeby wyświetla stan i komunikat dla użytkowników. Na przykład w przypadku błędu lub sukcesu.

Dialog

Tylko dane wejściowe. Dialog dotyczący prośby.

string

Identyfikator pliku na Dysku. Używaj go z interfejsem Drive API.

DriveDataRef

DriveDataRef, który odwołuje się do pliku na Dysku Google.

string

Typ MIME połączonego zasobu Dysku Google.

string

Podstawowy emotikon reprezentowany przez ciąg Unicode.

CustomEmoji

Tylko dane wyjściowe. Własny emotikon

Emoji

Emotikony powiązane z reakcjami.

int32

Łączna liczba reakcji przy użyciu powiązanego emotikona.

string

Wymagane. Nazwa zasobu użytkownika, z którym chcesz znaleźć wiadomość na czacie.

Format: users/{user}, gdzie {user} to id dla osoby w interfejsie People API lub id dla użytkownika w interfejsie Directory API. Jeśli na przykład identyfikator profilu People API to 123456789, możesz znaleźć czat z tą osobą, używając parametru users/123456789 jako name. Po zalogowaniu się jako użytkownik możesz używać tego adresu e-mail jako aliasu dla {user}. Na przykład users/example@gmail.com, gdzie example@gmail.com to adres e-mail użytkownika Google Chat.

string

Wymagane. Nazwa zasobu załącznika w formacie spaces/{space}/messages/{message}/attachments/{attachment}.

string

Wymagane. Nazwa zasobu niestandardowego emotikona.

Format: customEmojis/{customEmoji}

Możesz użyć nazwy emotikonu jako aliasu elementu {customEmoji}. Przykład: customEmojis/:example-emoji:, gdzie :example-emoji: to nazwa niestandardowego emotikona.

string

Wymagane. Nazwa zasobu subskrypcji do pobrania.

Aby uzyskać członkostwo w aplikacji za pomocą uwierzytelnienia użytkownika, możesz opcjonalnie użyć spaces/{space}/members/app.

Format: spaces/{space}/members/{member} lub spaces/{space}/members/app

Możesz użyć adresu e-mail użytkownika jako aliasu dla {member}. Na przykład spaces/{space}/members/example@gmail.com, gdzie example@gmail.com to adres e-mail użytkownika Google Chat.

bool

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 zakresów OAuth 2.0 chat.admin.memberships lub chat.admin.memberships.readonly.

Uzyskiwanie członkostwa w aplikacji w przestrzeni nie jest obsługiwane, gdy używasz dostępu administratora.

string

Wymagane. Nazwa zasobu wiadomości.

Format: spaces/{space}/messages/{message}

Jeśli masz ustawiony dla wiadomości niestandardowy identyfikator, możesz dla {message} użyć wartości z pola clientAssignedMessageId. Szczegółowe informacje znajdziesz w artykule Nazywanie wiadomości.

string

Wymagane. Nazwa zasobu wydarzenia w pokoju.

Format: spaces/{space}/spaceEvents/{spaceEvent}

string

Wymagane. Nazwa zasobu stanu odczytu pokoju do pobrania.

Obsługuje tylko pobieranie stanu odczytu w przypadku dzwoniącego użytkownika.

Aby odwołać się do użytkownika dzwoniącego, ustaw jedną z tych opcji:

• Alias me. Na przykład: users/me/spaces/{space}/spaceReadState.

• adres e-mail Workspace, Na przykład: users/user@example.com/spaces/{space}/spaceReadState.

• Identyfikator użytkownika. Na przykład: users/123456789/spaces/{space}/spaceReadState.

Format: użytkownicy/{użytkownik}/spaces/{spacja}/spaceReadState

string

Wymagane. Nazwa zasobu pokoju w formacie spaces/{space}.

Format: spaces/{space}

bool

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

Wymaga zakresów OAuth 2.0 chat.admin.spaces lub chat.admin.spaces.readonly.

string

Wymagane. Nazwa zasobu z stanem odczytu wątku do pobrania.

Obsługuje tylko pobieranie stanu odczytu w przypadku dzwoniącego użytkownika.

Aby odwołać się do użytkownika dzwoniącego, ustaw jedną z tych opcji:

• Alias me. Na przykład: users/me/spaces/{space}/threads/{thread}/threadReadState.

• adres e-mail Workspace, Na przykład: users/user@example.com/spaces/{space}/threads/{thread}/threadReadState.

• identyfikator użytkownika, Na przykład: users/123456789/spaces/{space}/threads/{thread}/threadReadState.

Format: users/{user}/spaces/{space}/threads/{thread}/threadReadState

string

Nazwa zasobu Grupy dyskusyjnej Google.

Reprezentuje grupę w Cloud Identity Groups API.

Format: groups/{group}

int32

Opcjonalnie: Maksymalna liczba zwracanych niestandardowych emotikonów. Usługa może zwrócić mniej niestandardowych emotikonów niż ta wartość. Jeśli nie zostanie podana, wartością domyślną jest 25. Maksymalna wartość to 200. wartości powyżej 200 są zmieniane na 200.

string

Opcjonalnie: (jeśli wznawiasz działanie po poprzednim zapytaniu).

Token strony otrzymany z poprzedniego wywołania listy niestandardowych emotikonów. Podaj ten parametr, aby pobrać kolejną stronę.

Przy dzieleniu na strony wartość filtra powinna być zgodna z wywołaniem podanym dla tokena strony. Przekazywanie innej wartości może prowadzić do nieoczekiwanych wyników.

string

Opcjonalnie: Filtr zapytania.

Umożliwia filtrowanie według twórcy.

Aby filtrować według twórcy, musisz podać prawidłową wartość. Obecnie tylko creator("users/me") i NOT creator("users/me") mogą filtrować niestandardowe emotikony według tego, czy zostały utworzone przez dzwoniącego czy nie.

Na przykład to zapytanie zwraca niestandardowy emotikon utworzony przez wywołującego:

creator("users/me")

Nieprawidłowe zapytania są odrzucane przez serwer z błędem INVALID_ARGUMENT.

CustomEmoji

Lista nieuporządkowana. Lista niestandardowych emotikonów na żądanej (lub pierwszej) stronie.

string

Token, który możesz wysłać jako pageToken, aby pobrać następną stronę wyników. Jeśli pole jest puste, nie ma kolejnych stron.

string

Wymagane. Nazwa zasobu pokoju, z którego chcesz pobrać listę członków.

Format: spaces/{space}

int32

Opcjonalnie: Maksymalna liczba subskrypcji do zwrócenia. Usługa może zwrócić mniej niż ta wartość.

Jeśli nie określono inaczej, zwracanych jest maksymalnie 100 członków.

Maksymalna wartość to 1000. Jeśli użyjesz wartości większej niż 1000, zostanie ona automatycznie zmieniona na 1000.

Wartości ujemne zwracają błąd INVALID_ARGUMENT.

string

Opcjonalnie: Token strony otrzymany z poprzedniego wywołania listy członkostwa. Podaj ten parametr, aby pobrać kolejną stronę.

Podczas dzielenia na strony wszystkie pozostałe parametry powinny być zgodne z wywołaniem, które dostarczyło token strony. Przekazywanie innych wartości do innych parametrów może prowadzić do nieoczekiwanych wyników.

string

Opcjonalnie: Filtr zapytania.

Możesz filtrować członkostwa według roli (role) i typu (member.type) członka.

Aby filtrować według roli, ustaw role na ROLE_MEMBER lub ROLE_MANAGER.

Aby filtrować według typu, ustaw wartość member.type na HUMAN lub BOT. Możesz też filtrować według member.type, używając operatora !=.

Aby filtrować dane według roli i typu, użyj operatora AND. Aby filtrować według roli lub typu, użyj operatora OR.

Gdy zasada use_admin_access ma wartość Prawda, wymagana jest właściwość member.type = "HUMAN" lub member.type != "BOT". Inne filtry typów członków zostaną odrzucone.

Na przykład te zapytania są prawidłowe:

role = "ROLE_MANAGER" OR role = "ROLE_MEMBER"
member.type = "HUMAN" AND role = "ROLE_MANAGER"

member.type != "BOT"

Te zapytania są nieprawidłowe:

member.type = "HUMAN" AND member.type = "BOT"
role = "ROLE_MANAGER" AND role = "ROLE_MEMBER"

Serwer odrzuca nieprawidłowe zapytania, zwracając błąd INVALID_ARGUMENT.

bool

Opcjonalnie: Gdy true, oprócz innych typów wspierania zwraca także informacje o wspieraniu powiązane z elementem Google Group. Jeśli ustawiona jest opcja filter, Google Group członkostwa, które nie pasują do kryteriów filtra, nie są zwracane.

bool

Opcjonalnie: Jeśli true, zwraca również wspierających powiązanych z invited, oprócz innych typów wspierających. Jeśli ustawiony jest filtr, subskrypcje (invited), które nie pasują do kryteriów filtra, nie są zwracane.

Obecnie wymaga uwierzytelniania użytkownika.

bool

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

Wymaga zakresu OAuth 2.0 chat.admin.memberships.readonly lub chat.admin.memberships.

Wyświetlanie członkostwa w aplikacji w pokoju nie jest obsługiwane, gdy używasz dostępu administratora.

Membership

Lista nieuporządkowana. Lista członkostw na stronie, której dotyczy żądanie (lub pierwszej stronie).

string

Token, który możesz wysłać jako pageToken, aby pobrać następną stronę wyników. Jeśli jest puste, nie ma kolejnych stron.

string

Wymagane. Nazwa zasobu pokoju, z którego mają być wyświetlane wiadomości.

Format: spaces/{space}

int32

Maksymalna liczba zwróconych wiadomości. Usługa może zwrócić mniej wiadomości niż ta wartość.

Jeśli nie określisz tej wartości, zwróci się maksymalnie 25 wyników.

Maksymalna wartość to 1000. Jeśli użyjesz wartości większej niż 1000, zostanie ona automatycznie zmieniona na 1000.

Wartości ujemne zwracają błąd INVALID_ARGUMENT.

string

Opcjonalne, jeśli wznawiasz działanie po poprzednim zapytaniu.

Token strony otrzymany z poprzedniego wywołania listy wiadomości. Podaj ten parametr, aby pobrać kolejną stronę.

Podczas podziału na strony wszystkie inne parametry powinny być takie same jak w wywołaniu, które dostarczyło token strony. Przekazywanie różnych wartości do innych parametrów może prowadzić do nieoczekiwanych wyników.

string

Filtr zapytania.

Wiadomości możesz filtrować według daty (create_time) i wątku (thread.name).

Aby filtrować wiadomości według daty ich utworzenia, wpisz create_time z sygnaturą czasową w formacie RFC-3339 i cudzysłowami podwójnymi. Na przykład: "2023-04-21T11:30:00-04:00". Możesz użyć operatora większego >, aby wyświetlić wiadomości utworzone po podanej sygnaturze czasowej, lub operatora mniejszego <, aby wyświetlić wiadomości utworzone przed podaną sygnaturą czasową. Aby filtrować wiadomości w określonym przedziale czasu, między 2 sygnaturami czasowymi użyj operatora AND.

Aby filtrować według wątku, określ thread.name w formacie spaces/{space}/threads/{thread}. W przypadku każdej kwerendy możesz określić tylko 1 element thread.name.

Aby filtrować według wątku i daty, użyj w zapytaniu operatora AND.

Prawidłowe są na przykład te zapytania:

create_time > "2012-04-21T11:30:00-04:00"

create_time > "2012-04-21T11:30:00-04:00" AND
  thread.name = spaces/AAAAAAAAAAA/threads/123

create_time > "2012-04-21T11:30:00+00:00" AND

create_time < "2013-01-01T00:00:00+00:00" AND
  thread.name = spaces/AAAAAAAAAAA/threads/123

thread.name = spaces/AAAAAAAAAAA/threads/123

Nieprawidłowe zapytania są odrzucane przez serwer z błędem INVALID_ARGUMENT.

string

Opcjonalne, jeśli wznawiasz działanie po poprzednim zapytaniu.

kolejność wyświetlania listy wiadomości; Określ wartość do posortowania za pomocą operacji sortowania. Prawidłowe wartości operacji porządkowania są następujące:

• ASC w kolejności rosnącej.

• DESC malejąco.

Domyślne sortowanie to create_time ASC.

bool

Określa, czy mają być uwzględniane usunięte wiadomości. Usuwane wiadomości zawierają czas usunięcia i metadane dotyczące ich usunięcia, ale ich treść jest niedostępna.

Message

Lista wiadomości.

string

Aby pobrać następną stronę wyników, możesz wysłać token jako pageToken. Jeśli pole jest puste, nie ma kolejnych stron.

string

Wymagane. Wiadomość, na którą zareagowali użytkownicy.

Format: spaces/{space}/messages/{message}

int32

Opcjonalnie: Maksymalna liczba zwróconych reakcji. Usługa może zwrócić mniej reakcji niż ta wartość. Jeśli nie zostanie podana, wartością domyślną jest 25. Maksymalna wartość to 200. wartości powyżej 200 są zmieniane na 200.

string

Opcjonalnie: (W przypadku wznawiania poprzedniego zapytania).

Token strony otrzymany z poprzedniego wywołania listy reakcji. Podaj go, aby pobrać kolejną stronę.

Przy dzieleniu na strony wartość filtra powinna być zgodna z wywołaniem podanym dla tokena strony. Przekazywanie innej wartości może prowadzić do nieoczekiwanych wyników.

string

Opcjonalnie: Filtr zapytania.

Możesz filtrować reakcje według emotikonów (emoji.unicode lub emoji.custom_emoji.uid) oraz użytkownika (user.name).

Aby filtrować reakcje według wielu emotikonów lub użytkowników, złącz podobne pola za pomocą operatora OR, np. emoji.unicode = "🙂" OR emoji.unicode = "👍" i user.name = "users/AAAAAA" OR user.name = "users/BBBBBB".

Aby filtrować reakcje według emotikonów i użytkowników, użyj operatora AND, np. emoji.unicode = "🙂" AND user.name = "users/AAAAAA".

Jeśli w zapytaniu używane są zarówno AND, jak i OR, pogrupuj je w nawiasach.

Prawidłowe są na przykład te zapytania:

user.name = "users/{user}"
emoji.unicode = "🙂"
emoji.custom_emoji.uid = "{uid}"
emoji.unicode = "🙂" OR emoji.unicode = "👍"
emoji.unicode = "🙂" OR emoji.custom_emoji.uid = "{uid}"
emoji.unicode = "🙂" AND user.name = "users/{user}"
(emoji.unicode = "🙂" OR emoji.custom_emoji.uid = "{uid}")
AND user.name = "users/{user}"

Te zapytania są nieprawidłowe:

emoji.unicode = "🙂" AND emoji.unicode = "👍"
emoji.unicode = "🙂" AND emoji.custom_emoji.uid = "{uid}"
emoji.unicode = "🙂" OR user.name = "users/{user}"
emoji.unicode = "🙂" OR emoji.custom_emoji.uid = "{uid}" OR
user.name = "users/{user}"
emoji.unicode = "🙂" OR emoji.custom_emoji.uid = "{uid}"
AND user.name = "users/{user}"

Serwer odrzuca nieprawidłowe zapytania, zwracając błąd INVALID_ARGUMENT.

Reaction

Lista reakcji na żądanej (lub pierwszej) stronie.

string

Token kontynuacji, który pozwala pobrać następną stronę wyników. Na ostatniej stronie wyników jest puste.

string

Wymagane. Nazwa zasobu pokoju Google Chat, w którym wystąpiły zdarzenia.

Format: spaces/{space}.

int32

Opcjonalnie: Maksymalna liczba zwracanych zdarzeń związanych z przestrzenią. Usługa może zwrócić mniej niż ta wartość.

Wartości ujemne zwracają błąd INVALID_ARGUMENT.

string

Token strony otrzymany z poprzedniego wywołania zdarzeń w pokoju listy. Podaj go, aby pobrać kolejną stronę.

Podczas dzielenia na strony wszystkie pozostałe parametry służące do wyświetlania listy zdarzeń pokoju muszą być zgodne z wywołaniem, które dostarczyło token strony. Przekazywanie różnych wartości do innych parametrów może prowadzić do nieoczekiwanych wyników.

string

Wymagane. Filtr zapytania.

Musisz określić co najmniej 1 typ zdarzenia (event_type) za pomocą operatora zawiera :. Aby filtrować według wielu typów zdarzeń, użyj operatora OR. Pomiń w filtrze typy zdarzeń zbiorczych. Żądanie automatycznie zwraca wszystkie powiązane zdarzenia zbiorcze. Jeśli na przykład filtrujesz według nowych reakcji (google.workspace.chat.reaction.v1.created), serwer zwraca też zdarzenia dotyczące nowych reakcji (google.workspace.chat.reaction.v1.batchCreated). Listę obsługiwanych typów zdarzeń znajdziesz w SpaceEvents dokumentacji referencyjnej.

Opcjonalnie możesz też filtrować według czasu rozpoczęcia (start_time) i czasu zakończenia (end_time):

• start_time: unikalna sygnatura czasowa, od której zaczyna się wyświetlanie listy zdarzeń dotyczących pokoju. Możesz wyświetlić zdarzenia, które miały miejsce do 28 dni temu. Jeśli nie jest określone, wyświetla się lista zdarzeń w czasie rzeczywistym z ostatnich 28 dni.
• end_time: sygnatura czasowa uwzględniająca, do której zdarzeń z pokoju należą zdarzenia. Jeśli nie określono inaczej, wyświetla listę zdarzeń do momentu przesłania żądania.

Aby określić godzinę rozpoczęcia lub zakończenia, użyj operatora równa się = i formatu w dokumencie RFC-3339. Aby filtrować według właściwości start_time i end_time, użyj operatora AND.

Prawidłowe są na przykład te zapytania:

start_time="2023-08-23T19:20:33+00:00" AND
end_time="2023-08-23T19:21:54+00:00"

start_time="2023-08-23T19:20:33+00:00" AND
(event_types:"google.workspace.chat.space.v1.updated" OR
event_types:"google.workspace.chat.message.v1.created")

Te zapytania są nieprawidłowe:

start_time="2023-08-23T19:20:33+00:00" OR
end_time="2023-08-23T19:21:54+00:00"

event_types:"google.workspace.chat.space.v1.updated" AND
event_types:"google.workspace.chat.message.v1.created"

Serwer odrzuca nieprawidłowe zapytania, zwracając błąd INVALID_ARGUMENT.

SpaceEvent

Wyniki są zwracane w kolejności chronologicznej (od najstarszych zdarzeń). Uwaga: w przypadku żądań listy pole permissionSettings nie jest zwracane w obiekcie pokoju.

string

Token kontynuacji używany do pobierania kolejnych zdarzeń. Jeśli pominiesz to pole, nie będzie kolejnych stron.

int32

Opcjonalnie: Maksymalna liczba miejsc do zwrócenia. Usługa może zwrócić mniej niż ta wartość.

Jeśli nie zostanie podana żadna wartość, zwróci się maksymalnie 100 miejsc.

Maksymalna wartość to 1000. Jeśli użyjesz wartości większej niż 1000, zostanie ona automatycznie zmieniona na 1000.

Wartości ujemne zwracają błąd INVALID_ARGUMENT.

string

Opcjonalnie: Token strony otrzymany z poprzedniego wywołania listy pokoi. Podaj ten parametr, aby pobrać kolejną stronę.

Podczas podziału na strony wartość filtra powinna odpowiadać wywołaniu, które dostarczyło token strony. Podanie innej wartości może spowodować nieoczekiwane wyniki.

string

Opcjonalnie: Filtr zapytania.

Pokoje możesz filtrować według typu pokoju (space_type).

Aby filtrować według typu pokoju, musisz podać prawidłową wartość wyliczeniową, np. SPACE lub GROUP_CHAT (space_type nie może mieć wartości SPACE_TYPE_UNSPECIFIED). Aby wysłać zapytanie dotyczące wielu typów pokojów, użyj operatora OR.

Prawidłowe są na przykład te zapytania:

space_type = "SPACE"
spaceType = "GROUP_CHAT" OR spaceType = "DIRECT_MESSAGE"

Serwer odrzuca nieprawidłowe zapytania, zwracając błąd INVALID_ARGUMENT.

Space

Lista pokoi na stronie, której dotyczy żądanie (lub na pierwszej stronie). Uwaga: pole permissionSettings nie jest zwracane w obiekcie Space w przypadku żądań listy.

string

Aby pobrać następną stronę wyników, możesz wysłać token jako pageToken. Jeśli jest puste, nie ma kolejnych stron.

string

Tylko dane wyjściowe. Dopasowany adres URL.

string

Nazwa zasobu członkostwa przypisana przez serwer.

Format: spaces/{space}/members/{member}

MembershipState

Tylko dane wyjściowe. Stan członkostwa.

MembershipRole

Opcjonalnie: Rola użytkownika w pokoju czatu, która określa jego uprawnienia w pokoju.

Tego pola można używać tylko jako danych wejściowych w usłudze UpdateMembership.

Timestamp

Opcjonalnie: Stała. Czas utworzenia członkostwa, np. kiedy użytkownik dołączył do pokoju lub został zaproszony do niego. To pole jest tylko wyjściowe, z wyjątkiem sytuacji, gdy jest używane do importowania historycznych członkostw w pokojach w trybie importowania.

Timestamp

Opcjonalnie: Niezmienna. Czas usunięcia członkostwa, np. gdy użytkownik opuścił pokój lub został z niego usunięty. To pole jest tylko wyjściowe, z wyjątkiem sytuacji, gdy jest używane do importowania historycznych członkostw w pokojach w trybie importowania.

User

Użytkownik lub aplikacja Google Chat, której dotyczy subskrypcja. Jeśli Twoja aplikacja do obsługi czatu uwierzytelnia się jako użytkownik, dane wyjściowe wypełnią pola name i type użytkownika.

Group

Grupa dyskusyjna Google, do której należy członkostwo.

Odczytywanie lub modyfikowanie członkostwa w Grupach dyskusyjnych Google wymaga uwierzytelniania użytkownika.

MembershipCreatedEventData

Listę nowych subskrypcji.

MembershipDeletedEventData

Lista usuniętych wspierań.

MembershipUpdatedEventData

Listę zaktualizowanych subskrypcji.

Membership

Nowa subskrypcja.

Membership

Usunięta subskrypcja. Wypełnione są tylko pola name i state.

Membership

Zaktualizowane członkostwo.

string

Nazwa zasobu wiadomości.

Format: spaces/{space}/messages/{message}

Gdzie {space} to identyfikator pokoju, w którym została opublikowana wiadomość, a {message} to identyfikator przypisany przez system tej wiadomości. Na przykład: spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB.

Jeśli podczas tworzenia wiadomości ustawisz niestandardowy identyfikator, możesz użyć tego identyfikatora do określenia wiadomości w żądaniu, zastępując {message} wartością z pola clientAssignedMessageId. Na przykład: spaces/AAAAAAAAAAA/messages/client-custom-name. Szczegółowe informacje znajdziesz w artykule Nazywanie wiadomości.

User

Tylko dane wyjściowe. Użytkownik, który utworzył wiadomość. Jeśli aplikacja Google Chat uwierzytelnia się jako użytkownik, dane wyjściowe wypełniają pola user name i type.

Timestamp

Opcjonalnie: Niezmienna. W przypadku pokoi utworzonych w Google Chat – czas utworzenia wiadomości. To pole jest tylko wyjściowe, z wyjątkiem sytuacji, gdy jest używane w pomieszczeniach w trybie importowania.

W przypadku pokoi w trybie importowania ustaw w tym polu historyczną sygnaturę czasową, w której wiadomość została utworzona w źródle, aby zachować pierwotny czas utworzenia.

Timestamp

Tylko dane wyjściowe. Czas ostatniej modyfikacji wiadomości przez użytkownika. Jeśli wiadomość nigdy nie została edytowana, to pole jest puste.

Timestamp

Tylko dane wyjściowe. Czas usunięcia wiadomości z Google Chat. Jeśli wiadomość nigdy nie została usunięta, to pole jest puste.

string

Treść wiadomości w postaci zwykłego tekstu. Pierwszy link do obrazu, filmu lub strony internetowej powoduje wyświetlenie elementu prowadzącego do podglądu. Możesz też wzmiankować użytkownika Google Chat lub wszystkich użytkowników pokoju.

Aby dowiedzieć się więcej o tworzeniu SMS-ów, zobacz Wysyłanie wiadomości.

string

Tylko dane wyjściowe. Zawiera wiadomość text ze znacznikami dodanymi w celu komunikowania formatowania. To pole może nie uwzględniać całego formatowania widocznego w interfejsie użytkownika, ale obejmuje:

• Składnia znaczników do pogrubienia, kursywy, przekreślenia, czcionki monospace, bloku czcionki monospace i listy punktowanej.

• Wzmianki użytkownika w formacie <users/{user}>.

• niestandardowe hiperlinki w formacie <{url}|{rendered_text}>, gdzie pierwszy ciąg to adres URL, a drugi – renderowany tekst (np. <http://example.com|custom text>);

• Niestandardowe emotikony w formacie :{emoji_name}:, np. :smile:. Nie dotyczy to emotikonów Unicode, takich jak U+1F600, które oznaczają uśmiechniętą buźkę.

Więcej informacji znajdziesz w artykule Wyświetlanie formatowania tekstu w wiadomości.

Card

Wycofane: użyj atrybutu cards_v2.

Szczegółowe, sformatowane i interaktywne karty, których możesz używać do wyświetlania elementów interfejsu, takich jak sformatowany tekst, przyciski i klikalne obrazy. Karty są zwykle wyświetlane pod zwykłym tekstem treści wiadomości. Pliki cards i cards_v2 mogą mieć maksymalny rozmiar 32 KB.

CardWithId

Tablica kart.

Karty mogą tworzyć tylko aplikacje do obsługi czatu. Jeśli aplikacja Czat uwierzytelnia się jako użytkownik, wiadomości nie mogą zawierać kart.

Aby dowiedzieć się, jak utworzyć wiadomość z kartami, przeczytaj sekcję Wysyłanie wiadomości.

Projektuj karty i wyświetlaj ich podgląd za pomocą kreatora kart.

Annotation

Tylko dane wyjściowe. Adnotacje powiązane z text w tej wiadomości.

Thread

Wątek, do którego należy wiadomość. Przykładowe użycie: Rozpoczynanie wątku wiadomości lub odpowiadanie na niego.

Space

Jeśli aplikacja Google Chat uwierzytelnia się jako użytkownik, dane wyjściowe wypełniają pole name.

string

Zwykły tekst opisu kart wiadomości używany, gdy nie można wyświetlić odpowiednich kart – na przykład do powiadomień na urządzeniu mobilnym.

ActionResponse

Tylko dane wejściowe. Parametry, których aplikacja Google Chat może używać do konfigurowania sposobu publikowania odpowiedzi.

string

Tylko dane wyjściowe. Zwykły tekst wiadomości z usuniętymi wszystkimi wzmiankami w aplikacji Google Chat.

SlashCommand

Tylko dane wyjściowe. Informacje o poleceniach po ukośniku (jeśli dotyczy).

Attachment

Załącznik przesłany przez użytkownika.

MatchedUrl

Tylko dane wyjściowe. Adres URL w spaces.messages.text, który pasuje do wzorca podglądu linku. Więcej informacji znajdziesz w sekcji Podgląd linków.

bool

Tylko dane wyjściowe. Gdy true, wiadomość jest odpowiedzią w wątku odpowiedzi. Gdy false, wiadomość jest widoczna w rozmowie na najwyższym poziomie pokoju jako pierwsza wiadomość w wątku lub wiadomość bez odpowiedzi w wątkach.

Jeśli pokój nie obsługuje odpowiadania w wątkach, to pole jest zawsze false.

string

Opcjonalnie: Niestandardowy identyfikator wiadomości. Możesz użyć pola, aby zidentyfikować wiadomość lub ją pobrać, usunąć lub zaktualizować. Aby ustawić niestandardowy identyfikator, podczas tworzenia wiadomości użyj pola messageId. Szczegółowe informacje znajdziesz w sekcji Nadawanie nazwy wiadomościom.

EmojiReactionSummary

Tylko dane wyjściowe. Lista podsumowań emotikonów w wiadomości.

User

Stała. Dane wejściowe do tworzenia wiadomości, w przeciwnym razie tylko dane wyjściowe. Użytkownik, który może wyświetlić wiadomość. Gdy to pole jest ustawione, wiadomość jest prywatna i widoczna tylko dla określonego użytkownika oraz aplikacji do obsługi czatu. Aby uwzględnić to pole w żądaniu, musisz wywołać interfejs Chat API za pomocą uwierzytelniania aplikacji i pominąć te elementy:

• Przyłącza
• Widżety akcesoriów

Więcej informacji znajdziesz w artykule Wysyłanie wiadomości prywatnej.

DeletionMetadata

Tylko dane wyjściowe. Informacje o usuniętej wiadomości. Wiadomość jest usuwana, gdy ustawiona jest wartość delete_time.

QuotedMessageMetadata

Tylko dane wyjściowe. Informacje o wiadomości, którą użytkownik Google Chat zacytował w pokoju. Użytkownicy Google Chat mogą zacytować wiadomość, aby na nią odpowiedzieć.

AttachedGif

Tylko dane wyjściowe. GIF-y dołączone do wiadomości.

AccessoryWidget

Co najmniej 1 interaktywny widget, który pojawia się u dołu wiadomości. Widżety akcesorium możesz dodawać do wiadomości zawierających tekst, karty lub zarówno tekst, jak i karty. Nieobsługiwane w przypadku wiadomości zawierających dialogi. Szczegółowe informacje znajdziesz w artykule Dodawanie interaktywnych widżetów na dole wiadomości.

Tworzenie wiadomości z widżetami akcesoriów wymaga uwierzytelniania aplikacji.

MessageCreatedEventData

Listę nowych wiadomości.

MessageDeletedEventData

Lista usuniętych wiadomości.

MessageUpdatedEventData

Lista zaktualizowanych wiadomości.

Message

Nowa wiadomość.

Message

Usunięta wiadomość. Wypełnione są tylko pola name, createTime, deleteTime i deletionMetadata.

Message

Zaktualizowana wiadomość.

string

Tylko dane wyjściowe. Nazwa zasobu cytowanej wiadomości.

Format: spaces/{space}/messages/{message}

Timestamp

Tylko dane wyjściowe. Sygnatura czasowa określająca, kiedy cytowana wiadomość została utworzona lub kiedy została ostatnio zaktualizowana.

string

Nazwa zasobu reakcji.

Format: spaces/{space}/messages/{message}/reactions/{reaction}

User

Tylko dane wyjściowe. Użytkownik, który utworzył reakcję.

Emoji

Emotikon użyty w reakcji.

ReactionCreatedEventData

Lista nowych reakcji.

ReactionDeletedEventData

lista usuniętych reakcji;

Reaction

Nowa reakcja.

Reaction

Usunięta reakcja.

string

Identyfikator URI tego linku.

RichLinkType

Typ linku z elementami rozszerzonymi.

DriveLinkData

Dane linku do Dysku.

ChatSpaceLinkData

Dane dotyczące linku do pokoju czatu.

bool

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 zakresu OAuth 2.0 chat.admin.spaces.readonly lub chat.admin.spaces.

Ta metoda obsługuje obecnie tylko dostęp administracyjny, więc w tym polu akceptowana jest tylko wartość true.

int32

Maksymalna liczba miejsc do zwrócenia. Usługa może zwrócić mniej niż ta wartość.

Jeśli nie określono inaczej, zwracanych jest maksymalnie 100 spacji.

Maksymalna wartość to 1000. Jeśli użyjesz wartości większej niż 1000, zostanie ona automatycznie zmieniona na 1000.

string

Token otrzymany z poprzedniego wywołania przestrzeni wyszukiwania. Podaj ten parametr, aby pobrać kolejną stronę.

Podczas podziału na strony wszystkie inne parametry powinny być takie same jak w wywołaniu, które dostarczyło token strony. Przekazywanie innych wartości do innych parametrów może prowadzić do nieoczekiwanych wyników.

string

Wymagane. Zapytanie.

Możesz wyszukiwać przy użyciu tych parametrów:

• create_time
• customer
• display_name
• external_user_allowed
• last_active_time
• space_history_state
• space_type

create_time i last_active_time akceptują sygnaturę czasową w formacie RFC-3339, a obsługiwane operatory porównania to: =, <, >, <= i >=.

Pole customer jest wymagane i służy do wskazywania, od którego klienta mają zostać pobrane pokoje. customers/my_customer to jedyna obsługiwana wartość.

Funkcja display_name akceptuje tylko operator HAS (:). Tekst dopasowywania jest najpierw dzielony na tokeny, a każdy z nich jest dopasowywany do prefiksu niezależnie od wielkości liter. Na przykład reguła Fun Eve pasuje do Fun event lub The evening was fun, ale nie do notFun event ani even.

external_user_allowed może przyjmować wartość true lub false.

space_history_state akceptuje tylko wartości z pola historyState zasobu space.

Wymagane jest pole space_type, a jedyną prawidłową wartością jest SPACE.

W różnych polach obsługiwane są tylko operatory AND. Prawidłowy przykład to space_type = "SPACE" AND display_name:"Hello", a nieprawidłowy space_type = "SPACE" OR display_name:"Hello".

Wśród tego samego pola space_type nie obsługuje operatorów AND ani OR. display_name, „space_history_state” i „external_user_allowed” obsługują tylko operatory OR. last_active_time i create_time obsługują zarówno operatory AND, jak i OR. AND może być używane tylko do reprezentowania przedziału, np. last_active_time < "2022-01-01T00:00:00+00:00" AND last_active_time > "2023-01-01T00:00:00+00:00".

Prawidłowe są te przykładowe zapytania:

customer = "customers/my_customer" AND space_type = "SPACE"

customer = "customers/my_customer" AND space_type = "SPACE" AND
display_name:"Hello World"

customer = "customers/my_customer" AND space_type = "SPACE" AND
(last_active_time < "2020-01-01T00:00:00+00:00" OR last_active_time >
"2022-01-01T00:00:00+00:00")

customer = "customers/my_customer" AND space_type = "SPACE" AND
(display_name:"Hello World" OR display_name:"Fun event") AND
(last_active_time > "2020-01-01T00:00:00+00:00" AND last_active_time <
"2022-01-01T00:00:00+00:00")

customer = "customers/my_customer" AND space_type = "SPACE" AND
(create_time > "2019-01-01T00:00:00+00:00" AND create_time <
"2020-01-01T00:00:00+00:00") AND (external_user_allowed = "true") AND
(space_history_state = "HISTORY_ON" OR space_history_state = "HISTORY_OFF")

string

Opcjonalnie: Sposób porządkowania listy pokoi.

Obsługiwane atrybuty, według których można sortować:

• membership_count.joined_direct_human_user_count – liczba użytkowników, którzy bezpośrednio dołączyli do pokoju.
• last_active_time – oznacza czas, w którym ostatnio dodano kwalifikujący się element do dowolnego tematu w tym pokoju.
• create_time – oznacza czas utworzenia pokoju.

Prawidłowe wartości operacji sortowania:

• ASC w kolejności rosnącej. Wartość domyślna.

• DESC – malejąco.

Obsługiwane składnie:

• membership_count.joined_direct_human_user_count DESC
• membership_count.joined_direct_human_user_count ASC
• last_active_time DESC
• last_active_time ASC
• create_time DESC
• create_time ASC

Space

Strona pokoi, których dotyczy prośba.

string

Token, za pomocą którego można pobrać następną stronę. Jeśli to pole jest puste, nie ma kolejnych stron.

int32

Łączna liczba pokoi pasujących do zapytania na wszystkich stronach. Jeśli wynik obejmuje więcej niż 10 000 pokoi, jest to wartość szacunkowa.

Space

Wymagane. Pole Space.spaceType jest wymagane.

Aby utworzyć pokój, ustaw Space.spaceType na SPACE i Space.displayName. Jeśli podczas konfigurowania pokoju pojawi się komunikat o błędzie ALREADY_EXISTS, spróbuj użyć innego elementu displayName. Istniejący pokój w organizacji Google Workspace może już używać tej wyświetlanej nazwy.

Aby utworzyć czat grupowy, ustaw Space.spaceType na GROUP_CHAT. Nie ustawiaj opcji Space.displayName.

Aby utworzyć rozmowę 1:1 między ludźmi, ustaw Space.spaceType na DIRECT_MESSAGE, a Space.singleUserBotDm na false. Nie ustawiaj wartości Space.displayName ani Space.spaceDetails.

Aby utworzyć rozmowę 1:1 między człowiekiem a aplikacją Google Chat, ustaw Space.spaceType na DIRECT_MESSAGE, a Space.singleUserBotDm na true. Nie ustawiaj wartości Space.displayName ani Space.spaceDetails.

Jeśli pokój DIRECT_MESSAGE już istnieje, zamiast tworzyć nowy pokój, zwracany jest ten pokój.

string

Opcjonalnie: Unikalny identyfikator tego żądania. Zalecamy losowy identyfikator UUID. Jeśli podasz identyfikator istniejącego żądania, zostanie zwrócony pokój utworzony z tym identyfikatorem, zamiast tworzyć nowy pokój. Podanie istniejącego identyfikatora żądania z tej samej aplikacji Google Chat, ale z innym uwierzytelnionym użytkownikiem spowoduje błąd.

Membership

Opcjonalnie: Użytkownicy lub grupy Google Chat, których chcesz zaprosić do pokoju. Pomiń użytkownika dzwoniącego, ponieważ jest on dodawany automatycznie.

Obecnie zestaw pozwala na maksymalnie 20 członków (oprócz dzwoniącego).

W przypadku członkostwa osoby fizycznej pole Membership.member musi zawierać user z wypełnionym name (format: users/{user}), a type musi być ustawiony na User.Type.HUMAN. Podczas konfigurowania pokoju możesz dodawać tylko użytkowników będących ludźmi (dodawanie aplikacji Google Chat jest obsługiwane tylko w przypadku konfigurowania wiadomości bezpośrednich za pomocą aplikacji do połączeń). Możesz też dodać użytkowników, używając adresu e-mail jako aliasu dla {user}. Na przykład user.name może mieć wartość users/example@gmail.com. Aby zaprosić użytkowników Gmaila lub użytkowników z zewnętrznych domen Google Workspace, {user} musi mieć adres e-mail użytkownika.

W przypadku członkostwa w Grupach dyskusyjnych Google pole Membership.group_member musi zawierać group z wypełnionym name (format groups/{group}). Grupy Google możesz dodawać tylko wtedy, gdy ustawisz wartość Space.spaceType na SPACE.

Opcjonalny, gdy wartość Space.spaceType to SPACE.

Wymagany w przypadku ustawienia zasady Space.spaceType na GROUP_CHAT i co najmniej 2 subskrypcji.

Jest on wymagany, jeśli ustawisz wartość Space.spaceType na DIRECT_MESSAGE dla użytkownika będącego osobą fizyczną, a także dokładnie 1 subskrypcję.

Musi być pusty podczas tworzenia rozmowy 1:1 między człowiekiem a aplikacją Google Chat (gdy Space.spaceType to DIRECT_MESSAGE, a Space.singleUserBotDm to true).

int64

Identyfikator wywołanego polecenia po ukośniku.

User

Aplikacja Google Chat, której dotyczy wywołane polecenie.

Type

Typ polecenia po ukośniku.

string

Nazwa wywołanego polecenia po ukośniku.

int64

Identyfikator wywołanego polecenia po ukośniku.

bool

Wskazuje, czy polecenie po ukośniku jest przeznaczone do okna.

string

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.

Type

Tylko dane wyjściowe. Wycofane: użyj w zastępstwie zasady space_type. Typ pokoju.

SpaceType

Typ pokoju. Wymagane podczas tworzenia pokoju lub aktualizowania typu pokoju. Dane wyjściowe tylko do innych zastosowań.

bool

Opcjonalnie: Określa, czy pokój jest czatem między aplikacją Google Chat a jednym człowiekiem.

bool

Tylko dane wyjściowe. Wycofane: użyj w zastępstwie zasady spaceThreadingState. czy wiadomości są w tym pokoju uporządkowane w wątki.

string

Wyświetlana nazwa pokoju. Wymagane podczas tworzenia pokoju z ustawieniem spaceType o wartości SPACE. Jeśli podczas tworzenia pokoju lub aktualizowania pokoju displayName zobaczysz komunikat o błędzie ALREADY_EXISTS, spróbuj użyć innego elementu displayName. Ta wyświetlana nazwa może być już używana w przypadku istniejącego pokoju w organizacji Google Workspace.

W przypadku czatów to pole może być puste.

Może mieć do 128 znaków.

bool

Niezmienna. Określa, czy ten pokój pozwala na dołączenie dowolnego użytkownika Google Chat. Dane wprowadzane podczas tworzenia pokoju w organizacji Google Workspace. Pomiń to pole podczas tworzenia pokoi w tych warunkach:

• Użytkownik uwierzytelniony korzysta z konta klienta (niezarządzanego konta użytkownika). Domyślnie w pokoju utworzonym przez konto dla użytkowników indywidualnych zezwala każdy użytkownik Google Chat.

W przypadku dotychczasowych pokoi to pole zawiera tylko dane wyjściowe.

SpaceThreadingState

Tylko dane wyjściowe. Stan wątku w pokoju czatu.

SpaceDetails

Informacje o pokoju, w tym opis i reguły.

HistoryState

stan historii wiadomości i wątków w tym pokoju;

bool

Opcjonalnie: Określa, czy ten pokój został utworzony w usłudze Import Mode w ramach migracji danych do Google Workspace. Podczas importowania pokoi nie są one widoczne dla użytkowników, dopóki import się nie zakończy.

Utworzenie pokoju w domenie Import Mode wymaga uwierzytelniania użytkownika.

Timestamp

Opcjonalnie: Stała. w przypadku pokoi utworzonych w Google Chat – czas utworzenia pokoju; To pole jest tylko wyjściowe, z wyjątkiem sytuacji, gdy jest używane w pomieszczeniach w trybie importowania.

W przypadku pokoi w trybie importowania ustaw w tym polu historyczną sygnaturę czasową, w której pokój został utworzony w źródle, aby zachować pierwotny czas utworzenia pokoju.

Jest wypełniane w wyniku tylko wtedy, gdy wartość spaceType to GROUP_CHAT lub SPACE.

Timestamp

Tylko dane wyjściowe. Sygnatura czasowa ostatniej wiadomości w pokoju.

bool

Tylko dane wyjściowe. w przypadku pokoi czatu z aplikacją Google Chat – informacja o tym, czy pokój został utworzony przez administratora Google Workspace; Administratorzy mogą zainstalować i skonfigurować czat w aplikacji Google Chat w imieniu użytkowników w swojej organizacji.

Aby instalacja była obsługiwana przez administratora, aplikacja Google Chat musi obsługiwać czat.

MembershipCount

Tylko dane wyjściowe. Liczba osób, które dołączyły do grupy, pogrupowane według typu wspierającego. Wartość wypełniana, gdy space_type ma wartość SPACE, DIRECT_MESSAGE lub GROUP_CHAT.

AccessSettings

Opcjonalnie: Określa ustawienie dostępu pokoju. Wartość jest podawana tylko wtedy, gdy space_type ma wartość SPACE.

string

Tylko dane wyjściowe. Identyfikator URI umożliwiający użytkownikowi dostęp do pokoju.

string

Opcjonalnie: Stała. Identyfikator klienta domeny pokoju. Wymagane tylko podczas tworzenia pokoju z uwierzytelnianiem aplikacji, w którym wartość SpaceType ma wartość SPACE. W przeciwnym razie nie należy jej ustawiać.

W formacie customers/{customer}, gdzie customer to id z [zasobu klienta w Admin SDK](https://developers.google.com/admin-sdk/directory/reference/rest/v1/customers). Aplikacje prywatne mogą też używać aliasu customers/my_customer do tworzenia pokoju w tej samej organizacji Google Workspace co aplikacja.

W przypadku czatów to pole nie jest wypełniane.

PredefinedPermissionSettings

Opcjonalnie: Tylko dane wejściowe. Wstępnie zdefiniowane ustawienia uprawnień pokoju – wprowadzane tylko podczas tworzenia pokoju. Jeśli to pole nie jest skonfigurowane, tworzony jest pokój współpracy. Po utworzeniu pokoju ustawienia zostaną wypełnione w polu PermissionSettings.

PermissionSettings

Opcjonalnie: ustawienia uprawnień pokoju dla istniejących pokoi; Pole do aktualizowania dokładnych ustawień uprawnień dotyczących pokoju. Obecne ustawienia uprawnień są zastępowane. Dane wyjściowe zawierają listę bieżących ustawień uprawnień.

AccessState

Tylko dane wyjściowe. Wskazuje stan dostępu do pokoju.

string

Opcjonalnie: Nazwa zasobu grupy odbiorców, która może wykryć pokój, dołączyć do pokoju i wyświetlić podgląd wiadomości w pokoju. Jeśli nie jest ustawiona, dostęp do pokoju mają tylko użytkownicy lub grupy dyskusyjne Google, które zostały zaproszone indywidualnie lub dodane do pokoju. Więcej informacji znajdziesz w artykule Ustawianie pokoju jako wykrywalnego dla grupy odbiorców.

Format: audiences/{audience}

Aby użyć domyślnej grupy odbiorców w organizacji Google Workspace, ustaw wartość audiences/default.

Czytanie informacji o grupie odbiorców umożliwia:

• Uwierzytelnianie użytkowników

• Uwierzytelnianie aplikacji za zatwierdzeniem przez administratora z zakresem chat.app.spaces w

To pole nie jest wypełniane, gdy używasz zakresu chat.bot z uwierzytelnianiem aplikacji.

Aby ustawić grupę odbiorców, musisz uwierzytelnić użytkownika.

int32

Liczba użytkowników, którzy bezpośrednio dołączyli do pokoju, bez uwzględniania użytkowników, którzy zostali członkami grupy.

int32

Liczba wszystkich grup, które bezpośrednio dołączyły do pokoju.

bool

Określa, czy menedżerowie pokoju mają to uprawnienie.

bool

Określa, czy użytkownicy, którzy nie są menedżerami, mają to uprawnienie.

PermissionSetting

Ustawienie dotyczące zarządzania użytkownikami i grupami w pokoju.

PermissionSetting

Ustawienie do aktualizowania nazwy, awatara, opisu i wytycznych pokoju.

PermissionSetting

Ustawienie do włączania i wyłączania historii pokoju.

PermissionSetting

Ustawienie dotyczące używania polecenia @all w pokoju

PermissionSetting

Ustawienie zarządzania aplikacjami w pokoju.

PermissionSetting

Ustawienie zarządzania webhookami w pokoju.

PermissionSetting

Tylko dane wyjściowe. Ustawienie dotyczące publikowania wiadomości w pokoju.

PermissionSetting

Ustawienie odpowiadania na wiadomości w pokoju.

string

Opcjonalnie: Opis pokoju. Możesz na przykład opisać temat dyskusji, cel lub uczestników pokoju.

Obsługuje do 150 znaków.

string

Opcjonalnie: Zasady, oczekiwania i etykieta

Może mieć do 5000 znaków.

SpaceUpdatedEventData

lista zaktualizowanych pokoi;

string

Nazwa zasobu zdarzenia dla pokoju.

Format: spaces/{space}/spaceEvents/{spaceEvent}

Timestamp

Czas wystąpienia zdarzenia.

string

Typ zdarzenia dotyczącego pokoju. Każdy typ zdarzenia ma wersję zbiorczą, która reprezentuje wiele wystąpień danego typu zdarzenia, które występują w krótkim czasie. W przypadku żądań spaceEvents.list() pomiń w filtrze zapytań typy zdarzeń zbiorczych. Domyślnie serwer zwraca zarówno typ zdarzenia, jak i wersję wsadową.

Obsługiwane typy zdarzeń messages:

• Nowa wiadomość: google.workspace.chat.message.v1.created
• Zaktualizowano wiadomość: google.workspace.chat.message.v1.updated
• Usunięta wiadomość: google.workspace.chat.message.v1.deleted
• Wiele nowych wiadomości: google.workspace.chat.message.v1.batchCreated
• Wiele zaktualizowanych wiadomości: google.workspace.chat.message.v1.batchUpdated
• Wiele usuniętych wiadomości: google.workspace.chat.message.v1.batchDeleted

Obsługiwane typy zdarzeń memberships:

• Nowa subskrypcja: google.workspace.chat.membership.v1.created
• Zaktualizowano subskrypcję google.workspace.chat.membership.v1.updated
• Usunięto subskrypcję: google.workspace.chat.membership.v1.deleted
• Wiele nowych subskrypcji: google.workspace.chat.membership.v1.batchCreated
• Wiele zaktualizowanych subskrypcji: google.workspace.chat.membership.v1.batchUpdated
• Kilka usuniętych subskrypcji: google.workspace.chat.membership.v1.batchDeleted

Obsługiwane typy zdarzeń w przypadku reakcji:

• Nowa reakcja: google.workspace.chat.reaction.v1.created
• Usunięto reakcję: google.workspace.chat.reaction.v1.deleted
• Wiele nowych reakcji: google.workspace.chat.reaction.v1.batchCreated
• Wiele usuniętych reakcji: google.workspace.chat.reaction.v1.batchDeleted

Obsługiwane typy zdarzeń dotyczących pokoju:

• Zaktualizowany pokój: google.workspace.chat.space.v1.updated
• Wiele aktualizacji pokoju: google.workspace.chat.space.v1.batchUpdated

MessageCreatedEventData

ładunek zdarzeń dla nowej wiadomości.

Typ zdarzenia: google.workspace.chat.message.v1.created

MessageUpdatedEventData

Ładunek zdarzenia dla zaktualizowanej wiadomości.

Typ zdarzenia: google.workspace.chat.message.v1.updated

MessageDeletedEventData

Ładunek zdarzenia dotyczący usuniętej wiadomości.

Typ zdarzenia: google.workspace.chat.message.v1.deleted

MessageBatchCreatedEventData

ładunek zdarzeń dla wielu nowych wiadomości.

Typ zdarzenia: google.workspace.chat.message.v1.batchCreated

MessageBatchUpdatedEventData

Ładunek zdarzeń dla wielu zaktualizowanych wiadomości.

Typ zdarzenia: google.workspace.chat.message.v1.batchUpdated

MessageBatchDeletedEventData

Ładunek zdarzeń dla wielu usuniętych wiadomości.

Typ zdarzenia: google.workspace.chat.message.v1.batchDeleted

SpaceUpdatedEventData

Ładunek zdarzenia dotyczącego aktualizacji pokoju.

Typ zdarzenia: google.workspace.chat.space.v1.updated

SpaceBatchUpdatedEventData

Ładunek zdarzenia do wielu aktualizacji pokoju.

Typ zdarzenia: google.workspace.chat.space.v1.batchUpdated

MembershipCreatedEventData

ładunek zdarzeń dla nowego wspierania kanału;

Typ zdarzenia: google.workspace.chat.membership.v1.created

MembershipUpdatedEventData

Ładunek zdarzenia dotyczący zaktualizowanej subskrypcji.

Typ zdarzenia: google.workspace.chat.membership.v1.updated

MembershipDeletedEventData

Ładunek zdarzenia dla usuniętej subskrypcji.

Typ zdarzenia: google.workspace.chat.membership.v1.deleted

MembershipBatchCreatedEventData

Ładunek zdarzeń dla wielu nowych użytkowników.

Typ zdarzenia: google.workspace.chat.membership.v1.batchCreated

MembershipBatchUpdatedEventData

Ładunek zdarzeń dla wielu zaktualizowanych subskrypcji.

Typ zdarzenia: google.workspace.chat.membership.v1.batchUpdated

MembershipBatchDeletedEventData

Ładunek zdarzenia dla wielu usuniętych wspierań.

Typ zdarzenia: google.workspace.chat.membership.v1.batchDeleted

ReactionCreatedEventData

ładunek zdarzeń dla nowej reakcji;

Typ zdarzenia: google.workspace.chat.reaction.v1.created

ReactionDeletedEventData

Ładunek zdarzenia dotyczący usuniętej reakcji.

Typ zdarzenia: google.workspace.chat.reaction.v1.deleted

ReactionBatchCreatedEventData

Ładunek zdarzenia na potrzeby wielu nowych reakcji.

Typ zdarzenia: google.workspace.chat.reaction.v1.batchCreated

ReactionBatchDeletedEventData

Ładunek zdarzenia dla wielu usuniętych reakcji.

Typ zdarzenia: google.workspace.chat.reaction.v1.batchDeleted

string

Nazwa zasobu stanu odczytu pokoju.

Format: users/{user}/spaces/{space}/spaceReadState

Timestamp

Opcjonalnie: Czas zaktualizowania stanu odczytu pokoju przez użytkownika. Zwykle odpowiada to sygnaturze czasowej ostatniej przeczytanej wiadomości lub sygnaturze czasowej określonej przez użytkownika oznaczającej ostatnią przeczytaną wiadomość w pokoju.

Space

Zaktualizowany pokój.

string

Nazwa zasobu wątku.

Przykład: spaces/{space}/threads/{thread}

string

Opcjonalnie: Dane wejściowe do tworzenia lub aktualizowania wątku. W przeciwnym razie tylko dane wyjściowe. Identyfikator wątku. Maksymalna długość tekstu to 4000 znaków.

Jest to unikalny identyfikator aplikacji Google Chat, która go ustawia. Jeśli na przykład wiele aplikacji do czatu utworzy wiadomość przy użyciu tego samego klucza wątku, wiadomości zostaną opublikowane w różnych wątkach. Aby odpowiedzieć w wątku utworzonym przez osobę lub inną aplikację Google Chat, zamiast tego użyj pola wątku name.

string

Nazwa zasobu stanu odczytu wątku.

Format: users/{user}/spaces/{space}/threads/{thread}/threadReadState

Timestamp

Czas zaktualizowania stanu przeczytania wątku przez użytkownika. Zwykle odpowiada to sygnaturze czasowej ostatniej przeczytanej wiadomości w wątku.

Membership

Wymagane. Subskrypcja do zaktualizowania. Zaktualizowane zostaną tylko pola określone przez update_mask.

FieldMask

Wymagane. Ścieżki pól do zaktualizowania. Jeśli jest wiele wartości, rozdziel je przecinkami lub użyj *, aby zaktualizować wszystkie ścieżki pól.

Obecnie obsługiwane ścieżki pól:

• role

bool

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.memberships zakresu OAuth 2.0.

Message

Wymagane. Komunikat z polami został zaktualizowany.

FieldMask

Wymagane. Ścieżki pól do zaktualizowania. Oddziel wartości przecinkami lub użyj *, aby zaktualizować wszystkie ścieżki pól.

Obecnie obsługiwane ścieżki pól:

• text

• attachment

• cards (wymaga uwierzytelniania aplikacji).

• cards_v2 (wymaga uwierzytelniania w aplikacji).

• accessory_widgets (wymaga uwierzytelniania w aplikacji).

bool

Opcjonalnie: Jeśli true i wiadomość nie zostaną znalezione, zostanie utworzona nowa wiadomość, a wartość updateMask zostanie zignorowana. Podany identyfikator wiadomości musi być przypisany przez klienta, w przeciwnym razie żądanie się nie powiedzie.

SpaceReadState

Wymagane. Stan odczytu pokoju i pola do zaktualizowania.

Obsługuje tylko aktualizowanie stanu odczytu użytkownika wywołującego.

Aby odwołać się do użytkownika dzwoniącego, ustaw jedną z tych opcji:

• Alias me. Na przykład: users/me/spaces/{space}/spaceReadState.

• adres e-mail Workspace, Na przykład: users/user@example.com/spaces/{space}/spaceReadState.

• Identyfikator użytkownika. Na przykład: users/123456789/spaces/{space}/spaceReadState.

Format: użytkownicy/{użytkownik}/spaces/{spacja}/spaceReadState

FieldMask

Wymagane. Ścieżki pól do zaktualizowania. Obecnie obsługiwane ścieżki pól:

• last_read_time

Gdy last_read_time przypada przed czasem utworzenia ostatniej wiadomości, pokój będzie wyświetlany w interfejsie jako nieprzeczytany.

Aby oznaczyć pokój jako przeczytany, ustaw last_read_time na dowolną wartość później (większą) niż czas utworzenia ostatniej wiadomości. Wartość last_read_time jest przekształcona tak, aby pasowała do ostatniego czasu utworzenia wiadomości. Pamiętaj, że stan odczytania pokoju wpływa tylko na stan odczytania wiadomości widocznych w rozmowie na najwyższym poziomie pokoju. Odpowiedzi w wątkach nie mają wpływu na tę sygnaturę czasową, a zależą one od stanu przeczytanego wątku.

Space

Wymagane. Pokój z polami do zaktualizowania. Pole Space.name należy wypełnić w formacie spaces/{space}. Zaktualizowane zostaną tylko pola określone przez update_mask.

FieldMask

Wymagane. Zaktualizowane ścieżki pól, jeśli jest ich kilka, rozdziel je przecinkami.

Możesz zaktualizować te pola pokoju:

space_details: aktualizuje opis pokoju. Obsługuje do 150 znaków.

display_name: 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.

space_type: obsługuje tylko zmianę typu pokoju GROUP_CHAT na SPACE. Uwzględnij w masie aktualizacji wartości display_name i space_type oraz sprawdź, czy wybrana przestrzeń ma niepustą wyświetlaną nazwę i typ SPACE. Podczas aktualizowania wyświetlanej nazwy uwzględnienie maski space_type i typu SPACE w określonym obszarze 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. Pole space_type nie jest obsługiwane w przypadku elementu useAdminAccess.

space_history_state: 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ąć w żądaniu wszystkie inne maski pól. Pole space_history_state nie jest obsługiwane w przypadku elementu useAdminAccess.

access_settings.audience: aktualizuje ustawienia 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 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, 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. Funkcja access_settings.audience nie jest obsługiwana w przypadku useAdminAccess.

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

• permission_settings.manageMembersAndGroups
• permission_settings.modifySpaceDetails
• permission_settings.toggleHistory
• permission_settings.useAtMentionAll
• permission_settings.manageApps
• permission_settings.manageWebhooks
• permission_settings.replyMessages

bool

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

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

string

Nazwa zasobu dla: user w Google Chat.

Format: users/{user}. users/app może być używany jako alias użytkownika aplikacji do połączeń bot.

W przypadku usługi human users {user} to ten sam identyfikator użytkownika co:

• id osoby w People API. Na przykład users/123456789 w Chat API reprezentuje tę samą osobę co identyfikator profilu osoby 123456789 w People API.

• id dla użytkownika w interfejsie Admin SDK Directory API.

• Adres e-mail użytkownika może być używany jako alias dla {user} w żądaniach do interfejsu API. Jeśli na przykład identyfikator profilu użytkownika w People API dla user@example.com to 123456789, możesz użyć users/user@example.com jako aliasu do odwołania do users/123456789. Zwrócona zostanie tylko kanoniczna nazwa zasobu (np. users/123456789).

string

Tylko dane wyjściowe. Wyświetlana nazwa użytkownika.

string

Unikalny identyfikator domeny Google Workspace użytkownika.

Type

Typ użytkownika.

bool

Tylko dane wyjściowe. Gdy true, użytkownik jest usuwany lub jego profil nie jest widoczny.

User

Wspominany użytkownik.

Type

Rodzaj wzmianki użytkownika.

Button

Lista przycisków. Przyciski mają też wartość oneof data i należy ustawić tylko jedno z tych pól.

TextParagraph

Wyświetla akapit tekstu w tym widżecie.

Image

wyświetlać obraz w tym widżecie.

KeyValue

Wyświetla w tym widżecie element klucz-wartość.

TextButton

Przycisk z tekstem i działaniem onclick.

ImageButton

Przycisk z obrazem i czynnością onclick

string

Nazwa metody służy do określenia, która część formularza spowodowała jego przesłanie. Te informacje są odczytywane w aplikacji Google Chat w ramach zdarzenia kliknięcia karty. Możesz używać tej samej nazwy metody w przypadku kilku elementów, które wywołują wspólne działanie.

ActionParameter

Lista parametrów działań.

string

Nazwa parametru skryptu działania.

string

Wartość parametru.

string

Adres URL obrazu.

OnClick

Działanie onclick.

double

Współczynnik proporcji tego obrazu (szerokość i wysokość). To pole umożliwia zarezerwowanie odpowiedniej wysokości obrazu podczas oczekiwania na jego wczytanie. Nie ma on na celu zastąpienia wbudowanego współczynnika proporcji obrazu. Jeśli zasada jest nieskonfigurowana, serwer wypełnia ją, pobierając obraz z wyprzedzeniem.

OnClick

Działanie onclick.

string

Nazwa tego image_button, który jest używany w ułatwieniach dostępu. Jeśli nie podasz tej nazwy, zostanie podana wartość domyślna.

Icon

Ikona określona przez enum, która odwołuje się do ikony dostarczonej przez interfejs Chat API.

string

Ikona określona przez adres URL.

string

Tekst etykiety u góry. Sformatowany tekst jest obsługiwany. Więcej informacji o formatowaniu tekstu znajdziesz w artykułach Formatowanie tekstu w aplikacjach Google Chat i Formatowanie tekstu w dodatkach do Google Workspace.

string

Tekst treści. Sformatowany tekst jest obsługiwany i zawsze wymagany. Więcej informacji o formatowaniu tekstu znajdziesz w artykułach Formatowanie tekstu w aplikacjach Google Chat i Formatowanie tekstu w dodatkach do Google Workspace.

bool

Czy treść powinna być wielowierszowa.

string

Tekst dolnej etykiety. Sformatowany tekst jest obsługiwany. Więcej informacji o formatowaniu tekstu znajdziesz w artykułach Formatowanie tekstu w aplikacjach Google Chat i Formatowanie tekstu w dodatkach do Google Workspace.

OnClick

Działanie onclick. Klikalne są tylko górna i dolna etykieta oraz obszar treści.

Icon

Wartość wyliczeniowa, którą zastępuje Chat API odpowiednim obrazem ikony.

string

Ikona określona przez adres URL.

Button

Przycisk, który można kliknąć, aby wywołać działanie.

FormAction

Jeśli jest określone, to działanie onclick powoduje działanie formularza.

OpenLink

To działanie onclick powoduje, jeśli jest określone, działanie otwierania linku.

string

Adres URL do otwarcia.

string

Tekst na przycisku.

OnClick

Działanie onclick przycisku.

string