Team photo的新api

Graph API的更新速度真是快，今年9月中旬又增加了關於Team photo的兩個新的api。

• https://docs.microsoft.com/en-us/graph/api/team-get-photo
• https://docs.microsoft.com/en-us/graph/api/team-update-photo

今天就給大家介紹一下如何使用這兩個新的api。 實際上說起來也簡單，因爲graph api的設計理解一脈相承。這兩個api一個是獲取一個team的圖標（photo），一個是更新修改team的圖標，所以對graph api熟悉的開發這立刻就可以想到他們對應的url是：

GET /beta/teams/{id}/photo
PUT /beta/teams/{id}/photo

對於GET獲取圖標的api需要特別提一下，上面這個api主要是獲取圖標的meta信息，返回信息類似於：

HTTP/1.1 200 OK
Content-type: application/json
{
    "@odata.mediaContentType": "image/jpeg",
    "id": "240X240",
    "width": 240,
    "height": 240
}

如果想要獲取真正的圖片文件，那要使用這個api：

GET /beta/teams/{id}/photo/$value

這個api會返回圖片的二進制流。

另外值得一提的是，graph api設計很貼心，對於圖片的獲取，還提供了resize功能，也就是說調用方可以指定想要的圖片的長和寬，api會返回對應大小的圖片。

GET /beta/teams/{id}/photo/{size}
GET /beta/teams/{id}/photo/{size}/$value

這裏的{size}目前支持這幾種：48x48, 64x64, 96x96, 120x120, 240x240, 360x360, 432x432, 504x504, 和648x648。比如我想要獲取一個id爲738c7842-d884-4456-9b77-e2c0a73fb200的team的圖標文件，就可以使用這個call

GET https://graph.microsoft.com/beta/teams/738c7842-d884-4456-9b77-e2c0a73fb200/photo/240x240/$value

對於更新team圖標，目前的api對於圖片大小有一個4MB的限制，所以如果你的圖片超過這個大小，再上傳前需要做一個壓縮處理。

最近teams還增加了很多其他實用的api，我會在後面慢慢介紹。