コメントを取得、追加、または削除する

固定リンクがコピーされました

コメントを取得する

固定リンクがコピーされました

メッセージIDとコメントの取得開始位置、取得上限数をリクエストのパラメーターとして受け取り、コメントの情報をレスポンスとして返すAPIです。
APIを実行するユーザーが宛先／差出人に含まれているメッセージのコメントのみ取得されます。

API名

固定リンクがコピーされました

MessageGetFollows

利用できるバージョン

固定リンクがコピーされました

クラウド版Garoon
パッケージ版Garoon 3.0以降

リクエスト

固定リンクがコピーされました

パラメーター名	型	パラメーター数	説明
@thread_id	xsd:string	1	コメントを取得するメッセージID
@offset	xsd:unsignedLong	1	コメントの取得開始位置。コメントの数で指定します。
@limit	xsd:unsignedLong	1	コメントの取得上限数

例

1

<parameters thread_id="5" offset="0" limit="20"></parameters>

レスポンス

固定リンクがコピーされました

パラメーター名	型	パラメーター数	説明
follow	message:FollowType	0～無制限- 0：指定されたコメントが存在しない	取得されたコメントの情報

例

1
2
3
4
5
6
7
8
9


<returns> 
  <follow id="15" number="2" text="書式編集を使用したコメント"  
   html_text="&lt;p&gt;&lt;strong&gt;&lt;font size=&quot;5&quot;&gt;書式編集を使用したコメント&lt;/font&gt;&lt;/strong&gt;&lt;/p&gt;"> 
    <creator user_id="1" name="Administrator" date="2010-07-09T00:41:19Z" /> 
  </follow> 
  <follow id="14" number="1" text="follow"> 
    <creator user_id="1" name="Administrator" date="2010-07-09T00:40:54Z" /> 
  </follow> 
</returns>

エラー

固定リンクがコピーされました

エラー番号	説明
GRN_MSSG_15003	指定したメッセージIDが存在しない場合

コメントを追加する

固定リンクがコピーされました

メッセージIDとコメントの情報をリクエストのパラメーターとして受け取り、メッセージにコメントを追加するAPIです。
APIを実行するユーザーが宛先／差出人に含まれているメッセージへのコメントのみ追加されます。
このAPIは、書式編集を利用したコメントの追加に対応していません。

API名

固定リンクがコピーされました

MessageAddFollows

利用できるバージョン

固定リンクがコピーされました

クラウド版Garoon
パッケージ版Garoon 3.0以降

リクエスト

固定リンクがコピーされました

パラメーター名	型	パラメーター数	説明
add_follow	配列	1～無制限	追加するコメント
add_follow/@thread_id	xsd:string	1	コメントを追加するメッセージID
add_follow/follow	message:FollowType	1	追加するコメントの情報
add_follow/file	配列	0～無制限- 0：添付ファイルが存在しない	コメントに添付するファイル
add_follow/file/content/text()	xsd:base64Binary	1	添付ファイルデータ
add_follow/file/@id	xsd:string	1	添付ファイルのID

例

 1
 2
 3
 4
 5
 6
 7
 8
 9
10


<parameters> 
  <add_follow thread_id="5"> 
    <follow id="dummy" number="dummy" text="follow"> 
      <file id="1" name="sample.txt"></file> 
    </follow> 
    <file id="1"> 
      <content>YWJj</content> 
    </file> 
  </add_follow> 
</parameters>

レスポンス

固定リンクがコピーされました

パラメーター名	型	パラメーター数	説明
thread	message:ThreadType	0～無制限	コメントが追加されたメッセージの情報

例

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12


<returns>
  <thread id="5" version="1278637512" confirm="false" subject="subject" is_draft="false" > 
    <addressee user_id="1" name="Administrator" deleted="false" confirmed="false" /> 
    <content body="content" ></th:content> 
    <follow id="15" number="2" /> 
    <follow id="14" number="1" /> 
    <folder id="2" /> 
    <folder id="3" /> 
    <creator user_id="1" name="Administrator" date="2010-07-07T10:28:40Z" /> 
    <modifier user_id="1" name="Administrator" date="2010-07-07T10:28:40Z" /> 
  </thread> 
</returns>

エラー

固定リンクがコピーされました

エラー番号	説明
GRN_MSSG_15003	指定したメッセージIDが存在しない場合
GRN_UTIL_API_65009	アップロードするファイルのサイズが、Base64エンコード後で300MBより大きい場合

コメントを削除する

固定リンクがコピーされました

メッセージのコメントIDをリクエストのパラメーターとして受け取り、指定されたコメントを削除するAPIです。
APIを実行するユーザーが追加したコメントのみ削除されます。

API名

固定リンクがコピーされました

MessageRemoveFollows

利用できるバージョン

固定リンクがコピーされました

クラウド版Garoon
パッケージ版Garoon 3.0以降

リクエスト

固定リンクがコピーされました

パラメーター名	型	パラメーター数	説明
follow_id/text()	base:IDType	1～無制限	削除するコメントのID

例

1
2
3


<parameters> 
  <follow_id>15</follow_id> 
</parameters>

レスポンス

固定リンクがコピーされました

なし

エラー

固定リンクがコピーされました

エラー番号	説明
GRN_MSSG_15004	指定したメッセージIDが存在しない場合

Garoon API

Garoon APIドキュメント