Joukkueiden vertailu (ennakko)

Yleiskatsaus

Keskustelutyökalut

mcp_graph_chat_addChatMember

Päätepiste:POST /v1.0/chats/{chat-id}/members

Lisää jäsenen keskusteluun käyttämällä - user@odata.bind, @odata.type- ja valinnaisia rooleja (jäsen, omistaja). Palauttaa 409-virhekoodin, jos jäsen on jo olemassa, 400-virhekoodin virheellisille käyttäjäviittauksille tai 403-virhekoodin, jos käytännöt rajoittavat lisäämistä.

Pakolliset parametrit: chat-id, @odata.type, user@odata.bind, roles

mcp_graph_chat_createChat

Päätepiste:POST /v1.0/chats

Luo uuden Teams-keskustelun : n kanssa chatType (oneOnOne edellyttää täsmälleen kahta osallistujaa, ryhmä vaatii enemmän kuin kaksi) ja -jäseniä. Palauttaa luvun 400, jos oneOnOne jäsenmäärä on väärä, 409, jos samoilla osallistujilla on jo keskustelu, tai 403, jos soittajalta puuttuu oikeudet.

Pakolliset parametrit:chatType, jäsenet

mcp_graph_chat_poistaKeskustelu

Päätepiste:DELETE /v1.0/chats/{chat-id}

Poistaa keskustelu pehmeästi. Palauttaa arvon 403, jos käyttöoikeus puuttuu, tai arvon 404, jos se on jo poistettu. Vuokraajan säilytyskäytännöt hallinnoivat tätä toimintoa.

Pakolliset parametrit: chat-id

mcp_graph_chat_deleteChatMessage

Päätepiste:POST /v1.0/users/{user-id}/chats/{chat-id}/messages/{chatMessage-id}/softDelete

Poistaa keskusteluviestin pehmeästi. Palauttaa luvun 403 ilman Chat.ReadWrite, virheellisten tunnusten 404:n, ja se saattaa silti säilyttää sanoman yhteensopivuuden puolesta.

Pakolliset parametrit: user-id, chat-id, chatMessage-id

mcp_graph_chat_getChat

Päätepiste:GET /v1.0/chats/{chat-id}

Noutaa keskustelun ID:n perusteella. Palauttaa metatietoja, kuten tyypin ja aiheen. Palauttaa luvun 404, jos keskustelua ei ole olemassa tai se ei ole näkyvissä, tai arvon 403, jos käyttöoikeudet on estetty.

Pakolliset parametrit: chat-id

mcp_graph_chat_getChatMessage (Viestin hakemisto chatille MCP Graph -rajapinnasta)

Päätepiste:GET /v1.0/chats/{chat-id}/messages/{message-id}

Hakee keskusteluviestin tunnuksen perusteella. Palauttaa luvun 404, jos viestiä ei ole olemassa tai se on piilotettu, tai 403:n, jolla ei ole asianmukaisia oikeuksia.

Pakolliset parametrit: chat-id, message-id

mcp_graph_chat_listChatMembers

Päätepiste:GET /v1.0/chats/{chat-id}/members

Näyttää luettelon keskusteluiden osallistujista. Palauttaa roolit (jäsen, omistaja tai vieras). Palauttaa luvun 403 ilman lukuoikeuksia tai 404: n, jos keskustelusta ei löydy.

Pakolliset parametrit: chat-id

mcp_graph_chat_listChatMessages

Päätepiste:GET /v1.0/chats/{chat-id}/messages

Näyttää keskustelun viestit, joissa on valinnainen $top, $filter, ja $orderby. Palauttaa sivutetut tulokset. Yhteensopivuus saattaa piilottaa sisällön. Virheisiin kuuluvat 400 virheellisille kyselyille ja 429 rajoittamista varten.

Pakolliset parametrit: chat-id

Valinnaiset parametrit:$top, $filter, , $orderby

mcp_graafinen_keskusteluluettelo_listaaKeskustelut

Päätepiste:GET /v1.0/chats

Luetteloi soittajan keskustelut valinnaisilla $top, $filter, $expandja $orderby. Palauttaa vain näkyvät keskustelut; piilotettuja tai järjestelmäkeskusteluja voidaan sulkea pois. Palauttaa virheellisille lajittelulausekkeille luvun 400.

Valinnaiset parametrit:$top, $orderby, $expand, , $filter

mcp_grafiikka_keskustelu_lähetäViesti

Päätepiste:POST /v1.0/chats/{chat-id}/messages

