Viva Engage
Viva Engage to wiodąca sieć społecznościowa dla firm, która może wykonywać pracę inteligentniej i szybciej. Połącz się z aplikacją Viva Engage, aby uzyskać dostęp do konwersacji w sieci przedsiębiorstwa.
Ten łącznik jest dostępny w następujących produktach i regionach:
| Usługa | Class | Regions |
|---|---|---|
| Copilot Studio | Standard | Wszystkie regiony usługi Power Automate z wyjątkiem następujących: - Rząd USA (GCC) - Rząd USA (GCC High) - China Cloud obsługiwane przez firmę 21Vianet - Departament Obrony USA (DoD) |
| Logic Apps | Standard | Wszystkie regiony usługi Logic Apps z wyjątkiem następujących: — Regiony platformy Azure Government — Regiony platformy Azure (Chiny) - Departament Obrony USA (DoD) |
| Power Apps | Standard | Wszystkie regiony usługi Power Apps z wyjątkiem następujących: - Rząd USA (GCC) - Rząd USA (GCC High) - China Cloud obsługiwane przez firmę 21Vianet - Departament Obrony USA (DoD) |
| Power Automate | Standard | Wszystkie regiony usługi Power Automate z wyjątkiem następujących: - Rząd USA (GCC) - Rząd USA (GCC High) - China Cloud obsługiwane przez firmę 21Vianet - Departament Obrony USA (DoD) |
| Kontakt | |
|---|---|
| Name | Microsoft |
| adres URL | https://microsoft.com |
| Metadane łącznika | |
|---|---|
| Publisher | Microsoft |
| Witryna internetowa | https://products.office.com/yammer/yammer-overview |
| Zasady ochrony prywatności | https://privacy.microsoft.com |
| Kategorie | Communication |
Ważne
Uwierzytelnianie OAuth2 dla usługi Yammer (Viva Engage) zostanie wkrótce wycofane.
- Nowe połączenia muszą używać uwierzytelniania entra ID od 1 września.
- Istniejące połączenia OAuth2 będą nadal działać do 15 listopada 2025 r.
Przełącz połączenia z uwierzytelnianiem entra ID przed 15 listopada 2025 r., aby uniknąć zakłóceń.
Znane problemy i ograniczenia
Następujące akcje i wyzwalacze nie gwarantują zwrócenia wszystkich komunikatów z powodu ograniczeń interfejsu API REST Viva Engage:
- Pobieranie wszystkich komunikatów
- Pobieranie komunikatów w grupie
- Pobieranie komunikatów w wątku
- Pobieranie komunikatów z mojego następującego kanału informacyjnego
- W przypadku nowej wiadomości w grupie
- Gdy w moim obserwowanym kanale informacyjnym pojawi się nowa wiadomość
Poniższa akcja może zwrócić maksymalnie 100 grup ze względu na ograniczenia interfejsu API REST Viva Engage:
- Pobieranie grup
Uwaga / Notatka
Interfejs API Viva Engage może ograniczyć liczbę zwracanych komunikatów. Jeśli tak się stanie, aby obejść ten limit, zapoznaj się z artykułem Jak uzyskać wszystkie komunikaty w grupie usługi Yammer przy użyciu usługi Microsoft Flow. Aby uzyskać więcej informacji dotyczących limitów interfejsu API Viva Engage, odwiedź stronę Limity szybkości interfejsu API usługi Yammer.
Ponadto następujące akcje i wyzwalacze mogą nie działać z grupą wszystkich firm z powodu ograniczeń interfejsu API REST Viva Engage:
- Pobieranie komunikatów w grupie
- Pobieranie komunikatów w grupie (wersja 2)
- W przypadku nowej wiadomości w grupie
Funkcja aplikacje innych firm musi być włączona w konfiguracji usługi Yammer. Odpowiedź akcji, taka jak "Odpowiedź nie znajduje się w formacie JSON", zwykle oznacza, że funkcja jest wyłączona.
Poniższe akcje umożliwiają utworzenie wpisu "Anons" z napisem "Tytuł" po ustawieniu odpowiednich parametrów zaawansowanych, jednak ten wpis nie będzie mógł być edytowany w interfejsie użytkownika Viva Engage. Viva Engage zdaje sobie sprawę z tego problemu i rozwiąże ten problem w przyszłej aktualizacji.
- PostMessage
- PostMessageV2
Tworzenie połączenia
Łącznik obsługuje następujące typy uwierzytelniania:
| Zaloguj się przy użyciu identyfikatora Entra firmy Microsoft | Zaloguj się przy użyciu identyfikatora Entra firmy Microsoft | Wszystkie regiony | Nie można udostępniać |
| Domyślne [PRZESTARZAŁE] | Ta opcja dotyczy tylko starszych połączeń bez jawnego typu uwierzytelniania i jest dostępna tylko w celu zapewnienia zgodności z poprzednimi wersjami. | Wszystkie regiony | Nie można udostępniać |
Zaloguj się przy użyciu identyfikatora Entra firmy Microsoft
Identyfikator uwierzytelniania: entraIDUserLogin
Dotyczy: wszystkie regiony
Zaloguj się przy użyciu identyfikatora Entra firmy Microsoft
Nie jest to możliwe do udostępnienia połączenie. Jeśli aplikacja power zostanie udostępniona innemu użytkownikowi, zostanie wyświetlony monit o jawne utworzenie nowego połączenia.
Domyślne [PRZESTARZAŁE]
Dotyczy: wszystkie regiony
Ta opcja dotyczy tylko starszych połączeń bez jawnego typu uwierzytelniania i jest dostępna tylko w celu zapewnienia zgodności z poprzednimi wersjami.
Nie jest to możliwe do udostępnienia połączenie. Jeśli aplikacja power zostanie udostępniona innemu użytkownikowi, zostanie wyświetlony monit o jawne utworzenie nowego połączenia.
Limity ograniczania
| Nazwa | Wywołania | Okres odnowienia |
|---|---|---|
| Wywołania interfejsu API na połączenie | 100 | 60 sekund |
| Częstotliwość sond wyzwalacza | 1 | 15 sekund |
Akcje
| Lubię wiadomość |
Ta operacja jest używana do polubinia określonego komunikatu. |
| Opublikuj wiadomość (wersja 2) |
Ta operacja służy do publikowania komunikatu w grupie lub wszystkich kanałach informacyjnych firmy. Jeśli zostanie podany identyfikator grupy, wiadomość zostanie wysłana do określonej grupy, w przeciwnym razie zostanie opublikowana w obszarze Wszystkie kanał informacyjny firmy. |
| Opublikuj wiadomość [PRZESTARZAŁE] |
Ta operacja służy do publikowania komunikatu w grupie lub wszystkich kanałach informacyjnych firmy. Jeśli zostanie podany identyfikator grupy, wiadomość zostanie wysłana do określonej grupy, w przeciwnym razie zostanie opublikowana w obszarze Wszystkie kanał informacyjny firmy. |
| Pobieranie grup |
Pobiera wszystkie grupy. Jeśli kopalnia = 1, pobierz tylko grupy, do których należy użytkownik |
| Pobieranie komunikatów w grupie (V2) [PRZESTARZAŁE] |
Ta akcja została przestarzała. Zamiast tego użyj polecenia Pobierz komunikaty w grupie (V3).
|
| Pobieranie komunikatów w grupie (wersja 3) |
Ta operacja zwraca komunikaty opublikowane w grupie. |
| Pobieranie komunikatów w grupie [PRZESTARZAŁE] |
Ta akcja została przestarzała. Zamiast tego użyj polecenia Pobierz komunikaty w grupie (V3).
|
| Pobieranie komunikatów w wątku (wersja 2) [PRZESTARZAŁE] |
Ta akcja została przestarzała. Zamiast tego użyj polecenia Pobierz komunikaty w wątku (V3).
|
| Pobieranie komunikatów w wątku (wersja 3) |
Ta operacja zwraca komunikaty opublikowane w wątku. |
| Pobieranie komunikatów w wątku [PRZESTARZAŁE] |
Ta akcja została przestarzała. Zamiast tego użyj polecenia Pobierz komunikaty w wątku (V3).
|
| Pobieranie komunikatów z mojego następującego kanału informacyjnego (wersja 3) |
Ta operacja zwraca komunikaty z następującego kanału informacyjnego, który jest konwersacjami obejmującymi osoby, grupy i tematy, które obserwuje użytkownik. |
| Pobieranie sieci |
Pobiera wszystkie sieci, do których należy użytkownik. |
| Pobieranie szczegółów użytkownika |
Ta operacja zwraca szczegóły profilu użytkownika. |
| Pobieranie wszystkich komunikatów (wersja 2) [PRZESTARZAŁE] |
Ta akcja została przestarzała. Zamiast tego użyj polecenia Pobierz wszystkie komunikaty (V3).
|
| Pobieranie wszystkich komunikatów (wersja 3) |
Ta operacja zwraca wszystkie publiczne komunikaty w sieci Viva Engage zalogowanego użytkownika. Odpowiada konwersacjom "Wszystkie" w interfejsie internetowym Viva Engage. |
| Pobieranie wszystkich komunikatów [PRZESTARZAŁE] |
Ta akcja została przestarzała. Zamiast tego użyj polecenia Pobierz wszystkie komunikaty (V3).
|
| Pobierz komunikaty z mojego następującego kanału informacyjnego (V2) [PRZESTARZAŁE] |
Ta akcja została przestarzała. Zamiast tego użyj opcji Pobierz komunikaty z mojego następującego kanału informacyjnego (V3).
|
| Pobierz komunikaty z mojego następującego kanału informacyjnego [PRZESTARZAŁE] |
Ta akcja została przestarzała. Zamiast tego użyj opcji Pobierz komunikaty z mojego następującego kanału informacyjnego (V3).
|
Lubię wiadomość
Ta operacja jest używana do polubinia określonego komunikatu.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator komunikatu
|
message_id | True | string |
Unikatowy identyfikator wiadomości. |
Opublikuj wiadomość (wersja 2)
Ta operacja służy do publikowania komunikatu w grupie lub wszystkich kanałach informacyjnych firmy. Jeśli zostanie podany identyfikator grupy, wiadomość zostanie wysłana do określonej grupy, w przeciwnym razie zostanie opublikowana w obszarze Wszystkie kanał informacyjny firmy.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator sieci
|
network_id | string |
Unikatowy identyfikator sieci. |
|
|
Identyfikator grupy
|
group_id | True | integer |
Grupa publikując komunikat na adres (0 = Wszystkie firmy/sieć). |
|
Tekst wiadomości
|
body | True | string |
Wiadomość do opublikowania w sieci. |
|
Odpowiedź na identyfikator
|
replied_to_id | integer |
Identyfikator wiadomości, na który odpowiada ta wiadomość. |
|
|
Identyfikator bezpośredni do
|
direct_to_id | integer |
W przypadku ustawienia wiadomość prywatna zostanie wysłana bezpośrednio do użytkownika ze wskazanym identyfikatorem. |
|
|
Nadawać
|
broadcast | boolean |
Opublikuj wiadomość jako ogłoszenie dla wszystkich użytkowników w grupie. |
|
|
Title
|
title | string |
Tytuł wiadomości do opublikowania. |
Zwraca
Lista jednego lub wielu komunikatów.
- Lista wiadomości
- MessageListV2
Opublikuj wiadomość [PRZESTARZAŁE]
Ta operacja służy do publikowania komunikatu w grupie lub wszystkich kanałach informacyjnych firmy. Jeśli zostanie podany identyfikator grupy, wiadomość zostanie wysłana do określonej grupy, w przeciwnym razie zostanie opublikowana w obszarze Wszystkie kanał informacyjny firmy.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator sieci
|
network_id | string |
Unikatowy identyfikator sieci. |
|
|
Identyfikator grupy
|
group_id | True | integer |
Grupa publikując komunikat na adres (0 = Wszystkie firmy/sieć). |
|
Tekst wiadomości
|
body | True | string |
Wiadomość do opublikowania w sieci. |
|
Odpowiedź na identyfikator
|
replied_to_id | integer |
Identyfikator wiadomości, na który odpowiada ta wiadomość. |
|
|
Identyfikator bezpośredni do
|
direct_to_id | integer |
W przypadku ustawienia wiadomość prywatna zostanie wysłana bezpośrednio do użytkownika ze wskazanym identyfikatorem. |
|
|
Nadawać
|
broadcast | boolean |
Opublikuj wiadomość jako ogłoszenie dla wszystkich użytkowników w grupie. |
|
|
Title
|
title | string |
Tytuł wiadomości do opublikowania. |
|
|
Temat 1
|
topic1 | string |
Temat do zastosowania do wiadomości. |
|
|
Temat 2
|
topic2 | string |
Temat do zastosowania do wiadomości |
|
|
Temat 3
|
topic3 | string |
Temat do zastosowania do wiadomości. |
|
|
Temat 4
|
topic4 | string |
Temat do zastosowania do wiadomości |
|
|
Temat 5
|
topic5 | string |
Temat do zastosowania do wiadomości. |
|
|
Temat 6
|
topic6 | string |
Temat do zastosowania do wiadomości. |
|
|
Temat 7
|
topic7 | string |
Temat do zastosowania do wiadomości |
|
|
Temat 8
|
topic8 | string |
Temat do zastosowania do wiadomości. |
|
|
Temat 9
|
topic9 | string |
Temat do zastosowania do wiadomości. |
|
|
Temat 10
|
topic10 | string |
Temat do zastosowania do wiadomości. |
|
|
Temat 11
|
topic11 | string |
Temat do zastosowania do wiadomości. |
|
|
Temat 12
|
topic12 | string |
Temat do zastosowania do wiadomości. |
|
|
Temat 13
|
topic13 | string |
Temat do zastosowania do wiadomości. |
|
|
Temat 14
|
topic14 | string |
Temat do zastosowania do wiadomości. |
|
|
Temat 15
|
topic15 | string |
Temat do zastosowania do wiadomości. |
|
|
Temat 16
|
topic16 | string |
Temat do zastosowania do wiadomości. |
|
|
Temat 17
|
topic17 | string |
Temat do zastosowania do wiadomości. |
|
|
Temat 18
|
topic18 | string |
Temat do zastosowania do wiadomości. |
|
|
Temat 19
|
topic19 | string |
Temat do zastosowania do wiadomości. |
|
|
Temat 20
|
topic20 | string |
Temat do zastosowania do wiadomości. |
Zwraca
Lista jednego lub wielu komunikatów.
- Lista wiadomości
- MessageList
Pobieranie grup
Pobiera wszystkie grupy. Jeśli kopalnia = 1, pobierz tylko grupy, do których należy użytkownik
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator sieci
|
network_id | string |
Identyfikator sieci |
|
|
kopalnia
|
mine | integer |
Służy do pobierania grup, które użytkownik jest częścią |
|
|
Pokaż całą grupę firmową
|
showAllCompanyGroup | integer |
Służy do wyświetlania wszystkich grup firmowych |
Zwraca
- response
- array of YammmerEntity
Pobieranie komunikatów w grupie (V2) [PRZESTARZAŁE]
Ta akcja została przestarzała. Zamiast tego użyj polecenia Pobierz komunikaty w grupie (V3).
Ta operacja zwraca komunikaty opublikowane w grupie.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator sieci
|
network_id | string |
Unikatowy identyfikator sieci. |
|
|
Identyfikator grupy
|
group_id | True | integer |
Unikatowy identyfikator grupy. |
|
Starsze niż
|
older_than | integer |
Zwraca komunikaty starsze niż identyfikator komunikatu określony jako ciąg liczbowy. Jest to przydatne w przypadku stronicowania komunikatów. Jeśli na przykład wyświetlasz obecnie 20 komunikatów, a najstarszy numer to 2912, możesz dołączyć ciąg "?older_than=2912" do żądania pobrania 20 komunikatów przed wyświetlanymi komunikatami. |
|
|
Nowsze niż
|
newer_than | integer |
Zwraca komunikaty nowsze niż identyfikator komunikatu określony jako ciąg liczbowy. Powinno to być używane podczas sondowania nowych komunikatów. Jeśli patrzysz na komunikaty, a ostatni zwrócony komunikat to 3516, możesz wysłać żądanie z parametrem "?newer_than=3516", aby upewnić się, że nie otrzymasz zduplikowanych kopii komunikatów już na stronie. |
|
|
Typ wątku komunikatów
|
threaded | string |
Threaded=true zwróci tylko początek wątku (pierwszy komunikat) dla każdego wątku. Ten parametr jest przeznaczony dla aplikacji, które muszą wyświetlać zwinięte wątki komunikatów. threaded=extended zwróci komunikaty początkowe wątku i dwa najnowsze komunikaty uporządkowane według działania, ponieważ są one wyświetlane w widoku domyślnym w interfejsie internetowym Viva Engage. |
|
|
Ograniczenie
|
limit | integer |
Zwraca tylko określoną liczbę komunikatów. |
Zwraca
Lista jednego lub wielu komunikatów.
- Lista wiadomości
- PageableMessageList
Pobieranie komunikatów w grupie (wersja 3)
Ta operacja zwraca komunikaty opublikowane w grupie.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator sieci
|
network_id | string |
Unikatowy identyfikator sieci. |
|
|
Identyfikator grupy
|
group_id | True | integer |
Unikatowy identyfikator grupy. |
|
Starsze niż
|
older_than | integer |
Zwraca komunikaty w wątkach, w których ostatni komunikat wątku jest starszy niż określony identyfikator komunikatu. Każdy wątek z najnowszym identyfikatorem komunikatu, który jest nowszy lub równy określonemu identyfikatorowi, nie będzie miał żadnych komunikatów zwracanych przez to zapytanie. |
|
|
Nowsze niż
|
newer_than | integer |
Zwraca komunikaty w wątkach, w których ostatni komunikat wątku jest nowszy niż określony identyfikator komunikatu. Każdy wątek z najnowszym identyfikatorem komunikatu, który jest starszy lub równy określonemu identyfikatorowi, nie będzie miał żadnych komunikatów zwracanych przez to zapytanie. |
|
|
Typ wątku komunikatów
|
threaded | string |
Threaded=true zwróci tylko początek wątku (pierwszy komunikat) dla każdego wątku. Ten parametr jest przeznaczony dla aplikacji, które muszą wyświetlać zwinięte wątki komunikatów. threaded=extended zwróci komunikaty początkowe wątku i dwa najnowsze komunikaty uporządkowane według działania, ponieważ są one wyświetlane w widoku domyślnym w interfejsie internetowym Viva Engage. |
|
|
Ograniczenie
|
limit | integer |
Zwraca tylko określoną liczbę komunikatów. |
Zwraca
Lista jednego lub wielu komunikatów.
- Lista wiadomości
- PageableMessageListV2
Pobieranie komunikatów w grupie [PRZESTARZAŁE]
Ta akcja została przestarzała. Zamiast tego użyj polecenia Pobierz komunikaty w grupie (V3).
Ta operacja zwraca komunikaty opublikowane w grupie.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator sieci
|
network_id | string |
Unikatowy identyfikator sieci. |
|
|
Identyfikator grupy
|
group_id | True | integer |
Unikatowy identyfikator grupy. |
|
Starsze niż
|
older_than | integer |
Zwraca komunikaty starsze niż identyfikator komunikatu określony jako ciąg liczbowy. Jest to przydatne w przypadku stronicowania komunikatów. Jeśli na przykład wyświetlasz obecnie 20 komunikatów, a najstarszy numer to 2912, możesz dołączyć ciąg "?older_than=2912" do żądania pobrania 20 komunikatów przed wyświetlanymi komunikatami. |
|
|
Nowsze niż
|
newer_than | integer |
Zwraca komunikaty nowsze niż identyfikator komunikatu określony jako ciąg liczbowy. Powinno to być używane podczas sondowania nowych komunikatów. Jeśli patrzysz na komunikaty, a ostatni zwrócony komunikat to 3516, możesz wysłać żądanie z parametrem "?newer_than=3516", aby upewnić się, że nie otrzymasz zduplikowanych kopii komunikatów już na stronie. |
|
|
Ograniczenie
|
limit | integer |
Zwraca tylko określoną liczbę komunikatów. |
|
|
Strona
|
page | integer |
Pobierz określoną stronę. Jeśli zwrócone dane są większe niż limit, możesz użyć tego pola, aby uzyskać dostęp do kolejnych stron |
Zwraca
Lista jednego lub wielu komunikatów.
- Lista wiadomości
- MessageList
Pobieranie komunikatów w wątku (wersja 2) [PRZESTARZAŁE]
Ta akcja została przestarzała. Zamiast tego użyj polecenia Pobierz komunikaty w wątku (V3).
Ta operacja zwraca komunikaty opublikowane w wątku.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator wątku
|
thread_id | True | integer |
Unikatowy identyfikator wątku. |
Zwraca
Lista jednego lub wielu komunikatów.
- Lista wiadomości
- PageableMessageList
Pobieranie komunikatów w wątku (wersja 3)
Ta operacja zwraca komunikaty opublikowane w wątku.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator wątku
|
thread_id | True | integer |
Unikatowy identyfikator wątku. |
Zwraca
Lista jednego lub wielu komunikatów.
- Lista wiadomości
- PageableMessageListV2
Pobieranie komunikatów w wątku [PRZESTARZAŁE]
Ta akcja została przestarzała. Zamiast tego użyj polecenia Pobierz komunikaty w wątku (V3).
Ta operacja zwraca komunikaty opublikowane w wątku.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator wątku
|
thread_id | True | integer |
Unikatowy identyfikator wątku. |
Zwraca
Lista jednego lub wielu komunikatów.
- Lista wiadomości
- MessageList
Pobieranie komunikatów z mojego następującego kanału informacyjnego (wersja 3)
Ta operacja zwraca komunikaty z następującego kanału informacyjnego, który jest konwersacjami obejmującymi osoby, grupy i tematy, które obserwuje użytkownik.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator sieci
|
network_id | string |
Unikatowy identyfikator sieci. |
|
|
Starsze niż
|
older_than | integer |
Zwraca komunikaty starsze niż identyfikator komunikatu określony jako ciąg liczbowy. Jest to przydatne w przypadku stronicowania komunikatów. Jeśli na przykład wyświetlasz obecnie 20 komunikatów, a najstarszy numer to 2912, możesz dołączyć ciąg "?older_than=2912" do żądania pobrania 20 komunikatów przed wyświetlanymi komunikatami. |
|
|
Nowsze niż
|
newer_than | integer |
Zwraca komunikaty nowsze niż identyfikator komunikatu określony jako ciąg liczbowy. Powinno to być używane podczas sondowania nowych komunikatów. Jeśli patrzysz na komunikaty, a ostatni zwrócony komunikat to 3516, możesz wysłać żądanie z parametrem "?newer_than=3516", aby upewnić się, że nie otrzymasz zduplikowanych kopii komunikatów już na stronie. |
|
|
Typ wątku komunikatów
|
threaded | string |
Threaded=true zwróci tylko początek wątku (pierwszy komunikat) dla każdego wątku. Ten parametr jest przeznaczony dla aplikacji, które muszą wyświetlać zwinięte wątki komunikatów. threaded=extended zwróci komunikaty początkowe wątku i dwa najnowsze komunikaty uporządkowane według działania, ponieważ są one wyświetlane w widoku domyślnym w interfejsie internetowym Viva Engage. |
|
|
Ograniczenie
|
limit | integer |
Zwraca tylko określoną liczbę komunikatów. |
Zwraca
Lista jednego lub wielu komunikatów.
- Lista wiadomości
- PageableMessageListV2
Pobieranie sieci
Pobieranie szczegółów użytkownika
Ta operacja zwraca szczegóły profilu użytkownika.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator użytkownika
|
user_id | True | integer |
Unikatowy identyfikator użytkownika. |
Zwraca
Właściwości użytkownika Viva Engage.
- User
- User
Pobieranie wszystkich komunikatów (wersja 2) [PRZESTARZAŁE]
Ta akcja została przestarzała. Zamiast tego użyj polecenia Pobierz wszystkie komunikaty (V3).
Ta operacja zwraca wszystkie publiczne komunikaty w sieci Viva Engage zalogowanego użytkownika. Odpowiada konwersacjom "Wszystkie" w interfejsie internetowym Viva Engage.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Unikatowy identyfikator sieci
|
network_id | string |
Identyfikator sieci |
|
|
Starsze niż
|
older_than | integer |
Zwraca komunikaty starsze niż identyfikator komunikatu określony jako ciąg liczbowy. Jest to przydatne w przypadku stronicowania komunikatów. Jeśli na przykład wyświetlasz obecnie 20 komunikatów, a najstarszy numer to 2912, możesz dołączyć ciąg "?older_than=2912" do żądania pobrania 20 komunikatów przed wyświetlanymi komunikatami. |
|
|
Nowsze niż
|
newer_than | integer |
Zwraca komunikaty nowsze niż identyfikator komunikatu określony jako ciąg liczbowy. Powinno to być używane podczas sondowania nowych komunikatów. Jeśli patrzysz na komunikaty, a ostatni zwrócony komunikat to 3516, możesz wysłać żądanie z parametrem "?newer_than=3516", aby upewnić się, że nie otrzymasz zduplikowanych kopii komunikatów już na stronie. |
|
|
Typ wątku komunikatów
|
threaded | string |
Threaded=true zwróci tylko początek wątku (pierwszy komunikat) dla każdego wątku. Ten parametr jest przeznaczony dla aplikacji, które muszą wyświetlać zwinięte wątki komunikatów. threaded=extended zwróci komunikaty początkowe wątku i dwa najnowsze komunikaty uporządkowane według działania, ponieważ są one wyświetlane w widoku domyślnym w interfejsie internetowym Viva Engage. |
|
|
Ograniczenie
|
limit | integer |
Zwraca tylko określoną liczbę komunikatów. |
Zwraca
Lista jednego lub wielu komunikatów.
- Lista wiadomości
- PageableMessageList
Pobieranie wszystkich komunikatów (wersja 3)
Ta operacja zwraca wszystkie publiczne komunikaty w sieci Viva Engage zalogowanego użytkownika. Odpowiada konwersacjom "Wszystkie" w interfejsie internetowym Viva Engage.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Unikatowy identyfikator sieci
|
network_id | string |
Identyfikator sieci |
|
|
Starsze niż
|
older_than | integer |
Zwraca komunikaty starsze niż identyfikator komunikatu określony jako ciąg liczbowy. Jest to przydatne w przypadku stronicowania komunikatów. Jeśli na przykład wyświetlasz obecnie 20 komunikatów, a najstarszy numer to 2912, możesz dołączyć ciąg "?older_than=2912" do żądania pobrania 20 komunikatów przed wyświetlanymi komunikatami. |
|
|
Nowsze niż
|
newer_than | integer |
Zwraca komunikaty nowsze niż identyfikator komunikatu określony jako ciąg liczbowy. Powinno to być używane podczas sondowania nowych komunikatów. Jeśli patrzysz na komunikaty, a ostatni zwrócony komunikat to 3516, możesz wysłać żądanie z parametrem "?newer_than=3516", aby upewnić się, że nie otrzymasz zduplikowanych kopii komunikatów już na stronie. |
|
|
Typ wątku komunikatów
|
threaded | string |
Threaded=true zwróci tylko początek wątku (pierwszy komunikat) dla każdego wątku. Ten parametr jest przeznaczony dla aplikacji, które muszą wyświetlać zwinięte wątki komunikatów. threaded=extended zwróci komunikaty początkowe wątku i dwa najnowsze komunikaty uporządkowane według działania, ponieważ są one wyświetlane w widoku domyślnym w interfejsie internetowym Viva Engage. |
|
|
Ograniczenie
|
limit | integer |
Zwraca tylko określoną liczbę komunikatów. |
Zwraca
Lista jednego lub wielu komunikatów.
- Lista wiadomości
- PageableMessageListV2
Pobieranie wszystkich komunikatów [PRZESTARZAŁE]
Ta akcja została przestarzała. Zamiast tego użyj polecenia Pobierz wszystkie komunikaty (V3).
Ta operacja zwraca wszystkie publiczne komunikaty w sieci Viva Engage zalogowanego użytkownika. Odpowiada konwersacjom "Wszystkie" w interfejsie internetowym usługi Yammer.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Unikatowy identyfikator sieci
|
network_id | string |
Identyfikator sieci |
|
|
Starsze niż
|
older_than | integer |
Zwraca komunikaty starsze niż identyfikator komunikatu określony jako ciąg liczbowy. Jest to przydatne w przypadku stronicowania komunikatów. Jeśli na przykład wyświetlasz obecnie 20 komunikatów, a najstarszy numer to 2912, możesz dołączyć ciąg "?older_than=2912" do żądania pobrania 20 komunikatów przed wyświetlanymi komunikatami. |
|
|
Nowsze niż
|
newer_than | integer |
Zwraca komunikaty nowsze niż identyfikator komunikatu określony jako ciąg liczbowy. Powinno to być używane podczas sondowania nowych komunikatów. Jeśli patrzysz na komunikaty, a ostatni zwrócony komunikat to 3516, możesz wysłać żądanie z parametrem "?newer_than=3516", aby upewnić się, że nie otrzymasz zduplikowanych kopii komunikatów już na stronie. |
|
|
Ograniczenie
|
limit | integer |
Zwraca tylko określoną liczbę komunikatów. |
|
|
Strona
|
page | integer |
Pobierz określoną stronę. Jeśli zwrócone dane są większe niż limit, możesz użyć tego pola, aby uzyskać dostęp do kolejnych stron |
Zwraca
Lista jednego lub wielu komunikatów.
- Lista wiadomości
- MessageList
Pobierz komunikaty z mojego następującego kanału informacyjnego (V2) [PRZESTARZAŁE]
Ta akcja została przestarzała. Zamiast tego użyj opcji Pobierz komunikaty z mojego następującego kanału informacyjnego (V3).
Ta operacja zwraca komunikaty z następującego kanału informacyjnego, który jest konwersacjami obejmującymi osoby, grupy i tematy, które obserwuje użytkownik.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator sieci
|
network_id | string |
Unikatowy identyfikator sieci. |
|
|
Starsze niż
|
older_than | integer |
Zwraca komunikaty starsze niż identyfikator komunikatu określony jako ciąg liczbowy. Jest to przydatne w przypadku stronicowania komunikatów. Jeśli na przykład wyświetlasz obecnie 20 komunikatów, a najstarszy numer to 2912, możesz dołączyć ciąg "?older_than=2912" do żądania pobrania 20 komunikatów przed wyświetlanymi komunikatami. |
|
|
Nowsze niż
|
newer_than | integer |
Zwraca komunikaty nowsze niż identyfikator komunikatu określony jako ciąg liczbowy. Powinno to być używane podczas sondowania nowych komunikatów. Jeśli patrzysz na komunikaty, a ostatni zwrócony komunikat to 3516, możesz wysłać żądanie z parametrem "?newer_than=3516", aby upewnić się, że nie otrzymasz zduplikowanych kopii komunikatów już na stronie. |
|
|
Typ wątku komunikatów
|
threaded | string |
Threaded=true zwróci tylko początek wątku (pierwszy komunikat) dla każdego wątku. Ten parametr jest przeznaczony dla aplikacji, które muszą wyświetlać zwinięte wątki komunikatów. threaded=extended zwróci komunikaty początkowe wątku i dwa najnowsze komunikaty uporządkowane według działania, ponieważ są one wyświetlane w widoku domyślnym w interfejsie internetowym Viva Engage. |
|
|
Ograniczenie
|
limit | integer |
Zwraca tylko określoną liczbę komunikatów. |
Zwraca
Lista jednego lub wielu komunikatów.
- Lista wiadomości
- PageableMessageList
Pobierz komunikaty z mojego następującego kanału informacyjnego [PRZESTARZAŁE]
Ta akcja została przestarzała. Zamiast tego użyj opcji Pobierz komunikaty z mojego następującego kanału informacyjnego (V3).
Ta operacja zwraca komunikaty z następującego kanału informacyjnego, który jest konwersacjami obejmującymi osoby, grupy i tematy, które obserwuje użytkownik.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator sieci
|
network_id | string |
Unikatowy identyfikator sieci. |
|
|
Starsze niż
|
older_than | integer |
Zwraca komunikaty starsze niż identyfikator komunikatu określony jako ciąg liczbowy. Jest to przydatne w przypadku stronicowania komunikatów. Jeśli na przykład wyświetlasz obecnie 20 komunikatów, a najstarszy numer to 2912, możesz dołączyć ciąg "?older_than=2912" do żądania pobrania 20 komunikatów przed wyświetlanymi komunikatami. |
|
|
Nowsze niż
|
newer_than | integer |
Zwraca komunikaty nowsze niż identyfikator komunikatu określony jako ciąg liczbowy. Powinno to być używane podczas sondowania nowych komunikatów. Jeśli patrzysz na komunikaty, a ostatni zwrócony komunikat to 3516, możesz wysłać żądanie z parametrem "?newer_than=3516", aby upewnić się, że nie otrzymasz zduplikowanych kopii komunikatów już na stronie. |
|
|
Ograniczenie
|
limit | integer |
Zwraca tylko określoną liczbę komunikatów. |
|
|
Strona
|
page | integer |
Pobierz określoną stronę. Jeśli zwrócone dane są większe niż limit, możesz użyć tego pola, aby uzyskać dostęp do kolejnych stron |
Zwraca
Lista jednego lub wielu komunikatów.
- Lista wiadomości
- MessageList
Wyzwalaczy
| Gdy w moim obserwowanym kanale informacyjnym (wersja 2) jest dostępna nowa wiadomość |
Ta operacja jest wyzwalana, gdy w sieci pojawi się nowy komunikat. |
| Gdy w moim obserwowanym kanale informacyjnym jest wyświetlany nowy komunikat [PRZESTARZAŁE] |
Ta akcja została przestarzała. Użyj opcji Jeśli w moim obserwowanym kanale informacyjnym (wersja 2) znajduje się nowy komunikat .
|
| W przypadku nowego komunikatu w grupie (wersja 2) |
Ta operacja jest wyzwalana po opublikowaniu nowego komunikatu w grupie. |
| W przypadku nowego komunikatu w grupie [PRZESTARZAŁE] |
Ta akcja została przestarzała. Zamiast tego użyj polecenia Jeśli w grupie (wersja 2) znajduje się nowy komunikat .
|
Gdy w moim obserwowanym kanale informacyjnym (wersja 2) jest dostępna nowa wiadomość
Ta operacja jest wyzwalana, gdy w sieci pojawi się nowy komunikat.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator sieci
|
network_id | string |
Wybierz sieć. |
Zwraca
Lista jednego lub wielu komunikatów.
- Lista wiadomości
- MessageListV2
Gdy w moim obserwowanym kanale informacyjnym jest wyświetlany nowy komunikat [PRZESTARZAŁE]
Ta akcja została przestarzała. Użyj opcji Jeśli w moim obserwowanym kanale informacyjnym (wersja 2) znajduje się nowy komunikat .
Ta operacja jest wyzwalana, gdy w sieci pojawi się nowy komunikat.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator sieci
|
network_id | string |
Wybierz sieć. |
Zwraca
Lista jednego lub wielu komunikatów.
- Lista wiadomości
- MessageList
W przypadku nowego komunikatu w grupie (wersja 2)
Ta operacja jest wyzwalana po opublikowaniu nowego komunikatu w grupie.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator sieci
|
network_id | string |
Unikatowy identyfer sieci. |
|
|
Identyfikator grupy
|
group_id | True | integer |
Unikatowy identyfikator grupy. |
Zwraca
Lista jednego lub wielu komunikatów.
- Lista wiadomości
- MessageListV2
W przypadku nowego komunikatu w grupie [PRZESTARZAŁE]
Ta akcja została przestarzała. Zamiast tego użyj polecenia Jeśli w grupie (wersja 2) znajduje się nowy komunikat .
Ta operacja jest wyzwalana po opublikowaniu nowego komunikatu w grupie.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator sieci
|
network_id | string |
Unikatowy identyfer sieci. |
|
|
Identyfikator grupy
|
group_id | True | integer |
Unikatowy identyfikator grupy. |
Zwraca
Lista jednego lub wielu komunikatów.
- Lista wiadomości
- MessageList
Definicje
User
Właściwości użytkownika Viva Engage.
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Nazwa użytkownika
|
name | string |
Nazwa użytkownika. |
|
Stanowisko
|
job_title | string |
Stanowisko użytkownika. |
|
Lokalizacja
|
location | string |
Lokalizacja użytkownika. |
|
Imię i nazwisko
|
full_name | string |
Pełna nazwa użytkownika. |
|
Imię
|
first_name | string |
Imię użytkownika. |
|
Nazwisko
|
last_name | string |
Nazwisko użytkownika. |
|
Adres URL profilu
|
web_url | string |
Adres URL profilu użytkownika. |
|
Email
|
string |
Adres e-mail użytkownika. |
|
|
Data urodzenia
|
birth_date | string |
Data urodzenia użytkownika. |
|
Adres URL zdjęcia
|
mugshot_url | string |
Adres URL zdjęcia użytkownika. |
Message
Właściwości pojedynczej wiadomości Viva Engage.
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
identyfikator
|
id | integer |
Identyfikator skojarzony z wpisem. |
|
Tekst
|
content_excerpt | string |
Zawartość tekstowa wpisu. |
|
Nadawca
|
sender_id | integer |
Unikatowy identyfikator użytkownika, który opublikował wiadomość. |
|
Odpowiedź na
|
replied_to_id | integer |
Identyfikator wiadomości, do której ta wiadomość jest odpowiedzią. |
|
Utworzono pod adresem
|
created_at | string |
Godzina utworzenia wiadomości. |
|
Sieć
|
network_id | integer |
Identyfikator komunikatu sieciowego jest skojarzony. |
|
Typ
|
message_type | string |
Deskryptor typu komunikatu. |
|
Typ nadawcy
|
sender_type | string |
Opis typu nadawcy. |
|
URL
|
url | uri |
Adres URL interfejsu API wpisu. |
|
Web Url
|
web_url | uri |
Internetowy adres URL wpisu. |
|
Identyfikator grupy
|
group_id | integer |
Unikatowy identyfikator grupy, która opublikowała wiadomość. |
|
Treść wiadomości
|
body | MessageBody |
Zawartość skojarzona z pojedynczą wiadomością. |
|
Identyfikator wątku
|
thread_id | integer |
Unikatowy identyfikator wątku. |
|
Wiadomość bezpośrednia
|
direct_message | boolean |
Flaga określająca, czy wpis jest wiadomością bezpośrednią. |
|
Identyfikator klienta
|
client_type | string |
Typ klienta. |
|
Adres URL klienta
|
client_url | uri |
Link internetowy klienta. |
|
Język
|
language | string |
Język używany w komunikacie. |
|
Oznakowany użytkownik
|
notified_user_ids | array of integer |
Szczegóły powiadomień użytkowników. |
|
Prywatność
|
privacy | string |
Szczegóły prywatności skojarzone z wiadomością. |
|
liked_by
|
liked_by | LikedBy |
Lubiane przez |
|
Czy komunikat systemowy
|
system_message | boolean |
Flaga określająca, czy wpis jest komunikatem wygenerowanym przez system, czy też nie. |
|
Tematy
|
topics | array of Topic |
Lista tematów. |
MessageV2
Właściwości pojedynczej wiadomości Viva Engage.
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
identyfikator
|
id | integer |
Identyfikator skojarzony z wpisem. |
|
Tekst
|
content_excerpt | string |
Zawartość tekstowa wpisu. |
|
Nadawca
|
sender_id | integer |
Unikatowy identyfikator użytkownika, który opublikował wiadomość. |
|
Odpowiedź na
|
replied_to_id | integer |
Identyfikator wiadomości, do której ta wiadomość jest odpowiedzią. |
|
Utworzono pod adresem
|
created_at | string |
Godzina utworzenia wiadomości. |
|
Sieć
|
network_id | integer |
Identyfikator komunikatu sieciowego jest skojarzony. |
|
Typ
|
message_type | string |
Deskryptor typu komunikatu. |
|
Typ nadawcy
|
sender_type | string |
Opis typu nadawcy. |
|
URL
|
url | uri |
Adres URL interfejsu API wpisu. |
|
Web Url
|
web_url | uri |
Internetowy adres URL wpisu. |
|
Identyfikator grupy
|
group_id | integer |
Unikatowy identyfikator grupy, która opublikowała wiadomość. |
|
Treść wiadomości
|
body | MessageBody |
Zawartość skojarzona z pojedynczą wiadomością. |
|
Identyfikator wątku
|
thread_id | integer |
Unikatowy identyfikator wątku. |
|
Wiadomość bezpośrednia
|
direct_message | boolean |
Flaga określająca, czy wpis jest wiadomością bezpośrednią. |
|
Identyfikator klienta
|
client_type | string |
Typ klienta. |
|
Adres URL klienta
|
client_url | uri |
Link internetowy klienta. |
|
Język
|
language | string |
Język używany w komunikacie. |
|
Oznakowany użytkownik
|
notified_user_ids | array of integer |
Szczegóły powiadomień użytkowników. |
|
Prywatność
|
privacy | string |
Szczegóły prywatności skojarzone z wiadomością. |
|
liked_by
|
liked_by | LikedBy |
Lubiane przez |
|
Czy komunikat systemowy
|
system_message | boolean |
Flaga określająca, czy wpis jest komunikatem wygenerowanym przez system, czy też nie. |
Temat
Właściwości pojedynczego tematu.
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
identyfikator
|
id | integer |
Unikatowy identyfikator tematu. |
|
Name
|
name | string |
Nazwa tematu. |
PageableMessageList
Lista jednego lub wielu komunikatów.
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Messages
|
value | array of Message |
PageableMessageListV2
Lista jednego lub wielu komunikatów.
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Messages
|
value | array of MessageV2 |
Lista komunikatów
Lista jednego lub wielu komunikatów.
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Messages
|
messages | array of Message |
messages |
MessageListV2
Lista jednego lub wielu komunikatów.
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Messages
|
messages | array of MessageV2 |
messages |
MessageBody
Zawartość skojarzona z pojedynczą wiadomością.
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Tekst
|
parsed | string |
Przeanalizowany format tekstu. |
|
Równina
|
plain | string |
Format zwykłego tekstu. |
|
Bogaty
|
rich | string |
Format tekstu sformatowanego. |
Lubiane przez
Lubiane przez
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Liczba
|
count | integer |
Liczba unikatowych polubień. |
|
Names
|
names | array of object |
Lista osób, które polubiły post. |
|
Pełna nazwa
|
names.full_name | string |
Pełne imię i nazwisko osoby, która polubiła post. |
Sieć
Właściwości pojedynczej sieci.
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
identyfikator
|
id | string |
Unikatowy identyfikator sieci. |
|
Name
|
name | string |
Podsumowanie sieci. |
|
Link
|
permalink | string |
Link internetowy do strony sieciowej. |
YammmerEntity
Właściwości pojedynczej jednostki Viva Engage.
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Description
|
type | string |
Szczegóły jednostki Viva Engage. |
|
Identyfikator grupy
|
id | integer |
Unikatowy identyfikator grupy. |
|
Pełna nazwa
|
full_name | string |
Nazwa jednostki Viva Engage. |