GET/users/{userId}/mail/mailfolders/favorite-contacts

よく使う項目リストを取得する。

Authorization

oauth2

Access Token を指定します。
指定の方法や Access Token の取得方法は 共通仕様 を参照してください。

Scope

mail
mail.read

HTTP Request

GEThttps://www.worksapis.com/v1.0/users/{userId}/mail/mailfolders/favorite-contacts

Path Parameters

ParameterTypeDescription
userId string 

ユーザーを特定する ID (URL エンコードする)

  • ユーザー ID (userId)
  • ログイン ID (email)
  • 自身 ("me")

required
example : me 

Header Parameters

HeadertypeDescription
Authorization string 

Bearer {token}


required 

Response

HTTP 200

OK

PropertyTypeDescription
favoriteContactsMailFolders array (object) 

よく使う項目フォルダ情報


required
minItems : 0
uniqueItems : true 

object

PropertyTypeDescription
unreadMailCount integer 

未読メール数


required
format : int32 
mailCount integer 

メール数


required
format : int32 
folderName string 

メールフォルダ名


required
minLength : 1
maxLength : 250 
email string 

メールアドレス


required
minLength : 1
format : email 

Response Example

example

1{2  "favoriteContactsMailFolders": [3    {4      "unreadMailCount": 6,5      "mailCount": 58,6      "folderName": "David",7      "email": "admin@example.com"8    },9    {10      "unreadMailCount": 15286,11      "mailCount": 15460,12      "folderName": "LINE WORKS",13      "email": "no_reply@example.com"14    },15    {16      "unreadMailCount": 0,17      "mailCount": 54,18      "folderName": "David_qtqt",19      "email": "qtqt@hbj.example.com"20    },21    {22      "unreadMailCount": 0,23      "mailCount": 1,24      "folderName": "David_fqfq",25      "email": "fqfq@example.com"26    }27  ]28}