Julkaisee uuden tekstimuotoisen viestin keskustelussa. Tarvitsee chat-id-tunnuksen ja ei-mitään body.content-sisältöä; vain teksti, jota tuetaan. Tämä saattaa palauttaa 429:n rajoittamisesta, 403:n, jos oikeuksia puuttuu, tai 404:n, jos keskustelu on virheellinen. Ei idempotent—avoid sokko-uudelleenyrityksiä.

Pakolliset parametrit: chat-id, body

mcp_graph_chat_updateChat

Päätepiste:PATCH /v1.0/chats/{chat-id}

Päivittää keskusteluominaisuudet, kuten vain ryhmäkeskusteluja koskevat ohjeet. Epäonnistuu kun käytössä on 400, jos käytetään yksi yhteen -keskustelulle, 403 ilman oikeuksia tai 404, jos chatia ei löydy.

Pakolliset parametrit: chat-id, topic

mcp_graph_chat_updateChatMessage

Päätepiste:PATCH /v1.0/chats/{chat-id}/messages/{message-id}

Päivittää keskusteluviestin uudella tekstimuotoisessa sisällössä. Jotkin järjestelmän tai yhteensopivuuden sanomat estävät muokkaamisen. Toiminto palauttaa arvon 403 tai 400, jos muokkausta ei sallita, tai 409-arvon ristiriidoille.

Pakolliset parametrit: chat-id, message-id

Kanava- ja tiimityökalut

mcp_graph_teams_addChannelMember

Päätepiste:POST /v1.0/teams/{team-id}/channels/{channel-id}/members

Lisää jäsenen yksityiseen tai jaettuun kanavaan käyttämällä - user@odata.bind, @odata.type- ja valinnaisia rooleja (omistaja tai tyhjä). Epäonnistuu vakiokanavissa. Palauttaa luvun 409, jos jäsen on jo olemassa, ja luvun 403, jos käyttöoikeuksia ei ole määritetty.

Pakolliset parametrit: team-id, channel-id, displayName, roles, user@odata.bind, @odata.type

mcp_graph_tiimit_luoKanava

Päätepiste:POST /v1.0/teams/{team-id}/channels

Luo tiimissä kanavan, displayName joka sisältää membershipTypevalinnaisen kuvauksen (vakio, yksityinen, jaettu) ja valinnaiset jäsenet. Yksityiset tai jaetut kanavat edellyttävät eksplisiittisiä jäseniä. Kaksoiskappaleet tai virheellinen jäsenyys aiheuttavat luvun 400 tai 409.

Pakolliset parametrit: team-id, displayName

Valinnaiset parametrit: kuvaus, jäsenyydenTyyppi, jäsenet

mcp_graph_teams_createPrivateChannel

Päätepiste:POST /v1.0/teams/{team-id}/channels

Luo yksityisen kanavan määrittämällä -arvoksi membershipTypeprivate. Jäseniä on sisällytettävä kanavaa luodessasi, ja jäsenluettelossa on oltava vähintään yksi omistaja. Palauttaa arvon 400, jos jäsenet puuttuvat, arvon 409, jos nimet ovat päällekkäisiä, tai arvon 403, jos kutsujalla ei ole oikeuksia.

Pakolliset parametrit: team-id, displayName, members

mcp_graph_teams_getChannel

Päätepiste:GET /v1.0/teams/{team-id}/channels/{channel-id}

Hakee kanavan, jossa on valinnainen $select ja $filter. Palauttaa luvun 404, jos kanavaa ei löydy tai soittajalta puuttuu käyttöoikeus, 403, jos käyttöoikeudet eivät riitä, tai 400 suodattimen, jota ei tueta.

Pakolliset parametrit: team-id, channel-id

Valinnaiset parametrit:$select, $filter

mcp_graph_teams_getTeam

Päätepiste:GET /v1.0/teams/{team-id}

Hakee tiimin ominaisuudet valinnaisilla $select ominaisuuksilla ja $expand. Palauttaa luvun 403 tai 404, jos joukkue ei ole käytettävissä.

Pakolliset parametrit: team-id

Valinnaiset parametrit:$select, $expand

mcp_graph_teams_listChannelMembers

Päätepiste:GET /v1.0/teams/{team-id}/channels/{channel-id}/members

Näyttää luettelon tietyn Microsoft Teams kanavan kaikista jäsenistä. Palauttaa kunkin jäsenen metatiedot, kuten käyttäjätiedot, roolit ja jäsenyyden tilan. Näistä tiedoista on hyötyä kanavan osallistumisen valvonnan, jäsenyyden tarkistamisen ennen roolipäivityksiä tai vaatimustenmukaisuuden varmistamisessa.

Pakolliset parametrit: team-id, channel-id

