Microsoft Teams

마이크로소프트 Teams는 비교적 새로운 서비스로 회사 내외의 합작을 효율적으로 실현하는 도구이다.팀 단위로 작업을 수행하도록 설계된 팀즈는 채팅, 파일, 기타 서비스와의 통합 기능 등을 제공한다.
Microsoft Graph는 Teams에 다음과 같은 리소스를 제공합니다.

그룹

팀

채널

채팅

관련 자원에는 달력, 드라이브, 예약 및 노트(OneNote)가 있습니다.
현재 팀워크의 자원은 베타 버전이다.따라서 C#의 샘플은 게재되지 않지만 HttpClient를 사용할 수 있습니다.
또한 현재 할 수 있는 조작은 유한하지만 상세한 상황은 더 많은 조작을 지원할 것이다.

그룹 자원

마이크로소프트 팀의 기본 단위는 팀이다.

주요 방안

그룹의 취득, 업데이트, 삭제

팀의 일람 취득 또는 차분 취득

그룹 설정의 수령, 생성, 업데이트 및 삭제

그룹의 소유자 또는 구성원 추가 또는 삭제

구성원이 설정한 조작

관련 자원의 조작

그룹 자원 작업

Microsoft Teams 팀은 이전에 소개한 팀과 내부에서 동일하지만 Office 365 그룹으로 등록해야 하고 추가 팀이 필요합니다.다음은 대표적인 몇 가지 조작을 소개한다.
그룹 생성
Teams 그룹을 만들려면 먼저 그룹 리소스를 만들고 Teams 설정에 로그인합니다.
POST: https://graph.microsoft.com/beta/groups
Body

{
  "description": "de:code 2018 Teams グループ",
  "displayName": "de:code 2018 Teams グループ",
  "groupTypes": [
    "Unified"
  ],
  "mailEnabled": true,
  "mailNickname": "decode2018teamsgroup",
  "securityEnabled": false,
  "visibility": "public"
}

PUT: https://graph.microsoft.com/beta/groups/{id}/team
Body

{  
  "memberSettings": {
    "allowCreateUpdateChannels": true
  },
  "messagingSettings": {
    "allowUserEditMessages": true,
    "allowUserDeleteMessages": true
  },
  "funSettings": {
    "allowGiphy": true,
    "giphyContentRating": "strict"
  },
  "guestSettings": {
    "allowCreateUpdateChannels": false,
    "allowDeleteChannels": false 
  },
}

그룹 가져오기 및 삭제
GET: https://graph.microsoft.com/beta/groups/{id}
DELETE: https://graph.microsoft.com/beta/groups/{id}
그룹에 소유자 또는 구성원 추가
추가할 수 있는 것은 사용자 또는 그룹입니다.
POST: https://graph.microsoft.com/beta/groups/{id}/owners/$ref
POST: https://graph.microsoft.com/beta/groups/{id}/members/$ref
Body

{
  "@odata.id": "https://graph.microsoft.com/beta/directoryObjects/{id}"
}

그룹 삭제 및 전체 삭제
그룹을 삭제하면 디렉토리에서 삭제된 항목으로 이동하고 삭제하면 완전히 삭제됩니다.
DELETE: https://graph.microsoft.com/beta/groups/{id}
DELETE: https://graph.microsoft.com/beta/directory/deleteditems/{id}
삭제된 파티 획득 및 회복
완전히 삭제되지 않은 경우 다음과 같이 취득하고 복원할 수 있다.
GET: https://graph.microsoft.com/beta/directory/deleteditems/microsoft.graph.group
POST https://graph.microsoft.com/beta/directory/deleteditems/{id}/restore

팀 리소스

이것은 그룹에 대한 Microsoft Teams 설정을 위한 리소스입니다.삭제할 때 조합을 삭제합니다.

주요 방안

팀의 제작, 갱신, 취득

팀 리소스 작업

다음은 대표적인 몇 가지 조작을 소개한다.
대오의 획득
GET: https://graph.microsoft.com/beta/groups/{id}/team
팀 업데이트
PATCH: https://graph.microsoft.com/beta/groups/{id}/team
Body

{  
  "memberSettings": {
    "allowCreateUpdateChannels": true
  },
  "messagingSettings": {
    "allowUserEditMessages": true,
    "allowUserDeleteMessages": true
  },
  "funSettings": {
    "allowGiphy": true,
    "giphyContentRating": "strict"
  }
}

사진 자료

그룹의 프로필 사진입니다.

주요 방안

사진 취득 및 업데이트

사진 자원 작업

다음은 대표적인 몇 가지 조작을 소개한다.
사진 가져오기
GET: https://graph.microsoft.com/beta/groups/{id}/photo/$value
사진 업데이트
PUT: https://graph.microsoft.com/beta/groups/{id}/photo/$value
Header

Content-Type: image/jpeg

Body

写真のバイナリデータ

채널 자원

그룹 내 채널을 대표하는 자원입니다.현재 업데이트 및 삭제할 수 없습니다.

주요 방안

채널 획득 및 생성

채널 자원 작업

다음은 대표적인 몇 가지 조작을 소개한다.
채널 생성
POST: https://graph.microsoft.com/beta/groups/{id}/team/channels
Body

{
  "displayName": "セッションについて",
  "description": "このチャネルではセッションについて話します。"
}

채팅 스레드 자원

이것은 채널의 채팅 라인을 표시하는 자원입니다.현재 업데이트 및 삭제할 수 없습니다.

주요 방안

채팅 스레드 만들기

채팅 라인 자원 조작

채팅 단서 만들기
contentType에서 0은 텍스트이고 1은 HTML입니다.
POST: https://graph.microsoft.com/beta/groups/{id}/team/channels/{channel_id}/chatthreads
Body

{
  "rootMessage": {
      "body": {
        "contentType": 1,
        "content": "<h1>セッションについて話しましょう！</h1>"
      }
  }
}

채팅 메시지 리소스

채팅 단서 속의 정보.현재 채팅 라인을 만들 때만 메시지를 발표할 수 있으며 다른 투고를 읽거나 편집할 수 없습니다.

총결산

Teams는 SharePoint의 기능, Skype for Business의 기능 등을 포함한 사내 협업 협력을 위한 도구다.팀 자체에도 확장 기능이 있지만 마이크로소프트 그래프는 팀을 사용하는 쪽이 될 수 있기 때문에 다양한 관점에서 확장할 수 있다.
디렉토리로 돌아가기

인용하다

Microsoft Graph의 팀워크 운영
Automate team lifecycles with Microsoft Teams and Graph(영어)