技術標籤：graph apiteams appTeamsteamsappgraph apioffice365microsoft

在寫這篇文章的時候，這個新功能還處在 Public Review，這意味著可能（很小的可能性）這裡寫的方法在正式釋出前還會有一些改動。

之前有一些做teams app開發的朋友問過我，能不能主動給一個team或者一個使用者安裝一個指定的app，之前做不到，但現在可以了，方法如下：

1. 許可權

先要確保你的app有TeamsAppInstallation.ReadWriteSelfForUser.All和TeamsAppInstallation.ReadWriteSelfForTeam.All

1. 找到要安裝的 app 的 id

我在前一篇部落格文章裡解釋過各種 id 的區別，簡單的說，開發者在 teams app 的 manifest json 檔案裡指定的 id，並且不是 teams app id，在manifest裡指定的 id 在teams graph api裡叫做 external id，而 app id 是 teams 自動生成的一個 id。需要我們通過這個api來獲取。

GET https://graph.microsoft.com/beta/appCatalogs/teamsApps?$filter=externalId eq '{11111111-2222-3333-4444-911d24850d7c}'

Response body:
{
  "value": [
    {
      "id": "b1c5353a-7aca-41b3-830f-27d5218fe0e5",
      "externalId": "11111111-2222-3333-4444-911d24850d7c",
      "name": "Test app name",
      "version": "0.0.1",
      ......
    }
  ]
}
 

上面的呼叫就是查詢一個 external id 是等於 manifest ID 的一個 app，而在返回的內容裡的 “id” 就是我們需要的 app id。

1. 檢查這個 app 是否已經給 user 安裝過

GET https://graph.microsoft.com/beta/users/{user-id}/teamwork/installedApps?$expand=teamsApp&$filter=teamsApp/id eq '{teamsAppId}'

1. 安裝 app 如果上一步檢測下來，user並沒有安裝過這個 app 的話，那麼我們就可以開始安裝 app 了。

POST https://graph.microsoft.com/beta/users/{user-id}/teamwork/installedApps

Request body:
{
   "
 
[email protected]" : "https://graph.microsoft.com/beta/appCatalogs/teamsApps/{teamsAppId}"
}

上面 4 部都完成後，那個user就可以開始使用 app 了