Valinnaiset parametrit:$top, $expand

mcp_graph_teams_listChannelMessages

Päätepiste:GET /v1.0/teams/{team-id}/channels/{channel-id}/messages

Näyttää luettelon kanavan viesteistä. Mukauta tuloksia valinnaisten $top parametrien ja $expand -parametrien avulla. Esimerkiksi kohdetta käytetään $expand vastausten sisällyttämiseen. Sivutus käsitellään :n kautta @odata.nextLink. Palauttaa arvon 403 ilman lukuoikeutta tai 400 virheellisille kyselyasetuksille.

Pakolliset parametrit: team-id, channel-id

Valinnaiset parametrit:$top, $expand

mcp_graph_teams_listChannels

Päätepiste:GET /v1.0/teams/{team-id}/allChannels

Näyttää luettelon ryhmän kanavista. Mukauta tuloksia valinnaisten $select parametrien tai $filter parametrien avulla. Palauttaa yksityiset ja jaetut kanavat vain, jos soittaja on jäsen. Epäonnistuu virheellä 403: lla, jos soittajalta puuttuvat lukuoikeudet, tai 400 virheellisille OData-kyselyille.

Pakolliset parametrit: team-id

Valinnaiset parametrit:$select, $filter

mcp_graph_teams_listTeams

Päätepiste:GET /v1.0/users/{user-id}/joinedTeams

Näyttää luettelon tietyn käyttäjän yhdistetyistä tiimeistä. Palauttaa vain kyseisen käyttäjän jäsenyydet, ei kaikkia vuokraajaryhmiä. Palauttaa luvun 403, jos soittaja ei voi tehdä kyselyä käyttäjälle, tai arvon 404, jos tunnus on virheellinen.

Pakolliset parametrit: user-id

mcp_graph_teams_postChannelMessage

Päätepiste:POST /v1.0/teams/{team-id}/channels/{channel-id}/messages

Julkaisee vain teksti -viestin kanavalle. Edellyttää team-id-, channel-id- ja body.content-parametria. Palauttaa luvun 403 ilman ChannelMessage.Send-tiedostoa, 404: n, jos kanavaa ei löydy, tai 400:n, jos sisältöä puuttuu.

Pakolliset parametrit: team-id, channel-id, body

mcp_graph_teams_replyToChannelMessage

Päätepiste:POST /v1.0/teams/{team-id}/channels/{channel-id}/messages/{message-id}/replies

Vastaa viestiin kanavassa käyttämällä body.content-toimintoa. Vain pelkkää tekstiä tuetaan. Palauttaa luvun 404, jos pääviestiä ei löydy, luvun 403 ilman oikeuksia tai 400 virheellisen sisällön osalta.

Pakolliset parametrit: team-id, channel-id, message-id, body

mcp_graph_teams_updateChannel

Päätepiste:PATCH /teams/{team-id}/channels/{channel-id}

Päivittää kanavan uudella displayName tai kuvauksella. Rajoitukset voivat koskea erikoiskanavia, kuten Yleisiä. Palauttaa 403:n käyttöoikeuksien puuttuessa, 409:n jos nimi on jo käytössä tai 400:n virheellisestä syötteestä.

Pakolliset parametrit: team-id, channel-id

Valinnaiset parametrit: displayName, description

mcp_graph_teams_updateChannelMember

Päätepiste:PATCH /teams/{team-id}/channels/{channel-id}/members/{membership-id}

Päivittää jäsenen roolin yksityisessä tai jaetussa kanavassa muuttamalla rooleja. Vakiokanavat perivät rooleja tiimiltä ja hylkäävät päivitykset yleensä. Palauttaa luvun 400, jos yritetään vakiokanavissa, 403, jos se ei ole sallittu, tai 404, jos jäsentä ei löydy.

Kuvankäsittelyn pakolliset parametrit: team-id, channel-id, membership-id, roolit

Tuetut toiminnot

• Keskusteluiden hallinta (luo, lue, päivitä, poista)
• Viestitoiminnot (lähetä, nouda, muokkaa, poista)
• Kanavan hallinta (luo, määritä, luettelo)
• Jäsenten hallinta (lisää, päivitä, luettelo)
• Ryhmän toiminnot (noutaminen, luettelo)

Tärkeimmät ominaisuudet

• Täydet luonti-, luku-, päivitys- ja poistotoiminnot (CRUD) keskusteluissa ja kanavissa.
• Yksityisten, jaettujen ja vakiokanavien tuki.
• Viestien ketjutus ja vastaukset.
• Jäsenroolien hallinta.
• OData-kyselyn tuki suodattamiselle ja sivutetuille toiminnoille.