chatter rest api...

Chatter REST API 開発者ガイドバージョン 35.0, Winter ’16

@salesforcedocs最終更新日: 2015/11/25

https://twitter.com/salesforcedocs

本書の英語版と翻訳版で相違がある場合は英語版を優先するものとします。

© Copyright 2000–2015 salesforce.com, inc. All rights reserved. Salesforce およびその他の名称や商標は、salesforce.com,

inc. の登録商標です。本ドキュメントに記載されたその他の商標は、各社に所有権があります。

目次

第 1 章: Chatter REST API の概要 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1

Chatter REST API を使用するケースの決定 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2Chatter REST API アーキテクチャ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2Chatter REST API レート制限 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4Chatter REST API リソース URL の作成 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5HTTP 要求の送信 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6Chatter REST API 要求および応答について . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6Chatter REST API 入力の使用 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11ワイルドカード . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21応答サイズの指定 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22

filterGroup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23exclude . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25include . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26

レスポンスボディの符号化 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28状況コードとエラー応答 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29OAuth と Chatter REST API について . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30

Web サーバ OAuth 認証フローについて . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33ユーザエージェント OAuth 認証フローについて . . . . . . . . . . . . . . . . . . . . . . . . . . 39トークンの使用 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43HTML からの静的アセットの直接要求およびフォーム要求の直接投稿 . . . . . . . . . . 44

CORS を使用した Chatter REST API および REST API へのアクセス . . . . . . . . . . . . . . . . . . . 45

第 2 章: Chatter REST API クイックスタート . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47

前提条件 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48ステップ 1: Salesforce Developer Edition 組織を取得する . . . . . . . . . . . . . . . . . . . . . . . . . 48ステップ 2: 認証を設定する . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48ステップ 3: OAuth を使用して Chatter REST API に接続する . . . . . . . . . . . . . . . . . . . . . . . 49Salesforce Communities への接続 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50

第 3 章: Chatter REST API の機能 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52

アクションリンクの使用 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53アクションリンクの使用事例 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55アクションリンクの概要、認証、およびセキュリティ . . . . . . . . . . . . . . . . . . . . . 57アクションリンクテンプレート . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62

コミュニティの使用 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78フィードおよびフィード要素の使用 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80Salesforce Files の使用 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87

第 4 章: Chatter REST API の例 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91

レスポンスボディを絞り込む . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92コミュニティで要求を実行する . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93自分のニュースフィードを取得する . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94他のユーザのフィードを取得する . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94グループフィードを取得する . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94フィード項目を投稿する . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95フィード要素を投稿し、Salesforce のファイルを含める . . . . . . . . . . . . . . . . . . . . . . . . 96インライン画像を含むフィード要素を投稿する . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96コメントを投稿する . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97コメントを投稿し、Salesforce のファイルを含める . . . . . . . . . . . . . . . . . . . . . . . . . . . 98バイナリファイルを投稿する . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98@メンションを投稿する . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99複数の @メンションを投稿する . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100@メンション提案のリストを取得する . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101アクションリンクを定義し、フィード要素を使用して投稿する . . . . . . . . . . . . . . . . . 102テンプレートのアクションリンクを定義し、フィード要素を使用して投稿する . . . . . . 105アクションリンクの状況を更新するかアクションリンクを呼び出す . . . . . . . . . . . . . . 109フィード投稿を編集する . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110コメントを編集する . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111質問のタイトルと投稿を編集する . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111フィード項目にいいね! と言う . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112フィード項目にいいね! と言い、いいね! の総数を返す . . . . . . . . . . . . . . . . . . . . . . . . 112フィード項目を共有する . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113最後の要求以降に更新されたフィード要素を取得する . . . . . . . . . . . . . . . . . . . . . . . . 113内部のフィード項目のみを含むフィードを取得する . . . . . . . . . . . . . . . . . . . . . . . . . . 114フィードを検索する . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114ユーザがフォローしているレコードのリストを取得する . . . . . . . . . . . . . . . . . . . . . . . 115ユーザの Chatter 活動の統計情報を取得する . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115フォローするユーザのおすすめを取得する . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115カスタムのおすすめを作成し、利用者を使用してスケジュールする . . . . . . . . . . . . . . 116グループを作成する . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118グループの写真を更新およびトリミングする . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119グループに参加する . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119非公開グループへの参加を要求する . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120非公開グループへの参加要求を承認または却下する . . . . . . . . . . . . . . . . . . . . . . . . . . 120グループに投稿する . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121レコードをフォローする . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122レコードのフォローを停止する . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122レコードフィードを取得する . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122ユーザプロファイルを更新する . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123ユーザの写真を更新およびトリミングする . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123非公開メッセージを送信する . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124複数のユーザのユーザ情報を取得する . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124

目次

第 5 章: Chatter REST API リソース . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126

Action Links リソース . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129Action Link Group Definitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130Action Link Group Definition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133Action Link Group . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134Action Link . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134Action Link Diagnostic Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138

Announcements リソース . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138Async Query リソース . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140

Async Query . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140Async Query, Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141

Batch リソース . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142Chatter リソース . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148Comments リソース . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148Communities リソース . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151Communities Moderation リソース . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153Connect リソース . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161Dashboard Component Snapshot リソース . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162Datacloud リソース . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164

Datacloud Company Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165Datacloud Contact Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165Datacloud OrderId Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165Datacloud Company Order Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166Datacloud Contact Order Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166Datacloud Orders . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167Datacloud Usage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 168

Feed Elements リソース . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169Feed Elements, Post and Search . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172Feed Elements, Batch Post . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174Feed Elements, Batch Get . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 178Feed Element . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 178Feed Element Capabilities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 179Feed Elements Capability, Approval . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 180Feed Elements Capability, Associated Actions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 180Feed Elements Capability, Banner . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 181Feed Elements Capability, Bookmarks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 181Feed Elements Capability, Bundle . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 182Feed Elements Capability, Bundle Elements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 183Feed Elements Capability, Canvas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 184Feed Elements Capability, Case Comment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 185Feed Elements Capability, Chatter Likes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 185Feed Elements Capability, Chatter Likes Items . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 186Feed Elements Capability, Comments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 186

目次

Feed Elements Capability, Comments Items . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 187Feed Elements Capability, Content . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189Feed Elements Capability, Dashboard Component Snapshot . . . . . . . . . . . . . . . . . . . 189Feed Elements Capability, Editability . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190Feed Elements Capability, Email Message . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190Feed Elements Capability, Enhanced Link . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190Feed Elements Capability, Link . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191Feed Elements Capability, Moderation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191Feed Elements Capability, Mute . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193Feed Elements Capability, Origin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194Feed Elements Capability, Poll . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194Feed Elements Capability, Question and Answers . . . . . . . . . . . . . . . . . . . . . . . . . . . 195Feed Elements Capability, Recommendations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197Feed Elements Capability, Record Snapshot . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197Feed Elements Capability, Topics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 198Feed Elements Capability, Tracked Changes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200

Feed Items リソース . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200Feed-Items Batch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200Feed-Items Query . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 201Feed-Items, Specific Feed Item . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 202Feed Items Comments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 203Feed-Items Likes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 206Feed-Items Polls . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 206Feed-Items Topics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 208

Feed リソース . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 209Bookmarks Feed リソース . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 211Communities Home Feed リソース . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 217Communities Moderation Feed リソース . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 219Company Feed リソース . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 223Favorites Feed リソース . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 228Feeds リソース . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 235Files Feed リソース . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 236Filter Feed リソース . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 242Groups Feed リソース . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 251Mute Feed リソース . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 257News Feed リソース . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 260People Feed リソース . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 282Record Feed リソース . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 289To Feed リソース . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 310Topics Feed リソース . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 316User Profile Feed リソース . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 320

Files Connect Repository リソース . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 340Files Connect Repository List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 341Files Connect リポジトリ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 342

目次

Files Connect Repository Directory Entries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 342Files Connect Repository File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 343Files Connect Repository File Content . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 344Files Connect Repository Folder Allowed Item Types . . . . . . . . . . . . . . . . . . . . . . . . . 344Files Connect Repository Folder Items . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 345Files Connect Repository Item Type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 347Files Connect Repository Permissions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 347Files Connect Repository Permission Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 349

Files リソース . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 349File Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 350File Content . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 353File Shares . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 354Files Shares Link . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 356File Previews . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 357File Preview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 357File Rendition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 358File Information, Batch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 359

Folders リソース . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 360Groups リソース . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 364

List of Groups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 365Group Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 369Batch Group Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 373Group Announcements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 373Group Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 376Group Members . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 377Group Members—Private . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 379Group Membership Requests—Private . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 383Group Memberships リソース . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 384Group Photo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 387Group Records . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 391Group Record . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 392Group Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 392Group Topics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 394

Influence リソース . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 394Likes リソース . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 395Managed Topics リソース . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 396

Managed Topics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 396Managed Topic . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 402

Mentions リソース . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 403Mentions Completions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 404Mentions Validations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 406

Motifs リソース . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 407Push Notifications リソース . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 409Question and Answers Suggestions リソース . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 410

目次

Recommendation Audience Resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 411Recommendation Audiences . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 412Recommendation Audience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 414Recommendation Audience Members . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 416

おすすめ定義リソース . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 417Recommendation Definitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 418Recommendation Definition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 419Recommendation Definition Photo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 421

Records リソース . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 424Followers on Records リソース . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 425Topics on Records リソース . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 426

スケジュール済みおすすめリソース . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 428スケジュール済みおすすめ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 428Scheduled Recommendation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 432

Subscriptions リソース . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 436Topics リソース . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 437

List of Topics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 438Topics Suggestions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 440Trending Topics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 441Topic . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 443Topics, Endorse People . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 445Topic Endorsements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 446Topic Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 447Topic Groups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 449Topics, Knowledgeable People List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 449Related Topics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 450Topics, Opt Outs from Knowledgeable People List . . . . . . . . . . . . . . . . . . . . . . . . . . 450Topics, Opt Out from Knowledgeable People List . . . . . . . . . . . . . . . . . . . . . . . . . . . 451

User Profiles リソース . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 451Users リソース . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 452

User Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 455User Profile Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 456Batch User Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 458User Conversations, General . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 458User Conversations, Specific . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 460Change Status of Conversations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 461Get Unread Count for Conversations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 462Users Files, General . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 462User Files, Filtered by Group . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 467User Files, Filtered by Sharing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 467User Followers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 468Following . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 469User Groups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 471Topics a User is Knowledgeable About . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 472

目次

User Messages, General . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 473User Messages, Specific . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 481User Photo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 481User Recommendations, General . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 484User Recommendations for a Specific Action . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 486User Recommendations for a Specific Action and Object Category . . . . . . . . . . . . . . . 488User Recommendations for a Specific Action and Key Prefix . . . . . . . . . . . . . . . . . . . 492User Recommendations for a Specific Action and Object ID . . . . . . . . . . . . . . . . . . . . 494User Recommendations for a Specific Action and Object Type . . . . . . . . . . . . . . . . . . 495User Reputation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 496User Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 496User Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 498Topics Recently Used . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 498

Zones リソース . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 499List of Zones . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 499Zone Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 500Zone Search Results . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 500

第 6 章: Chatter REST API リクエストボディ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 502

Action Link Definition Input . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 502Action Link Group Definition Input . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 508Action Link Input . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 512Action Link Template Binding Input . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 512Announcement Input . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 513Associated Actions Capability Input . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 514Async Query Input . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 515Attachment Input: Canvas App . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 516Attachment Input: Existing Content . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 517Attachment Input: Feed Poll . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 518Attachment Input: Link . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 518Attachment Input: New File Upload . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 519Batch Collection Input . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 520Batch Input . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 521Bookmarks Capability Input . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 522Canvas Capability Input . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 523Comment Input . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 524Comment Capabilities Input . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 525Content Capability Input . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 525Datacloud Order Input . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 526Dashboard Component Snapshot Input . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 527Feed Element Capabilities Input . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 528Feed Favorite Input . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 530Feed Item Input . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 531Feed Item Topic Input . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 536

目次

Feed Poll Input . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 536File Input . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 537File Shares Input . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 538Files Connect Field Value Input . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 539Files Connect Item Input . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 539Files Connect Permission Collection Input . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 540Files Connect Permission Input . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 541Folder Input . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 541Folder Item Input . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 542Following Input . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 543Generic Batch Collection Input . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 544Generic Batch Input . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 545Group Chatter Settings Input . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 548Group Information Input . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 548Group Input . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 549Group Member Input . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 550Group Membership Request Update . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 551Group Record Input . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 552Link Capability Input . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 552Managed Topic Input . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 553Managed Topic Position Collection Input . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 554Managed Topic Position Input . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 556Message Body Input . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 557Message Segment Input: Hash Tag . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 558Message Segment Input: Inline Image . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 558Message Segment Input: Link . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 559Message Segment Input: Markup Begin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 559Message Segment Input: Markup End . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 559Message Segment Input: Mention . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 560Message Segment Input: Text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 560Moderation Flag Input . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 561Mute Capability Input . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 561Photo Input . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 562Poll Capability Input . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 563Push Notification Input . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 564Question and Answers Capability Input . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 564Recommendation Audience Input . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 565Recommendation Definition Input . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 567Request Header Input . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 568Scheduled Recommendation Input . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 568Share Input . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 571Topic Assignment Input . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 571Topic Endorsement Input . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 572Topic Input . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 572

目次

Topic Names Input . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 573User Chatter Settings Input . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 573User ID Collection Input . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 574User Input . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 574User Message . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 575User Message Recipient Input . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 576User Message Recipient List Input . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 577User Status Input . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 577User Stream (Conversation) Input . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 577

第 7 章: Chatter REST API レスポンスボディ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 578

Action Link Definition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 578Action Link Diagnostic . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 582Action Link Group Definition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 582Address . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 584Announcement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 585Announcement Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 585Approval Capability . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 586Approval Post Template Field . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 587Article Item . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 587Associated Actions Capability . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 587Async Query . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 588Banner Capability . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 589Batch Result Item . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 590Batch Results . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 591Bookmarks Capability . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 591Case Comment Capability . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 591Canvas Capability . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 592Chatter Activity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 593Chatter Directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 594Chatter Influence . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 594Chatter Likes Capability . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 594ClientInfo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 595Comment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 595Comment Capabilities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 597Comment Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 598Comments Capability . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 598Community . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 599Community Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 600Connect Directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 600Content Capability . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 600Conversation Detail . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 603Conversation Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 603Conversation Summary Collection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 603

目次

Conversation Unread Count . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 604Dashboard Component Snapshot . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 604Dashboard Component Snapshot Capability . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 605Datacloud Company . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 605Datacloud Company Collection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 607Datacloud Contact . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 608Datacloud Contact Collection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 609Datacloud Order . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 610Datacloud Purchase Usage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 610Edit Capability . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 610Email Address . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 611Email Message Capability . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 612Enhanced Link Capability . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 612Error Message . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 613Error with Output . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 613Explanation Details . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 613Explanation Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 615External File Permission Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 617Favorite . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 618Favorites Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 619Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 619Feed . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 621Feed Directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 622Feed Directory Item . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 622Feed Element Capabilities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 625Feed Element Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 628Feed Entity Is Editable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 629Feed Item . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 629Feed Item Attachment: Approval . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 638Feed Item Attachment: Basic Template . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 639Feed Item Attachment: Canvas Template . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 639Feed Item Attachment: Case Comment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 640Feed Item Attachment: Content . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 642Feed Item Attachment: Dashboard . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 644Feed Item Attachment: Email Message . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 645Feed Item Attachment: Link . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 645Feed Item Attachment: Poll . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 646Feed Item Attachment: Record Snapshot . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 646Feed Item Attachment: Tracked Change . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 646Feed Item Body . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 647Feed Item Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 648Feed Item Preamble Message Body . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 649Feed Items Topics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 649Feed Poll Choice . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 649

目次

Feed Tracked Change . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 650File Detail . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 650File Preview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 651File Preview Collection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 651File Preview URL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 652File Share Link . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 652File Shares Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 653File Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 653File Summary Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 658Files Connect Allowed Item Type Collection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 658Files Connect Field Definition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 658Files Connect Item Type Detail . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 659Files Connect Item Type Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 659Files Connect Permission . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 660Files Connect Permission Collection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 660Files Connect Permission Type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 660Files Connect Provider Type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 661Files Connect リポジトリ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 661Files Connect Repository Collection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 662Files Connect Repository Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 663Flat Feed . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 663Flat Feed Item . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 664Folder . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 664Folder Item . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 665Folder Item Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 665Follower Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 666Following Counts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 666Following Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 667Generic Bundle Capability . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 667汎用フィード要素 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 668Group . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 670Group Chatter Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 672Group Detail . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 672Group Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 675Group Member . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 675Group Member Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 675Group Membership Request . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 676Group Membership Request Collection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 677Group Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 677Group Record . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 677Group Record Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 678Icon . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 678Influence Thresholds . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 679Knowledgeable People . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 679

目次

Knowledgeable People Collection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 680Like . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 680Like Message Body . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 681Like Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 681Link Capability . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 682List View Column . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 682List View Definition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 682List View Object . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 683List View Record . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 683List View Sort . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 684Maintenance Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 685Managed Topic . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 686Managed Topic Collection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 687Mention Completion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 687Mention Completion Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 688Mention Validation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 688Mention Validations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 689Message . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 690Message Collection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 691Message Segment: Entity Link . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 691Message Segment: Field Change . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 691Message Segment: Field Change Name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 692Message Segment: Field Change Value . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 693Message Segment: Hashtag . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 693Message Segment: Inline Image . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 694Message Segment: Link . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 694Message Segment: Markup Begin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 695Message Segment: Markup End . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 695Message Segment: Mention . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 696Message Segment: More Changes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 697Message Segment: Resource Link . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 698Message Segment: Text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 698Moderation Capability . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 698Moderation Flags . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 699Motif . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 699Mute Capability . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 701Non-Entity Recommendation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 701Organization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 702Origin Capability . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 702Phone Number . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 702Photo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 703Platform Action . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 704Platform Action Group . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 708Poll Capability . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 709

目次

Question and Answers Capability . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 710Question and Answers Suggestion Collection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 710Recommendation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 711Recommendation Audience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 712Recommendation Audience Collection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 713Recommendation Definition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 713Recommendation Definition Collection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 713Recommendations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 714Recommendations Capability . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 714Recommended Object . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 715Record Field . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 715Record Field: Blank . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 716Record Field: Compound . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 716Record Field: Currency . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 717Record Field: Date . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 718Record Field: Percent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 718Record Field: Picklist . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 719Record Field: Reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 719Record Field: Reference with Date . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 720Record Snapshot Capability . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 720Record Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 721Record Summary List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 721Record View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 722Record View Section . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 723Reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 723Repository Directory Entry Collection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 724Repository File Detail . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 724Repository File Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 724Repository Folder Item . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 725Repository Folder Items Collection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 726Repository Folder Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 726Repository Group Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 727Repository Permission Type Collection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 728Repository User Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 728評価 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 728Reputation Level . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 729Request Header . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 729スケジュール済みおすすめ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 729Scheduled Recommendation Collection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 730Shares . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 731Subscription . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 731Subscription Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 732Time Zone . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 732Topic . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 733

目次

Topic Collection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 733Topic Endorsement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 734Topic Endorsement Collection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 734Topic Images . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 735Topic Opt Out . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 735Topic Opt Out Collection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 736Topic Suggestion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 736Topic Suggestion Collection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 736Topics Capability . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 736Topics People Are Knowledgeable About . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 737Topics People Are Knowledgeable About Collection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 737Tracked Change Bundle Capability . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 738Tracked Changes Capability . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 738Unauthenticated User . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 739User Capabilities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 739User Chatter Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 740User Detail . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 740User Group Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 743User Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 744User Profile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 744User Profile Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 744User Reference Collection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 745User Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 745User Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 747User Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 747Zone . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 750Zone Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 750Zone Search Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 751Zone Search Result . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 751

第 8 章: Chatter REST API の付録 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 753

アクションリンクの表示ラベル . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 753

目次

第 1 章 Chatter REST API の概要

エディション

使用可能なエディション:Salesforce Classic

使用可能なエディション:Personal Edition を除くすべてのエディション。さらに、一部の機能では、組織で Chatter が有効になっている必要があります。

特にモバイルアプリケーションで、Salesforceデータを表示するには、Chatter REST API を使用します。Chatter

REST API 応答は、表示用にローカライズおよび構造化されます。アプリケーションに必要な応答のみが含まれるように、応答を絞り込むことができます。また、Chatterフィード、ユーザ、グループ、フォロワーに加え、Chatter REST APIでは、ファイル、おすすめ情報、トピック、通知、Data.com の購入などにプログラムを介してアクセスすることもできます。Chatter REST APIは、Facebook や Twitter などのフィードを提供する他の企業から公開されている API に似ていますが、Chatter 以外の Salesforce 機能も公開されます。

トピック:

• Chatter REST API を使用するケースの決定

• Chatter REST APIアーキテクチャ

• Chatter REST APIレート制限

• Chatter REST API リソース URL の作成

• HTTP 要求の送信• Chatter REST API 要

求および応答について

• Chatter REST API 入力の使用

• ワイルドカード• 応答サイズの指定• レスポンスボディ

の符号化• 状況コードとエ

ラー応答• OAuth と Chatter

REST API について• CORS を使用した

Chatter REST API および REST API へのアクセス

1

Chatter REST API を使用するケースの決定

次の場合は、Chatter REST API を使用してください。• モバイルアプリケーションを作成する。• サードパーティ製 Web アプリケーションを Salesforce と統合して、ユーザのグループに行動について通知す

る。• ユーザが認証された後、フィードをイントラネットサイトなどの外部システムに表示する。• フィードをサードパーティサイトに統合して利用可能にする。たとえば、投稿に #tweet ハッシュタグが含

まれる場合は常に Chatter 項目を Twitter に投稿するアプリケーションなどがあります。• Chatter と連動し、フィード上で通知を行える簡単なゲームを作成する。• 組織のブランド情報を含むカスタムの Chatter 用スキンを作成する。

Chatter REST API と他の Salesforce API との違いChatter REST API と REST API では、次のような違いがあります。• Web サイトとモバイルデバイスで表示するように、データが構造化される。• 返された情報がユーザのタイムゾーンと言語にローカライズされる。• フィードで追跡されている変更値は、値ペア表現で返される。• Chatter REST API のレート制限は、ユーザ、アプリケーション、および時間ごとです。SOAP API および REST API

のレート制限は、組織ごとです。必要に応じて、REST API から ID を抽出し、それを Chatter REST API への要求で使用します。

Chatter in ApexConnectApi 名前空間の Apex クラスでは多くの Chatter REST API リソースアクションが静的メソッドとして公開されています。この名前空間は、Chatter in Apex とも呼ばれます。Chatter in Apex は、Apex からの HTTP コールアウトを使用せずに Force.com プラットフォームで Chatter アプリケーションを開発するために使用します。Chatter in Apex についてのドキュメントは、『Apex コード開発者ガイド』を参照してください。

関連トピック:

Chatter REST API レート制限

Chatter REST API アーキテクチャ

Chatter REST API を使用するには、認証方法やサポートされるデータ形式など、そのアーキテクチャの特性をいくつか理解する必要があります。認証

Chatter REST API は OAuth 2.0 を使用します。

メモ: Salesforce には、HTTPS を使用してセキュアにアクセスします。

2

Chatter REST API を使用するケースの決定Chatter REST API の概要

http://tools.ietf.org/html/draft-ietf-oauth-v2-10

CORS (クロスオリジンリソーススクリプティング)

Chatter REST APIおよび REST APIでは、CORS (クロスオリジンリソース共有) がサポートされます。Web ブラウザで JavaScript からこれらの API にアクセスするには、スクリプトを提供するオリジンを CORS ホワイトリストに追加します。「CORS を使用した Chatter REST API および REST API へのアクセス」を参照してください。

デフォルトの HTML エンティティ符号化Chatter REST API 応答は、デフォルトでは最小限に符号化された HTML エンティティになります。ネイティブのモバイルアプリケーションなど、非 HTML コンテキストの場合、Chatter REST API クライアントは、未加工 (符号化されていない) の出力を要求できます。要求の X-Chatter-Entity-Encoding HTTP ヘッダーを false に設定します。詳細は、「レスポンスボディの符号化」 (ページ 28) を参照してください。

JSON と XML のサポートJavaScript Object Notation (JSON) 形式は UTF-8 でサポートされます。日時情報は ISO8601 形式です。XML 逐次化は SOAP API と類似しています。XML 要求は UTF-8 および UTF-16 でサポートされ、XML 応答は UTF-8

で提供されます。デフォルトでは、応答は JSON 形式です。XML を指定するには、HTTP ヘッダー Accept: application/xml

を使用します (JSON を指定するには、Accept: application/json を使用します)。戻り値の形式を指定するには、.json または .xml のいずれかをリソースの URI に付加します。たとえば、/chatter/feeds/filter/me/001/feed-elements.xml です。

メモ: すべての機能が XML をサポートしているわけではありません。

ローカライズされた名前と時刻Chatter REST API は、名前と日時の両方をユーザのロケール設定にローカライズします。ユーザは、個人情報にロケールを設定します。ユーザがロケールを設定していない場合、Chatter REST API は組織のデフォルトのロケールを使用します。クライアントは、組織で使用できる任意のロケールを使用して、デフォルトのロケールを上書きできます。任意の API 要求のロケールを上書きするには、Accept-Language HTTP ヘッダーを使用します。

メモ: ISO-8601 の日付形式は常に GMT です。

Salesforce ID の長さレスポンスボディでの Salesforce ID は常に 18 文字です。リクエストボディでは、15 文字または 18 文字の ID

を使用できます。UI のテーマ

クライアントは、X-Connect-Theme HTTP ヘッダーを使用して任意の API 要求の UI テーマを指定できます。2 つのテーマがあり、各テーマには独自の motif アイコンのセット、Classic と Salesforce1 があります。テーマ名では、大文字と小文字が区別されます。

メソッドの上書き使用する HTTP ライブラリで任意の HTTP メソッド名の上書きまたは設定が許可されていない場合に HTTP メソッドを上書きするには、要求パラメータ _HttpMethod を使用します。POST https://instance_name/services/data/v35.0/chatter//chatter/users/me/conversations/03MD0000000008KMAQ?_HttpMethod=PATCH&read=true

3

Chatter REST API アーキテクチャChatter REST API の概要

http://www.iso.org/iso/catalogue_detail?csnumber=40874

メモ: _HttpMethodパラメータでは、大文字と小文字が区別されます。すべての値で大文字と小文字を正しく区別してください。

Chatter REST API レート制限

Chatter REST API要求はレート制限の対象になります。Chatter REST APIには、他の Salesforce API とは異なるレート制限があります。Chatter REST API には、ユーザ、アプリケーション、および時間ごとのレート制限があります。レート制限を超過すると、すべての Chatter REST API リソースが 503 Service Unavailable エラーコードを返します。

メモ: 負荷、パフォーマンスやその他のシステムの問題によっては、その制限に達する前に使用できなくなる場合があります。制限は、通知なく変更される場合があります。アプリケーションは、使用可能な要求を効率よく利用し、503 エラーコードを適切に処理する必要があります。

Force.com のセッション ID を使用するアプリケーションの場合、レート制限はユーザごとおよび時間ごとになり、アプリケーションの個別のバケットはありません。セッション ID を使用してアクセスするすべてのアプリケーションでは、この一般割り当て数が使用されます。ユーザ、アプリケーション、時間ごとの制限を利用するには、OAuth トークンを使用します。レート制限に達しないアプリケーションを作成するには、次のガイドラインを使用してください。• テストの実行時に制限に達する場合は、複数のユーザを使用して実際のシナリオをシミュレーションしま

す。• フィードの更新をポーリングする場合、1 分間に 1 回 (1 時間に 60 回) を超えるポーリングを行わないでくだ

さい。1 回の要求でより多くの結果を返すには、ページサイズを増やします。• 非公開メッセージをポーリングする場合、1 時間に 60 回を超えるポーリングを行わないでください。• 複数の要求を回避するには、ファイルやダッシュボードの変換など、制限された静的アセットをキャッシュ

します (グループプロファイルおよびユーザプロファイルの写真は制限されません)。• チームの各開発者は、2 つの接続アプリケーション (1 つは自動テスト用、もう 1 つは手動テストと開発用)

を設定する必要があります。接続アプリケーションを他の開発者と共有しないでください。• 本番環境には固有の接続アプリケーションを使用します。• アプリケーション間で接続アプリケーションを共有しないでください。

重要: データを抽出するには、REST API または SOAP API を使用して sObject を操作します。Chatter REST API を使用して、データを抽出しないでください。

REST API のレート制限とクエリ言語は、次の使用事例に適しています。• システム間でユーザプロファイルを移行または同期する。• 分析アプリケーションを作成する。• レコードおよび項目を返すクエリを記述する。

関連トピック:

Chatter REST API を使用するケースの決定

4

Chatter REST API レート制限Chatter REST API の概要

Chatter REST API リソース URL の作成

すべてのChatter REST APIリソースへのアクセスには、会社のインスタンスの URI に、バージョンとコミュニティ情報、およびリソースの URI を組み合わせて使用します。たとえば、次のようなインスタンスがある場合に、コミュニティを含まない URL を作成するとします。https://na1.salesforce.com

バージョン情報:

/services/data/v35.0

リソース:

/chatter/feeds/news/me/feed-elements

これらを組み合わせると完全な URL は次のようになります。https://na1.salesforce.com/services/data/v35.0/chatter/feeds/news/me/feed-elements

コミュニティの一部であるリソースにアクセスするには、バージョン情報の後、リソースの前に次のように指定します。/connect/communities/communityId

たとえば、コミュニティの News Feed リソースにアクセスする完全な URL は次のようになります。https://na1.salesforce.com/services/data/v35.0/connect/communities/communityId/chatter/feeds/news/me/feed-elements

デフォルトのコミュニティのリソースにアクセスするには、internalショートカットをコミュニティ ID として使用します。/connect/communities/internal

internalショートカットは、コミュニティが有効になっていない場合でも使用できます。複数の組織向けにアプリケーションを開発しており、コミュニティを使用しない組織がある場合に、このショートカットを使用できます。レスポンスボディの URL には、/connect/communities/internal が含まれます。この形式を使用すると、コミュニティの参照時に文字列の補間を実行できます。デフォルトのコミュニティのリソースにアクセスする場合は、/chatter リソース(/connect/communities/internal なし) を直接使用することもできます。レスポンスボディの URL には、/connect/communities/internal は含まれません。さらに、組織のコミュニティのカスタム URL を使用して、コミュニティ内のリソースにアクセスすることも可能です。次に例を示します。https://communitydomain.force.com/communitypath/services/data/v35.0/connect/communities/communityId/chatter/feeds/news/me/feed-elements

5

Chatter REST API リソース URL の作成Chatter REST API の概要

HTTP 要求の送信

Chatter REST APIは HTTP メソッドを使用して JSON および XML コンテンツを送受信します。そのため、自分で選んだツールや言語を使用してクライアントアプリケーションを非常に簡単に構築することができます。Chatter REST API リソースへの HTTP 要求には、次の情報が含まれます。• HTTP メソッド (GET、POST、PATCH、または DELETE)。• 要求の認証に使用される OAuth 2.0 アクセストークン。トークンの取得方法については、「Chatter REST API ク

イックスタート」を参照してください。• Chatter REST API リソース URL。• レコードを更新するための情報など、要求に必要な情報が含まれる要求パラメータまたはリクエストボ

ディ。リクエストボディには、JSON または XML を含めることができます。リソース固有の要求パラメータとリクエストボディを渡すと、要求パラメータが無視されます。リソースに固有でない要求パラメータ (ベアラートークン URL 内のパラメータや _HttpMethod パラメータなど) はリクエストボディと共に処理されます。ベアラートークンパラメータはそのまま使用します。パラメータの追加や削除はしないでください。

HTTP メソッドは、情報の取得や、レコードの作成、更新、削除など、目的のアクションを示すために使用されます。• GET は、基本リソースサマリー情報など、情報の取得に使用されます。• POST は、新しい項目 (フィード項目、コメント、いいね! など) の作成やグループへの登録に使用されます。• PATCH は、ファイルの名前変更など、項目の部分的な更新に使用されます。• PUT は、会話を既読とマークする場合など、項目の全体的な更新に使用されます。• DELETE は、フィード要素などの項目の削除、またはグループからの登録解除に使用されます。• HEAD は、リソースメタデータの取得に使用されます。使用方法は GET と似ていますが、レスポンスボディ

を返しません。HEAD は、リソースが使用可能かどうかのテストに使用できます。

Chatter REST API 要求および応答について

Chatter REST API を使用するための一般的なプロセスフローは次のようになります。1. HTTP 要求を Salesforce に送信します。2. システムがユーザとクライアントアプリケーションを認証します。3. HTTP 要求を使用して Chatter REST API リソースを要求します。4. システムが HTTP 戻りコードを返します。追加の情報 (Chatter REST APIレスポンスボディなど) は、必要に応じ

て応答に含まれます。Chatter REST APIの各リソースは、HTTP メソッド (GET、POST、DELETE、HEAD など) で使用される URI です。各リソースは、ユーザのニュースフィードや投稿へのコメントなど、Chatter 内のものを表します。

6

HTTP 要求の送信Chatter REST API の概要

リソースの多くは、指定されたユーザ ID またはキーワード meを使用して現在のコンテキストユーザを示します。たとえば、現在のコンテキストユーザのユーザプロファイル情報を返すには、次のリソースを使用します。/chatter/users/me

ユーザ ID で特定のユーザを指定することもできます。/chatter/users/005D0000001GLoh

正常にリソースにアクセスすると、JSON または XML でレスポンスボディが返されます。デフォルトでは、JSON

が返されます。各レスポンスボディに 1 つ以上のレスポンスボディ項目が含まれます。たとえば、上記のリソース (Users) にアクセスすると、次のようなレスポンスボディが返されます。これには、住所 (address)、現在の状況 (currentStatus)、電話番号 (phoneNumbers) など、他のレスポンスボディも含まれています。

使用可能なバージョン

検索条件グループとバージョン

説明型プロパティ

23.0Big、29.0ユーザのプロファイルから取得したテキストStringaboutMe

30.0Small、30.0ユーザの追加表示ラベル。たとえば、「顧客」、「パートナー」、「Acme Corporation」

StringadditionalLabel

などがあります。ユーザに追加表示ラベルがない場合、値は null です。

23.0Big、29.0住所Addressaddress

23.0Big、29.0Chatter 活動統計Chatter ActivitychatterActivity

23.0Big、29.0ユーザの影響度ランクChatter InfluencechatterInfluence

32.0Medium、32.0コミュニティでのユーザのニックネームStringcommunityNickname

23.0Small、29.0会社名StringcompanyName

23.0 ～ 25.0User StatuscurrentStatusメモ: このプロパティは、バージョン25.0 以降、使用できなくなります。

ユーザの現在の状況32.0Small、32.0コミュニティで表示されるユーザの名前。

ニックネームが有効な場合は、ニックネームStringdisplayName

が表示されます。ニックネームが有効ではない場合は、氏名が表示されます。

23.0Medium、29.0ユーザのメールアドレスStringemail

23.0Small、29.0ユーザの名StringfirstName

23.0Big、29.0このユーザをフォローしているユーザの数IntegerfollowersCount

23.0Big、29.0ユーザがフォローしている項目に関する情報Following CountsfollowingCounts

7

Chatter REST API 要求および応答についてChatter REST API の概要




23.0Big、29.0ユーザがフォローしているグループの数IntegergroupCount

31.0Small、31.0ユーザに Chatter へのアクセス権がある場合は true、それ以外の場合は false

BooleanhasChatter

23.0Small、29.0ユーザの 18 文字の IDStringid

23.0Small、29.0ユーザが有効な場合は true、それ以外の場合は false

BooleanisActive

23.0 ～ 25.0BooleanisChatterGuestメモ: このプロパティは、バージョン26.0 以降、使用できなくなります。代わりに、userType プロパティを使用してください。

ユーザがChatter顧客の場合は true、それ以外の場合は false

28.0Small、29.0ユーザがコンテキストユーザと同じコミュニティに含まれる場合は true、それ以外の場

BooleanisInThisCommunity

合は false。範囲が「すべてのユーザ」の投稿に対するレコードフィードの @メンションの場合、false になることがあります。

23.0Small、29.0ユーザの姓StringlastName

23.0Big、29.0ユーザのマネージャの 18 文字の IDStringmanagerId

23.0Big、29.0ロケールに基づいて連結されたマネージャの姓と名

StringmanagerName

27.0Small、29.0オブジェクトがユーザであることを示す小、中、大のアイコン。motif にはオブジェクトのベース色を含めることもできます。motif アイコンは、ユーザのプロファイル写真ではありません。

Motifmotif

23.0Medium、29.0コンテキストユーザがこのユーザをフォローしている場合は、登録に関する情報が含まれ

ReferencemySubscription

ます。それ以外の場合は、null を返します。

23.0Small、29.0ロケールに基づいて連結されたユーザの姓と名

Stringname

23.0Big、29.0ユーザの電話番号のコレクションPhone Number[]phoneNumbers

8





23.0Small、29.0ユーザの写真に関する情報Photophoto

32.0Big、32.0コミュニティでのユーザの評価。コミュニティで実行したイベントやアクションを基に獲得したポイント数によって判断されます。

評価reputation

29.0Big、29.0ユーザが受け取った感謝の数。IntegerthanksReceived

23.0Small、29.0ユーザの役職Stringtitle

23.0Small、29.0UserStringtype

23.0Small、29.0ユーザの Chatter プロファイルへの URLStringurl

24.0Small、29.0ユーザのユーザ名 ([email protected]

など)

Stringusername

26.0Medium、29.0ユーザの種別を指定します。有効な値は、次のとおりです。

StringuserType

• ChatterGuest — 非公開グループの外部ユーザ。

• ChatterOnly — Chatter Free ユーザ。• Guest — 認証されていないユーザ。• Internal — 標準組織メンバー。• Portal — カスタマーポータル、パート

ナーポータル、またはコミュニティの外部ユーザ。

• System — Chatter Expert またはシステムユーザ。

• Undefined — カスタムオブジェクトのユーザ種別

JSON 形式では、出力は次のようになります。{

"aboutMe": "I'm excited to be part of the team focused on building out our appsbusinessand showing our customers their future.","additionalLabel" : null,"address": {

"city": "Seattle","country": "US","state": "WA","street": "2001 8th Ave",

9


"zip": "98121""formattedAdress": "2001 8th Ave\nSeattle, WA 98121\nUS"

},"chatterActivity": {

"commentCount": 0,"commentReceivedCount": 1,"likeReceivedCount": 0,"postCount": 2

},"chatterInfluence" : {"percentile" : "0.6666666666666667","rank" : 1

},"communityNickname": "marRave","companyName": "Seattle Apps","displayName": "Marion Raven","email": "[email protected]","firstName": "Marion","followersCount": 1,"followingCounts": {

"people": 5,"records": 0,"total": 5

},"groupCount": 3,"hasChatter": true,"id": "005D0000001Kl6xIAC","isActive": true,"isInThisCommunity" : true,"lastName": "Raven","managerId": null,"managerName": null,"motif": {

"color" : "20aeb8","largeIconUrl": "/img/icon/profile64.png","mediumIconUrl": "/img/icon/profile32.png","smallIconUrl": "/img/icon/profile16.png"

},"mySubscription": null,"name": "Marion Raven","phoneNumbers": [{

"label": "Work","phoneNumber": "(206) 999-2846","phoneType": "Work"

}],"photo": {

"fullEmailPhotoUrl":"https://instance_name/ncsphoto/SqRfG_-PUTY6KtfOp_f0cGW2pGjfqoWUUgTENHjVyS1i9x6Z16L8wXEGigpcWjAd",

"largePhotoUrl": "https://instance_name/profilephoto/729D00000000BDV/F","photoVersionId": "729D00000000BDV","smallPhotoUrl": "https://instance_name/profilephoto/729D00000000BDV/T","standardEmailPhotoUrl":

"https://instance_name/ncsphoto/SqRfG_-PUTY6KtfOp_f0cGW2pGjfqoWUUgTENHjVyS1q43x_rW2ciXBHst0Eh3Y6",

10


"url": "/services/data/v35.0/chatter/users/005D0000001LL8OIAW/photo"},"reputation" : null,"thanksReceived" : null,"title": null,"type": "User","url": "/services/data/v35.0/chatter/users/005D0000001Kl6xIAC","userType": "Internal";"username": "[email protected]"

}

メモ: Salesforce は複数のサーバインスタンス上で実行されます。このガイドの例は、instance_name を使用してインスタンスを示します。組織のインスタンスは、na1.salesforce.com またはna6.mycompany.com と類似している場合があります。レスポンスボディ内の項目には完全修飾 URL を持つものもありますが、ほとんどは相対 URL が返されます。相対 URL の場合は、項目が認証されたときにクライアントアプリケーションに与えられるインスタンスを先頭に付加します。

Chatter REST API 入力の使用

入力での POST、PATCH、または PUT の使用HTTP POST、PATCH、および PUT メソッドを使用して要求を行うとき、要求パラメータまたはリクエストボディを使用できます。リクエストボディには、JSON または XML を含めることができます。リソース固有の要求パラメータとリクエストボディを渡すと、要求パラメータが無視されます。リソースに固有でない要求パラメータ (ベアラートークン URL 内のパラメータや _HttpMethod パラメータなど) はリクエストボディと共に処理されます。ベアラートークンパラメータはそのまま使用します。パラメータの追加や削除はしないでください。要求パラメータを使用して要求を送信するには、値 application/x-www-form-urlencoded を指定したContent-Type ヘッダー項目を使用します。リクエストボディを使用して要求を送信するには、Content-Type ヘッダー項目と Accept ヘッダー項目に次のいずれかの値を使用します。• application/json

• application/xml

バイナリファイルのアップロード最大 2 GB (ヘッダーを含める) のバイナリファイルをアップロードするには、マルチパート/フォームデータ要求のボディパートとして送信する必要があります。投稿またはコメントのテキストのような情報を、同じマルチパート/フォームデータ要求の JSON または XML リッチ入力ボディパートとして送信できます。または、その情報を要求パラメータで送信するように選択することもできます。リッチ入力リクエストボディと要求パラメータの両方を渡すと、要求パラメータは無視されます。

11

Chatter REST API 入力の使用Chatter REST API の概要

マルチパート/フォームデータ要求を作成するには、要求のヘッダーで Content-Type HTTP ヘッダーをmultipart/form-data に設定します。HTTP ヘッダーについての詳細は、W3C フォームコンテンツタイプと、マルチパート/フォームデータインターネットメディアタイプが定義されている RFC 2388 を参照してください。次の表では、マルチパート/フォームデータ要求のリッチ入力ボディパートに必要な HTTP ヘッダーとパラメータを説明します。

説明ヘッダー値とパラメータリッチ入力ボディパートの HTTP ヘッダー

投稿またはコメントのリクエストボディ。JSON の場合は、nameの値に "json"を使用します。

form-data; name="json"

form-data; name="xml"

Content-Disposition

XML の場合は、nameの値に "xml"を使用します。

リクエストボディのデータ形式と文字セット。JSON の場合、値は application/jsonにする必要があります。

application/json; charset=UTF-8

application/xml; charset=UTF-8

Content-Type

XML の場合、値は application/xml にする必要があります。

ヒント: Web ブラウザは通常、非バイナリパート (リッチ入力ボディなど) に独自の Content-Type があると、マルチパートの要求を実行することができません。この問題を回避するには、特定のContent-Disposition name を指定して、Salesforce がリッチ入力パートの Content-Type を読み取れるようにします (リッチ入力ボディに Content-Type を指定する必要はありません)。

次の表では、Web ブラウザからのマルチパート/フォームデータ要求のリッチ入力ボディパートに必要な HTTP

ヘッダーとパラメータについて説明します。

説明ヘッダー値とパラメータWeb ブラウザからのリッチ入力ボディパートのHTTP ヘッダー

バイナリファイルを含むフィード要素を投稿するには、name の値を"feedElement"にする必要があります。バイナリファイルを含むコメントを投稿するには、name の値を "comment" にする必要があります。

form-data; name="feedElement"

form-data; name="comment"

form-data; name="photo"

form-data; name="file"

Content-Disposition

12


http://www.w3.org/TR/html401/interact/forms.html#h-17.13.4.2

http://tools.ietf.org/html/rfc2388

説明ヘッダー値とパラメータWeb ブラウザからのリッチ入力ボディパートのHTTP ヘッダー

ユーザまたはグループの写真を投稿するには、name の値を "photo" にする必要があります。[ファイル] リストにファイルを投稿するには、nameの値を "file"にする必要があります。

次の表では、マルチパート/フォームデータ要求のバイナリアップロードボディパートに必要な HTTP ヘッダーとパラメータを説明します。

説明ヘッダー値とパラメータバイナリアップロードボディパートの HTTP ヘッダー

バイナリ添付ファイルを含むフィード要素を投稿するには、name の値を

form-data;name="feedElementFileUpload";filename=string

form-data;name=name="feedElementFileUpload";filename=string

Content-Disposition

"feedElementFileUpload"にする必要があります。バイナリファイルを含むコメントを投稿するには、name の値を

form-data; name="fileUpload"filename=string

"feedElementFileUpload"にする必要があります。

form-data; name="fileData"filename=string

ユーザまたはグループの写真を投稿するには、name の値を "fileUpload" にする必要があります。[ファイル] リストにファイルを投稿するには、nameの値を "fileData"にする必要があります。

メモ: filename パラメータと値を指定する必要があります。ただし、Chatter は、Content Capability Input のtitleプロパティの値を filename

パラメータの値ではなく、ファイル名として使用します。

バイナリファイルのメディアタイプと文字セット。

application/octet-stream;charset=ISO-8859-1

Content-Type

13


メモ: 空白と改行 (CRLF) は重要です。たとえば、次の行では空白が必要です: Content-Disposition:

form-data; name="feedItemFileUpload"; title="2012_q1_review.ppt"。空白ではなく CRLF を使用すると、エラーが返されます。

バイナリファイルを含むフィード要素の投稿次の例では、/chatter/feed-elementsリソースを使用して新しいフィード項目 (フィード要素の種類の1 つ) を投稿し、バイナリファイルをアップロードして新しいフィード項目に添付します。次の例では cURL

を使用します。curl -H "X-PrettyPrint: 1" -F 'json={ "body":{ "messageSegments":[ { "type":"Text","text":"Please accept this receipt." } ] },"capabilities":{ "content":{ "description":"Receipt for expenses", "title":"receipt.pdf"} }, "feedElementType":"FeedItem", "subjectId":"005RR000000DmOb" };type=application/json' -F"[email protected];type=application/octet-stream"-X POST https://instance_name/services/data/v35.0/chatter/feed-elements-H 'Authorization: OAuth 00DRR0000000N0g!...' --insecure

以下に、上記の例を、リクエストボディパートが確認できる形式に変えた例を示します。POST /services/data/v35.0/chatter/feed-elements HTTP/1.1Authorization: OAuth 00DRR0000000N0g!...User-Agent: Jakarta Commons-HttpClient/3.0.1Host: instance_nameContent-Length: 845Content-Type: multipart/form-data; boundary=a7V4kRcFA8E79pivMuV2tukQ85cmNKeoEgJgqAccept: application/json

--a7V4kRcFA8E79pivMuV2tukQ85cmNKeoEgJgqContent-Disposition: form-data; name="json"Content-Type: application/json; charset=UTF-8

{"body":{

"messageSegments":[{

"type":"Text","text":"Please accept this receipt."

}]

},"capabilities":{

"content":{"description":"Receipt for expenses","title":"receipt.pdf"

}},"feedElementType":"FeedItem","subjectId":"005RR000000DmOb"

}

--a7V4kRcFA8E79pivMuV2tukQ85cmNKeoEgJgqContent-Disposition: form-data; name="feedElementFileUpload"; filename="receipt.pdf"Content-Type: application/octet-stream; charset=ISO-8859-1

14


...contents of receipt.pdf...

--a7V4kRcFA8E79pivMuV2tukQ85cmNKeoEgJgq--

バイナリファイルを含むフィード要素の一括投稿次の例では、/chatter/feed-elements/batchリソースを使用してフィード要素を一括投稿し、2 つのバイナリファイルをアップロードして、バッチ内のフィード要素に添付します。リクエストボディにはバイナリパートに関する情報を含める必要があります。次の例では cURL を使用します。curl -H "X-PrettyPrint: 1" -F 'json={"inputs":[{"binaryPartNames":["bin1"],"richInput":{"subjectId":"me","body":{"messageSegments":[{"type":"Text","text":"Please accept this receipt"}]},"capabilities":{"content" : {"description": "Receipt for expenses","title":"receipt.pdf"}},"feedElementType":"FeedItem"}},{"binaryPartNames":["bin2"],"richInput":{"subjectId":"me","body":{"messageSegments":[{"type":"Text","text":"PostNumber 2"}]},"capabilities": {"content" : {"description": "Receipt for expenses","title":"receipt2.pdf"}},"feedElementType":"FeedItem"}}]};type=application/json'-F "bin1=@/Users/jsmith/Desktop/receipt.pdf;type=application/octet-stream" -F"bin2=@/Users/jsmith/Desktop/receipt2.pdf;type=application/octet-stream"-X POST https://instance_name/services/data/v35.0/chatter/feed-elements/batch-H 'Authorization: OAuth 00DD00000007HoR44QATPNzhzYEJBfU' --insecure

以下に、上記の例を、リクエストボディパートが確認できる形式に変えた例を示します。POST /services/data/v35.0/chatter/feed-elements/batch HTTP/1.1Authorization: OAuth 00DRR0000000N0g!...User-Agent: Jakarta Commons-HttpClient/3.0.1Host: instance_nameContent-Length: 845Content-Type: multipart/form-data; boundary=a7V4kRcFA8E79pivMuV2tukQ85cmNKeoEgJgqAccept: application/json


{"inputs": [{"binaryPartNames": ["bin1"

],"richInput": {"subjectId": "me","body": {"messageSegments": [{"type": "Text","text": "Please accept this receipt"

}]

},

15


"capabilities": {"content": {"description": "Receipt for expenses","title": "receipt.pdf"

}},"feedElementType": "FeedItem"

}},{"binaryPartNames": ["bin2"

],"richInput": {"subjectId": "me","body": {"messageSegments": [{"type": "Text","text": "Post Number 2"

}]

},"capabilities": {"content": {"description": "Receipt for expenses","title": "receipt2.pdf"


}}

]}

--a7V4kRcFA8E79pivMuV2tukQ85cmNKeoEgJgqContent-Disposition: form-data; name="bin1"; filename="receipt.pdf"Content-Type: application/octet-stream; charset=ISO-8859-1


--a7V4kRcFA8E79pivMuV2tukQ85cmNKeoEgJgqContent-Disposition: form-data; name="bin2"; filename="receipt2.pdf"Content-Type: application/octet-stream; charset=ISO-8859-1

...contents of receipt2.pdf...


メモ: binaryPartNamesプロパティ内のバイナリパート名は、バイナリリクエストパートの nameプロパティ内のバイナリパート名と一致する必要があります。

16


バイナリファイルを含むコメントの投稿次の例では、cURL を使用してフィード項目にコメントを投稿し、バイナリ添付ファイルをアップロードします。curl -H "X-PrettyPrint: 1" -F 'json={ "body":{ "messageSegments":[ { "type":"Text","text":"Here's another receipt." } ] }, "capabilities":{ "content":{ "title":"receipt2"} } };type=application/json' -F"[email protected];type=application/octet-stream"-X POSThttps://instance_name/services/data/v35.0/chatter/feed-elements/0D5RR0000004Grx/capabilities/comments/items

-H 'Authorization: OAuth 00DRR0000000N0g!ARoAQB...' --insecure

以下に、上記の例を、リクエストボディパートが確認できる形式に変えた例を示します。POST/services/data/v35.0/chatter/feed-elements/0D5RR0000004Grx/capabilities/comments/itemsHTTP/1.1

Authorization: OAuth00DD0000000Jhd2!AQIAQC.lh4qTQcBhOPm4TZom5IaOOZLVPVK4wI_rPYJvmE8r2VW8XA.OZ7S29JEM_7Ctq1lst2dzoV.owisJc0KacUbDxyaeAccept: application/jsonUser-Agent: Jakarta Commons-HttpClient/3.0.1Host: instance_nameContent-Length: 978Content-Type: multipart/form-data; boundary=F9jBDELnfBLAVmLNbnLIYibT5Icp0h3VJ7mkI

--F9jBDELnfBLAVmLNbnLIYibT5Icp0h3VJ7mkIContent-Disposition: form-data; name="json"Content-Type: application/json; charset=UTF-8

{"body":{


"type":"Text","text":"Here's another receipt."

}]

},"capabilities":{

"content":{"title":"receipt2"

}}

}

--F9jBDELnfBLAVmLNbnLIYibT5Icp0h3VJ7mkIContent-Disposition: form-data; name="feedElementFileUpload"; filename="receipt2.txt"Content-Type: application/octet-stream; charset=ISO-8859-1

...contents of receipt2.txt...

17


--F9jBDELnfBLAVmLNbnLIYibT5Icp0h3VJ7mkI--

バイナリファイルを含む複数のコメントの投稿この例は、2 つのサブ要求が含まれる https://instance_name/services/data/v35.0/connect/batch

への汎用バッチ要求です。各サブ要求はフィード項目にコメントし、バイナリファイルをコメントにアップロードします。richInput プロパティには、各サブ要求のリクエストボディを含める必要があります。また、binaryPartName および binaryPartNameAlias プロパティには、バイナリパートに関する情報を含める必要もあります。次に cURL の例を示します。curl -H "X-PrettyPrint: 1" -F 'json={ "haltOnError":true, "batchRequests":[ {"url":"/v33.0/chatter/feed-elements/0D5D0000000YG0N/capabilities/comments/items","method":"Post", "binaryPartName":"binaryPart1","binaryPartNameAlias":"feedElementFileUpload", "richInput":{ "body":{ "messageSegments":[{ "type":"Text", "text":"Check out this file, it may help." } ] },"capabilities":{ "content":{ "title":"Presentation1.txt" } } } }, {"url":"/v33.0/chatter/feed-elements/0D5D0000000YG0M/capabilities/comments/items","method":"Post", "binaryPartName":"binaryPart2","binaryPartNameAlias":"feedElementFileUpload", "richInput":{ "body":{ "messageSegments":[{ "type":"Text", "text":"Check out this file, it may help." } ] },"capabilities":{ "content":{ "title":"Presentation2.txt" } } } } ]};type=application/json' -F"binaryPart1=@/Users/jbleyle/Desktop/Presentation1.txt;type=application/octet-stream"-F "binaryPart2=@/Users/jbleyle/Desktop/Presentation2.txt;type=application/octet-stream"

-X POST https://instance_name/services/data/v35.0/connect/batch-H 'Authorization: OAuth 00DD00000007HoR!...' --insecure

これは、マルチパート/フォームデータリクエストボディです。

https://instance_name/services/data/v35.0/connect/batch

Authorization: OAuth 00DD0000000Jhd2!...Accept: application/jsonHost: instance_nameContent-Type: multipart/form-data; boundary=123123

--123123Content-Disposition: form-data; name="json"Content-Type: application/json

{"haltOnError":true,"batchRequests":[

{"url":"/v35.0/chatter/feed-elements/0D5D0000000YG0D/capabilities/comments/items",

"method":"Post","binaryPartName":"binaryPart1",

18


"binaryPartNameAlias":"feedElementFileUpload","richInput":{

"body":{"messageSegments":[

{"type":"Text","text":"Check out this file, it may help."

}]

},"capabilities":{

"content":{"title":"Presentation1.txt"

}}

}},{"url":"/v35.0/chatter/feed-elements/0D5D0000000YG0H/capabilities/comments/items",

"method":"Post","binaryPartName":"binaryPart2","binaryPartNameAlias":"feedElementFileUpload","richInput":{



}]

},"capabilities":{


}}

}}

]}

--123123Content-Disposition: form-data; name="binaryPart1"; filename="Presentation1.txt"Content-Type: application/octet-stream; charset=ISO-8859-1Content-Transfer-Encoding: binary

This is the content of file 1--123123Content-Disposition: form-data; name="binaryPart2"; filename="Presentation2.txt"Content-Type: application/octet-stream; charset=ISO-8859-1Content-Transfer-Encoding: binary

19


This is the content of file 2--123123--

ユーザの写真の投稿およびトリミング次の例では、cURL を使用してユーザプロファイルの写真をアップロードし、トリミングします。curl -H "X-PrettyPrint: 1" -F 'json={"cropX": "0", "cropY": "0", "cropSize":"200"};type=application/json'-F "[email protected];type=application/octet-stream"-X POST https://instance_name/services/data/v35.0/chatter/users/me/photo-H 'Authorization: OAuth 00DRR0000000N0g!ARoAQFRi_gBqZhajAX22MNuLrrE2Xk...'--insecure

以下に、上記の例を、リクエストボディパートが確認できる形式に変えた例を示します。POST /services/data/v35.0/chatter/users/me/photo HTTP/1.1Authorization: OAuth00DD0000000Jhd2!AQIAQC.lh4qTQcBhOPm4TZom5IaOOZLVPVK4wI_rPYJvmE8r2VW8XA.OZ7S29JEM_7Ctq1lst2dzoV.owisJc0KacUbDxyaeUser-Agent: Jakarta Commons-HttpClient/3.0.1Host: instance_nameContent-Length: 543Content-Type: multipart/form-data; boundary=a7V4kRcFA8E79pivMuV2tukQ85cmNKeoEgJgqAccept: application/json

--a7V4kRcFA8E79pivMuV2tukQ85cmNKeoEgJgqContent-Type: application/json; charset=UTF-8Content-Disposition: form-data; name="json"

{"cropX" : "0","cropY" : "0","cropSize" : "200"

}

--a7V4kRcFA8E79pivMuV2tukQ85cmNKeoEgJgqContent-Disposition: form-data; name="fileUpload"; filename="myPhoto.jpg"Content-Type: application/octet-stream; charset=ISO-8859-1

...contents of myPhoto.jpg...


[ファイル] リストへのファイルの投稿次の例では、cURL を使用してファイルを [ファイル] リストにアップロードします。curl -H "X-PrettyPrint: 1" -F 'json={"title":"BoatPrices"};type=application/json'-F "[email protected];type=application/octet-stream"-X POST https://instance_name/services/data/v35.0/chatter/users/me/files-H 'Authorization: OAuth 00DRR0000000N0g!...' --insecure

以下に、上記の例を、リクエストボディパートが確認できる形式に変えた例を示します。POST /services/data/v35.0/chatter/users/me/files

20


Authorization: OAuth00DD0000000Jhd2!AQIAQC.lh4qTQcBhOPm4TZom5IaOOZLVPVK4wI_rPYJvmE8r2VW8XA.OZ7S29JEM_7Ctq1lst2dzoV.owisJc0KacUbDxyaeUser-Agent: Jakarta Commons-HttpClient/3.0.1Host: instance_nameContent-Length: 489Content-Type: multipart/form-data; boundary=a7V4kRcFA8E79pivMuV2tukQ85cmNKeoEgJgqAccept: application/json


{"title":"BoatPrices"

}

--a7V4kRcFA8E79pivMuV2tukQ85cmNKeoEgJgqContent-Disposition: form-data; name="fileData"; filename="BoatPrices.txt"Content-Type: application/octet-stream; charset=ISO-8859-1

...contents of BoatPrices.txt...


ワイルドカード

Chatter REST API と Chatter in Apex の検索でテキストパターンを一致させるには、ワイルドカード文字を使用します。ワイルドカードが一般的に使用されるのはフィードを検索するときです。qパラメータで検索文字列とワイルドカードを渡します。次の例は、Chatter REST API 要求です。/chatter/feed-elements?q=chat*

次の例は、Chatter in Apex メソッドコールです。ConnectApi.ChatterFeeds.searchFeedElements(null, 'chat*');

検索内のテキストパターンと一致させるために、次のワイルドカード文字を指定できます。

説明ワイルドカード

検索語の途中または末尾で、0 個以上の文字の代わりにアスタリスクを使用できます。たとえば、「太*」を検索すると、「太一」、「太郎」、「太次郎」などの「太」で始まるデータ

*

が表示されます。ただし、中国語、日本語、韓国語、またはタイ語で検索する場合は、検索語の中間にアスタリスクまたは疑問符のワイルドカードは使用できません。単語または語句内のリテラルアスタリスクを検索する場合、アスタリスクをエスケープします ( \ 文字をそれの前に付けます)。

21

ワイルドカードChatter REST API の概要

説明ワイルドカード

疑問符は、検索語の途中または末尾にある 1 つのみの文字の代わりに使用できます。たとえば、「jo?n」を検索すると、「john」や「joan」を含むデータが表示されます。ただし、中国

?

語、日本語、韓国語、またはタイ語で検索する場合は、検索語の中間にアスタリスクまたは疑問符のワイルドカードは使用できません。また、検索キーワードの先頭にワイルドカードの疑問符を使用しても機能しません。ルックアップ検索では ? は使用できません。

ワイルドカードを使用する場合には、以下の点に注意してください。• ワイルドカード検索の条件を絞り込むほど、検索結果はより速く返され、期待する結果が返される可能性

が高まります。たとえば、単語 prospect (または複数形 prospects) のすべての発生を検索するには、無関係の一致 ( prosperity など) を返す可能性のある制限のより少ないワイルドカード検索 (prosp* など)

を指定するよりも、検索文字列内で prospect* を指定する方がより効率的です。• 単語のすべてのバリエーションを見つけるために、検索を調整します。たとえば、propertyとproperties

を見つけるには、propert* を指定します。• 句読点にはインデックスを付けます。語句内で *または ?を見つけるためには、検索文字列を引用符で囲

む必要があり、特殊文字をエスケープする必要があります。たとえば、"where are you\?" は、語句where are you? を見つけます。エスケープ文字 (\) は、この検索が正しく機能するために必要です。

応答サイズの指定

応答サイズを指定するには、filterGroup を要求パラメータとして、またはリクエストボディで使用し、プロパティのグループをサイズで指定します。さらに、excludeや includeを要求パラメータとして、またはリクエストボディで使用し、特定のプロパティを除外したり、含めたりします。アプリケーションに必要なデータのみが返されるようにするには、絞り込み条件を使用します。

このセクションの内容:

filterGroup

要求 URL またはリクエストボディで filterGroup パラメータを使用して、返されるプロパティのグループサイズ (Small、Medium、Big) を指定します。filterGroup プロパティは、API バージョン 29.0 以降で使用できます。exclude

特定のプロパティをレスポンスボディから除外するには、exclude要求パラメータを使用します。exclude

パラメータは、API バージョン 27.0 以降で使用できます。include

レスポンスボディを特定のプロパティに限定するには、includeクエリ文字列パラメータを使用します。

22

応答サイズの指定Chatter REST API の概要

filterGroup要求 URL またはリクエストボディで filterGroup パラメータを使用して、返されるプロパティのグループサイズ (Small、Medium、Big) を指定します。filterGroup プロパティは、API バージョン 29.0 以降で使用できます。

メモ: filterGroup パラメータは、JSON と REST のみでサポートされています。

各レスポンスボディのすべてのプロパティにグループサイズが割り当てられます。• Big — デフォルトのサイズです。レスポンスボディにすべてのプロパティ (Big、Medium、および Small

のマークが付けられたプロパティ) が含まれます。• Medium — Medium および Small のマークが付けられたプロパティが含まれます。• Small — 最小の応答サイズです。Small のマークが付けられたプロパティのみが含まれます。

メモ: サイズの割り当ては、ドキュメントにのみ表示されます。レスポンスボディには表示されません。

要求に filterGroupがある場合、レスポンスボディには、指定されたグループの一部であるプロパティのみが含まれます。検索条件グループの使用について、次の事項を把握している必要があります。• デフォルトの filterGroup サイズは Big です。• プロパティに割り当てられる各検索条件グループサイズには、API バージョンがあります。今後、API バー

ジョンのプロパティは、別の検索条件グループに移動する可能性があります。• 検索条件グループは、DELETE と HEAD を除くすべての HTTP 動詞に影響します。• 特に指定のない限り、バッチ要求のボディ内のサブ要求を含むすべての要求 URL で filterGroupパラメー

タを使用できます。• filterGroup パラメータを include または exclude 条件パラメータと組み合わせて使用し、返される

プロパティのセットを変更できます。結果セットは、2 つのセットの結合です。

filterGroup パラメータと、include または exclude パラメータの併用要求には、filterGroup パラメータ、グループサイズ値、include または exclude 条件パラメータ、URL

の値を含めることができます。これは、汎用バッチ要求のサブ要求にも該当します。要求 (またはサブ要求) に filterGroup と include の両方のパラメータがあると、include パラメータで指定されたプロパティが常に応答に含まれます。要求 (またはサブ要求) に filterGroup と exclude の両方のパラメータがあると、exclude パラメータで指定されたプロパティが常に応答から除外されます。次の表の行を左から右に読んでいき、応答にプロパティが含まれているかどうかを確認します。

応答にプロパティがある

要求のfilterGroup

にプロパティがある

要求にfilterGroup

がある

要求のexclude 条件にプロパティがある

要求にexclude 条件がある

要求のinclude 条件にプロパティがある

要求にinclude 条件がある

いいえいいえいいえいいえいいえいいえはい

23

filterGroupChatter REST API の概要

応答にプロパティがある

要求のfilterGroup

にプロパティがある

要求にfilterGroup

がある

要求のexclude 条件にプロパティがある

要求にexclude 条件がある

要求のinclude 条件にプロパティがある

要求にinclude 条件がある

はいはい/いいえはい/いいえいいえいいえはいはい

はいいいえいいえいいえはいいいえいいえ

いいえいいえはいいいえはいいいえいいえ

いいえはい/いいえはい/いいえはいはいいいえいいえ

いいえいいえはいいいえいいえいいえいいえ

はいはいはいいいえいいえいいえいいえ

エラー (400)はい/いいえはい/いいえはい/いいえはいはい/いいえはい

例この例では、User Profile リソースの Small レスポンスボディを取得します。GET /chatter/users/me?filterGroup=Small

次にレスポンスボディを示します。{

"companyName": "Universal Containers","firstName": "Deanna","hasChatter": true,"id": "005D0000001LL8OIAW","isActive": true,"isInThisCommunity": true,"lastName": "Li","motif": {

"color": "1797C0","largeIconUrl": "/img/icon/profile64.png","mediumIconUrl": "/img/icon/profile32.png","smallIconUrl": "/img/icon/profile16.png"

},"name": "Deanna Li","photo": {

"photoVersionId": "729D00000000LJFIA2","smallPhotoUrl": "https://instance_name/profilephoto/729D00000000LJF/T","standardEmailPhotoUrl": "https://instance_name/ncsphoto/SqRfG_-PUTY6KtfOp_f0cEw-MQI3xmkJ21oNEOQ-5sYVo6fntPnCQ_-xIH-GU3vI","url": "/services/data/v35.0/chatter/users/005D0000001LL8OIAW/photo"

},"title": null,"type": "User","url": "/services/data/v35.0/chatter/users/005D0000001LL8OIAW","username": "[email protected]"

}

24

filterGroupChatter REST API の概要

exclude特定のプロパティをレスポンスボディから除外するには、exclude 要求パラメータを使用します。exclude

パラメータは、API バージョン 27.0 以降で使用できます。exclude クエリの値は、バー (|) で区切られたプロパティのリストです。URL は、バーを %7C として符号化します。各プロパティ名の前にスラッシュを含める必要があります。次の要求は、aboutMe プロパティと address プロパティをレスポンスボディから除外します。/chatter/users/me?exclude=/aboutMe%7C/address

次の表に、exclude クエリパラメータの使用ルールおよびその他の例を示します。

絞り込み後の出力Exclude の値元の出力説明

エラーコードINVALID_FILTER_VALUE の 400

エラー

exclude=bar{"bar" : "bar value","baz" : "baz value"}

プロパティ名の前にスラッシュ (/) を含めないと、要求からエラーが返されます。

{"baz" : "baz

exclude=/bar{"bar" : "bar value",

プロパティを名前で絞り込みます。

value"}

"baz" : "baz value"}

<foo><bar>bar value

exclude=/foo<foo><bar>bar value</bar>

最上位レベルのプロパティは絞り込みできません。こ </bar><baz>baz value</baz>

</foo>のクエリ文字列はエラーを返しません。

<baz>baz value</baz></foo>

{"baz" : "baz

exclude=/foo%7C/bar{"foo" : "foo value",

複数のプロパティを絞り込むには、バー (|) 区切り文字 value"

}"bar" : "bar value","baz" : "baz value"}

を使用します。URL

は、区切り文字を%7C として符号化します。

<foo><bar>bar value

exclude=/someObject<foo><bar>bar value</bar>

レスポンスボディの絞り込みでは、レスポンスボディ </bar><baz>baz value</baz>

内のすべてが絞り込まれます。

<baz>baz value</baz></foo>

<someObject><sub>sub 1</sub>

</someObject></foo>

25

excludeChatter REST API の概要

絞り込み後の出力Exclude の値元の出力説明

<foo><bar>bar value

exclude=/someObject/sub<foo><bar>bar value</bar>

レスポンスボディ内でネストされたプロパティを絞り </bar><baz>baz value</baz>

込むには、親レス <baz>baz value</baz>

<someObject><sub>sub value</sub>ポンスボディの名

<someObject></someObject></foo>前を条件セグメン

トとして含めます。

</someObject></foo>

<foo><bar>bar value

exclude=/someList/item/id<foo><bar>bar valu</bar>

リスト内の項目は、プロパティ名で識別します。こ </bar><baz>baz value</baz>

の例では XML を使用します。

<baz>baz value</baz><someList>

<someList><item><id>1</id>

<item/></item><item/><item><item/><id>2</id>

</someList></foo>

</item><item><id>3</id>

</item></someList></foo>

{"bar" : "bar value",

exclude=/someList/item/id{"bar" : "bar value",

リスト内の項目は、プロパティ名で識別します。こ "baz" : "baz value","baz" : "baz value",

の例では JSON を使用します。

"someList" : [{},{},

"someList" : [{"id" : "1"

{}},]}

{"id" : "2"

} ,{"id" : "3"

}]}

includeレスポンスボディを特定のプロパティに限定するには、include クエリ文字列パラメータを使用します。include クエリ文字列パラメータの値は、バー (|) で区切られたプロパティのリストです。URL は、バーを%7C として符号化します。各プロパティ名の前にスラッシュを含めます。

26

includeChatter REST API の概要

次の要求では、aboutMe プロパティと address プロパティのみがレスポンスボディに含まれます。/chatter/users/me?include=/aboutMe%7C/address

次の表に、include クエリパラメータの使用ルールを示します。

絞り込み後の出力Include の値元の出力説明

エラーコードINVALID_FILTER_VALUE

の 400 エラー

include=bar{"bar" : "bar value","baz" : "baz value"}

プロパティ名の前にスラッシュ (/) を含めないと、要求からエラーが返されます。

{"bar" : "bar

include=/bar{"bar" : "bar value",

プロパティを名前で絞り込みます。

value",}

"baz" : "baz value"}

<foo><bar>bar value

include=/foo<foo><bar>bar value</bar>

最上位レベルのプロパティは無視されます。この操作 </bar><baz>baz value</baz>

</foo>を行っても、エラーにはなりません。

<baz>baz value</baz>

</foo>

{"foo" : "foo

include=/foo%7C/bar{"foo" : "foo value",

複数のプロパティを絞り込むには、バー (|) 区切り文字 value",

"bar" : "bar"bar" : "bar value","baz" : "baz value"}

を使用します。URL

は、区切り文字を%7C として符号化します。

value",}

<foo><someObject>

include=/someObject<foo><bar>bar value</bar>

レスポンスボディの絞り込みでは、その下にあるすべ <sub>sub 1<baz>baz value</baz>

てのものが絞り込まれます。

</sub></someObject>

</foo>

<someObject><sub>sub 1</sub>

</someObject></foo>

<foo><someObject>

include=/someObject/sub<foo><bar>bar value</bar>

レスポンスボディ内でネストされたプロパティを絞り <sub>sub 1<baz>baz value</baz>

込むには、親レス </sub></someObject>

</foo>

<someObject><sub>sub value</sub></someObject>

</foo>

ポンスボディの名前を条件セグメン

27

includeChatter REST API の概要

絞り込み後の出力Include の値元の出力説明

トとして含めます。

<foo><someList>

include=/someList/item/id<foo><bar>bar valu</bar>

リスト内の項目は、プロパティ名で識別します。こ <item><baz>baz value</baz>

の例では XML を使用します。

<id>1</id></item><item>

<someList><item><id>1</id>

<id>2</id></item></item><item><item><id>2</id><id>3</id></item>

</item><item></someList>

</foo><id>3</id>

</item></someList></foo>

{"someList" : [

include=/someList/item/id{"bar" : "bar value",

リスト内の項目は、プロパティ名で識別します。こ {"baz" : "baz value",

の例では JSON を使用します。

"id" : "1"},{

"someList" : [{"id" : "1"

"id" : "2"},} ,{{"id" : "2""id" : "3"} ,

}{]}

"id" : "3"}

]}

レスポンスボディの符号化

Chatter REST API 応答は、デフォルトでは最小限に符号化された HTML エンティティになります。次の文字は、すべての文字列でエスケープされます。

エスケープ文字文字

<<

>>

""

28

レスポンスボディの符号化Chatter REST API の概要

エスケープ文字文字

''

\\

&&

Chatter REST API は、応答ペイロードに含まれる URL 値に特殊な符号化を行います。URL の主部分は、RFC2396 に従って URL 符号化され、クエリ文字列は HTML 形式で符号化されます。この符号化は無効にできません。

警告: Chatter REST APIは、ユーザが送信したコンテンツを配信します。このコンテンツは、入力時に絞り込みされず、サードパーティのモバイルアプリケーションや Web アプリケーションなど、多くのソースから送られてくる場合があります。アプリケーションで出力を使用するコンテキストに対して Chatter REST

API 出力を処理します。出力の処理に失敗すると、アプリケーションとユーザがクロスサイトスクリプト(XSS) 攻撃やその他の問題にさらされ、結果的にデータ損失、アプリケーション障害、組織情報の漏洩につながる可能性があります。

Chatter REST API 出力は、多くのコンテキストで使用できます。デフォルトのエンティティ符号化がすべてのコンテキストに適していると想定しないでください。Chatter REST API出力を HTML 属性値内、URL 内、JavaScript 内、<script>タグ内、CSS 内で使用する場合は、それぞれ異なる符号化とホワイトリスト登録が必要になります。さまざまなコンテキストでの API 出力の処理用法についての詳細は、オープン Web アプリケーションセキュリティプロジェクトを参照してください。ネイティブのモバイルアプリケーションなど、非 HTML コンテキストの場合、Chatter REST APIクライアントは、未加工 (符号化されていない) の出力を要求できます。要求の X-Chatter-Entity-Encoding HTTP ヘッダーをfalse に設定します。

状況コードとエラー応答

応答ヘッダーには、HTTP 状況コードが含まれます。応答が正常でない場合は、そのエラーに付随するエラーメッセージがレスポンスボディに含まれ、必要に応じてエラーが発生した項目またはオブジェクトに関する情報も含まれます。

説明HTTP 状況コード

GET、PATCH、または HEAD 要求が成功しました200

POST 要求が成功しました201

DELETE が成功しました204

要求を理解できませんでした。通常は、特定のリソースに対して無効な ID が使用されていることが原因です。たとえば、groupIdが要求される場合に userIdを使用すると、要求は 400 を返します。

400

セッション ID または OAuth トークンが期限切れか無効です。または、要求がゲストユーザによって行われた場合、ゲストユーザはこのリソースにアクセスできません。レスポンスボディに message および errorCode が含まれます。

401

29

状況コードとエラー応答Chatter REST API の概要

https://www.ietf.org/rfc/rfc2396.txt

https://www.owasp.org/index.php/XSS_%28Cross_Site_Scripting%29_Prevention_Cheat_Sheet

https://www.owasp.org/index.php/XSS_%28Cross_Site_Scripting%29_Prevention_Cheat_Sheet

説明HTTP 状況コード

要求が却下されました。コンテキストユーザに要求されたデータへの適切なアクセス権限があること、またはコンテキストユーザが外部ユーザではないことを確認してください。

403

指定されたリソースが見つからなかったか、リソースがすでに削除されています。404

競合が発生しました。たとえば、グループへの参加要求を更新しようとしたら、その要求がすでに承認または却下されていた場合などに発生するエラーです。

409

前提処理が失敗しました。たとえば、バッチ要求で haltOnError が true に設定され、サブ要求が失敗した場合、後続のサブ要求は 412 を返します。

412

Force.com 内でエラーが発生したため、要求を完了できませんでした。Salesforce カスタマーサポートにお問い合わせください。

500

1 時間あたりの要求数を超えています。503

例この要求ではコメント ID が必要ですが、代わりにフィード項目 ID が使用されています。GET /chatter/comments/0D5D0000000XZoHKAW

レスポンスボディは次のようになります。HTTP/1.1 400 Bad RequestDate: Fri, 22 May 2015 17:32:10 GMTSet-Cookie: BrowserId=D_3feNw7RYmP4DA;Path=/;Domain=.salesforce.com;Expires=Tue, 21-Jul-201517:32:10 GMTExpires: Thu, 01 Jan 1970 00:00:00 GMTContent-Type: application/json;charset=UTF-8Transfer-Encoding: chunked

[ {"errorCode" : "INVALID_ID_FIELD","message" : "Invalid identifier: 0D5D0000000XZoHKAW"

} ]

OAuth と Chatter REST API について

OAuth は、ユーザデータへのアクセスにセキュア認証を許可するオープンプロトコルです。ユーザのユーザ名およびパスワードを渡す必要はありません。OAuth は、ソフトウェアアクセスのバレットキーと呼ばれることがよくあります。バレットキーとは、自動車の特定の部分のみ開けられる鍵のことです。たとえば、トランクやダッシュボードの小物入れなどは開けられません。Chatter REST API は、OAuth を使用してアプリケーションを Salesforce に接続する前にセキュアに識別します。

30

OAuth と Chatter REST API についてChatter REST API の概要

OAuth を使用すると、アプリケーションにログイン情報を保存せずにすみます。アプリケーションへのユーザのログインは、標準の Salesforce ページを使用して行うことができます。この際、Salesforce ページからアプリケーションへのアクセストークンが返されます。アプリケーションは、このアクセストークンを使用してChatter

REST API Web サービスにアクセスできます。この認証方法は、モバイルアプリケーションと Web ページの両方で使用できます。Chatter REST API は OAuth 2.0 を使用します。

接続アプリケーションについてChatter REST API を使用するには、組織に REST エントリポイントを作成する必要があります。Salesforce は、このエントリポイントを接続アプリケーション定義として定義します。接続アプリケーション定義の作成例については、「ステップ 2: 認証を設定する」 (ページ 48)を参照してください。接続アプリケーションの作成および使用時の考慮事項• 接続アプリケーション定義で使用されるラベルと OAuth 用語は次のように対応付けられます。

説明OAuth 用語接続アプリケーションのラベル

Salesforce に対してアプリケーションを識別する一意の識別子。

client_idコンシューマ鍵

アプリケーションに関連付けられた秘密鍵。

client_secretコンシューマの秘密

クライアントアプリケーションに関連付けられた URL。場合によっ

redirect_uriコールバック URL

ては、これはクライアントの Web

ブラウザがリダイレクトされる先の実際の URL にする必要があります。それ以外では、この URL は使用されませんが、クライアントアプリケーションとサーバ (接続アプリケーション定義) 間で値が一致する必要があります。たとえば、http://mycomponent.myapp のように、アプリケーションを識別する値を使用できます。

• モバイルアプリケーションを開発している場合、次の値を [コールバック URL] (redirect_uri) に使用して、独自のアプリケーションサーバの設定を省略できます。https://login.instance_name/services/oauth2/success

Web アプリケーションを開発する場合は、この値を使用しないでください。

31


http://tools.ietf.org/html/draft-ietf-oauth-v2-10

• 接続アプリケーションがユーザの組織と同じ組織に存在していなくてもかまいません。作成する接続アプリケーションは、どの組織へのサインインにも使用できます。

• テスト用に 1 つ、本番用に 1 つとして、複数の接続アプリケーション定義を作成することをお勧めします。1 つのみを作成する場合、アプリケーションコードの場所を反映させて [コールバック URL]の値を変更する必要があります。さらに、iOS と Android など、異なるプラットフォームを開発する場合は、複数の接続アプリケーションを作成する必要があります。

OAuth の基礎• OAuth は、クライアントアプリケーションにリソース所有者が所有するリソースへのアクセス権を付与しま

す。OAuth では、リソースとはセキュアな状態に保つ必要があるものを指します。Chatter REST API の場合、API を介してアクセス可能なすべてのデータを保護対象として考慮します。

• リソースへのアクセス権を付与するかどうかはリソース所有者次第です。このコンテキストでは、システム管理者 (ユーザと接続アプリケーションを管理する) とユーザ (サードパーティアプリケーションにログインしてアクセス権を付与する) を合わせたものがリソース所有者です。

• アプリケーションがリソースにアクセスする場合、リソース所有者からの認証が要求されます。OAuth では、アプリケーションにリソースへのアクセス権を付与するさまざまな方法が提供されます。これらは許可種別またはフローと呼ばれます。コンテキストに応じて適したフローは異なります。

• クライアントアプリケーションがリソースへのアクセスを認証されると、クライアントアプリケーションにはアクセストークンと更新トークンが与えられます。認証されたクライアントアプリケーションには、ID を証明するために、後続のすべての Web サービス要求にアクセストークンを含める必要があります。アクセストークンの有効期間は限られています。アクセストークンの期限が切れると、認証されたクライアントアプリケーションは、更新トークンを使用して新しいアクセストークンを取得するための特殊な要求を行うことができます。

OAuth フローユーザは、Salesforce にアクセスする前に認証を受ける必要があります。OAuth には複数の認証フローがあります。各認証フローには複数のステップがあります。これらは、OAuth 標準および Salesforce へのアクセスを試行するアプリケーションの種別によって決まります。認証が成功すると、クライアントアプリケーションにはアクセストークンと更新トークンが与えられます。Salesforce は、Chatter REST API で使用するために次のフローをサポートしています。• Web サーバフロー• ユーザエージェントフローさらに、アプリケーションのアクセスが認証された後に更新トークンを使用して新しいアクセストークンを取得することもできます。Salesforce Communites での OAuth の使用についての詳細は、『Salesforce Communites 実装ガイド』を参照してください。

32


https://resources.docs.salesforce.com/198/latest/en-us/sfdc/pdf/salesforce_communities_implementation.pdf

アクセス権の取り消しユーザにクライアントアプリケーションへのアクセス権が付与された後、そのアクセス権を取り消すには、[個人情報] ページの [接続アプリケーション] セクションで [取り消し] をクリックします。

関連リソースChatter REST APIの最新情報とその他のコード例は、https://developer.salesforce.com/page/Chatter_APIを参照してください。Chatter REST APIは、一部のインフラストラクチャを Force.com REST API と共有します。次の Force.comチュートリアルに含まれる認証に関する情報は、Chatter REST API にも該当します。• Getting Started with the Force.com REST API (Force.com REST API の使用開始)

• Digging Deeper into OAuth on Force.com (Force.com の OAuth の詳細)

• Using OAuth to Authorize External Applications (OAuth を使用した外部アプリケーションの認証)

Force.com REST API の認証部分は、Chatter REST APIと共有されています。Force.com REST API をサポートする次のライブラリが役立ちます。• Force.com JavaScript REST Toolkit

OAuth は広く使われている認証標準です。OAuth のクライアントライブラリを使用すると、クライアントアプリケーションの開発プロセスを円滑に進めることができます。次のクライアントプログラミングライブラリが役に立ちます。• Ruby on Rails: OmniAuth

• Java Apache Amber

Web サーバ OAuth 認証フローについて通常、このフローを使用するのは、クライアントの秘密を機密扱いで保存できる Web アプリケーションです。Web サーバフローで非常に重要な点として、アプリケーションがコンシューマの秘密を保護できる必要があります。一般的なフローは次のようになります。個々のステップについては、その後に説明します。

33

Web サーバ OAuth 認証フローについてChatter REST API の概要

https://developer.salesforce.com/page/Chatter_API

https://developer.salesforce.com/page/Getting_Started_with_the_Force.com_REST_API

https://developer.salesforce.com/page/Digging_Deeper_into_OAuth_2.0_on_Force.com

https://developer.salesforce.com/page/Using_OAuth_to_Authorize_External_Applications

https://github.com/developerforce/Force.com-JavaScript-REST-Toolkit/

https://github.com/intridea/omniauth/wiki

https://cwiki.apache.org/confluence/display/AMBER/OAuth+2.0+Client

OAuth Web サーバフローの概要を次に説明します。1. リソースの認証を要求するために、クライアントアプリケーションは、エンドユーザのブラウザをリソー

ス所有者の認証サーバでホストされている Web ページにリダイレクトします。この場合は、Salesforce ログインページです。

2. エンドユーザが Salesforce にログインして自分自身を認証します。この Web ページは、リソース所有者(Salesforce) がホストし、エンドユーザが直接操作しているため、クライアント Web アプリケーションがユーザのログイン情報を見つけることはありません。エンドユーザは、クライアントアプリケーションの認証も行います。

3. Salesforce は、指定されたコールバック URL を使用して認証コードをクライアントアプリケーションに返送します。

4. 認証コードを取得したら、クライアントアプリケーションはアクセストークンを取得するための認証コードを返します。

5. 認証コードの確認後、Salesforce はレスポンストークンを返します。エラーがなければ、レスポンストークンには、アクセスコード、更新トークン、追加情報が含まれます。

6. 保護されるリソースは Chatter REST API エンドポイントです。

34


Chatter REST API および Salesforce による Web サーバフローの使用ここでは、OAuth Web サーバフローを Salesforceおよび Chatter REST APIで使用する場合の詳細を具体的に説明します。1. 次の要求パラメータを指定して、クライアントの Web ブラウザをページ

https://login.instance_name/services/oauth2/authorize に転送します。

説明パラメータ

この認証フローの場合、必ず code にするresponse_type

このアプリケーション用に定義された接続アプリケーションからの [コンシューマ鍵] 値

client_id

このアプリケーション用に定義された接続アプリケーションからの [コールバック URL] 値

redirect_uri

必要に応じて、次の要求パラメータを含めることもできます。


承認後にコールバック URL で返される、URL 符号化された状態データを指定します。

state

ログインと承認についてユーザにプロンプトメッセージを表示するかどうかを決定します。値は、

immediate

true か false のいずれかです。デフォルトはfalse です。• trueに設定され、ユーザが現在ログインしてお

り、以前にこのアプリケーションを承認している場合、承認ステップはスキップされます。

• trueに設定され、ユーザがログインしていないか、これまでこのアプリケーションを承認したことがない場合、セッションはただちにエラーコード immediate_unsuccessful で終了します。

提供される Web ページの種別を示します。有効な値は、次のとおりです。

display

• page — 全画面のページ認証。これは、値が指定されていない場合のデフォルト値です。

• popup — 最新の Web ブラウザのポップアップウィンドウ用に最適化されたコンパクトなダイアログ。

35



• touch — Android や iPhone など、最新のスマートフォン用に設計されたモバイル用に最適化されたダイアログ。

• mobile — BlackBerry OS 5 など、機能の少ないスマートフォン用に設計されたモバイル用に最適化されたダイアログ。

2. ログインに成功したら、ユーザはアプリケーションを認証するように要求されます。

36


ユーザがすでにアプリケーションを認証している場合、このステップはスキップされます。3. クライアントアプリケーションが認証されたことが Salesforce で確認されると、エンドユーザの Web ブラウ

ザは、redirect_uri パラメータで指定されたコールバック URL にリダイレクトされます。このパラメータのクエリ文字列には次の値が付加されます。


アクセストークンと更新トークンを取得するために渡される認証コード

code

37



最初の要求の一部として渡される状態値 (該当する場合のみ)。

state

redirect_uri Web ページは、クライアントアプリケーションサーバでホストされていると想定されます。4. クライアントアプリケーションサーバは、認証コードを抽出して、これを含めたアクセストークン要求を

Salesforce に渡す必要があります。この要求は、URL

https://login.instance_name/services/oauth2/token に対する POST 送信として次のクエリパラメータを指定して行う必要があります。


このフローの値は authorization_code である必要があります。

grant_type

接続アプリケーション定義のコンシューマ鍵。client_id

接続アプリケーション定義のコンシューマの秘密。client_secret

承認後にユーザをリダイレクトする URI。これは、接続アプリケーション定義の [コールバック URL]

redirect_uri

項目の値に完全に一致している必要があります。また、最初のリダイレクトによって送信された値と同じ値です。

承認後にコールバックから取得される認証コード。code

期待される戻り形式。このパラメータは省略可能です。デフォルトは json です。値は次のとおりです。

format

• urlencoded

• json

• xml

5. この要求が成功した場合、サーバは次の内容を保持するレスポンスボディを返します。


Chatter REST API要求を行うために使用可能なセッション ID。このセッション ID はユーザインターフェース

access_token

では使用できません。これは、ユーザのセッションと同様に扱い、厳密に保護する必要があります。

38



新しいアクセストークン (セッション) を取得するために将来使用できるトークン。

refresh_token

警告: この値は秘密です。ユーザのパスワードなどと同様に処理し、適切な手段で保護する必要があります。

ユーザの組織のインスタンスを示す URL。この例では、インスタンスは na1:

https://na1.salesforce.com です。

instance_url

ユーザ、およびユーザの詳細に関するクエリの両方を識別するために使用できる ID URL。エンドユーザ

id

に関する詳細な情報を取得するための HTTP 要求で使用できます。

連結 ID と issued_at を含むコンシューマの非公開キーで署名されている Base64 符号化された

signature

HMAC-SHA256 署名。これは、サーバによる送信以降変更されなかった ID URL の確認に使用できます。

いつ署名が作成されたか。issued_at

ユーザエージェント OAuth 認証フローについて通常、このフローは、JavaScript から直接 Chatter REST API にアクセスするモバイルアプリケーションまたはアプリケーションで使用されます。このフローでは、クライアントアプリケーションは信頼できないため、クライアントのログイン情報やユーザのログイン情報を保存できないということを前提にしています。

警告: アクセストークンは符号化され、リダイレクト URI になっているため、エンドユーザや、コンピュータまたはデバイス上にある他のアプリケーションに公開できます。JavaScript を使用して認証する場合、window.location.replace(); をコールし、ブラウザの履歴からコールバックを削除することをお勧めします。

一般的なフローは次のようになります。個々のステップについては、その後に説明します。

39

ユーザエージェント OAuth 認証フローについてChatter REST API の概要

次に、OAuth ユーザエージェントフローの概要を説明します。1. リソースの認証を要求するために、クライアントアプリケーションは、エンドユーザのブラウザをリソー

ス所有者の認証サーバでホストされている Web ページにリダイレクトします。この場合は、Salesforce ログインページです。

2. エンドユーザが Salesforce にログインして自分自身を認証します。この Web ページは、リソース所有者(Salesforce) がホストし、エンドユーザが直接操作しているため、クライアント Web アプリケーションがユーザのログイン情報を見つけることはありません。クライアントアプリケーションがすでにブラウザで実行されている場合、そのままブラウザをリダイレクトできます。クライアントアプリケーションがモバイルアプリケーションの場合、ブラウザを開く必要があります (iOS の UIWebViewなど)。エンドユーザはこの Web ページを使用して自分自身を認証し、その後、クライアントアプリケーションを認証します。

3. 認証されると、認証サーバはエンドユーザの Web ブラウザをリダイレクト URL にリダイレクトします。この URL は、クライアントアプリケーションがアクセストークンと更新トークンを取得するために使用できます。

4. 保護されるリソースは Chatter REST API リソースです。

40


Chatter REST API および Salesforce によるユーザエージェントフローの使用ここでは、OAuth ユーザエージェントフローを SalesforceおよびChatter REST APIで使用する場合の詳細を具体的に説明します。1. 次の要求パラメータを指定して、クライアントの Web ブラウザをページ

https://login.instance_name/services/oauth2/authorize に転送します。


この認証フローの場合、必ず token にするresponse_type

このアプリケーション用に定義された接続アプリケーションからの [コンシューマ鍵] 値

client_id

このアプリケーション用に定義された接続アプリケーションからの [コールバック URL] 値

redirect_uri

必要に応じて、次の要求パラメータを含めることもできます。


提供される Web ページの種別を示します。有効な値は、次のとおりです。

display

• page — 全画面のページ認証。これは、値が指定されていない場合のデフォルト値です。

• popup — 最新の Web ブラウザのポップアップウィンドウ用に最適化されたコンパクトなダイアログ。

• touch — Android や iPhone など、最新のスマートフォン用に設計されたモバイル用に最適化されたダイアログ。

• mobile — BlackBerry OS 5 など、以前のスマートフォン用に設計された、モバイル用に最適化されたダイアログ。

アプリケーションがアクセスできるデータを指定します。Chatter REST APIにアクセスするために値を指定

scope

する必要はありません。値を指定する場合は、chatter_api 値を含める必要があります。

承認後にコールバック URL で返される、URL 符号化された状態データを指定します。

state

41


2. ログインに成功したら、ユーザはアプリケーションを認証するように要求されます。ユーザがすでにアプリケーションを認証している場合、このステップはスキップされます。

3. クライアントアプリケーションが認証されたことが Salesforce で確認されると、エンドユーザの Web ブラウザは、redirect_uri パラメータで指定されたコールバック URL にリダイレクトされます。このパラメータにはハッシュ記号 (#) の後に次の値が付加されます。これは、クエリ文字列ではありません。


Chatter REST API要求を行うために使用可能なセッション ID。このセッション ID はユーザインターフェース

access_token

では使用できません。これは、ユーザのセッションと同様に扱い、厳密に保護する必要があります。

アクセストークンが有効な時間 (秒)。expires_in

新しいアクセストークン (セッション) を取得するために将来使用できるトークン。

refresh_token

警告: この値は秘密です。ユーザのパスワードなどと同様に処理し、適切な手段で保護する必要があります。

更新トークンが返されるのは、リダイレクト URI がhttps://login.instance_name/services/oauth2/success

であるか、HTTPS 以外のカスタムプロトコルで使用されている場合のみです。

次の追加パラメータが返されますが、このフローと Chatter REST API では使用されません。• instance_url

• id

• signature

• issued_at

4. クライアントアプリケーションが Web アプリケーションの場合、そこで使用されるリダイレクト Web ページには、クライアントアプリケーションがアクセストークンと更新トークンを取得するために操作可能なJavaScript が含まれている場合があります。または、クライアントアプリケーション (ネイティブまたは Web) がページhttps://login.instance_name/services/oauth2/successをコールバック URL として使用している場合があります。リダイレクト時に実際にページを読み込む代わりに、リダイレクト URI をインターセプトしてパラメータ値を抽出する必要があります。refresh_tokenパラメータ値は、リダイレクト URI がこのURI である場合か、カスタムプロトコルを使用する場合にのみ提供されます。クライアントアプリケーションは、アクセストークンと更新トークンを取得すると、それらのトークンを使用して Chatter REST API に要求を行います。

42


トークンの使用両方の認証フローの一部として、アクセストークンと更新トークンを使用します。

アクセストークンの使用Chatter REST API 要求を正常に行うには、要求に有効なアクセストークンを含める必要があります。これを行うには、HTTP 認証ヘッダーを使用します。Authorization: OAuth <access token>

要求のトークンの期限が切れていたためにエラー応答が返された場合、更新トークンを使用して新しいアクセストークンを取得できます。アクセストークンが取り消されたために要求がエラーになった場合、クライアントアプリケーションがアクセス権を得るには、ユーザによる再認証が必要です。

更新トークンの使用クライアントアプリケーションに更新トークンがある場合、更新トークンを使用して新しいアクセストークンの要求を送信できます。新しいアクセストークンを要求するには、クライアントアプリケーションが次のクエリパラメータを指定したPOST 要求を https://login.instance_name/services/oauth2/token に送信する必要があります。


このフローの値は refresh_tokenである必要があります。

grant_type

クライアントアプリケーションがすでに受け取っている更新トークン。

refresh_token

接続アプリケーション定義のコンシューマ鍵。client_id

必要に応じて、次のパラメータを含めることもできます。


接続アプリケーション定義のコンシューマの秘密。client_secret

期待される戻り形式。デフォルトは jsonです。値は次のとおりです。

format

• urlencoded

• json

• xml

このリクエストが成功した場合、サーバは access_token を保持するペイロードを返します。

43

トークンの使用Chatter REST API の概要

次の追加パラメータも返されますが、このフローと Chatter REST API では使用されません。• instance_url

• id

• signature

• issued_at

HTML からの静的アセットの直接要求およびフォーム要求の直接投稿Salesforce でホストされない HTML ページでは、ユーザやグループ画像を表示したり、フォームに添付ファイルを投稿したりするのが困難でした。理由は、これらのアセットの URL で認証が必要であるからです。この認証は、ページが Salesforceでホストされるときに、セッション Cookie によって提供されます。Salesforceでホストされないページは、セッション Cookie にアクセスできません。また、HTML のコンテキスト <img>、<a>、および<form> から OAuth トークンを渡すこともできません。この問題を解決するには、自己認証を行うべアラートークン URL を要求します。べアラートークン URL は、リソースへのアクセスを提供するべアラートークンが付加された Chatter REST API リソースです。ベアラートークン URL はそのまま使用します。パラメータを追加または削除しないでください。パラメータを追加または削除すると、エラーが発生します。次の操作を行うには、<img>、<a>、および <form> タグでべアラートークンURL を使用します。• Chatter ユーザプロファイルの画像およびファイル、ファイルやダッシュボードのプレビューなどの静的な

Chatter REST API アセットの要求• 添付ファイルがあるフィード項目やコメント、またはユーザプロファイル写真の更新など、ファイルが添

付されている場合の Chatter REST API へのフォーム要求の投稿静的アセットの要求またはフォーム要求の投稿を行うには、べアラートークン URL を返すリソースを要求します。次に、べアラートークン URL を使用して、リソースを要求します。1. べアラートークン URL を含むレスポンスボディのプロパティを使用して、リソースを要求します。

• Comment Page — currentPageUrl*

• Content Capability — downloadUrl、externalDocumentUrl、renditionUrl、repositoryFileUrl

• Feed — feedElementPostUrl*、feedElementsUrl*、feedItemsUrl*

• Feed Item — photoUrl

• Feed Item Attachment: Content — downloadUrl、externalDocumentUrl、renditionUrl、repositoryFileUrl

• Feed Item Attachment: Dashboard — fullSizeImageUrl、thumbnailUrl

• File Detail — downloadUrl、externalDocumentUrl、renditionUrl、renditionUrl240By180、renditionUrl720By480、repositoryFileUrl

• File Preview URL — previewUrl

• File Summary — downloadUrl、externalDocumentUrl、renditionUrl、renditionUrl240By180、renditionUrl720By480、repositoryFileUrl

• File Summary Page — currentPageUrl*

• Icon — url

• Mention Completion — photoUrl

44

HTML からの静的アセットの直接要求およびフォーム要求の直接投稿

Chatter REST API の概要

• Message Segment: Inline Image — url*

• Photo — largePhotoUrl、smallPhotoUrl、url*

• Repository File Detail — downloadUrl

• Repository File Summary — downloadUrl

* 添付ファイルがあるフィード項目やコメントなど、バイナリファイルを含む新しい項目を POST または PUT

するときに使用します。

2. true の値を使用して、X-Connect-Bearer-Urls 要求ヘッダーを渡します。X-Connect-Bearer-Urls: true

3. レスポンスボディからべアラートークン URL を解析し、それを HTML タグで使用して、静的アセットの要求またはフォーム要求の投稿を行います。べアラートークン URL には、次の特性があります。• べアラートークンは、特定の URL にのみ適しています。クエリパラメータを追加したり、並び替えたり

すると、URL が無効になります。• べアラートークンの Time to Live (TTL) は 20 分です。トークンの有効期限が切れた場合、再度要求する必要

があります。• べアラートークン URL への要求は、べアラートークン URL を返したリソースを要求したユーザとして認

証されます。

CORS を使用した Chatter REST API および REST API へのアクセス

エディション

使用可能なエディション:Salesforce Classic およびLightning Experience

使用可能なエディション:Developer Edition、Enterprise Edition、Performance Edition、Unlimited Edition

ユーザ権限

作成、参照、更新、および削除する• 「すべてのデータの編

集」

Chatter REST APIおよび REST APIでは、CORS (クロスオリジンリソース共有) がサポートされます。Web ブラウザで JavaScript からこれらの API にアクセスするには、スクリプトを提供するオリジンを CORS ホワイトリストに追加します。CORSは、Web ブラウザが他のオリジンからのリソースを要求 (クロスオリジン要求) できるようにする W3C 勧告です。たとえば、CORS を使用すると、https://www.example.com にある JavaScript スクリプトでhttps://www.salesforce.com からのリソースを要求できます。CORS をサポートするブラウザが、Salesforce CORS ホワイトリスト内のオリジンに要求を行うと、Salesforce はオリジンを含む Access-Control-Allow-Origin

HTTP ヘッダーと、追加の CORS HTTP ヘッダーを返します。オリジンがホワイトリストにない場合は、Salesforce が HTTP 状況コード 403 を返します。1. [設定] から、[クイック検索]ボックスに「CORS」と入力し、[CORS]を選択し

ます。2. [新規] を選択します。3. オリジンの URL パターンを入力します。

オリジンの URL パターンには、HTTPS プロトコルとドメイン名を含める必要があり、ポートを含めることもできます。ワイルドカード文字 (*) はサポート

45



http://www.w3.org/TR/cors/

されますが、第 2 レベルドメイン名の前にある必要があります。たとえば、https://*.example.com により、example.com のすべてのサブドメインがホワイトリストに追加されます。オリジンの URL パターンに IP アドレスを使用できます。ただし、IP アドレスと、同じアドレスに解決するドメインは同じオリジンではないため、CORS ホワイトリストには別々のエントリとして追加する必要があります。

重要: OAuth トークンが必要な要求では、OAuth トークンを渡す必要があります。

46



第 2 章 Chatter REST API クイックスタートSalesforce に接続して認証し、Chatter REST API に対して要求を実行して応答を確認します。

トピック:

• 前提条件• ステップ 1:

Salesforce DeveloperEdition 組織を取得する

• ステップ 2: 認証を設定する

• ステップ 3: OAuthを使用して ChatterREST API に接続する

• SalesforceCommunities への接続

47

前提条件

クイックスタートを開始する前に、次の前提条件を満たしていることを確認してください。次のことに習熟しておいてください。• cURL。コマンドラインツールであり、クイックスタートでは Salesforce への HTTP 要求を行うクライアントア

プリケーションとして使用します。cURL は、多くの Linux システムや Mac システムにあらかじめインストールされています。Windows バージョンは、curl.haxx.se/からダウンロードできます。Windows で HTTPS を使用する場合、システムが SSL 対応の cURL の要件を満たしていることを確認してください。

メモ: cURL はオープンソースのツールで、Salesforce ではサポートされていません。

• JavaScript Object Notation (JSON)。このクイックスタートで返されるデータ形式です。• OAuth 2.0。Salesforce が認証に使用するフレームワークです。このクイックスタートでは手順を説明します

が、OAuth の用語と概念に習熟しておくと役立ちます。

ステップ 1: Salesforce Developer Edition 組織を取得する

まだForce.com開発者コミュニティのメンバーでない場合、developer.salesforce.com/signupにアクセスし、Developer Edition 組織のサインアップの説明に従ってください。すでに Enterprise Edition、Unlimited Edition、またはPerformance Edition を所有している場合でも、組織の使用中のデータを保護するために、サンプルデータに対するソリューションの開発、ステージングおよびテストには Developer Edition を使用します。これは、特に、(データをただ参照するだけのアプリケーションに対し) データを挿入、更新または削除するアプリケーションの場合に該当します。Developer Edition 組織をすでに所有している場合は、「API の有効化」権限があることを確認します。この権限はデフォルトで有効になっていますが、管理者によって変更されている場合があります。詳細は、Salesforceユーザインターフェースのヘルプを参照してください。

ステップ 2: 認証を設定する

Salesforce 組織で接続アプリケーションを作成し、OAuth を有効にします。クライアントアプリケーションは、接続アプリケーションを使用して Salesforce に接続します。1. Developer Edition 組織で、[設定] から [クイック検索]ボックスに「アプリケーション」と入力し、[アプリケー

ション] を選択し、[接続アプリケーション] セクションで [新規] をクリックして、新しい接続アプリケーションを作成します。クライアントは、接続アプリケーションが組織で定義されていなくても、接続アプリケーションを使用して組織にサインインできます。

2. 接続アプリケーション名を入力します。3. 取引先責任者のメールと、必要に応じてその他の情報を入力します。4. [OAuth 設定の有効化] を選択します。

48

前提条件Chatter REST API クイックスタート

http://curl.haxx.se/

https://developer.salesforce.com/signup

5. [コールバック URL]を入力します。これはセキュアである必要があります。http://は機能せず、https://

のみが機能します。このクイックスタートでは、「https://」と入力してください。

6. OAuth の範囲を入力します。接続アプリケーションでアクセスを許可する他の範囲に加え、[Chatter フィードへのアクセスと管理] を選択します。

7. [保存] をクリックします。[コンシューマ鍵]が作成され、表示されます。また、[コンシューマの秘密]が作成されます (表示するにはリンクをクリックします)。

ステップ 3: OAuth を使用して Chatter REST API に接続する

OAuth を使用して Salesforce に接続し、アクセストークンを取得します。アクセストークンを要求で Chatter REST

API に渡します。「ステップ 2: 認証を設定する」を完了し、接続アプリケーションを作成してからこのタスクを開始します。作成した接続アプリケーションで使用される用語と、例で使用される OAuth のプロパティの対応付けを次の表に示します。OAuth 2.0 仕様では、「コンシューマ」ではなく「クライアント」という用語を使用します。

例の値接続アプリケーションのアプリケーションラベル

client_idコンシューマ鍵

client_secretコンシューマの秘密

メモ: このクイックスタートでは、ユーザ名パスワード OAuth 認証フローを使用します。ユーザ名パスワード認証フローでは、ユーザのログイン情報をやりとりする必要があります。この認証フローは、このクイックスタートのように必要な場合にのみ使用してください。更新トークンは発行されません。さらに、Salesforce Communities ではユーザ名パスワード認証フローはサポートされていません。このクイックスタートでは、コミュニティ URL への要求は行わないでください。

Salesforce への要求を行うには、次の例に組織の値を代入します。1. アクセストークンを生成します。

次の cURL コマンドはアクセストークンを生成します。curl --form client_id=3MVG9PhR6g6B7ps4xDycwGrI4PvjVZvK9

--form client_secret=8870355475032095511--form grant_type=password--form [email protected] password=1Lsfdc!https://login.salesforce.com/services/oauth2/token

ヒント: 複数行コマンドを Mac または Linux コマンドラインインターフェースに貼り付ける場合、各行をバックスラッシュ (「\」) でエスケープしてコマンドが次の行に続くことを示します。エスケープされた行は次のようになります。curl --form client_id=3MVG9PhR6g6B7ps4xDycwGrI4PvjVZvK9 \

49

ステップ 3: OAuth を使用して Chatter REST API に接続する

Chatter REST API クイックスタート

複数行コマンドを Windows コマンドプロンプトに貼り付ける場合、各行をキャレット (「^」) でエスケープします。エスケープされた行は次のようになります。curl --form client_id=3MVG9PhR6g6B7ps4xDycwGrI4PvjVZvK9 ^

応答には、次のようにサーバインスタンスとアクセストークンが含まれます。{"id":"https://login.salesforce.com/id/00Di0000000hT9uEAE/005i00000022uIbAAI","issued_at":"1302907727777","instance_url":"https://na1.salesforce.com","signature":"5jcevY5fUai0lWntuSxkwBzWcvRjd01RCOkIBZpyGv0=","access_token":"00DD0000000FJ6T!AQkAQPde_DMF2vGzddfZmBRS95GojDbtA

rKkgukAgZP0OVFYY5KkAqhLw9ejeKIlpJ3FgwGAWeRlBiWRt8mfXEuAZGbZNosk"}

2. Chatter REST API リソースを要求するには、返された instance_url をサーバインスタンスとして使用します。返された access_token を Authorization 要求ヘッダーで Bearer トークンとして渡します。curl -X GET https://na1.salesforce.com/services/data/v35.0/chatter/users/me

-H 'Authorization: Bearer 00DD0000000FJ6T!AQkAQPde_DMF2vGzddfZmBRS95GojDbtArKkgukAgZP0OVFYY5KkAqhLw9ejeKIlpJ3FgwGAWeRlBiWRt8mfXEuAZGbZNosk'

この例では次の値を使用しています。

値プロパティ

na1.salesforce.comサーバインスタンス3MVG9PhR6g6B7ps4xDycwGrI4PvjVZvK9client_id

8870355475032095511client_secret

password

grant_typeの値は使用する OAuth 認証フローに応じて異なります。

grant_type

[email protected]

1Lsfdc!password

Salesforce Communities への接続

OAuth を使用して Salesforce のコミュニティに接続するには、サーバインスタンス名をコミュニティ URL へのフルパスで置き換えます。Salesforceコミュニティに接続するには、OAuth Web サーバおよびユーザエージェントワークフローを使用します。

50

Salesforce Communities への接続Chatter REST API クイックスタート

承認 URL を使用してユーザを認証するには、login.salesforce.com ホスト名をコミュニティ URL へのフルパスで置き換えます。次の例はコミュニティ URL ではありません。https://login.salesforce.com/services/oauth2/authorize?response_type=token&client_id=your_app_id&redirect_uri=your_redirect_uris

コミュニティ URL は、次のようになります。https://acme.force.com/customers/services/oauth2/authorize?response_type=token&client_id=your_app_id&redirect_uri=your_redirect_uri

正常に実装されると、この URL によりユーザはアプリケーションのブランド名が入ったログインページに移動します。アプリケーションを認証したら、ユーザアクセストークンを設定し、将来の認証に備えてトークンを更新します。トークンエンドポイントの要求で、次のようにホストをコミュニティで置き換えます。https://acme.force.com/customers/services/oauth2/token

Chatter REST API リソースを要求するには、Salesforce ホスト名を使用してコミュニティ ID を次のように指定します。https://na1.salesforce.com/services/data/v29.0/connect/communities/communityId/chatter/feeds/news/me/feed-elements

または、ホスト名をコミュニティ URL へのフルパスで置き換えます。https://communitydomain.force.com/communitypath/services/data/v29.0/connect/communities/communityId/chatter/feeds/news/me/feed-elements

51

Salesforce Communities への接続Chatter REST API クイックスタート

第 3 章 Chatter REST API の機能『Chatter REST API開発者ガイド』のこの章では、Chatter REST API 機能の操作に使用するリソースについて説明します。

トピック:

• アクションリンクの使用

• コミュニティの使用

• フィードおよびフィード要素の使用

• Salesforce Files の使用

52

アクションリンクの使用

アクションリンクは、フィード要素上のボタンです。アクションリンクをクリックすると、ユーザを特定のWeb ページに移動したり、ファイルダウンロードを開始したり、Salesforce または外部サーバへの API コールを呼び出したりできます。アクションリンクには、URL と HTTP メソッドが含まれ、リクエストボディとヘッダー情報 (認証用の OAuth トークンなど) を含めることができます。アクションリンクを使用して Salesforce およびサードパーティサービスをフィードに統合することで、ユーザはアクションを実行して生産性を高め、イノベーションを促進できます。

Workflow次のフィード項目には、[承認] および [却下] という 2 つのアクションリンクを含む 1 つのアクションリンクグループがあります。

フィード要素を使用してアクションリンクを作成および投稿するワークフローは、次のとおりです。1. (省略可能) アクションリンクテンプレートを作成します。2. /connect/action-link-group-definitionsに対して要求を実行して、アクションリンクグループを定義するか、テン

プレートからアクションリンクグループをインスタンス化します。アクションリンクグループには、少なくとも 1 つのアクションリンクが含まれます。

3. /chatter/feed-elementsに対して要求を実行して、フィード要素を投稿し、アクションリンクを関連付けます。

Action Links リソースアクションリンクを操作するには、次のリソースを使用します。

53

アクションリンクの使用Chatter REST API の機能

タスクHTTP メソッドリソース

アクションリンクグループ定義を作成します。アクションリンクをフィード要素に関連付け

POST/connect/action-link-group-definitions

るには、まずアクションリンクグループ定義を作成します。次に、関連付けられたアクション機能を含むフィード要素を投稿します。

関連付けられたアクション機能を含むフィード要素を投稿します。1 つのフィード要素に、

POST/chatter/feed-elements

最大 10 個のアクションリンクグループを関連付けます。

アクションリンクの status の情報取得や更新を行います。アクションリンクの status

GET、PATCH/connect/action-links/actionLinkId

と Action Link Definition Input の labelKey プロパティの組み合わせにより、UI に表示されるテキストが決まります。Api および ApiAsync

アクションリンクの API 要求をトリガするには、status を PendingStatus に設定します。

アクションリンクグループ定義の情報取得や削除を行います。アクションリンクグループ

GET、DELETE/connect/action-link-group-definitions/actionLinkGroupId

定義を削除すると、その定義へのすべての参照がフィード要素から削除されます。アクションリンクグループ定義の取得や削除を行うには、クライアントは定義を作成した接続アプリケーションと同じである必要があり、ユーザは定義を作成したか「すべてのデータの参照」権限を持っている必要があります。

コンテキストユーザの状態を含む、アクションリンクグループに関する情報を取得します。

GET/connect/action-link-groups/actionLinkGroupId

アクションリンクが実行されたときに返された診断情報を取得します。診断情報は、アク

GET/connect/action-links/actionLinkId/diagnostic-info

ションリンクにアクセスできるユーザに対してのみ提供されます。

フィード要素に関連付けられたすべてのプラットフォームアクションを取得します。アクショ

GET/chatter/feed-elements/feedElementId/capabilities/associated-actions

ンリンクは、プラットフォームアクションの種別の 1 つです。

指定されたフィード種別のフィード要素を取得します。フィード要素にアクションリンク

GETFeed リソース/chatter/feeds/feedType/userId/feed-elements

が関連付けられている場合、関連付けられた/chatter/feeds/feedType/feed-elements

54

アクションリンクの使用Chatter REST API の機能

タスクHTTP メソッドリソース

アクション機能でアクションリンクデータが返されます。


アクションリンクの使用事例アクションリンクを使用してSalesforceおよびサードパーティサービスをフィードと統合できます。アクションリンクでは、Salesforce またはサードパーティ API への HTTP 要求を実行できます。また、ファイルをダウンロードしたり、Web ページを開いたりすることもできます。このトピックには、2 つの使用事例があります。アクションリンクの概要、認証、およびセキュリティChatter REST API アクションリンクのセキュリティ、認証、表示ラベル、およびエラーについて学習します。アクションリンクテンプレート[設定] でアクションリンクテンプレートを作成し、Chatter REST API または Apex から共通のプロパティを持つアクションリンクグループをインスタンス化できます。テンプレートをパッケージ化して他の Salesforce 組織に配布できます。

関連トピック:

アクションリンクを定義し、フィード要素を使用して投稿するテンプレートのアクションリンクを定義し、フィード要素を使用して投稿するテンプレートのアクションリンクを定義し、フィード要素を使用して投稿する

アクションリンクの使用事例アクションリンクを使用してSalesforceおよびサードパーティサービスをフィードと統合できます。アクションリンクでは、Salesforce またはサードパーティ API への HTTP 要求を実行できます。また、ファイルをダウンロードしたり、Web ページを開いたりすることもできます。このトピックには、2 つの使用事例があります。

フィードから手順をダウンロードして部品を注文する架空の 3D プリントショップ「BuildIt」が、アクションリンクを使用して Salesforce に統合される AppExchange アプリケーションを作成したとします。BuildIt の顧客は、このアプリケーションをインストールすると、BuildIt のWeb サイトへのアクセス、アカウントの作成、BuildIt に部品を注文できるように特定のユーザを招待するSalesforce

へのアクションリンクを含む投稿の送信を行えます。このサンプルフィード要素は、BuildIt の顧客である Pam

Jones からその部下の Jin Chang に投稿されたものです。[ダウンロード] アクションリンクをクリックすると、BuildIt Web サイトから部品情報を含むファイルがダウンロードされます。[注文] アクションリンクをクリックすると、Jin Chang に BuildIt Web サイトのページが表示されて部品を注文できます。

55

アクションリンクの使用事例Chatter REST API の機能

フィードから旅程を承認または却下する架空の「Travel Example」という会社の開発者として、「Travel Example for Salesforce」というアプリケーションをSalesforce AppExchange 用に作成するとします。会社 A には「Travel Example for Salesforce」がインストールされています。会社 A の誰かが Travel Example Web サイトにアクセスし、旅程を予約します。Travel Example のサーバ側コードは、会社 A のSalesforce組織に本文テキスト [この出張を承認してください。]、および表示ラベル [承認]と [却下]のアクションリンクを含むフィード項目を投稿するChatter REST API要求を実行します。これらのアクションリンクは、旅程を承認または却下するために Travel Example サーバの REST リソースに対して HTTP 要求を実行します。

「Travel Example for Salesforce」アプリケーションを作成するため、[設定] でこれらのアクションリンクおよび関連付けられたアクションリンクグループを定義するアクションリンクテンプレートを作成しました。サーバ側

56

アクションリンクの使用事例Chatter REST API の機能

コードでは、テンプレートからアクションリンクグループをインスタンス化する Chatter REST API 要求を実行します。また、アクションリンクグループをフィード項目に関連付けて投稿する、別の Chatter REST API 要求を実行します。[アクション URL]、[HTTP ヘッダー]、および [HTTP リクエストボディ] テンプレート項目には、コンテキスト変数とバインド変数を含めることができます。[アクション URL] に {!userId} コンテキスト変数を含めます。これにより、ユーザがフィードのアクションリンクをクリックしたときに、Salesforceがそのユーザの ID をサーバ側コードに送信して誰がアクションリンクをクリックしたかを伝えます。アクションリンクでは、定義済みのコンテキスト変数のセットがサポートされています。アクションリンクテンプレートで必要なバインド変数を作成し、今後の変更に対応できる動的なコードにすることができます。サーバ側コードでは、アクションリンクグループをインスタンス化するときにバインド変数の値を設定します。パッケージを更新することなく新しい API バージョンをリリースできるように、{!Bindings.apiVersion}を使用します。また、アクションリンクをクリックすることでユーザが作成した旅程を承認または却下できるように、{!Bindings.tripId} も使用します。アクションリンクが 1 人のユーザのみに表示されるように、[ユーザ表示設定] 項目を設定します。[カスタムユーザ(別名)]項目に値を入力します。これは、サーバ側コードがアクションリンクグループをインスタンス化するときに、ユーザのマネージャの ID に対して値が設定されるバインド変数でもあります。[承認] アクションリンク用のアクションリンクテンプレートを次に示します。

アクションリンクの概要、認証、およびセキュリティChatter REST API アクションリンクのセキュリティ、認証、表示ラベル、およびエラーについて学習します。

57

アクションリンクの概要、認証、およびセキュリティChatter REST API の機能

Workflow次のフィード項目には、[承認] および [却下] という 2 つのアクションリンクを含む 1 つのアクションリンクグループがあります。

フィード要素を使用してアクションリンクを作成および投稿するワークフローは、次のとおりです。1. (省略可能) アクションリンクテンプレートを作成します。2. /connect/action-link-group-definitionsに対して要求を実行して、アクションリンクグループを定義するか、テン

プレートからアクションリンクグループをインスタンス化します。アクションリンクグループには、少なくとも 1 つのアクションリンクが含まれます。

3. /chatter/feed-elementsに対して要求を実行して、フィード要素を投稿し、アクションリンクを関連付けます。

アクションリンクテンプレート[設定] でアクションリンクテンプレートを作成して、共通のプロパティを持つアクションリンクグループをインスタンス化します。テンプレートをパッケージ化して他の Salesforce 組織に配布できます。テンプレートにバインド変数を指定し、そのアクションリンクグループをインスタンス化するときに変数の値を設定します。たとえば、API バージョン番号、ユーザ ID、または OAuth トークンにバインド変数を使用します。テンプレートでコンテキスト変数を指定することもできます。ユーザがアクションリンクを実行すると、Salesforce によってこれらの値 (どの組織でどのユーザがリンクを実行したかなど) が提供されます。アクションリンクグループをインスタンス化するには、/connect/action-link-group-definitionsリソースへの要求を実行します。テンプレートで定義されたバインド変数のテンプレート ID と値を指定します。「アクションリンクテンプレートの設計」を参照してください。

58


アクションリンクの種別アクションリンクを定義するときに、actionType プロパティでアクションリンクの種別を指定します。アクションリンクには次の 4 つの種別があります。• Api — アクションリンクは、アクション URL で同期 API をコールします。Salesforceは、サーバから返された

HTTP 状況コードに基づいて状況を SuccessfulStatus または FailedStatus に設定します。• ApiAsync — アクションリンクは、アクション URL で非同期 API をコールします。アクションは、非同期操

作の完了時にサードパーティが /connect/action-links/actionLinkId への要求を行って状況をSuccessfulStatus または FailedStatus に設定するまで、PendingStatus 状態のままになります。

• Download — アクションリンクは、アクション URL からファイルをダウンロードします。• Ui — アクションリンクはアクション URL の Web ページをユーザに表示します。さまざまな種別のアクションリンクのさまざまなワークフローで、アクションリンクの状況 (Pending、Successful、または Failed) が設定されます。詳細は、/connect/action-links/actionLinkIdを参照してください。

認証アクションリンクを定義するときは、URL (actionUrl) と、その URL に対して要求を行うために必要な HTTP

ヘッダー (headers) を指定します。外部リソースに認証が必要な場合は、リソースで必要とするすべての場所に情報を含めます。Salesforce リソースに認証が必要な場合は、HTTP ヘッダーに OAuth 情報を含めるか、URL にベアラートークンを含めることができます。Salesforce は自動的に次のリソースを認証します。• テンプレート内の相対 URL

• アクションリンクグループが Apex からインスタンス化されるときの /services/apexrest で始まる相対URL

機密情報を扱う操作にこれらのリソースを使用しないでください。

セキュリティHTTPS

アクションリンクのアクション URL は、https:// で始まるか、「認証」セクションのルールのいずれかに一致する相対 URL である必要があります。

暗号化API の詳細は、暗号化して保存され、クライアントには隠匿されます。テンプレートからインスタンス化されていないアクションリンクの actionURL、headers、およびrequestBodyデータは、組織の暗号化鍵で暗号化されます。アクションリンクテンプレートの [アクション URL]、[HTTP ヘッダー]、および [HTTP リクエストボディ] は暗号化されません。テンプレートからアクションリンクグループをインスタンス化するときに使用されるバインド値は、組織の暗号化鍵で暗号化されます。

59


アクションリンクテンプレート「アプリケーションのカスタマイズ」ユーザ権限を持つユーザのみが、[設定] でアクションリンクテンプレートの作成、編集、削除、およびパッケージ化を行うことができます。テンプレートに機密情報を保存しないでください。バインド変数を使用して、アクションリンクグループをインスタンス化するときに機密情報を追加します。アクションリンクグループがインスタンス化されると、値は暗号化された形式で保存されます。「バインド変数の定義」を参照してください。

接続アプリケーション接続アプリケーションを使用してアクションリンクを作成する場合、常に制御可能なコンシューマキーのある接続アプリケーションを使用することをお勧めします。接続アプリケーションはサーバ間の通信に使用され、逆コンパイル可能なモバイルアプリケーションに対してはコンパイルされません。

有効期限アクションリンクグループを定義するときは、有効期限 (expirationDate) を指定します。この期限後は、グループのアクションリンクを実行できなくなり、フィードから削除されます。アクションリンクグループ定義に OAuth トークンが含まれる場合、そのグループの有効期限を OAuth トークンの有効期限と同じ値に設定します。アクションリンクテンプレートは、若干異なるユーザの除外メカニズムを使用します。「アクションリンクグループの有効期限の設定」を参照してください。

ユーザの除外またはユーザの指定Action Link Definition Input の excludeUserId プロパティは、アクションの実行から単一ユーザを除外する場合に使用します。Action Link Definition Input の userId プロパティは、アクションを実行できる唯一のユーザの ID を指定する場合に使用します。userId プロパティを指定しない場合、または null を渡す場合は、すべてのユーザがアクションを実行できます。アクションリンクに excludeUserId と userId 両方を指定することはできません。アクションリンクテンプレートは、若干異なるユーザの除外メカニズムを使用します。「アクションリンクを表示できるユーザの設定」を参照してください。

アクションリンクグループ定義の参照、変更、または削除アクションリンクとアクションリンクグループには、定義ビューとコンテキストユーザビューという 2 つのビューがあります。定義には、認証情報などの機密情報が含まれる可能性があります。コンテキストユーザビューは、表示オプションによって絞り込まれ、コンテキストユーザの状態が値に反映されます。アクションリンクグループ定義には機密情報 (OAuth トークンなど) を含めることができます。そのため、定義を参照、変更、または削除するには、ユーザがその定義を作成したか、「すべてのデータの参照」権限を持っている必要があります。さらに、Chatter REST API では、定義を作成した接続アプリケーションから要求を実行する必要があります。Apex では、定義を作成した名前空間からコールを行う必要があります。

コンテキスト変数コンテキスト変数を使用して、アクションリンクを実行したユーザとアクションリンクが呼び出されたコンテキストに関する情報を、アクションリンクの呼び出しによって実行された HTTP 要求に渡すことができます。コンテキスト変数は、Action Link Definition Input リクエストボディまたはConnectApi.ActionLinkDefinitionInputオブジェクトの actionUrl、headers、および requestBody

プロパティで使用できます。コンテキスト変数はまた、アクションリンクテンプレートの [アクション URL]、

60


[HTTP リクエストボディ]、および [HTTP ヘッダー]項目でも使用できます。テンプレートの公開後も、これらの項目は編集 (コンテキスト変数の追加と削除を含む) できます。次のコンテキスト変数があります。

説明コンテキスト変数

ユーザが実行したアクションリンクの ID。{!actionLinkId}

ユーザが実行したアクションリンクが含まれるアクションリンクグループの ID。

{!actionLinkGroupId}

ユーザがアクションリンクを実行したコミュニティのID。内部組織の場合、値は空のキー"000000000000000000" になります。

{!communityId}

ユーザがアクションリンクを実行したコミュニティのURL。内部組織の場合、値は空の文字列 "" になります。

{!communityUrl}

ユーザがアクションリンクを実行した組織の ID。{!orgId}

アクションリンクを実行したユーザの ID。{!userId}

バージョン設定API のアップグレードや機能の変更による問題を避けるため、アクションリンクを定義するときにはバージョン設定を使用することをお勧めします。たとえば、Action Link Definition Input の actionUrl プロパティはhttps://www.example.com/api/v1/exampleResource のようになります。テンプレートがパッケージで配布された後でも、テンプレートを使用して actionUrl、headers、またはrequestBodyプロパティの値を変更できます。たとえば、新しい入力が必要な新しい API バージョンをリリースする場合、システム管理者はアクションリンクテンプレートの入力を変更できます。すでにフィード要素に関連付けられているアクションリンクでも新しい入力が使用されます。ただし、新しいバインド変数を公開済みアクションリンクテンプレートに追加することはできません。API がバージョン管理されていない場合、Action Link Group Definition Input の expirationDate プロパティを使用して API のアップグレードや機能変更による問題を避けることができます。「アクションリンクグループの有効期限の設定」を参照してください。

エラーアクションリンクの診断情報リソース (/connect/action-links/actionLinkId/diagnostic-info) を使用して、Api アクションリンクおよび AsyncApi アクションリンクを実行後の状況コードおよびエラーを返します。診断情報は、アクションリンクにアクセスできるユーザに対してのみ提供されます。

61


ローカライズされた表示ラベルアクションリンクは、Action Link Definition Input リクエストボディの labelKey プロパティおよびアクションリンクテンプレートの [表示ラベルキー] 項目に指定された、定義済みのローカライズされた表示ラベルセットを使用します。表示ラベルのリストについては、「アクションリンクの表示ラベル」を参照してください。

メモ: アクションリンクに適した表示ラベルキー値がない場合、アクションリンクテンプレートの [表示ラベル]項目にカスタムラベルを指定し、[表示ラベルキー]を [なし] に設定します。ただし、カスタム表示ラベルはローカライズされません。

アクションリンクテンプレートエディション


使用可能なエディション:Personal Edition を除くすべてのエディション。

[設定] でアクションリンクテンプレートを作成し、Chatter REST API または Apex から共通のプロパティを持つアクションリンクグループをインスタンス化できます。テンプレートをパッケージ化して他の Salesforce 組織に配布できます。アクションリンクは、フィード要素上のボタンです。アクションリンクをクリックすると、ユーザを特定の Web ページに移動したり、ファイルダウンロードを開始したり、Salesforce または外部サーバへの API コールを呼び出したりできます。アクションリンクには、URL と HTTP メソッドが含まれ、リクエストボディとヘッダー情報 (認証用の OAuth トークンなど) を含めることができます。アクションリンクを使用して Salesforce およびサードパーティサービスをフィードに統合することで、ユーザはアクションを実行して生産性を高め、イノベーションを促進できます。次の例では、[承認]と [却下]が架空の旅行 Web サイトの REST API への API コールを実行して旅程を承認または却下するアクションリンクです。Pam が旅行 Web サイトに旅程を作成すると、旅行 Web サイトが Chatter REST API

要求を実行してアクションリンクを含むフィード項目を Pam のマネージャである Kevin に対して投稿し、Kevin

が旅程を承認または却下できるようにします。

62

アクションリンクテンプレートChatter REST API の機能

重要: アクションリンクは開発者機能です。アクションリンクテンプレートは [設定] で作成しますが、Apex または Chatter REST API を使用してテンプレートからアクションリンクを生成し、そのリンクをフィード要素に追加する必要があります。


アクションリンクテンプレートの設計テンプレートを作成する前に、テンプレートにどの値を設定し、テンプレートからアクションリンクグループをインスタンス化するときにバインド変数にどの値を設定するかを検討します。アクションリンクテンプレートの作成[設定] でアクションリンクテンプレートを作成し、Chatter REST API または Apex から共通のプロパティを持つアクションリンクグループをインスタンス化できます。テンプレートをパッケージ化して他の Salesforce 組織に配布できます。アクションリンクテンプレートの編集未公開のアクションリンクグループテンプレートおよび関連付けられているアクションリンクテンプレートのすべての項目を編集できます。アクションリンクグループテンプレートの削除アクションリンクグループテンプレートを削除すると、関連付けられているアクションリンクテンプレートと、そのテンプレートからインスタンス化されているすべてのアクションリンクグループが削除されます。削除されたアクションリンクグループは、関連付けられているすべてのフィード要素に表示されなくなります。アクションリンクテンプレートのパッケージ化アクションリンクテンプレートをパッケージ化して他の Salesforce 組織に配布できます。

関連トピック:

テンプレートのアクションリンクを定義し、フィード要素を使用して投稿するテンプレートのアクションリンクを定義し、フィード要素を使用して投稿する

アクションリンクテンプレートの設計テンプレートを作成する前に、テンプレートにどの値を設定し、テンプレートからアクションリンクグループをインスタンス化するときにバインド変数にどの値を設定するかを検討します。• アクションリンクテンプレートの概要• テンプレート設計の考慮事項• アクションリンクグループの有効期限の設定• バインド変数の定義• アクションリンクを表示できるユーザの設定• コンテキスト変数の使用

63


アクションリンクテンプレートの概要[設定] に次のようなアクションリンクグループテンプレートが表示されます。

各アクションリンクグループに、少なくとも 1 つのアクションリンクが必要です。この例のアクションリンクテンプレートには、[アクション URL]項目に API バージョン番号、[HTTP リクエストボディ]項目にアイテム番号、[HTTP ヘッダー] 項目に OAuth トークン値の 3 つのバインド変数があります。

64


アクションリンクグループをインスタンス化して、バインド変数の値を設定する Chatter REST API 要求は、次のとおりです。POST /connect/action-link-group-definitions

{"templateId":"07gD00000004C9r","templateBindings":[

{"key":"ApiVersion","value":"v1.0"

},{

"key":"ItemNumber","value":"8675309"

},{

"key":"BearerToken",

"value":"00DRR0000000N0g!ARoAQMZyQtsP1Gs27EZ8hl7vdpYXH5O5rv1VNprqTeD12xYnvygD3JgPnNR"}

]}

次は、テンプレートからアクションリンクグループをインスタンス化して、バインド変数の値を設定するApex

コードです。// Get the action link group template Id.ActionLinkGroupTemplate template = [SELECT Id FROM ActionLinkGroupTemplate WHEREDeveloperName='Doc_Example'];

// Add binding name-value pairs to a map.Map<String, String> bindingMap = new Map<String, String>();bindingMap.put('ApiVersion', '1.0');bindingMap.put('ItemNumber', '8675309');bindingMap.put('BearerToken','00DRR0000000N0g!ARoAQMZyQtsP1Gs27EZ8hl7vdpYXH5O5rv1VNprqTeD12xYnvygD3JgPnNR');

// Create ActionLinkTemplateBindingInput objects from the map elements.List<ConnectApi.ActionLinkTemplateBindingInput> bindingInputs = newList<ConnectApi.ActionLinkTemplateBindingInput>();for (String key : bindingMap.keySet()) {

ConnectApi.ActionLinkTemplateBindingInput bindingInput = newConnectApi.ActionLinkTemplateBindingInput();

bindingInput.key = key;bindingInput.value = bindingMap.get(key);bindingInputs.add(bindingInput);

}

// Set the template Id and template binding values in the action link group definition.ConnectApi.ActionLinkGroupDefinitionInput actionLinkGroupDefinitionInput = newConnectApi.ActionLinkGroupDefinitionInput();actionLinkGroupDefinitionInput.templateId = template.id;actionLinkGroupDefinitionInput.templateBindings = bindingInputs;

65


// Instantiate the action link group definition.ConnectApi.ActionLinkGroupDefinition actionLinkGroupDefinition =ConnectApi.ActionLinks.createActionLinkGroupDefinition(Network.getNetworkId(),actionLinkGroupDefinitionInput);

テンプレート設計の考慮事項テンプレートを設計するときは次の点を検討します。• アクションリンクグループの有効期限を決定します。

「アクションリンクグループの有効期限の設定」を参照してください。• テンプレートにバインド変数を定義して、グループをインスタンス化するときの値を設定します。テンプ

レートに機密情報を保存しないでください。機密情報はバインド変数を使用して実行時に追加します。「バインド変数の定義」を参照してください。

• アクションリンクがフィード要素に関連付けられているときに、アクションリンクを表示できるユーザを決定します。「アクションリンクを表示できるユーザの設定」を参照してください。

• アクションリンクの実行コンテキストに関する情報を取得するためには、テンプレートのコンテキスト変数を使用します。アクションリンクの実行時に、Salesforce が値を入力し、HTTP 要求で送信します。「コンテキスト変数の使用」を参照してください。

アクションリンクグループの有効期限の設定テンプレートからアクションリンクグループを作成するときに、テンプレートに指定された期間に基づいて有効期限を計算することも、アクションリンクグループに有効期限を設定しないことも可能です。テンプレートに有効期限までの時間を設定するには、アクションリンクグループテンプレートの[有効期限までの時間]項目に値を入力します。この値は、アクションリンクグループがインスタンス化されてから、関連付けられたフィード要素から削除され実行できなくなるまでの時間数です。最大値は 8760 で、365 日に相当します。アクションリンクグループをインスタンス化するときに有効期限を設定するには、Action Link Group Definition リクエストボディ (Chatter REST API) または ConnectApi.ActionLinkGroupDefinition 入力クラス (Apex) のいずれかの expirationDate プロパティを設定します。有効期限のないアクションリンクグループを作成するには、テンプレートの [有効期限までの時間] 項目に値を入力せず、アクションリンクグループをインスタンス化するときに expirationDate プロパティにも値を入力しません。テンプレートからアクションリンクグループを作成するときに、expirationDate と [有効期限までの時間]

は次のように連動します。• expirationDate を指定すると、新しいアクションリンクグループでその値が使用されます。• expirationDateを指定せず、テンプレートで [有効期限までの時間]を指定した場合は、新しいアクショ

ンリンクグループで [有効期限までの時間] の値が使用されます。

66


• expirationDateも [有効期限までの時間]も指定しない場合は、テンプレートからインスタンス化されたアクションリンクグループに有効期限が設定されません。

バインド変数の定義テンプレートでバインド変数を定義し、アクションリンクグループをインスタンス化するときにその値を設定します。

重要: テンプレートに機密情報を保存しないでください。機密情報はバインド変数を使用して実行時に追加します。バインドの値が設定されている場合は、Salesforce に暗号化形式で保存されます。

バインド変数は、アクションリンクテンプレートの [アクション URL]、[HTTP リクエストボディ]、および[HTTP ヘッダー] 項目で定義できます。テンプレートを公開後、これらの項目を編集することや項目間でバインド変数を移動させること、バインド変数を削除することができます。ただし、新しいバインド変数を追加することはできません。テンプレートでバインド変数のキーを定義します。アクションリンクグループをインスタンス化するときに、キーとその値を指定します。バインド変数キーは {!Bindings.key} の形式です。key は、事前に定義された \w 文字クラスの[\p{Alpha}\p{gc=Mn}\p{gc=Me}\p{gc=Mc}\p{Digit}\p{gc=Pc}] で Unicode 文字をサポートします。次の [アクション URL] 項目には 2 つのバインド変数があります。https://www.example.com/{!Bindings.ApiVersion}/items/{!Bindings.ItemId}

次の [HTTP ヘッダー] 項目には 2 つのバインド変数があります。Authorization: OAuth {!Bindings.OAuthToken}Content-Type: {!Bindings.ContentType}

アクションリンクグループを Chatter REST API でインスタンス化するときにキーとその値を指定します。

POST /connect/action-link-group-definitions

{"templateId":"07gD00000004C9r","templateBindings" : [

{"key":"ApiVersion","value":"1.0"

},{

"key":"ItemId","value":"8675309"

},{

"key":"OAuthToken","value":"00DRR0000000N0g_!..."

},{

"key":"ContentType",

67


http://www.unicode.org/reports/tr18/#Compatibility_Properties

"value":"application/json"}

]}

Apex にバインド変数キーを指定して、その値を設定します。Map<String, String> bindingMap = new Map<String, String>();bindingMap.put('ApiVersion', '1.0');bindingMap.put('ItemId', '8675309');bindingMap.put('OAuthToken', '00DRR0000000N0g_!...');bindingMap.put('ContentType', 'application/json');

List<ConnectApi.ActionLinkTemplateBindingInput> bindingInputs =new List<ConnectApi.ActionLinkTemplateBindingInput>();

for (String key : bindingMap.keySet()) {ConnectApi.ActionLinkTemplateBindingInput bindingInput = new

ConnectApi.ActionLinkTemplateBindingInput();bindingInput.key = key;bindingInput.value = bindingMap.get(key);bindingInputs.add(bindingInput);

}

// Define the action link group definition.ConnectApi.ActionLinkGroupDefinitionInput actionLinkGroupDefinitionInput =new ConnectApi.ActionLinkGroupDefinitionInput();actionLinkGroupDefinitionInput.templateId = '07gD00000004C9r';actionLinkGroupDefinitionInput.templateBindings = bindingInputs;

// Instantiate the action link group definition.ConnectApi.ActionLinkGroupDefinition actionLinkGroupDefinition =ConnectApi.ActionLinks.createActionLinkGroupDefinition(Network.getNetworkId(),actionLinkGroupDefinitionInput);

ヒント: アクションリンクテンプレートでは同じバインド変数を複数回使用でき、インスタンス化のときに値を 1 回だけ指定します。たとえば、あるアクションリンクテンプレートの [HTTP リクエストボディ]

項目で {!Bindings.MyBinding} を 2 回使用し、同じアクションリンクグループテンプレート内の別のアクションリンクテンプレートの [HTTP ヘッダー] 項目でもう一回使用することができますが、この場合、テンプレートからアクションリンクグループをインスタンス化するときにこの共有変数の値を 1 回のみ指定します。

アクションリンクを表示できるユーザの設定[ユーザ表示設定] ドロップダウンリストから値を選択して、アクションリンクがフィード要素に関連付けられた後にそのアクションリンクを表示できるユーザを決定します。使用可能なオプションに [カスタムユーザのみに表示] と [カスタムユーザ以外の全員に表示] があります。このいずれかの値を選択して、アクションリンクを特定のユーザのみが表示できるようにするか、特定のユーザが表示できないようにします。次に、[カスタムユーザ(別名)] 項目に値を入力します。この値はバインド変数キーです。アクションリンクグループをインスタンス化するコードで、キーを使用して、バインド変数の場合と同じように値を指定します。

68


次のテンプレートは、[カスタムユーザ(別名)] の値に Invitee を使用します。

アクションリンクグループをインスタンス化するときに、バインド変数を設定する場合と同じように値を設定します。


{"templateId":"07gD00000004C9r","templateBindings" : [

{"key":"Invitee","value":"005D00000017u6x"

}]

}

テンプレートで[作成者のマネージャのみに表示]を使用する場合にユーザにマネージャがいなければ、テンプレートからアクションリンクグループをインスタンス化するときにエラーが表示されます。この場合のマネー

69


ジャは、インスタンス化の時点のマネージャです。インスタンス化した後にユーザのマネージャを変更した場合、この変更は反映されません。

コンテキスト変数の使用コンテキスト変数を使用して、アクションリンクを実行したユーザとアクションリンクが呼び出されたコンテキストに関する情報を、アクションリンクの呼び出しによって実行された HTTP 要求に渡すことができます。コンテキスト変数は、Action Link Definition Input リクエストボディまたはConnectApi.ActionLinkDefinitionInputオブジェクトの actionUrl、headers、および requestBody

プロパティで使用できます。コンテキスト変数はまた、アクションリンクテンプレートの [アクション URL]、[HTTP リクエストボディ]、および [HTTP ヘッダー]項目でも使用できます。テンプレートの公開後も、これらの項目は編集 (コンテキスト変数の追加と削除を含む) できます。使用可能なコンテキスト変数は次のとおりです。






{!communityId}


{!communityUrl}



たとえば、Survey Example という会社に勤務していて、「Survey Example for Salesforce」というアプリケーションを Salesforce AppExchange 用に作成したとします。会社 A には「Survey Example for Salesforce」がインストールされています。会社 A の誰かが surveyexample.com にアクセスしてアンケートを作成します。Survey Example

のコードは、Chatter REST API を使用して、会社 A の Salesforce 組織に本文テキスト [調査を実行] と、表示ラベル[OK] のアクションリンクを含むフィード項目を作成します。この UIアクションリンクをクリックすると、ユーザがSalesforceからアンケートに回答する surveyexample.com

の Web ページに移動します。そのアクションリンクの [HTTP リクエストボディ] または [アクション URL] に {!userId} コンテキスト変数が含まれる場合、ユーザがフィードのアクションリンクをクリックすると、Salesforceはクリックしたユーザの ID を、作成した HTTP 要求に含めてサーバに送信します。アクションリンクを作成する Survey Example のサーバ側コードに {!actionLinkId} コンテキスト変数が含まれる場合は、Salesforce がアクションリンクの ID を含む HTTP 要求を送信するため、この ID をデータベースに保存できます。

70


次の例では、アクションリンクテンプレートの [アクション URL] に {!userId} コンテキスト変数が含まれます。

ヒント: バインド変数とコンテキスト変数は同じ項目で使用できます。たとえば、アクション URLhttps://www.example.com/{!Bindings.apiVersion}/doSurvey?salesforceUserId={!userId}

にはバインド変数とコンテキスト変数が含まれています。

71


アクションリンクテンプレートの作成

エディション



ユーザ権限

アクションリンクグループテンプレートを作成する• 「アプリケーションの

カスタマイズ」

アクションリンクテンプレートを作成する• 「アプリケーションの


[設定] でアクションリンクテンプレートを作成し、Chatter REST API または Apex から共通のプロパティを持つアクションリンクグループをインスタンス化できます。テンプレートをパッケージ化して他の Salesforce 組織に配布できます。

メモ: アクションリンクテンプレートは、[設定] から作成するだけでなく、メタデータ API、SOAP API、および REST APIを使用して作成することもできます。

[アクション URL]、[HTTP リクエストボディ]、および [HTTP ヘッダー] 項目はバインド変数とコンテキスト変数をサポートします。テンプレートにバインド変数を定義し、アクションリンクグループをインスタンス化するときにその値を設定します。テンプレートでコンテキスト変数が使用されている場合、アクションリンクが実行されると Salesforce が値を入力して要求で返します。テンプレートでこれらの変数を使用する方法についての詳細は、「アクションリンクテンプレートの設計」を参照してください。1. [設定] から、[クイック検索]ボックスに「アクションリンクテンプレート」と

入力し、[アクションリンクテンプレート] を選択します。2. [新規] をクリックします。3. テンプレートの [名前]を入力します。この名前が、アクションリンクグルー

プテンプレートのリストに表示されます。これがアクションリンクグループテンプレートの公開後に編集可能な唯一のアクションリンクグループテンプレート値です。

4. [API 参照名]を入力します。コードからこのテンプレートを参照するには、開発者名を使用します。[API

参照名] はデフォルトの空白を除いた名前になります。文字、数字、アンダースコア文字のみを使用できます。

5. [カテゴリ]を選択します。これは、インスタンス化したアクションリンクグループをフィード要素上のどこに表示するかを示します。[プライマリ] を選択すると、アクションリンクグループはフィード要素の本文に表示されます。[オーバーフロー] を選択すると、アクションリンクグループはフィード要素のオーバーフローメニューに表示されます。アクションリンクグループテンプレートが [プライマリ] の場合、最大 3 個のアクションリンクテンプレートを含めることができます。アクションリンクグループテンプレートが [オーバーフロー] の場合、最大 4

個のアクションリンクテンプレートを含めることができます。6. [実行可] の数を選択します。これは、このテンプレートからインスタンス化されたアクションリンクグ

ループを何回実行できるかを示します (1 つのグループ内に同じアクションリンクを含めることはできません)。Unlimited を選択すると、グループ内のアクションリンクを種別 Apiまたは ApiAsyncにすることはできません。

7. (省略可能) [有効期限までの時間] を入力します。これは、アクションリンクグループを作成してから、アクションリンクグループが関連するフィード要素から削除され実行できなくなるまでの時間数です。最大値は、8760 です。「アクションリンクグループの有効期限の設定」を参照してください。

72


8. [保存] をクリックします。9. [新規] をクリックしてアクションリンクテンプレートを作成します。

アクションリンクテンプレートは、自動的に主従関係でアクションリンクグループテンプレートに関連付けられます。

10. [アクション種別] をクリックします。値は次のとおりです。• Api — アクションリンクは、アクション URL で同期 API をコールします。Salesforce は、サーバから返さ

れた HTTP 状況コードに基づいて状況を SuccessfulStatus または FailedStatus に設定します。• ApiAsync — アクションリンクは、アクション URL で非同期 API をコールします。アクションは、非同

期操作の完了時にサードパーティが /connect/action-links/actionLinkIdへの要求を行って状況を SuccessfulStatus または FailedStatus に設定するまで、PendingStatus 状態のままになります。

• Download — アクションリンクは、アクション URL からファイルをダウンロードします。• Ui — アクションリンクはアクション URL の Web ページをユーザに表示します。

11. [アクション URL] を入力します。これはアクションリンクの URL です。UIアクションリンクの場合、URL は Web ページになります。Downloadアクションリンクの場合、URL は、ダウンロードするファイルへのリンクになります。Api アクションリンクまたは ApiAsync アクションリンクの場合、URL は REST リソースになります。Salesforceサーバでホストされるリソースへのリンクは、 / で開始する相対リンクにすることができます。他のすべてのリンクは、https:// で始まる絶対リンクにする必要があります。この項目には、バインド変数を {!Bindings.key} 形式で含めることができます(https://www.example.com/{!Bindings.itemId} など)。バインド変数の値は、テンプレートからアクションリンクグループをインスタンス化するときに設定します。たとえば、次の Chatter REST API の例では、itemId の値が 8675309 に設定されます。


{"templateId" : "07gD00000004C9r","templateBindings" : [

{"key":"itemId","value": "8675309"

}]

}

この項目には、コンテキスト変数を含めることもできます。コンテキスト変数を使用して、アクションリンクを実行したユーザに関する情報をサーバ側のコードに渡すことができます。たとえば、次のアクションリンクは、アンケートに回答するためにアクションリンクをクリックしたユーザの ID を、アンケートをホストするサーバに渡します。actionUrl=https://example.com/doSurvey?surveyId=1234&salesforceUserId={!userId}

73


12. HTTP 要求の実行に使用する [HTTP メソッド] を入力します。13. (省略可能) [アクション種別] が Api または ApiAsync の場合、[HTTP リクエストボディ] を入力します。

この項目には、バインド変数とコンテキスト変数を含めることができます。14. (省略可能) [アクション種別] が Api または ApiAsync の場合、[HTTP ヘッダー] を入力します。

この項目には、バインド変数とコンテキスト変数を含めることができます。テンプレートからインスタンス化されたアクションリンクが Salesforce リソースへの要求を実行する場合、テンプレートには Content-Type ヘッダーが必要です。

15. (省略可能) このアクションリンクをグループのデフォルトリンク (UI で特殊な形式を使用) にするには、[グループ内のデフォルトリンク] を選択します。各グループに含めることができるデフォルトリンクは 1 つのみです。

16. (省略可能) アクションリンクが実行される前にユーザに確認ダイアログを表示するには、[要確認] を選択します。

17. このテンプレートからインスタンス化されたアクションリンクグループ内のアクションリンクの相対 [位置] を入力します。最初の位置は 0 です。

18. [表示ラベルキー] を入力します。この値は、状況 NewStatus、PendingStatus、SuccessfulStatus、FailedStatus に対して表示される UI 表示ラベルセットのキーです。たとえば、[投稿]セットには、[投稿]、[投稿待機中]、[投稿済み]、[投稿失敗]の表示ラベルが含まれます。次の画像は、状況の値が SuccessfulStatus のときの [投稿] 表示ラベルキーを持つアクションリンクを示します。

74


19. (省略可能) アクションリンクに適した [表示ラベルキー] 値がない場合、[表示ラベルキー] を [なし] に設定して、[表示ラベル] 項目に値を入力します。アクションリンクには、NewStatus、PendingStatus、SuccessStatus、FailedStatus の 4 つの状況があります。次の文字列が、各状況の表示ラベルに追加されます。• 表示ラベル• 表示ラベル待機中• 表示ラベル成功• 表示ラベル失敗たとえば、label の値が「See Example」の場合、4 つのアクションリンクの状態の値は「See Example」、「See Example 待機中」、「See Example 成功」、および「See Example 失敗」になります。アクションリンクでは、表示ラベル名の生成に LabelKey または Label を使用できますが、両方は使用できません。

20. [ユーザ表示設定] を選択します。これはアクションリンクグループを表示できるユーザを示します。[作成者のマネージャのみに表示] を選択した場合、マネージャはアクションリンクグループがインスタンス化されたときの作成者のマネージャになります。アクションリンクグループがインスタンス化された後に作成者のマネージャが変わった場合、変更は反映されません。

21. (省略可能) [カスタムユーザのみに表示] または [カスタムユーザ以外の全員に表示] を選択した場合は、[カスタムユーザ(別名)] を入力します。バインド変数の値を設定する場合と同様に、文字列を入力し、アクションリンクグループをインスタンス化するときにその値を設定します。ただし、テンプレートではバインド変数の構文は使用せずに、値のみを入力してください。たとえば、ExpenseApprover などと入力します。次の Chatter REST API の例では、ExpenseApprover の値を 005B0000000Ge16 に設定します。


{"templateId" : "07gD00000004C9r","templateBindings" : [

{"key":"ExpenseApprover","value": "005B0000000Ge16"

}]

}

22. このアクションリンクグループテンプレートに別のアクションリンクテンプレートを作成するには、[保存& 新規] をクリックします。

23. このアクションリンクグループテンプレートへのアクションリンクテンプレートの追加が完了したら、[保存] をクリックします。

24. アクションリンクグループテンプレートを公開するには、[最後に開いたビューへ] をクリックして [アクションリンクグループテンプレート] リストビューに戻ります。

75


重要: Apexまたは Chatter REST APIでアクションリンクグループをテンプレートからインスタンス化するには、事前にテンプレートを公開する必要があります。

25. 公開するアクションリンクグループテンプレートの [編集] をクリックします。26. [公開済み] を選択して、[保存] をクリックします。

アクションリンクテンプレートの編集

エディション



ユーザ権限

アクションリンクグループテンプレートを編集する• 「アプリケーションの


アクションリンクテンプレートを編集する• 「アプリケーションの


未公開のアクションリンクグループテンプレートおよび関連付けられているアクションリンクテンプレートのすべての項目を編集できます。1. [設定] から、[クイック検索]ボックスに「アクションリンクテンプレート」と

入力し、[アクションリンクテンプレート] を選択します。2. アクションリンクグループテンプレートを編集するには、名前の横にある

[編集] をクリックします。グループテンプレートが公開されていない場合は、任意の項目を編集します。公開されている場合は、[名前] 項目のみを編集します。

3. アクションリンクテンプレートを編集する手順は次のとおりです。a. 主アクションリンクグループテンプレートの名前をクリックします。b. アクションリンクテンプレート ID をクリックして、アクションリンクテ

ンプレートの詳細ページを表示します。c. [編集] をクリックします。

関連付けられているアクションリンクグループテンプレートが公開されていない場合は、任意の項目を編集します。公開されている場合は、次のいずれかの項目を編集します。• アクション URL

• HTTP リクエストボディ• HTTP ヘッダー上記の項目は、コンテキスト変数およびバインド変数をサポートします。これらのいずれかの項目のコンテキスト変数を追加および削除できます。新しいバインド変数を追加することはできません。実行できる操作は、次のとおりです。• バインド変数をアクションリンクテンプレートの別の編集可能項目に移動する。• アクションリンクテンプレートでバインド変数を複数回使用する。• 同じアクションリンクグループテンプレートに関連付けられている任意のアクションリンクテンプ

レートでバインド変数を複数回使用する。• バインド変数を削除する。

76


アクションリンクグループテンプレートの削除

エディション



ユーザ権限

アクションリンクグループテンプレートを削除する• 「アプリケーションの


アクションリンクテンプレートを削除する• 「アプリケーションの


アクションリンクグループテンプレートを削除すると、関連付けられているアクションリンクテンプレートと、そのテンプレートからインスタンス化されているすべてのアクションリンクグループが削除されます。削除されたアクションリンクグループは、関連付けられているすべてのフィード要素に表示されなくなります。1. [設定] から、[クイック検索]ボックスに「アクションリンクテンプレート」と

入力し、[アクションリンクテンプレート] を選択します。2. アクションリンクグループテンプレートを削除するには、名前の横にある

[削除] をクリックします。

重要: アクションリンクグループテンプレートを削除すると、関連付けられているアクションリンクテンプレートと、そのテンプレートからインスタンス化されているすべてのアクションリンクグループが削除されます。アクションリンクグループは、関連付けられているすべてのフィード要素から削除されます。つまり、アクションリンクはフィードの投稿に表示されなくなります。

3. アクションリンクテンプレートを削除する手順は、次のとおりです。a. 主アクションリンクグループテンプレートの名前をクリックします。b. アクションリンクテンプレート ID をクリックして、アクションリンクテ

ンプレートの詳細ページを表示します。c. [削除] をクリックします。

重要: 公開されているアクションリンクグループテンプレートに関連付けられているアクションリンクテンプレートは削除できません。

77


アクションリンクテンプレートのパッケージ化

エディション



ユーザ権限

アクションリンクテンプレートをパッケージ化する• 「AppExchange パッ

ケージの作成」

アクションリンクテンプレートをパッケージ化して他の Salesforce 組織に配布できます。アクションリンクグループテンプレートを追加すると、関連付けられているアクションリンクテンプレートもパッケージに追加されます。アクションリンクグループテンプレートは、未管理パッケージまたは管理パッケージに追加できます。アクションリンクグループテンプレートは、パッケージ化できるコンポーネントとして管理パッケージのすべての機能 (AppExchangeのリスト、転送アップグレード、インストール後 Apex スクリプト、ライセンス管理、高度な登録者サポートなど) も活用できます。管理パッケージを作成するには、Developer Edition

組織を使用する必要があります。• 「パッケージの作成および編集」(https://help.salesforce.com) を参照してくださ

い。

コミュニティの使用

コミュニティは、従業員、お客様、およびパートナーが接続するブランド空間です。ビジネスニーズに合わせてコミュニティをカスタマイズしながら作成することができ、その後もコミュニティ間をシームレスに移行できます。特定のコミュニティでは、ほとんどのChatter REST APIリソースを要求できます。たとえば、特定のコミュニティ内で、Feeds、Files、Groups、Topics、Users リソースに対して要求を実行できます。コミュニティでリソースを使用できる場合、そのドキュメントには /connect/communities/communityIdで始まるリソースが含まれます。一部の Chatter REST API リソースは、コミュニティ内でのみ使用できます。これには、コンテンツのフラグ設定とモデレート、管理トピックの使用、ユーザの評価に関する情報の取得を行うためのリソースが含まれます。コミュニティで使用できるリソースは、ログインなしでのアクセスを許可するかどうかに関係なく使用できます。ただし、コミュニティでログインなしでのアクセスが許可されている場合、ゲストユーザはどの Chatter

REST API リソースにもアクセスできません。次の表に、コミュニティ内でのみ使用できるリソースを示します。

ToDoHTTP メソッドリソース

コンテキストユーザが使用できるすべてのコミュニティリストを返します。

GET/connect/communities

指定されたコミュニティに関する情報を返します。

GET/connect/communities/communityId

コンテキストユーザがコミュニティモデレータの場合、コミュニティメンバーが 1 つのコメ

GET、POST、DELETE

/connect/communities/communityId/chatter/comments/commentId/moderation-flags ントにフラグを設定した回数を返します。ま

た、モデレーションのためにコメントにフラ

78

コミュニティの使用Chatter REST API の機能

https://help.salesforce.com


グを設定したり、コメントのすべてのフラグを削除したりします。コンテキストユーザがコミュニティモデレータでない場合は、ユーザがコメントにフラグを設定したかどうかを返します。また、モデレーションのためにコメントにフラグを設定したり、ユーザが以前に追加したフラグを削除したりします。

フィード要素のモデレーション機能に関する情報の取得、フィード要素へのモデレーショ

GET、POST、DELETE

/connect/communities/communityId/chatter/feed-elements/feedElementId/capabilities/moderation ンフラグの追加、またはフィード要素のすべ

てのモデレーションフラグの削除を行います。

コンテキストユーザがコミュニティモデレータの場合、コミュニティメンバーによってフラグが設定されたファイルを返します。

GET/connect/communities/communityId/chatter/files/moderation

コンテキストユーザがコミュニティモデレータの場合、コミュニティメンバーが 1 つのファ

GET、POST、DELETE

/connect/communities/communityId/chatter/files/fileId/moderation-flags

イルにフラグを設定した回数を返します。また、モデレーションのためにファイルにフラグを設定したり、ファイルのすべてのフラグを削除したりします。コンテキストユーザがコミュニティモデレータでない場合は、ユーザがファイルにフラグを設定したかどうかを返します。また、モデレーションのためにファイルにフラグを設定したり、ユーザが以前に追加したフラグを削除したりします。

コンテキストユーザが「コミュニティフィードのモデレート」権限を持つコミュニティモ

GET/connect/communities/communityId/chatter/feeds/moderation/feed-elements

デレータの場合、コミュニティメンバーによってフラグが設定された、コミュニティ内のすべてのフィード要素とコメントのリストを返します。デフォルトでは、結果ページごとに25 件のフィード要素を返します。

コミュニティの管理トピックに関連付けられたすべてのフィード要素のリストを返します。

GET/connect/communities/communityId/chatter/feeds/home/feed-elements

79

コミュニティの使用Chatter REST API の機能


コミュニティのすべての管理トピックを取得します。管理トピックを作成します。管理トピックを並び替えます。

GET、POST、PATCH

/connect/communities/communityId/managed-topics

コミュニティの管理トピックの情報取得または削除を行います。

GET、DELETE/connect/communities/communityId/managed-topics/managedTopicId

指定されたコミュニティユーザの評価を返します。

GET/connect/communities/communityId/chatter/users/userId/reputation

関連トピック:

Chatter REST API リソース URL の作成コミュニティで要求を実行する

フィードおよびフィード要素の使用

API バージョン 30.0 以前では、Chatter フィードはフィード項目のコンテナでした。API バージョン 31.0 では、フィードの定義が拡張され、フィード項目モデルに完全には適合しない新しいオブジェクトが追加されました。Chatter フィードは、フィード要素のコンテナになりました。API バージョン 32.0 では、フィード要素はフィード項目または汎用フィード要素のどちらにすることもできます。フィードとフィード要素はChatterの中核部分であるため、Chatter REST APIを使用してアプリケーションを開発するには、これらの理解が不可欠です。

メモ: Salesforce ヘルプでは、フィード項目を投稿といいます。

機能フィードを多様化する取り組みの一環として、フィード要素の持つさまざまな機能性を個々の機能に分割しました。機能では、一貫した方法でフィードのオブジェクトを操作できます。フィード要素で使用できる機能を判別するためにフィード要素種別を調べないでください。使用可能な機能を明示的に示す機能オブジェクトを調べてください。機能が存在するかどうかを確認することで、フィード要素に対してクライアントが実行できる操作を判別します。すべてのフィード要素に capabilities プロパティがあり、このプロパティに Feed Element Capabilities レスポンスボディが保持されています。Feed Element Capabilities レスポンスボディには 1 つ以上のプロパティがあり、それぞれのプロパティにフィード要素の機能が保持されています。機能には、ある操作が可能であることを示す情報と、その操作に関連付けられたデータが含まれます。フィード要素に機能が存在する場合、機能に関連付けられたデータがまだなくてもその機能を使用できます。たとえば、chatterLikes機能プロパティがフィード要素に存在する場合 (chatterLikes.page.itemsプロパティ内のいいね! リストにいいね! が含まれているかどうかに関係なく)、コンテキストユーザはそのフィード要素にいいね! と言うことができます。その機能プロパティがフィード要素に存在しない場合、そのフィード要素にいいね! と言うことはできません。

80

フィードおよびフィード要素の使用Chatter REST API の機能

Salesforce UI でのフィード項目の表示「機能」で学んだように、クライアントは capabilities プロパティを使用して、フィード要素で可能な操作やフィード要素を表示する方法を判別します。フィード項目以外のすべてのフィード要素では、クライアントはフィード要素の種別を知る必要はなく、機能を確認できます。フィード項目には機能がありますが、actor

などのプロパティもいくつかあり、これらは機能として公開されていません。このため、フィード項目はフィード要素とは異なる方法で処理する必要があります。一貫したフィード項目のビューを顧客に提供し、容易に UI を作成する手段を開発者に提供するために、Salesforce

UI では、1 つのレイアウトを使用して各フィード項目を表示しています。このレイアウトには常に同じ要素が含まれ、要素は常に同じ位置にあります。変化するのはレイアウト要素のコンテンツのみです。

次のフィード項目レイアウト要素があります。1. アクター (Feed Item レスポンスボディの actor プロパティ) — フィード項目の作成者の写真またはアイコン2. ヘッダー (Feed Item レスポンスボディの header プロパティ) — コンテキストを提供します。同じフィード

項目に、誰がどこに投稿したかに応じて異なるヘッダーを設定できます。たとえば、Gordon がこのフィード項目を自分のプロファイルに投稿したとします。そのフィード項目をグループと共有すると、グループフィードのフィード項目のヘッダーは「Gordon Johnson (元の投稿者: Gordon Johnson)」となります。「元の投稿者」テキストが Gordon のプロファイルのフィード項目へのリンクになります。

3. 内容 (Feed Item レスポンスボディの bodyプロパティ) — すべてのフィード項目には内容がありますが、ユーザがフィード項目のテキストを指定しない場合は、内容が null になることがあります。内容は null になる可能性があるため、テキスト表示のデフォルトケースとして使用できません。代わりに、常に値が含まれる、フィード項目のヘッダーの text プロパティを使用します。

4. 補助内容 (Feed Item レスポンスボディの capabilities プロパティ) — フィード項目の機能の視覚化。「機能」を参照してください。

重要: attachmentプロパティは、API バージョン 32.0 以降でサポートされていません。代わりに、Feed

Element Capabilities レスポンスボディを保持する capabilities プロパティを使用して、フィード要素に表示する内容を確認します。

5. 作成者タイムスタンプ (Feed Item レスポンスボディの relativeCreatedDate プロパティ) — フィード項目が投稿された日時。フィード項目の作成後 2 日を経過していない場合、日時は相対的なローカライズされ

81


た文字列として書式設定されます (「17 分前」、「昨日」など)。それ以外の場合は、日時は絶対的なローカライズされた文字列として書式設定されます。

Salesforce UI でのバンドルの表示メモ: バンドル投稿にはフィード追跡変更が含まれます。Salesforce1 ダウンロード可能アプリケーションでは、バンドル投稿がレコードフィードのみにあります。

「機能」セクションで学んだように、クライアントは ConnectApi.FeedElement.capabilitiesプロパティを使用して、フィード要素で可能な操作やフィード要素を表示する方法を判別する必要があります。このセクションでは、フィード要素の表示方法の一例としてバンドルを使用しますが、これらのプロパティはどのフィード要素でも使用できます。きれいに整理されたフィードをユーザに提供するために、フィード変更追跡のフィード項目はバンドルに集約できます。個々のフィード項目を表示するには、バンドルをクリックします。

バンドルは、バンドル機能を備えた汎用フィード要素です。次のバンドルレイアウト要素があります。1. ヘッダー (Generic Feed Element レスポンスボディの header プロパティ) — フィード変更追跡バンドルの場

合、このテキストは「このレコードは更新されました。」です。ヘッダーの下にある時間は、Generic Feed Element レスポンスボディの relativeCreatedDate プロパティです。

2. 補助内容 (Generic Feed Element レスポンスボディの capabilities.bundle.changes プロパティ) — バンドルは、バンドル内の最初の 2 つのフィード変更追跡について fieldName、oldValue、および newValue

プロパティを表示します。フィード変更追跡が 3 つ以上ある場合は、バンドルが [すべての更新を表示] リンクを表示します。

82


フィード要素の表示ユーザに表示されるフィード要素は、システム管理者によるフィード追跡、共有ルール、および項目レベルセキュリティの設定に応じて異なります。たとえば、ユーザにレコードへのアクセス権がない場合、そのレコードの更新は表示されません。フィード要素の親を表示できるユーザは、そのフィード要素を表示できます。通常、ユーザには次のフィード更新が表示されます。• ユーザに @メンションしているフィード要素 (ユーザがそのフィード要素の親にアクセスできる場合)

• ユーザがメンバーであるグループに @メンションしているフィード要素• ユーザが親レコードを表示できるレコードに対するレコード項目の変更 (User、Group、および File レコード

を含む)

• ユーザに投稿されたフィード要素• ユーザが所有するか、ユーザがメンバーであるグループに投稿されたフィード要素• 標準およびカスタムレコードのフィード要素 (ToDo、行動、リード、取引先、ファイルなど)

フィード種別フィードには多くの種別があります。各フィード種別は、フィード要素のコレクションを定義するアルゴリズムです。

重要: このアルゴリズム、つまりフィード要素のコレクションは、リリースが変わると変更される可能性があります。

フィード種別はリソースで次のように公開されます。/chatter/feeds/feedType/chatter/feeds/feedType/subjectId

たとえば、次のリソースは、ニュースフィードとトピックフィードのリソースです。

/chatter/feeds/news/subjectId/chatter/feeds/topics/subjectId

各フィード種別とその説明は、次のとおりです。• Bookmarks — コンテキストユーザがブックマークとして保存したすべてのフィード項目が含まれます。• Company — 種別 TrackedChange のフィード項目を除くすべてのフィード項目が含まれます。ユーザが

フィード項目を表示するには、親への共有アクセス権が必要です。• Files — コンテキストユーザがフォローしている人またはグループによって投稿されたファイルを含むす

べてのフィード項目が含まれます。• Filter — 指定したオブジェクト種別の親を持つフィード項目を含むように絞り込まれたニュースフィー

ドが含まれます。• Groups — コンテキストユーザが所有するか、メンバーであるすべてのグループのすべてのフィード項目

が含まれます。• Home — コミュニティの管理トピックに関連付けられたすべてのフィード項目が含まれます。

83


• Moderation — モデレーション用にフラグが設定されたすべてのフィード項目が含まれます。このコミュニティモデレーションフィードは、「コミュニティフィードのモデレート」権限を持つユーザのみが使用できます。

• Mute — コンテキストユーザがミュートしたすべてのフィード項目が含まれます。• News — コンテキストユーザがフォローする人、ユーザがメンバーとなっているグループ、およびユーザ

がフォローするファイルとレコードからのすべての更新が含まれます。また、親がコンテキストユーザであるレコード、およびコンテキストユーザをメンションするかコンテキストユーザがメンバーとなっているグループをメンションするすべてのフィード項目とコメントのすべての更新も含まれます。

• People — コンテキストユーザがフォローしているすべての人によって投稿されたすべてのフィード項目が含まれます。

• Record — 親が指定したレコードであるすべてのフィード項目が含まれます。レコードは、グループ、ユーザ、オブジェクト、ファイル、その他の標準またはカスタムオブジェクトの場合があります。レコードがグループの場合、フィードにはそのグループにメンションしているフィード項目も含まれます。レコードがユーザの場合、フィードにはそのユーザに対するフィード項目のみが含まれます。別のユーザのレコードフィードを取得できます。

• To — コンテキストユーザのメンションを含むすべてのフィード項目、コンテキストユーザがコメントしたフィード項目、コンテキストユーザが作成し、コメントされたフィード項目が含まれます。

• Topics — 指定したトピックを含むすべてのフィード項目が含まれます。• UserProfile — フィードで追跡可能なレコードをユーザが変更したときに作成されたフィード項目、親

がユーザであるフィード項目、およびユーザに @メンションしているフィード項目が含まれます。このフィードは、グループ更新など、より多くのフィード項目を返すニュースフィードとは異なります。別のユーザのユーザプロファイルフィードを取得できます。

• Favorites — コンテキストユーザが保存したお気に入りが含まれます。お気に入りには、フィード検索、リストビュー、およびトピックがあります。

• Filter — 指定したエンティティ種別の親を持つ項目を含むように絞り込まれたニュースフィードが含まれます。

/chatter/feed-elements を使用したフィード項目の投稿ヒント: /chatter/feed-elementsリソースを使用すると、フィード種別を渡す必要がないため、非常に簡単に効率よくフィード項目を投稿できます。API バージョン 31.0 では、投稿できるフィード要素種別はフィード項目のみです。将来的に他のフィード要素種別が追加される可能性があるため、アプリケーションを今後の変更にも対応できるように、このリソースを使用します。

フィード項目を投稿するには、次のリソースを使用します。POST /chatter/feed-elements

フィード項目を投稿するときには、標準オブジェクトまたはカスタムオブジェクトの子を作成します。subjectId要求パラメータ、または Feed Item Input リクエストボディの subjectIdプロパティに、親オブジェクトを指定します。投稿されたフィード項目の parent プロパティには、親オブジェクトに関する情報が含まれます。

84


ユーザプロファイルへの投稿次の例では、要求パラメータを使用して、テキスト投稿をコンテキストユーザのユーザプロファイルに投稿します。POST /chatter/feed-elements?feedElementType=FeedItem&subjectId=me&text=Test

subjectId に、別名 me を指定します。コンテキストユーザのユーザ ID を指定することもできます。新しく投稿されたフィード項目の parent プロパティには、コンテキストユーザの User Summary レスポンスボディが含まれます。

別のユーザへの投稿次の例では、リクエストボディを使用して、別のユーザに投稿します。subjectIdプロパティでは、ユーザの ID を指定します。POST /chatter/feed-elements

{"feedElementType":"FeedItem","subjectId":"005RR000000DmOg","body" : {

"messageSegments" : [{

"type" : "Text","text" : "When should we meet for release planning?"

}]

}}

新しく投稿されたフィード項目の parent プロパティには、対象ユーザの User Summary レスポンスボディが含まれます。

グループへの投稿次の例では、リクエストボディを使用して、グループに投稿します。subjectIdプロパティでは、グループ ID を指定します。POST /chatter/feed-elements

{"feedElementType":"FeedItem","subjectId":"0F9RR0000004CPw","body" : {


"type" : "Text","text" : "When should we meet for release planning?"

}]

}}

新しく投稿されたフィード項目の parentプロパティには、指定されたグループの Group レスポンスボディが含まれます。

85


レコード (ファイルや取引先など) への投稿次の例では、リクエストボディを使用して、レコードフィードでユーザにメンションします。subjectId

プロパティでは、レコード ID を指定します。POST /chatter/feed-elements

{"feedElementType" : "FeedItem","subjectId" : "001RR000002G4Y0","body" : {


"type" : "Mention","id" : "005RR000000DmOg"

},{

"type" : "Text","text" : " Have you checked on this account recently?"

}]

}}

新しいフィード項目の parent プロパティは、指定されたレコードタイプに応じて異なります。レコードタイプが File の場合、親は File Summary レスポンスボディです。レコードタイプが Group の場合、親は Group

レスポンスボディです。レコードタイプが User の場合、親は User Summary レスポンスボディです。その他すべてのレコードタイプの場合、親は Record Summary レスポンスボディです。

フィードからのフィード要素の取得ヒント: フィード要素を含むフィードを返すには、次のメソッドをコールします。API バージョン 31.0 では、フィード要素種別はフィード項目とバンドルのみですが、これは今後変更される可能性があります。

フィードからフィード要素を取得する方法は、どのフィード種別でも似ていますが同一ではありません。会社フィード、ホームフィードまたはモデレーションフィードからフィード要素を取得する場合は、件名 ID

を指定しないでください。

リソースフィード種別

/chatter/feeds/company/feed-elementsCompany

/connect/communities/communityId/chatter/feeds/home/feed-elementsホーム/connect/communities/communityId/chatter/feeds/moderation/feed-elements

Moderation

お気に入りフィードおよびフィルタフィードからフィード要素を取得するには、favoriteIdまたはkeyPrefix

を指定します。keyPrefix はオブジェクト ID の最初の 3 文字であり、オブジェクト種別を示します。次のフィードの場合、subjectId は、コンテキストユーザの ID または別名 me である必要があります。

86



/chatter/feeds/favorites/subjectId/favoriteId/feed-elementsFavorites

/chatter/feeds/filter/subjectId/keyPrefix/feed-elementsFilter

レコードフィードからフィード要素を取得するには、レコード ID を指定します。


/chatter/feeds/record/recordId/feed-elementsRecord

ヒント: recordId は、フィードをサポートする任意のタイプのレコードにすることができます (グループを含む)。Salesforce UI のグループページ上のフィードは、レコードフィードです。

その他すべてのフィード種別からフィード要素を取得するには、件名 ID を指定します。別のフィードを指定するには、feedTypeを置き換えます。ユーザプロファイルフィードとトピックフィードを除く、次の表のすべてのフィード種別で、subjectId はコンテキストユーザの ID または別名 me である必要があります。


/chatter/feeds/feedType/subjectId/feed-elements

例: /chatter/feeds/news/me/feed-elements

Bookmarks、Files、Groups、Mute、News、People、To、Topics、User Profile

関連トピック:

Feeds リソース

Salesforce Files の使用

Chatter REST API を使用して、Salesforce Files Sync を含む、Salesforce Files を操作できます。Salesforce Files を使用すると、クラウドでファイルのアップロード、保存、検索、フォロー、共有、およびコラボレーションができます。Salesforce Files Sync を使用すると、Chatter、デスクトップ、モバイルデバイス間でファイルをセキュアに保存、同期、および共有できます。ファイルとフォルダにどこからでもアクセスして、即座に組織全体で更新して最新の状態を維持できます。


フィード要素の投稿や、組織のすべてのフィード要素の検索を行います。

GET、POST/chatter/feed-elements

87

Salesforce Files の使用Chatter REST API の機能


コンテキストユーザがフォローしている人またはグループによって投稿されたファイルを含むすべてのフィード要素を返します。

GET/chatter/feeds/files/me/feed-elements

コンテキストユーザが所有するグループかメンバーであるグループすべてからの全フィー

GET/chatter/feeds/news/me/feed-elements

ド要素と、コンテキストユーザがフォローしている全ファイル、レコード、およびユーザからの全フィード要素。このリソースは、フィード要素に関する情報を取得し、フィード要素を投稿するために使用します。

コンテキストユーザがフォローしているすべてのレコードのフィード要素、または指定さ

GET/chatter/feeds/records/recordId/feed-elements

れた recordId のすべてのフィード要素を返します。このリソースは、フィードの検索や特定のフィード (別のユーザのフィードも含める) のフィード要素の取得に使用します。このリソースを使用してグループのフィード要素を取得するには、グループ ID を recordId として指定します。

フィードで追跡可能なレコードをユーザが変更したときに作成されたフィード要素、親が

GET/chatter/feeds/user-profile/userId/feed-elements

ユーザであるフィード要素、およびユーザにメンションしているフィード要素を返します。このフィードは、グループ更新など、より多くのフィード項目を返すニュースフィードとは異なります。User-Profile Feed へのフィード項目の post 送信に使用できます。別のユーザのユーザプロファイルフィードを取得できます。

外部ファイルへの参照を含む、指定されたファイルに関する情報を取得します。外部ファイ

GET、POST、PATCH、DELETE

/chatter/files/fileId

ルへの参照を含む、既存のファイルの新バージョンをアップロードします。ファイルの名称変更、別のフォルダへの移動、ファイルの削除を行います。

外部ファイルへの参照を含む、ファイルのコンテンツを返します。コンテンツは、レスポンスボディとしてストリーミングされます。

GET/chatter/files/fileId/content

指定されたファイルの共有先であるオブジェクトに関する情報を返します。オブジェクト

GET、POST/chatter/files/fileId/file-shares

はユーザ、グループ、またはレコードの場合

88



があります。指定されたファイルをユーザと共有する場合にも使用できます。

リンクとして共有されるファイルの説明。ファイルの共有リンクの作成、アクセス、または削除を行います。

GET、PUT、DELETE

/chatter/files/fileId/file-shares/link

ファイルのサポートされているプレビューに関する情報の取得や、ファイルプレビューの生成を行います。

GET、PATCH/chatter/files/fileId/previews

ファイルプレビューまたはプレビュー内の特定のページを取得します。

GET/chatter/files/fileId/previews/previewFormat

ファイルの変換。変換とは、ファイルのバイナリプレビューです。バイナリの形式は、要求で指定された形式によって異なります。

GET/chatter/files/fileId/rendition

ファイル ID によって指定されたファイルのリストに関する情報。ファイルのリストに関す

GET、DELETE/chatter/files/batch/fileIds

る情報の取得や、ファイルのリストの削除を行います。

指定されたフォルダに関する情報を取得します。フォルダの移動、名前の変更、および削除を行います。ルートフォルダを同期します。

GET、PATCH、DELETE

/chatter/folders/folderId

フォルダの内容に関する情報を取得します。フォルダへのファイルの追加や、フォルダの

GET、POST/chatter/folders/folderId/items

作成を行います。ルートフォルダを同期します。

指定されたグループに投稿されたファイルに関する情報を返します。

GET/chatter/groups/groupId/files

指定されたトピックに最近投稿された 5 つのファイルに関する情報を返します。

GET/connect/topics/topicId/files

外部ファイルへの参照を含む、Salesforce Files

Sync へのファイルの投稿、またはユーザが所GET、POST/chatter/users/userId/files

有するファイルに関する情報の取得を行います。ユーザと共有されているファイル、ユーザがフォローしているファイル、一般的な組織ファイルは対象外です。

指定されたユーザがメンバーであるグループに投稿されたファイルに関する情報を返します。

GET/chatter/users/me/files/filter/groups

89



指定されたユーザと共有されているファイルに関する情報を返します。

GET/chatter/users/me/files/filter/shared-with-me

メモ: 別名 me は、コンテキストユーザのユーザ ID に置き換えることができます。

90


第 4 章 Chatter REST API の例Chatter REST API の例を使用してタスクを実行します。Chatter REST API を使用するときは、次の事項に留意してください。• 要求パラメータは Chatter REST API リソース URL の一部として組み込まれることがあります

(/chatter/users?q=searchtextなど)。リクエストボディは、要求の一部として組み込まれる可能性のあるリッチ入力です。リソースにアクセスするときは、リクエストボディまたは要求パラメータのいずれかを使用できます。両方は使用できません。

• リクエストボディでは、Content-Type: application/jsonまたは Content-Type: application/xml

を使用します。• 要求パラメータでは、Content-Type: application/x-www-form-urlencoded を使用します。リクエストボディについての詳細は、「入力での POST、PATCH、または PUT の使用」を参照してください。バイナリファイルのアップロード方法の例については、「バイナリファイルのアップロード」を参照してください。


レスポンスボディを絞り込むコミュニティで要求を実行する自分のニュースフィードを取得する他のユーザのフィードを取得するグループフィードを取得するフィード項目を投稿するフィード要素を投稿し、Salesforce のファイルを含めるインライン画像を含むフィード要素を投稿するコメントを投稿するコメントを投稿し、Salesforce のファイルを含めるバイナリファイルを投稿する@メンションを投稿する複数の @メンションを投稿する@メンション提案のリストを取得するアクションリンクを定義し、フィード要素を使用して投稿する

91

テンプレートのアクションリンクを定義し、フィード要素を使用して投稿するアクションリンクの状況を更新するかアクションリンクを呼び出すフィード投稿を編集するコメントを編集する質問のタイトルと投稿を編集するフィード項目にいいね! と言うフィード項目にいいね! と言い、いいね! の総数を返すフィード項目を共有する最後の要求以降に更新されたフィード要素を取得する内部のフィード項目のみを含むフィードを取得するフィードを検索するユーザがフォローしているレコードのリストを取得するユーザの Chatter 活動の統計情報を取得するフォローするユーザのおすすめを取得するカスタムのおすすめを作成し、利用者を使用してスケジュールするグループを作成するグループの写真を更新およびトリミングするグループに参加する非公開グループへの参加を要求する非公開グループへの参加要求を承認または却下するグループに投稿するレコードをフォローするレコードのフォローを停止するレコードフィードを取得するユーザプロファイルを更新するユーザの写真を更新およびトリミングする非公開メッセージを送信する複数のユーザのユーザ情報を取得する

レスポンスボディを絞り込む

リソースすべて

HTTP メソッドGET

92

レスポンスボディを絞り込むChatter REST API の例

要求パラメータexclude、include、および filterGroup

要求を行うときにレスポンスボディを絞り込むには、exclude および include クエリパラメータを使用します。クエリ値は、バー (|) で区切られたプロパティのリストです。URL は、バーを %7Cとして符号化します。各プロパティ名の前にスラッシュ (/) を使用します。返すレスポンスボディ (Big、Medium、または Small) を指定するには、filterGroup クエリパラメータを使用します。各レスポンスボディのすべてのプロパティにこれらのグループサイズのいずれかが割り当てられます。

要求パラメータの例この News Feed URL リソースは次のようになります。/chatter/users/me?include=/aboutMe%7C/address

ルールと例についての詳細は、「応答サイズの指定」を参照してください。戻り値

絞り込まれたレスポンスボディ上記の要求パラメータの例では、Feed レスポンスボディに対して次を返します。{

"aboutMe": "Salesforce Administrator and Citizen Developer","address": {

"city": "San Francisco","country": "US","formattedAddress": "1 Market St\nSan Francisco, CA 94105\nUS","state": "CA","street": "1 Market St","zip": "94105"

}}

コミュニティで要求を実行する

リソースドキュメントにサポート対象外と明記されている場合を除き、リソースはコミュニティをサポートします。

HTTP メソッド不特定

例特定のコミュニティへの要求を実行するには、リソースにプレフィックス/connect/communities/communityId を付けます。たとえば、次のリソースは、特定のコミュニティの新しいフィードからフィード項目を取得します。/connect/communities/communityId/chatter/feeds/news/me/feed-elements

詳細は、「Chatter REST API リソース URL の作成」および「Salesforce Communities への接続」を参照してください。

93

コミュニティで要求を実行するChatter REST API の例

戻り値不特定

自分のニュースフィードを取得する

リソース/chatter/feeds/news/me/feed-elements


例/services/data/v35.0/chatter/feeds/news/me/feed-elements

戻り値Feed Element Page

他のユーザのフィードを取得する

リソース/chatter/feeds/user-profile/userId/feed-elements

または/chatter/feeds/record/userId/feed-elements


例/services/data/v35.0/chatter/feeds/user-profile/005R0000000HwMA/feed-elements

または/services/data/v35.0/chatter/feeds/record/005R0000000HwMA/feed-elements


関連トピック:

User Profile Feed リソースRecord Feed リソース

グループフィードを取得する

リソース/chatter/feeds/record/recordId/feed-elements

94

自分のニュースフィードを取得するChatter REST API の例

recordId をグループ ID に置き換えます。HTTP メソッド

GET

例/services/data/v35.0/chatter/feeds/record/0F9D00000000I4O/feed-elements


フィード項目を投稿する

リソース/chatter/feed-elements

HTTP メソッドPOST

リクエストボディFeed Item Input

要求パラメータfeedElementType、subjectId、text

リクエストボディの例subjectId に、フィード項目の親になるユーザ、グループ、またはレコードを指定します。{

"body" : {"messageSegments" : [

{"type" : "Text","text" : "When should we meet for release planning? "

},{

"type" : "Mention","id" : "005D00000016Qxp"

}]},

"feedElementType" : "FeedItem","subjectId" : "0F9B000000000W2"

}

要求パラメータの例/services/data/v35.0/chatter/feed-elements?feedElementType=FeedItem&subjectId=0F9B000000000W2&text=New+post

戻り値Feed Item

95

フィード項目を投稿するChatter REST API の例

フィード要素を投稿し、Salesforce のファイルを含める

この例では、Salesforceにアップロードされているファイルを含むフィード要素を投稿します。新しいファイルをアップロードするには、「バイナリファイルのアップロード」を参照してください。リソース

/chatter/feed-elements



リクエストボディの例{


{"type":"Text","text":"Please take a look at this file."

}]

},"capabilities":{

"content":{"contentDocumentId":"069D00000001pyS"

}},"subjectId":"me","feedElementType":"FeedItem"

}

戻り値Feed Item

インライン画像を含むフィード要素を投稿する

次の例では、Salesforce にアップロードされているインライン画像を含むフィード要素を投稿します。新しいファイルをアップロードするには、「バイナリファイルのアップロード」を参照してください。リソース




96

フィード要素を投稿し、Salesforce のファイルを含めるChatter REST API の例




},{

"type":"InlineImage","fileId":"069xx00000000QO","altText":"API Spec"

},{

"type":"Text","text":"And this one."

},{

"type":"InlineImage","fileId":"069xx00000000QT","altText":"REST API Spec"

}]

},"subjectId":"me","feedElementType":"FeedItem"

}

戻り値Feed Item

コメントを投稿する

リソース/chatter/feed-elements/feedElementId/capabilities/comments/items


リクエストボディComment Input

要求パラメータtext



{"type":"Text","text":"New comment"

97

コメントを投稿するChatter REST API の例

}]

}}

要求パラメータの例/services/data/v35.0/chatter/feed-elements/feedElementId/capabilities/comments/items?text=New+comment

戻り値Comment

コメントを投稿し、Salesforce のファイルを含める

この例では、すでにSalesforceにアップロードされているファイルを含むコメントを投稿します。新しいファイルをアップロードするには、「バイナリファイルのアップロード」を参照してください。リソース

/chatter/feed-elements/feedElementId/capabilities/comments/items



要求パラメータtext




}]

},"capabilities":{

"content":{"contentDocumentId":"069D00000001pyS"

}}

}

戻り値Comment

バイナリファイルを投稿する

バイナリファイルを投稿する方法についての詳細は、「Chatter REST API 入力の使用」を参照してください。

98

コメントを投稿し、Salesforce のファイルを含めるChatter REST API の例

• バイナリファイルを含むフィード要素の投稿• バイナリファイルを含むフィード要素の一括投稿• バイナリファイルを含むコメントの投稿• バイナリファイルを含むコメントの一括投稿• ユーザの写真の投稿およびトリミング• [ファイル] リストへのバイナリファイルの投稿

@メンションを投稿する

リソースメンションを含むフィード項目を投稿するには、/chatter/feed-elementsを使用します。メンションを含むコメントを投稿するには、/chatter/feed-elements/feedElementId/capabilities/comments/itemsを使用します。


リクエストボディフィード項目の場合、Feed Item Input を使用します。コメントの場合、Comment Input を使用します。どちらの入力の場合も、Message Segment Input: Mention を使用します。

リクエストボディの例次にフィード項目の例を示します。{



},{

"type" : "Mention","id" : "005T0000000mzCy"

}]

},"feedElementType" : "FeedItem","subjectId" : "005D00000016Qxp"

}

次にコメントの例を示します。{ "body" :

{"messageSegments" : [

{"type": "mention",

99

@メンションを投稿するChatter REST API の例

"id" : "005D0000001GpHp"},{"type": "text","text" : " Did you see the new plans?"

}]

}}

メモ: メンションの前後に空白が自動的に追加されることはないため、テキストメッセージセグメントには空白を含めます。

戻り値Feed Item

Comment

複数の @メンションを投稿する

リソース最大 25 個のメンションを含むフィード項目を投稿するには、/chatter/feed-elementsを使用します。最大 25 個のメンションを含むコメントを投稿するには、/chatter/feed-elements/feedElementId/capabilities/comments/itemsを使用します。


リクエストボディフィード項目の場合、Feed Item Input を使用します。コメントの場合、Comment Input を使用します。どちらの入力の場合も、Message Segment Input: Mention を使用します。

リクエストボディの例次にフィード項目の例を示します。{



},{

"type" : "Mention","id" : "005T0000000mzCy"

},{

"type" : "Text","text" : " "

},{

100

複数の @メンションを投稿するChatter REST API の例

"type" : "Mention","id" : "005B0000000Ek1S"

}]

},"feedElementType" : "FeedItem","subjectId" : "005D00000016Qxp"

}

次にコメントの例を示します。{ "body" :

{"messageSegments" : [

{"type": "mention","id":"005D0000001LL8YIAW"

},{"type" : "Text","text" : " "

},{"type": "mention","id":"005D0000001LL8sIAG"

},{

"type": "text","text":" Did you see the new plans?"

}]

}}

メモ: メンションの前後に空白が自動的に追加されることはないため、必要な位置に空白を含めます。

戻り値Feed Item

Comment

@メンション提案のリストを取得する

リソースメンション提案のリストを取得するには、Mentions Completions リソース (/chatter/mentions/completions)

を使用します。コンテキストユーザに対して有効な提案を判定するには、Mentions Validations リソース(/chatter/mentions/validations) を使用します。


要求パラメータcontextId、page、pageSize、q、type

101

@メンション提案のリストを取得するChatter REST API の例

戻り値Mention Completion Page

Mention Validations

アクションリンクを定義し、フィード要素を使用して投稿する

ステップ 1: アクションリンクグループを定義するラジオボタンと同様に、アクションリンクはグループ内にネストする必要があります。グループ内のアクションリンクは、グループのプロパティを共有し、相互に排他的です (クリックできるのは、グループ内の 1 つのアクションリンクのみです)。1 つのアクションリンクを定義する場合でも、アクションリンクグループに含める必要があります。アクションリンクはフィード項目のボタンと考えます。ボタンのように、アクションリンクには表示ラベル(labelKey) があります。アクションリンク定義には、URL (actionUrl) や HTTP メソッド (method) のほか、省略可能なリクエストボディ (requestBody) や HTTP ヘッダー (headers) など、他にもプロパティがあります。ユーザがこのアクションリンクをクリックすると、Chatter REST API に対して HTTP POST 要求が実行され、フィード項目がChatterに投稿されます。requestBodyプロパティは、新しいフィード項目のテキストなど、actionUrl

リソースのリクエストボディを保持します。この例では、新しいフィード項目にテキストしか含まれていませんが、添付ファイルやアンケートなどの他の機能やアクションリンクも含めることができます。リソース

/connect/action-link-group-definitions


リクエストボディAction Link Group Definition Input

このリクエストボディには、Action Link Definition Input リクエストボディのコレクションを保持するactionLinks プロパティがあります。この例では 1 つのアクションリンクがあります。

リクエストボディの例POST /services/data/v35.0/connect/action-link-group-definitions{

"executionsAllowed":"OncePerUser","expirationDate":"2015-05-20T19:32:10+0000","category":"Primary","actionLinks":[

{"actionType":"Api","actionUrl":"/services/data/v35.0/chatter/feed-elements","labelKey":"Post","method":"HttpPost","requiresConfirmation":"false",

"requestBody":"{\"subjectId\": \"me\",\"feedElementType\": \"FeedItem\",\"body\":

{\"messageSegments\": [{\"type\": \"Text\",\"text\": \"This post was created via an API

102


Chatter REST API の例

action link.\"}]}}","headers":[

{"name":"Content-Type","value":"application/json"

},{

"name":"Authorization","value":"OAuth 00DD00000007WNP!ARsAQHhIdgwbihG7e8ga"

}]

}]

}

cURL を使用した要求の例cURLを使用して要求を実行するには、次のように入力し、Developer Edition インスタンス名および OAuth 情報を置き換えます。curl -H "X-PrettyPrint: 1" -H "Content-Type: application/json"-d '{ "executionsAllowed":"OncePerUser", "expirationDate":"2015-09-20T19:32:10+0000","category":"Primary","actionLinks":[ { "actionType":"Api","actionUrl":"/services/data/v35.0/chatter/feed-elements","groupDefault":"true", "labelKey":"Post", "method":"HttpPost","requiresConfirmation":"true","requestBody":"{\"subjectId\": \"me\",\"feedElementType\": \"FeedItem\",\"body\":{\"messageSegments\": [{\"type\": \"Text\",\"text\": \"This is a test post created viaan API action link.\"}]}}","headers":[ { "name":"Content-Type", "value":"application/json" }, {"name":"Authorization", "value":"OAuth 00DD00000007WNP!ARsAQHhIdgwbihG7e8ga" }] }] }'-X POST "https://instance_name/services/data/v35.0/connect/action-link-group-definitions"

-H 'Authorization: OAuth 00DRR0000000N0g!RWaPj94O6yOD.lfjB9LqMk' --insecure

レスポンスボディAction Link Group Definition

ステップ 2: アクションリンクグループをフィード項目に関連付けて投稿する1 つのフィード要素には、最大 10 個のアクションリンクグループを関連付けられます。リソース




103




リクエストボディの例ステップ 1 の Action Link Group Definition レスポンスの id からアクションリンクグループ ID を取得します。POST /services/data/v35.0/chatter/feed-elements

{"body": {"messageSegments": [{"type": "Text","text": "Click to post a feed item."}

]},

"subjectId": "me","feedElementType": "feedItem","capabilities": {"associatedActions": {"actionLinkGroupIds": ["0AgRR0000004CTr0AM"]

}}

}

cURL を使用した要求の例cURL を使用して要求を実行するには、次のように入力し、ステップ 1 で返されたアクションリンクグループ ID、Developer Edition インスタンス名、および OAuth 情報を置き換えます。curl -H "X-PrettyPrint: 1" -H "Content-Type: application/json" -d '{ "body": {"messageSegments":[ { "type": "Text", "text": "Click to post a feed item." } ] }, "subjectId": "me","feedElementType": "feedItem", "capabilities":{ "associatedActions": { "actionLinkGroupIds": ["0AgRR0000004CTr0AM"] } } }'-X POST "https://instance_name/services/data/v35.0/chatter/feed-elements"-H 'Authorization: OAuth OOARoAQETAKEIddnMWXh462dprYAgRWaPj94O6yOD' --insecure

レスポンスボディFeed Item

関連トピック:

アクションリンクの使用アクションリンクテンプレートAction Link Group Definitions

Feed Elements, Post and Search

テンプレートのアクションリンクを定義し、フィード要素を使用して投稿するテンプレートのアクションリンクを定義し、フィード要素を使用して投稿する

104




テンプレートのアクションリンクを定義し、フィード要素を使用して投稿する

ステップ 1: アクションリンクテンプレートを作成するラジオボタンと同様に、アクションリンクはグループ内にネストする必要があります。グループ内のアクションリンクは、グループのプロパティを共有し、相互に排他的です (クリックできるのは、グループ内の 1 つのアクションリンクのみです)。1 つのアクションリンクを定義する場合でも、アクションリンクグループに含める必要があります。アクションリンクテンプレートおよびアクションリンクグループテンプレートでも同様です。この例では、アクションリンクグループ内の 1 つのアクションリンクを使用します。ユーザがこのアクションリンクをクリックすると、Chatter REST API に対して HTTP POST 要求が実行され、フィード項目が Chatter に投稿されます。[HTTP リクエストボディ] 項目は、新しいフィード項目のテキストなど、[アクション URL] リソースのリクエストボディを保持します。この例では、新しいフィード項目にテキストしか含まれていませんが、添付ファイルやアンケートなどの他の機能やアクションリンクも含めることができます。1. [設定] から、[クイック検索]ボックスに「アクションリンクテンプレート」と入力し、[アクションリンクテ

ンプレート] を選択します。2. 新しいアクションリンクグループテンプレートで次の値を使用します。

値項目

ドキュメントの例名前Doc_Example開発者名

プライマリアクションカテゴリ

ユーザごとに 1 回実行可

3. 新しいアクションリンクテンプレートで次の値を使用します。

値項目

ドキュメントの例アクションリンクグループテンプレートApiアクションの種類/services/data/{!Bindings.ApiVersion}/chatter/feed-elementsアクション URL

全員に表示ユーザ表示設定{"subjectId": "{!Bindings.SubjectId}","feedElementType":"FeedItem","body": {"messageSegments": [{"type": "Text","text":"{!Bindings.Text}"}]}}

HTTP リクエストボディ

Content-Type: application/jsonHTTP ヘッダー

105



値項目

0位置

投稿表示ラベルキーPOSTHTTP メソッド

4. アクションリンクグループテンプレートに戻り、[公開済み] を選択します。[保存] をクリックします。アクションリンクグループテンプレート ID をメモし、ステップ 3 に進みます。

ステップ 2: アクションリンクグループテンプレート ID を取得する[設定] でアクションリンクグループテンプレートへのアクセス権がある場合は、アクションリンググループテンプレート ID を取得してステップ 3 に進むことができます。リソース

/services/data/v33.0/query


要求パラメータq — SOQL クエリ文字列。

要求パラメータの例GET/services/data/v35.0/query?q=SELECT+id+FROM+ActionLinkGroupTemplate+WHERE+DeveloperName='Doc_Example'

cURL の例curlhttps://na1.salesforce.com/services/data/v35.0/query?q=SELECT+id+FROM+ActionLinkGroupTemplate+WHERE+DeveloperName='Doc_Example' -H "Authorization: Bearer token"

レスポンスボディクエリ結果レコードの配列。{

"totalSize":1,"done":true,"records":[

{"attributes":{

"type":"ActionLinkGroupTemplate",

"url":"/services/data/v35.0/sobjects/ActionLinkGroupTemplate/07gD00000004CEhIAM"},"Id":"07gD00000004CEhIAM"

}

106



]}

ステップ 3: アクションリンクグループをインスタンス化するリソース



リクエストボディAction Link Group Definition Input

リクエストボディの例POST /services/data/v35.0/connect/action-link-group-definitions{

"templateId":"07gD00000004CEhIAM","templateBindings" : [

{"key":"ApiVersion","value":"v33.0"

},{

"key":"Text","value":"This post was created by an API Action Link!"

},{

"key":"SubjectId","value":"me"

}]

}

cURL を使用した要求の例cURLを使用して要求を実行するには、次のように入力し、Developer Edition インスタンス名および OAuth 情報を置き換えます。curl -H "X-PrettyPrint: 1" -H "Content-Type: application/json" -d '{"templateId":"07gD00000004CEhIAM","templateBindings" : [ { "key":"ApiVersion", "value":"v35.0" },{ "key":"Text", "value":"This post was created by an API Action Link!" }, {"key":"SubjectId", "value":"me" } ] }'-X POST"https://instance_name/services/data/v35.0/connect/action-link-group-definitions"-H 'Authorization: OAuth 00DRR0000000N0g!RWaPj94O6yOD.lfjB9LqMk' --insecure

レスポンスボディAction Link Group Definition

107




ステップ 4: アクションリンクグループをフィード要素に関連付けて投稿する1 つのフィード要素には、最大 10 個のアクションリンクグループを関連付けられます。リソース




リクエストボディの例ステップ 3 の Action Link Group Definition レスポンスの id からアクションリンクグループ ID を取得します。POST /services/data/v35.0/chatter/feed-elements

{"body": {"messageSegments": [{"type": "Text","text": "Click to post a feed item."}

]},

"subjectId": "me","feedElementType": "feedItem","capabilities": {"associatedActions": {"actionLinkGroupIds": ["0AgRR0000004CTr0AM"]

}}

}

cURL を使用した要求の例cURL を使用して要求を実行するには、次のように入力し、ステップ 2 で返されたアクションリンクグループ ID、Developer Edition インスタンス名、および OAuth 情報を置き換えます。curl -H "X-PrettyPrint: 1" -H "Content-Type: application/json" -d '{ "body": {"messageSegments": [ { "type": "Text", "text": "Click to post a feed item." } ] },"subjectId": "me", "feedElementType": "feedItem", "capabilities": { "associatedActions":{ "actionLinkGroupIds": ["0AgRR0000004CTr0AM"] } } }' -X POST"https://instance_name/services/data/v35.0/chatter/feed-elements" -H 'Authorization:OAuth OOARoAQETAKEIddnMWXh462dprYAgRWaPj94O6yOD' --insecure

108




レスポンスボディFeed Item

関連トピック:

Action Link Group Definitions

Feed Elements, Post and Search

アクションリンクテンプレートアクションリンクの使用アクションリンクを定義し、フィード要素を使用して投稿する

アクションリンクの状況を更新するかアクションリンクを呼び出す

使用方法このリソースを使用して、アクションリンクの status プロパティを更新します。Api または ApiAsync

アクションリンクを呼び出すには、状況を PendingStatus に設定します。アクションリンクの status

と Action Link Definition Input の labelKey プロパティの組み合わせにより、UI に表示されるテキストが決まります。さまざまな種別のアクションリンクには、さまざまな status ワークフローを指定できます。Api

アプリケーションから Api アクションリンクを呼び出すには、PATCH 要求を実行してリンクをPendingStatusとしてマークします。Salesforceにより、Action Link Definition Input で指定された actionUrl

へのコールアウトが処理されます。Apiアクションリンクの場合、Salesforceがサーバから返された HTTP

状況コードに基づいて status を SuccessfulStatus または FailedStatus に設定します。ApiAsync

アプリケーションからこのアクションリンクを呼び出すには、PATCH 要求を実行してリンクをPendingStatusとしてマークします。Salesforceにより、Action Link Definition Input で指定された actionUrl

へのコールアウトが処理されます。ApiAsyncアクションリンクの場合、コールアウトによってサーバでの非同期操作が開始されます。Salesforce により status が PendingStatus に設定されます。ただし、コールでエラー状況コードが返された場合は、status は FailedStatus に設定されます。非同期処理を終了したサーバは、アクションリンクをコールバックし、PATCH を実行してアクションリンクを SuccessfulStatus または FailedStatus に設定します。

Download と Ui

Platform Action レスポンスボディの actionUrl のリンクから、ユーザにダウンロードや UI アクセスを行わせます。PATCH 要求を実行して status を SuccessfulStatus または FailedStatus に設定する時期は、アプリケーションで決定する必要があります。

メモ: 次の場合、アクションリンクの status に対する PATCH 要求はできません。• 別の status から NewStatus に戻す。• 最終的な status (FailedStatus または SuccessfulStatus) から NewStatus または

PendingStatus に変更する。

109



• アクションリンクが属するアクションリンクグループの executionsAllowed プロパティがUnlimited である。

• Apiまたは ApiAsyncアクションリンクの executionsAllowedプロパティが Onceの場合、ユーザが初めて PATCH を実行して status を PendingStatus に設定すると、アクションリンクへのコールアウトが行われます。同じユーザが PATCH を実行して状況を PendingStatusに再度設定すると、Salesforceから現在のアクションリンクの情報が返されます。ただし、別のユーザが PATCH を実行して状況を PendingStatusに設定すると、エラーが発生します。いずれの場合も、アクションリンクへのコールアウトは再送信されません。

リソース/connect/action-links/actionLinkId

HTTP メソッドPATCH

リクエストボディAction Link Input

要求パラメータstatus

リクエストボディの例{ "status":"SuccessfulStatus" }

要求パラメータの例/services/data/v35.0/connect/action-links/actionLinkId?status=SuccessfulStatus

戻り値Platform Action

フィード投稿を編集する

リソース/chatter/feed-elements/feedElementId



Feed Item Input リクエストボディの body プロパティは編集可能です。リクエストボディの例

{"body":{


"type":"Text","text":"Check out the latest API documentation on developer.salesforce.com."

110

フィード投稿を編集するChatter REST API の例

}]

}}

戻り値Feed Item

コメントを編集する

リソース/chatter/comments/commentId



Comment Input の body プロパティは編集可能です。リクエストボディの例

{ "body":{"messageSegments":[

{"type":"Text","text":"I am definitely going to check that out."

}]

}}

戻り値Comment

質問のタイトルと投稿を編集する

リソース/chatter/feed-elements/feedElementId



body プロパティと questionTitle プロパティは編集可能です。リクエストボディの例

{"body":{

"messageSegments":[

111

コメントを編集するChatter REST API の例

{"type":"Text","text":"The latest public versions are on developer.salesforce.com."

}]

},"capabilities":{

"questionAndAnswers" : {"questionTitle" : "Where can I find API documentation"

}}

}

戻り値Feed Item

フィード項目にいいね! と言う

リソース/chatter/feed-elements/feedElementId/capabilities/chatter-likes/items


例/services/data/v35.0/chatter/feed-elements/feedElementId/capabilities/chatter-likes/items

戻り値Like

フィード項目にいいね! と言い、いいね! の総数を返す

リソース/connect/batch/


リクエストボディGeneric Batch Collection Input


"batchRequests" : [{

"method" : "Post","url" :

"/v35.0/chatter/feed-elements/feedElementId/capabilities/chatter-likes/items"},{

"method" : "Get",

112

フィード項目にいいね! と言うChatter REST API の例

"url" :"/v35.0/chatter/feed-elements/feedElementId/capabilities/chatter-likes/items"

}],"haltOnError" : "false"

}

戻り値Batch Results

フィード項目を共有する




要求パラメータoriginalFeedElementId、subjectId


"originalFeedElementId": "0D5D0000000DaZBKA0","subjectId": "me"}

要求パラメータの例/services/data/v35.0/chatter/feed-elements?originalFeedElementId=0D5D0000000DaZBKA0&subjectId=me

戻り値Feed Item

最後の要求以降に更新されたフィード要素を取得する

リソース最後のコール以降に更新されたフィード要素のみを取得するには、Feed Element Page レスポンスボディのupdatesUrl プロパティの値に対して要求を実行します。次のフィードは updatesUrl プロパティを返します。• 会社 — /chatter/feeds/company/feed-elements

• ファイル — /chatter/feeds/files/me/feed-elements

• 条件 — /chatter/feeds/filter/me/filterId/feed-elements

• グループ — /chatter/feeds/groups/me/feed-elements

• ニュース — /chatter/feeds/news/me/feed-elements

• 人 — /chatter/feeds/people/me/feed-elements

113

フィード項目を共有するChatter REST API の例

• レコード — /chatter/feeds/record/recordId/feed-elements

次の Feed Elements Page レスポンスボディからの抜粋は、updatesUrl プロパティのサンプル値を示しています。{......"updatesUrl" : "/services/data/v35.0/chatter/feeds

/news/005D0000001LL8OIAW/feed-elements?updatedSince=2:1384811809000"...}

フィード要素は、最後のフィード要求の時刻以降に作成されたか、最後のフィード要求の時刻以降にフィード要素に sort=LastModifiedDateDesc およびコメントが追加された場合、更新されたものとみなされます。いいね! やトピックを追加してもフィード要素は更新されません。



内部のフィード項目のみを含むフィードを取得する



要求パラメータshowInternalOnly

例/services/data/v35.0/chatter/feeds/record/0F9D00000000I4O/feed-elements?showInternalOnly=true


フィードを検索する

リソース/chatter/feed-elements?q=searchString

検索文字列にはワイルドカード文字を含めることができ、ワイルドカード文字を除く 2 文字以上が含まれている必要があります。


要求パラメータq

114

内部のフィード項目のみを含むフィードを取得するChatter REST API の例

要求パラメータの例/services/data/v35.0/chatter/feed-elements?q=track


ユーザがフォローしているレコードのリストを取得する

リソース/chatter/users/userId/following


要求パラメータpage (省略可能)

要求パラメータの例/services/data/v35.0/chatter/users/005D0000001GLowIAB/following?page=1

戻り値Subscription Page

ユーザの Chatter 活動の統計情報を取得する

リソース/chatter/users/userId


例/services/data/v35.0/chatter/users/005D0000001GLowIAB?include=/chatterActivity

戻り値User Detail

フォローするユーザのおすすめを取得する

リソース/chatter/users/me/recommendations/follow/users


例/services/data/v35.0/chatter/users/me/recommendations/follow/users

115

ユーザがフォローしているレコードのリストを取得するChatter REST API の例

戻り値Recommendations

カスタムのおすすめを作成し、利用者を使用してスケジュールする

コミュニティマネージャ (「コミュニティの作成および設定」または「コミュニティの管理」権限を持つユーザ) は、コミュニティのおすすめ利用者、おすすめ定義、およびスケジュール済みおすすめに対するアクセス、作成、削除を行うことができます。「すべてのデータの編集」権限を持つユーザも、おすすめ利用者、おすすめ定義、およびスケジュール済みおすすめに対するアクセス、作成、削除を行うことができます。これらのおすすめは、Salesforce1 モバイルブラウザアプリケーションのコミュニティのフィードに直接表示されます。また、デフォルトでホームページの右側と、コミュニティマネージャがコミュニティビルダーでSummer '15 以降のバージョンの Napili テンプレートを使用して追加した場所にも表示されます。

ステップ 1: カスタムのおすすめを定義するリソース

/connect/communities/communityId/recommendation-definitions


リクエストボディRecommendation Definition Input


"name":"Corporate Training Project","title":"Want to learn more about the Corporate Training Project?","explanation":"Click this link to learn more!","actionUrl":"https://www.example.com","actionUrlName":"Launch"

}

レスポンスボディRecommendation Definition

ステップ 2: 画像をカスタムのおすすめに追加するこの例では、Salesforce にアップロードされている画像ファイルを追加します。新しい画像ファイルをアップロードするには、「バイナリファイルのアップロード」を参照してください。リソース

/connect/recommendation-definitions/recommendationDefinitionId/photo

ステップ 1 の Recommendation Definition レスポンスボディで返された recommendationDefinitionId を使用します。

116



HTTP メソッドPUT

リクエストボディPhoto Input


"cropSize" : "120","cropX" : "0","cropY" : "0","fileId" : "069D00000001IOh"

}

レスポンスボディPhoto

ステップ 3: おすすめ利用者を作成するリソース

/connect/communities/communityId/recommendation-audiences


リクエストボディRecommendation Audience Input


"name" : "New Hires"}

レスポンスボディRecommendation Audience

ステップ 4: メンバーをおすすめ利用者に追加するリソース

/connect/communities/communityId/recommendation-audiences/recommendationAudienceId

ステップ 3 の Recommendation Audience レスポンスボディで返された recommendationAudienceId を使用します。


リクエストボディRecommendation Audience Input

117




"memberOperationType" : "Add","members" : {

"userIds" : ["005B0000000Ge16","005D0000001GpHp"]

}}

レスポンスボディRecommendation Audience

ステップ 5: 利用者を使用して、カスタムのおすすめをスケジュールするリソース

/connect/communities/communityId/scheduled-recommendations


リクエストボディScheduled Recommendation Input


"recommendationDefinitionId" : "0RDD00000004CEhOAM","recommendationAudienceId":"02JD00000008SfdMAE"

}

レスポンスボディScheduled Recommendation

グループを作成する

リソース/chatter/groups


リクエストボディGroup Input

要求パラメータ (必須)

name、visibility

118

グループを作成するChatter REST API の例


"name" : "Chatter API","visibility" : "PublicAccess"

}

要求パラメータの例/services/data/v35.0/chatter/groups?name=Chatter+API&visibility=PublicAccess

戻り値Group Detail

グループの写真を更新およびトリミングする

この例では、既存の写真 (すでにアップロードされている写真) をトリミングします。写真を新たにアップロードしてから、トリミングすることもできます。新しい写真をアップロードするには、マルチパート/フォームデータ要求を使用する必要があります。「バイナリファイルのアップロード」を参照してください。リソース

/chatter/groups/groupId/photo



要求パラメータcropSize、cropX、cropY、fileId

リクエストボディの例{ "cropSize" : "240",

"cropX" : "20","cropY" : "20","fileId" : "069D00000001IOh"

}

要求パラメータの例/services/data/v35.0/chatter/groups/0F9300000008ORJ/photo?cropSize=240&cropX=20&cropY=20&fileId=069D00000001IOh

戻り値Photo

グループに参加する

リソース/chatter/groups/groupId/members

119

グループの写真を更新およびトリミングするChatter REST API の例


リクエストボディGroup Member Input

要求パラメータuserId

リクエストボディの例{"userId": "005D0000001GpHp" }

要求パラメータの例/services/data/v35.0/chatter/groups/0F9D000000006bOKAQ/members?userId=005D0000001GpHp

戻り値グループメンバー

非公開グループへの参加を要求する

リソース/chatter/groups/groupId/members/requests


例/services/data/v35.0/chatter/groups/0F9D000000006bOKAQ/members/requests

戻り値Group Membership Request

非公開グループへの参加要求を承認または却下する

リソース/chatter/group-memberships-requests/requestId


リクエストボディGroup Membership Request Update

要求パラメータstatus および responseMessage

responseMessage パラメータは、status の値が Declined の場合にのみ使用されます。

120

非公開グループへの参加を要求するChatter REST API の例

リクエストボディの例{ "status " : "Accepted" }

要求パラメータの例/services/data/v35.0/chatter/group-membership-requests/0I5D000000002fwKAA?status=Accepted

戻り値Group Membership Request

グループに投稿する




要求パラメータfeedElementType、subjectId、text

リクエストボディの例subjectId にグループを指定します。{


{"type" : "Text","text" : "When should we meet for release planning?"

},{


}]},

"feedElementType" : "FeedItem","subjectId" : "0F9B000000000W2"

}

要求パラメータの例/services/data/v35.0/chatter

/feed-elements?feedElementType=FeedItem&subjectId=0F9B000000000W2&text=New+post

戻り値Feed Item

121

グループに投稿するChatter REST API の例

レコードをフォローする

リソース/chatter/users/me/following


リクエストボディFollowing Input

要求パラメータsubjectId

subjectId はフォローする項目の ID です。バージョン 29.0 以上では、subjectId をトピック ID にすることができます。

リクエストボディの例{ "subjectId" : "001D000000Iyu2p" }

要求パラメータの例/services/data/v35.0/chatter/users/me/following?subjectId=001D000000Iyu2p

戻り値Subscription

レコードのフォローを停止する

リソース/chatter/subscriptions/subscriptionId

HTTP メソッドDELETE

例/services/data/v35.0/chatter/subscriptions/0E8D00000001JkFKAU

戻り値204: DELETE が成功しました完全に構造化されたレスポンスボディは返されず、戻りコードのみが返されます。

レコードフィードを取得する



122

レコードをフォローするChatter REST API の例

例/services/data/v35.0/chatter/feeds/record/005x0000001oXx9AAE/feed-elements


ユーザプロファイルを更新する

リソース/chatter/users/userId


リクエストボディUser Input

要求パラメータaboutMe

リクエストボディの例{ "aboutMe": "Writer at Salesforce"}

要求パラメータの例/services/data/v35.0/chatter/users/me?aboutMe=Writer+at+Salesforce

戻り値User Detail

ユーザの写真を更新およびトリミングする

この例では、既存の写真 (すでにアップロードされている写真) をトリミングします。写真を新たにアップロードしてから、トリミングすることもできます。新しい写真をアップロードするには、マルチパート/フォームデータ要求を使用する必要があります。「バイナリファイルのアップロード」を参照してください。この例を使用してグループの写真を更新およびトリミングするには、/chatter/groups/groupId/photoに置き換えます。リソース

/chatter/users/userId/photo



要求パラメータcropSize、cropX、cropY、fileId

123

ユーザプロファイルを更新するChatter REST API の例

リクエストボディの例{ "cropSize" : "240",


}

要求パラメータの例/services/data/v35.0/chatter/users/me/photo?cropSize=240&cropX=20&cropY=20&fileId=069D00000001IOh

戻り値Photo

非公開メッセージを送信する

リソース/chatter/users/me/messages/


リクエストボディUser Message

要求パラメータrecipients または inReplyTo

text

リクエストボディの例{ "body" : "Are we ready for next week's customer meeting?","recipients" : ["005D0000001GOYpIAO", "005D0000001GbdHIAS"]

}

要求パラメータの例/services/data/v35.0/chatter/users/me/messages?recipients=005D0000001GOYpIAO,005D0000001GbdHIAS&text=Are+we+ready+for+next+week's+customer+meeting?

戻り値Message

複数のユーザのユーザ情報を取得する

リソース/chatter/users/batch/user_list。user_list はユーザ ID のリストです。場合によっては、アプリケーションがChatter REST APIを 2 回コールする必要があります。1 回目はフィード項目とユーザ ID を取得し、2 回目はユーザ ID のリストを使用してこのリソースをコールします。

124

非公開メッセージを送信するChatter REST API の例


例/services/data/v35.0/chatter/users/batch/005D0000001Kl6xIAC,005D0000005J3D4HVB, . . .

戻り値Batch Results

125

複数のユーザのユーザ情報を取得するChatter REST API の例

第 5 章 Chatter REST API リソースこの章では、Chatter REST API リソースについて説明します。REST リソースは、エンドポイントと呼ばれることもあります。


Action Links リソースアクションリンクは、フィード要素上のボタンです。アクションリンクをクリックすると、ユーザを特定の Web ページに移動したり、ファイルダウンロードを開始したり、Salesforceまたは外部サーバへの API コールを呼び出したりできます。アクションリンクには、URL と HTTP メソッドが含まれ、リクエストボディとヘッダー情報 (認証用の OAuth トークンなど) を含めることができます。アクションリンクを使用してSalesforce

およびサードパーティサービスをフィードに統合することで、ユーザはアクションを実行して生産性を高め、イノベーションを促進できます。Announcements リソースお知らせに関する情報。既存のお知らせの表示期限の情報取得や更新を行います。お知らせは、削除されるか、別のお知らせで置き換えられない限り、その表示期限の 11:59 p.m. まで Salesforce UI の指定の場所に表示されます。Async Query リソース非同期に処理する SOQL クエリを送信し、状況を確認します。データのサイズや保存場所に関係なく、一貫した SOQL クエリを実行するには、非同期クエリリソースを使用します。Batch リソース最大 25 個のサブ要求から成るバッチを含むリクエストボディを作成し、1 つの要求としてサーバに送信して、アプリケーションのパフォーマンスを向上させます。バッチ内の各サブ要求のレスポンスボディと HTTP

状況は、1 つのレスポンスボディ内で返されます。各サブ要求は、レート制限にカウントされます。Chatter リソースChatter フィード、グループ、およびユーザリソースのディレクトリ。Comments リソースコメントの情報取得、編集、削除、またはコメントへのいいね! を行います。コンテキストユーザがコメントを編集できるかどうかを判別します。Communities リソースコンテキストユーザが使用できるコミュニティに関する情報、または特定のコミュニティに関する情報。Communities Moderation リソースユーザがフィード要素、コメント、またはファイルに不適切フラグを設定したかどうかに関する情報。フラグの削除にも使用されます。

126

Connect リソースコンテキストユーザの組織と設定に関する情報、およびコンテキストユーザがメンバーであるコミュニティに関する情報。Dashboard Component Snapshot リソースダッシュボードコンポーネントのスナップショット。Datacloud リソースData.com の取引先責任者または会社を購入するために使用する Datacloud リソースに関する情報。Feed Elements リソースフィード要素に関する情報。フィード要素へのアクセス、フィード要素の編集、投稿、検索、削除を行います。バンドルやそのフィード要素など、フィード要素の機能にアクセスします。Feed Items リソースフィード項目に関する情報。フィード項目のアクセス、検索、削除、ブックマーク、いいね! を行います。コメントのアクセスと投稿、アンケートのアクセスと投票、トピックのアクセス、追加、削除を行います。Feed リソースフィードは、フィード項目で構成されます。さまざまなフィード種別があります。フィード種別ごとに、どのフィード項目を含むかを決めるアルゴリズムがあります。Files Connect Repository リソースFiles Connect リポジトリは、Salesforce に接続している外部コンテンツリポジトリです。これらのリソースを使用して、リポジトリのリストの取得、リポジトリまたはリポジトリファイルに関する情報の取得、リポジトリファイルのコンテンツの取得を行います。また、リポジトリフォルダ内のファイルとフォルダに関する情報の取得にもこれらのリソースを使用します。これらのリソースを使用して、リポジトリのディレクトリエントリ、権限、権限タイプを取得します。また、リポジトリの権限の更新にもこれらのリソースを使用します。Files リソースコンテンツ、表示されているバージョン、共有など、ファイルに関する情報。Folders リソースフォルダまたはフォルダの内容に関する情報。フォルダの変更と削除、フォルダへの項目の追加、およびルートフォルダの同期を行います。Groups リソースグループのメンバー、写真、および組織内のグループなど、グループに関する情報。グループの作成および削除、グループへのメンバーの追加、グループの写真の変更を行います。Influence リソース組織のユーザを Chatter での影響度によって分類するために使用するパーセントしきい値のリスト。Likes リソース指定されたいいね! に関する情報。いいね! の削除にも使用されます。Managed Topics リソースコミュニティの管理トピック。管理トピックのリストを取得します。コミュニティの管理トピックの作成、削除、または並び替えを行います。

127

Chatter REST API リソース

Mentions リソースフィード項目またはコメントの本文でメンション可能なユーザおよびグループに関する情報。ユーザまたはグループは、メンションされると通知を受け取ります。Motifs リソース小、中、大の一連の motif アイコンの URL を返します。レコードの一連の motif アイコンは、レコードタイプによって異なります。motif にはレコードタイプのベース色を含めることもできます。Push Notifications リソースモバイル転送通知をユーザのデバイスの接続アプリケーションに送信します。受信者の接続アプリケーションと同じ組織で開発された、または同じパッケージにインストールされた接続アプリケーションでセッションが確立されている場合にのみこのリソースにアクセスできます。Question and Answers Suggestions リソース質問および回答の提案を取得します。Recommendation Audience Resources

カスタムおすすめの特定の利用者を対象にします。これらのリソースは、おすすめ利用者の情報取得、作成、更新、削除に使用します。おすすめ定義リソースおすすめ定義を使用すると、コミュニティに表示されるカスタムおすすめを作成して、ユーザに動画の閲覧やトレーニングの受講などを促すことができます。これらのリソースは、おすすめ定義の情報取得、作成、変更、削除に使用します。また、おすすめ定義の写真の情報取得、アップロード、変更、および削除にも使用します。Records リソースレコードをフォローしている人に関する情報を取得します。レコードに対するトピックの追加や削除を行います。スケジュール済みおすすめリソーススケジュール済みおすすめに関する情報の取得、スケジュール済みおすすめの作成、変更、削除を行います。Subscriptions リソース指定された登録に関する情報。登録の削除 (レコードまたはトピックのフォロー解除など) にも使用されます。Topics リソース組織のトピックのリスト、指定されたテキスト文字列、フィード項目、またはレコードの推奨トピックのリスト、組織のトピックのトレンドのリスト、指定されたトピックに関する情報、指定されたトピックの支持、指定されたトピックに最近投稿されたファイルに関する情報、指定されたトピックに最近投稿したグループに関する情報、指定されたトピックに関する知識のあるユーザ、および指定されたトピックに関連するトピックのリスト。User Profiles リソースユーザのプロファイルに関する詳細を返します。このユーザプロファイルデータが、プロファイルページ(Chatter プロファイルページとも呼ばれる) に入力されます。このデータには、ユーザ情報 (住所、マネージャ、電話番号など)、一部のユーザ機能 (権限)、および一連のサブタブアプリケーション (プロファイルページのカスタムタブ) が含まれます。

128


Users リソースユーザをフォローしている人、ユーザのファイルやおすすめなど、ユーザに関する情報。フィード項目のpost 送信と会話状況の更新にも使用されます。Zones リソースChatter アンサーゾーンに関する情報。

Action Links リソース

アクションリンクは、フィード要素上のボタンです。アクションリンクをクリックすると、ユーザを特定のWeb ページに移動したり、ファイルダウンロードを開始したり、Salesforce または外部サーバへの API コールを呼び出したりできます。アクションリンクには、URL と HTTP メソッドが含まれ、リクエストボディとヘッダー情報 (認証用の OAuth トークンなど) を含めることができます。アクションリンクを使用して Salesforce およびサードパーティサービスをフィードに統合することで、ユーザはアクションを実行して生産性を高め、イノベーションを促進できます。アクションリンクとアクションリンクグループには、定義ビューとコンテキストユーザビューという 2 つのビューがあります。定義には、認証情報などの機密情報が含まれる可能性があります。コンテキストユーザビューは、表示オプションによって絞り込まれ、コンテキストユーザの状態が値に反映されます。使用可能なリソース:

説明リソース

アクションリンクグループ定義を作成します。アクションリンクをフィード要素に関連付けるには、まず


アクションリンクグループ定義を作成します。次に、関連付けられたアクション機能を含むフィード要素を投稿します。

アクションリンクグループ定義の情報取得や削除を行います。アクションリンクグループ定義を削除する

/connect/action-link-group-definitions/actionLinkGroupId

と、その定義へのすべての参照がフィード要素から削除されます。アクションリンクグループ定義の取得や削除を行うには、クライアントは定義を作成した接続アプリケーションと同じである必要があり、ユーザは定義を作成したか「すべてのデータの参照」権限を持っている必要があります。

コンテキストユーザの状態を含む、アクションリンクグループに関する情報を取得します。

/connect/action-link-groups/actionLinkGroupId

アクションリンクの statusの情報取得や更新を行います。アクションリンクの status と Action Link

/connect/action-links/actionLinkId

Definition Input の labelKey プロパティの組み合わせにより、UI に表示されるテキストが決まります。Api

および ApiAsyncアクションリンクの API 要求をトリ

129

Action Links リソースChatter REST API リソース

説明リソース

ガするには、statusを PendingStatusに設定します。

アクションリンクが実行されたときに返された診断情報を取得します。診断情報は、アクションリンクにアクセスできるユーザに対してのみ提供されます。

/connect/action-links/actionLinkId/diagnostic-info

関連トピック:

アクションリンクの使用アクションリンクを定義し、フィード要素を使用して投稿する

Action Link Group Definitionsアクションリンクグループ定義を作成します。アクションリンクをフィード要素に関連付けるには、まずアクションリンクグループ定義を作成します。次に、関連付けられたアクション機能を含むフィード要素を投稿します。すべてのアクションリンクはグループに属している必要があります。1 つのグループ内のアクションリンクは、相互排他的で、同じプロパティを共有します。各自のアクショングループでスタンドアロンアクションを定義します。この画像は、[ダウンロード] と [注文] という 2 つのアクションリンクを含む 1 つのアクションリンクグループがあるフィード要素を示しています。

130

Action Link Group DefinitionsChatter REST API リソース

リソース/connect/action-link-group-definitions

/connect/communities/communityId/action-link-group-definitions

適用開始バージョン33.0

Chatter が必要かどうかいいえ


Action Link Group Definitions リソースは、POST のクエリパラメータをサポートしていません。Action Link Group

Definition Input リクエストボディを使用する必要があります。POST のリクエストボディ

Action Link Group Definition Input

POST のレスポンスボディAction Link Group Definition

POST の例アクションリンクグループをフィード項目に関連付けるには、まずアクションリンクグループ定義を作成します。

メモ: Salesforceリソースへの actionUrlは、相対リンクにすることができます。他のすべてのリンクは、https:// で始まる絶対リンクにする必要があります。


{"actionLinks": [{

"actionType" : "Api","actionUrl" : "https://www.example.com/api/v1/confirm","groupDefault" : "true","headers" : [{

"name" : "Authorization","value" : "OAuth 00DRR0000000N0g!ARoAQMZyQtsP1Gs27EZ8hl7vdpYXH5O5rv1

VNprqTeD12xYnvygD3JgPnNR._nmE6thZakAbBVJUsjUInMUaKMlkNKaWXdHO"},{

"name" : "Content-Type","value" : "application/json"

},{

"name" : "Accept","value" : "application/json"

},{

"name" : "X-PrettyPrint","value" : "1"

131


}],"labelKey" : "Confirm","method" : "HttpPost","requiresConfirmation" : "true"

},{

"actionType" : "Api","actionUrl" : "https://www.example.com/api/v1/deny","groupDefault" : "false","headers" : [{

"name" : "Authorization","value" : "OAuth 00DRR0000000N0g!ARoAQMZyQtsP1Gs27EZ8hl7vdpYXH5O5rv1

VNprqTeD12xYnvygD3JgPnNR._nmE6thZakAbBVJUsjUInMUaKMlkNKaWXdHO"},{

"name" : "Content-Type","value" : "application/json"

},{

"name" : "Accept","value" : "application/json"

},{

"name" : "X-PrettyPrint","value" : "1"

}],"labelKey": "Deny","method" : "HttpPost","requiresConfirmation" : "true"

},{

"actionType": "Ui","actionUrl" : "https://www.example.com/reviewPage.html","groupDefault" : "false","labelKey" : "Review","method" : "HttpGet","requiresConfirmation" : "false"

},"executionsAllowed" : "OncePerUser","category" : "Primary","expirationDate" : "2014-05-09T18:45:39.000Z"

}

次に、アクションリンクグループをフィード項目に関連付けて、フィード項目を post 送信します。/connect/action-link-group-definitions応答からアクションリンクグループ ID を取得し、POST

要求で /chatter/feed-elementsに渡します。POST /chatter/feed-elements

{"body": {

132


"messageSegments": [{"type": "Text","text": "Please confirm or deny this item. You can also click Review to provide

more feedback."}

]},

"subjectId": "me","feedElementType": "FeedItem","capabilities": {"associatedActions": {"actionLinkGroupIds": ["0AgRR0000004CTr0AM"]

}}

}

さまざまな種別のアクションリンクのさまざまなワークフローで status プロパティが設定されます。値は UI に表示されます。詳細は、/connect/action-links/actionLinkIdを参照してください。

メモ: この例では、他の機能は含まれていませんが、アクションリンクのあるフィード項目では、コンテンツ、アンケート、リンクなど、他の機能がサポートされます。

関連トピック:

アクションリンクを定義し、フィード要素を使用して投稿するアクションリンクテンプレートアクションリンクを定義し、フィード要素を使用して投稿するテンプレートのアクションリンクを定義し、フィード要素を使用して投稿する

Action Link Group Definitionアクションリンクグループ定義の情報取得や削除を行います。アクションリンクグループ定義を削除すると、その定義へのすべての参照がフィード要素から削除されます。アクションリンクグループ定義の取得や削除を行うには、クライアントは定義を作成した接続アプリケーションと同じである必要があり、ユーザは定義を作成したか「すべてのデータの参照」権限を持っている必要があります。リソース

/connect/action-link-group-definitions/actionLinkGroupId

/connect/communities/communityId/action-link-group-definitions/actionLinkGroupId



HTTP メソッドGET、DELETE、HEAD

133

Action Link Group DefinitionChatter REST API リソース

GET のレスポンスボディAction Link Group Definition

DELETE のレスポンスボディ204: DELETE が成功しました

Action Link Groupコンテキストユーザの状態を含む、アクションリンクグループに関する情報を取得します。すべてのアクションリンクはグループに属している必要があります。1 つのグループ内のアクションリンクは、相互排他的で、同じプロパティを共有します。アクションリンクグループ定義とは異なり、アクションリンクグループは、クライアントからアクセスできます。リソース

/connect/action-link-groups/actionLinkGroupId

/connect/communities/communityId/action-link-groups/actionLinkGroupId



HTTP メソッドGET、HEAD

GET のレスポンスボディPlatform Action Group

Action Linkアクションリンクの statusの情報取得や更新を行います。アクションリンクの statusと Action Link Definition

Input の labelKey プロパティの組み合わせにより、UI に表示されるテキストが決まります。Api およびApiAsync アクションリンクの API 要求をトリガするには、status を PendingStatus に設定します。この画像には 2 つのアクションリンクがあります。この画像では、両方のアクションリンクの status がNewStatus です。

134

Action Link GroupChatter REST API リソース

Pam Smith が [確認]をクリックすると、アクションリンク status が SuccessfulStatus に設定され、その結果、この画像のフィード項目が表示されます。

さまざまな種別のアクションリンクには、さまざまな status ワークフローを指定できます。Api

アプリケーションから Api アクションリンクを呼び出すには、PATCH 要求を実行してリンクをPendingStatus としてマークします。Salesforceにより、Action Link Definition Input で指定された actionUrl

へのコールアウトが処理されます。Api アクションリンクの場合、Salesforce がサーバから返された HTTP 状況コードに基づいて status を SuccessfulStatus または FailedStatus に設定します。

ApiAsync

アプリケーションからこのアクションリンクを呼び出すには、PATCH 要求を実行してリンクをPendingStatus としてマークします。Salesforceにより、Action Link Definition Input で指定された actionUrl

へのコールアウトが処理されます。ApiAsync アクションリンクの場合、コールアウトによってサーバで

135

Action LinkChatter REST API リソース

の非同期操作が開始されます。Salesforceにより statusが PendingStatusに設定されます。ただし、コールでエラー状況コードが返された場合は、status は FailedStatus に設定されます。非同期処理を終了したサーバは、アクションリンクをコールバックし、PATCH を実行してアクションリンクをSuccessfulStatus または FailedStatus に設定します。

Download と Ui

Platform Action レスポンスボディの actionUrl のリンクから、ユーザにダウンロードや UI アクセスを行わせます。PATCH 要求を実行して statusを SuccessfulStatusまたは FailedStatusに設定する時期は、アプリケーションで決定する必要があります。

メモ: 次の場合、アクションリンクの status に対する PATCH 要求はできません。• 別の status から NewStatus に戻す。• 最終的な status (FailedStatusまたは SuccessfulStatus) から NewStatusまたは PendingStatus

に変更する。• アクションリンクが属するアクションリンクグループの executionsAllowedプロパティが Unlimited

である。• Apiまたは ApiAsyncアクションリンクの executionsAllowedプロパティが Onceの場合、ユーザ

が初めて PATCH を実行して status を PendingStatus に設定すると、アクションリンクへのコールアウトが行われます。同じユーザが PATCH を実行して状況を PendingStatus に再度設定すると、Salesforce から現在のアクションリンクの情報が返されます。ただし、別のユーザが PATCH を実行して状況を PendingStatus に設定すると、エラーが発生します。いずれの場合も、アクションリンクへのコールアウトは再送信されません。

リソース/connect/action-links/actionLinkId

/connect/communities/communityId/action-links/actionLinkId



HTTP メソッドGET、PATCH、HEAD

PATCH のリクエストボディルート XML タグ

<actionLink>

JSON の例{ "status" : "SuccessfulStatus" }

136


プロパティ


必須項目/省略可能

説明型名前

33.0必須項目アクションの現在の実行状況。値は次のとおりです。

Stringstatus

• FailedStatus — アクションリンクの実行に失敗しました。

• NewStatus — アクションリンクの実行の準備が整っています。Download および Ui

アクションリンクでのみ使用できます。

• PendingStatus — アクションリンクが実行されています。この値を選択すると、Api および ApiAsync アクションリンクの API コールがトリガされます。

• SuccessfulStatus — アクションリンクが正常に実行されました。

PATCH の要求パラメータ

使用可能なバージョン説明型名前

33.0値は次のとおりです。Stringstatus


• NewStatus — アクションリンクの実行の準備が整っています。Download および Ui

アクションリンクでのみ使用できます。

• PendingStatus — アクションリンクが実行されています。この値を選択すると、Apiお

137



よび ApiAsync アクションリンクの API

コールがトリガされます。

• SuccessfulStatus

— アクションリンクが正常に実行されました。

GET または PATCH のレスポンスボディPlatform Action

PATCH の例PATCH /connect/action-links/0AnRR0000004CTS0A2?status=FailedStatus

Action Link Diagnostic Informationアクションリンクが実行されたときに返された診断情報を取得します。診断情報は、アクションリンクにアクセスできるユーザに対してのみ提供されます。リソース

/connect/action-links/actionLinkId/diagnostic-info

/connect/communities/communityId/action-links/actionLinkId/diagnostic-info

使用可能なバージョン33.0



レスポンスボディAction Link Diagnostic

Announcements リソース

お知らせに関する情報。既存のお知らせの表示期限の情報取得や更新を行います。お知らせは、削除されるか、別のお知らせで置き換えられない限り、その表示期限の 11:59 p.m. まで Salesforce UI の指定の場所に表示されます。お知らせは、情報を強調表示するために使用します。ユーザは、グループフィードのお知らせに対するディスカッション、いいね!、コメントの投稿ができます。他の投稿と同様に、お知らせが投稿されると、グループ

138

Action Link Diagnostic InformationChatter REST API リソース

メンバーは選択したグループメール通知頻度に応じてメール通知を受信します。フィード投稿を削除するとお知らせが削除されます。次のSalesforceの画像では、お知らせが黄色で表示されています。お知らせを作成すると、お知らせのテキストを含むフィード項目も作成されます。これもこの画像で確認できます。

グループにお知らせを投稿したり、グループ内のすべてのお知らせに関する情報を取得したりするには、Group

Announcements リソース (/chatter/groups/groupId/announcements) を使用します。リソース

/chatter/announcements/announcementId

/connect/communities/communityId/chatter/announcements/announcementId


Chatter が必要かどうかはい

HTTP メソッドGET、PATCH、DELETE、HEAD



必須項目/省略可能説明値パラメータ名

31.0必須項目別のお知らせが最初に投稿されていない

DateexpirationDate

限り、この日付の11:59 p.m. まで

139

Announcements リソースChatter REST API リソース



Salesforce UI にお知らせが表示されます。Salesforce UI では、expirationDate

の時間値は無視されます。ただし、時間値を使用して各自のUI で独自の表示ロジックを作成することはできます。

GET、PATCH のレスポンスボディAnnouncement

DELETE のレスポンスボディHTTP 状況コード 204

Async Query リソース

非同期に処理する SOQL クエリを送信し、状況を確認します。データのサイズや保存場所に関係なく、一貫した SOQL クエリを実行するには、非同期クエリリソースを使用します。

メモ: この機能は現在、パイロットプログラムを通じて一部のお客様が使用できます。このパイロットプログラムに参加する方法については、salesforce.com にお問い合わせください。パイロットプログラムへの参加には、追加の契約条件が適用される場合があります。パイロットプログラムは変更される可能性があるため、このパイロットプログラムへの参加や、特定の期間にこの機能を有効化することは保証できません。このドキュメント、プレスリリース、または公式声明で参照されている未リリースのサービスまたは機能は、現在利用できず、提供が遅れたり中止されたりする可能性があります。サービスのご購入をご検討中のお客様は、現在利用可能な機能に基づいて購入をご決定ください。

使用可能なリソース:

説明リソース

データのサイズや保存場所に関係なく、非同期に処理する SOQL クエリを送信します。

/async-queries

非同期クエリの状況を確認します。/async-queries/jobId

Async Queryデータのサイズや保存場所に関係なく、非同期に処理する SOQL クエリを送信します。

140

Async Query リソースChatter REST API リソース


リソース/async-queries




POST のリクエストボディAsync Query Input

POST のレスポンスボディAsync Query

関連トピック:

Async Query, Status

Async Query, Status非同期クエリの状況を確認します。


リソース/async-queries/jobId



141

Async Query, StatusChatter REST API リソース


GET のレスポンスボディAsync Query

関連トピック:

Async Query

Batch リソース

最大 25 個のサブ要求から成るバッチを含むリクエストボディを作成し、1 つの要求としてサーバに送信して、アプリケーションのパフォーマンスを向上させます。バッチ内の各サブ要求のレスポンスボディと HTTP 状況は、1 つのレスポンスボディ内で返されます。各サブ要求は、レート制限にカウントされます。このリソースは、クライアントとサーバ間の往復回数を最小限に抑えるために作成します。たとえば、モバイルアプリケーションで、ユーザがフィード項目にいいね! と言うためにボタンをタップすると、レスポンスボディにはいいね! に関する情報が含まれますが、フィード項目に対するいいね! の総数は含まれません。フィード項目にいいね! と言うには、POST で要求を/chatter/feed-elements/feedElementId/capabilities/chatter-likes/itemsに送信します。いいね! の合計を取得するには、GET で/chatter/feed-elements/feedElementId/capabilities/chatter-likes/itemsからフィード項目情報を取得します。次のように、両方の要求を Generic Batch Collection Input リクエストボディに追加し、1 つの POST 要求で両方を/connect/batch に送信します。{


"method" : "Post","url" : "/v35.0/chatter/feed-elements/feedElementId/capabilities/chatter-likes/items"

},{

"method" : "Get","url" : "/v35.0/chatter/feed-elements/feedElementId/capabilities/chatter-likes/items"

}],"haltOnError" : "false"

}

バッチ内の各要求はサブ要求と呼ばれます。サブ要求はすべて同じユーザのコンテキスト内で実行されます。各サブ要求は独立しており、相互に情報を渡すことはできません。サブ要求は、リクエストボディ内の順序に従って実行されます。サブ要求が正常に実行されると、データがコミットされます。コミットは、以降のサブ要求の出力に反映されます (前の例のように、フィード項目にいいね! と言ってから、いいね! の総数を取得するなど)。サブ要求が失敗した場合、前のサブ要求で行われたコミットはロールバックされません。

142

Batch リソースChatter REST API リソース

リソース/connect/batch




リクエストボディGeneric Batch Collection Input

ルート XML タグ<batch>

JSON

{"batchRequests" : [{

"method" : "Get","url" : "/v35.0/chatter/feeds/news/me"

},{

"method" : "Get","url" : "/v35.0/chatter/feeds/user-profile/me"

}]

}

プロパティ


説明型名前

28.0実行するサブ要求の URL を含む、Batch

Request Input リクエストボディのコレクション。

Generic Batch Input[]batchRequests

28.0デフォルト値は、false です。値が false で、バッチ内のサブ要求が完了しない場合、Salesforceは、バッ

BooleanhaltOnError

チ内の後続のサブ要求を実行しようと試みます。値が true で、HTTP 応答 400 番台または 500 番台のエラーが含まれるためにバッチ内のサブ要求が完了しない場合、Salesforce は実行を停止します。バッチ内にある後続のサブ要求の実行

143



説明型名前

は試みず、後続のサブ要求ごとに HTTP

412 状況コードと前の要求が失敗したことを示すBATCH_PROCESSING_HALTED エラーメッセージを返します。/connect/batch への最上位要求は、HTTP 200 を返し、応答内のhasErrors プロパティが true に設定されます。

要求パラメータなし。

応答Batch Results

例この単純な例では、https://instance_name/services/data/v35.0/connect/batch に対する POST

要求に、2 つのサブ要求を持つ次のリクエストボディが含まれています。{



},{


}]

}

Batch Results レスポンスボディには、サブ要求ごとに Batch Result Item レスポンスボディが含まれます。{

"hasErrors": false,"results": [

{"result": {

"feedElementPostUrl": "/services/data/v35.0/chatter/feed-elements","feedElementsUrl": "/services/data/v35.0/chatter/feeds

/user-profile/005D0000001LL8OIAW/feed-elements","isModifiedUrl": null

},"statusCode": 200

},{

144


"result": {"feedElementPostUrl": "/services/data/v35.0/chatter/feed-elements","feedElementsUrl": "/services/data/v35.0/chatter/feeds

/news/005D0000001LL8OIAW/feed-elements","isModifiedUrl": null

},"statusCode": 200

}]

}

例: haltOnError が true の場合これは前と同じ例ですが、最初のサブ要求にエラーが含まれ、haltOnError が true に設定されています。最初のサブ要求には入力ミスがあります。{


"method" : "Get","url" : "/v35.0/chatter/feeds/user-profile/men"

},{


}],"haltOnError" : "true"

}

Batch Results レスポンスボディには、サブ要求ごとに Batch Result Item レスポンスボディが含まれます。/connect/batch への最上位要求は HTTP 200 を返しますが、最初のサブ要求はリソースが見つからないため HTTP 404 を返します。haltOnError が true であるため、次のサブ要求は HTTP 412 を返します。また、hasErrors は true に設定されています。{

"hasErrors": true,"results": [

{"result": [{

"errorCode": "NOT_FOUND","message": "The requested resource does not exist"

}],"statusCode": 404

},{

"result": [{"errorCode": "BATCH_PROCESSING_HALTED","message": "Batch processing halted per request"


}]

}

145


バイナリファイルを含む複数のコメントの投稿この例は、2 つのサブ要求が含まれる https://instance_name/services/data/v35.0/connect/batch

への汎用バッチ要求です。各サブ要求はフィード項目にコメントし、バイナリファイルをコメントにアップロードします。richInput プロパティには、各サブ要求のリクエストボディを含める必要があります。また、binaryPartName および binaryPartNameAlias プロパティには、バイナリパートに関する情報を含める必要もあります。次に cURL の例を示します。curl -H "X-PrettyPrint: 1" -F 'json={ "haltOnError":true, "batchRequests":[ {"url":"/v33.0/chatter/feed-elements/0D5D0000000YG0N/capabilities/comments/items","method":"Post", "binaryPartName":"binaryPart1","binaryPartNameAlias":"feedElementFileUpload", "richInput":{ "body":{ "messageSegments":[{ "type":"Text", "text":"Check out this file, it may help." } ] },"capabilities":{ "content":{ "title":"Presentation1.txt" } } } }, {"url":"/v33.0/chatter/feed-elements/0D5D0000000YG0M/capabilities/comments/items","method":"Post", "binaryPartName":"binaryPart2","binaryPartNameAlias":"feedElementFileUpload", "richInput":{ "body":{ "messageSegments":[{ "type":"Text", "text":"Check out this file, it may help." } ] },"capabilities":{ "content":{ "title":"Presentation2.txt" } } } } ]};type=application/json' -F"binaryPart1=@/Users/jbleyle/Desktop/Presentation1.txt;type=application/octet-stream"-F "binaryPart2=@/Users/jbleyle/Desktop/Presentation2.txt;type=application/octet-stream"

-X POST https://instance_name/services/data/v35.0/connect/batch-H 'Authorization: OAuth 00DD00000007HoR!...' --insecure

これは、マルチパート/フォームデータリクエストボディです。

https://instance_name/services/data/v35.0/connect/batch

Authorization: OAuth 00DD0000000Jhd2!...Accept: application/jsonHost: instance_nameContent-Type: multipart/form-data; boundary=123123

--123123Content-Disposition: form-data; name="json"Content-Type: application/json

{"haltOnError":true,"batchRequests":[

{"url":"/v35.0/chatter/feed-elements/0D5D0000000YG0D/capabilities/comments/items",


"body":{

146



"type":"Text","text":"Check out this file, it may help."

}]

},"capabilities":{


}}

}},{"url":"/v35.0/chatter/feed-elements/0D5D0000000YG0H/capabilities/comments/items",




}]

},"capabilities":{


}}

}}

]}

--123123Content-Disposition: form-data; name="binaryPart1"; filename="Presentation1.txt"Content-Type: application/octet-stream; charset=ISO-8859-1Content-Transfer-Encoding: binary

This is the content of file 1--123123Content-Disposition: form-data; name="binaryPart2"; filename="Presentation2.txt"Content-Type: application/octet-stream; charset=ISO-8859-1Content-Transfer-Encoding: binary

147


This is the content of file 2--123123--

関連トピック:

フィード項目にいいね! と言い、いいね! の総数を返すFeed Elements, Batch Post

Chatter リソース

Chatter フィード、グループ、およびユーザリソースのディレクトリ。リソース

/chatter

/connect/communities/communityId/chatter



HTTP メソッドGET または HEAD

レスポンスボディChatter Directory

レスポンスボディの例{

"feeds": "/services/data/v35.0/chatter/feeds","groups": "/services/data/v35.0/chatter/groups","users": "/services/data/v35.0/chatter/users"

}

Comments リソース

コメントの情報取得、編集、削除、またはコメントへのいいね! を行います。コンテキストユーザがコメントを編集できるかどうかを判別します。使用可能なリソース:

説明リソース

コメントの情報取得、編集、または削除を行います。/chatter/comments/commentId

コンテキストユーザがコメントを編集できるかどうかを判別します。

/chatter/comments/commentId/capabilities/edit/is-editable-by-me

148

Chatter リソースChatter REST API リソース

説明リソース

コメントへのいいね! に関する情報を取得します。コメントへのいいね! にも使用されます。

/chatter/comments/commentId/likes

Commentコメントの情報取得、編集、または削除を行います。リソース

/chatter/comments/commentId

/connect/communities/communityId/chatter/comments/commentId



HTTP メソッドGET、DELETE、PATCH

PATCH はバージョン 34.0 以降でサポートされます。PATCH のリクエストボディルート XML タグ

<comment>

プロパティ


説明型名前

24.0 ～ 31.0省略可能。値は次のとおりです。種別によって異なる。attachment

• Attachment Input: Existing Content

• Attachment Input: New File Upload

重要: バージョン 32.0 以降では、capabilities プロパティを使用します。

23.0コメントの本文。コメントのこのプロパティを編集するに

Message Body Inputbody

は、/chatter/comments/commentId

に対して PATCH 要求を実行します。コメントの編集は、バージョン 34.0 以降でサポートされています。

149

Comments リソースChatter REST API リソース


説明型名前

32.0添付ファイルなど、コメントの機能。Comment Capabilities Inputcapabilities

GET および PATCH のレスポンスボディComment

例ニュースフィードやレコードフィードなど、任意のフィードからの特定のコメントの ID を検索できます。コメントに関する情報を返すには、次のリソースと HTTP GET メソッドを使用します。/chatter/comments/0D7D00000000NtkKAE

Comment Capability, Editabilityコンテキストユーザがコメントを編集できるかどうかを判別します。リソース

/chatter/comments/commentId/capabilities/edit/is-editable-by-me

/connect/communities/communityId/chatter/comments/commentId/capabilities/edit/is-editable-by-me




GET のレスポンスボディFeed Entity Is Editable

Comment Likesコメントへのいいね! に関する情報を取得します。コメントへのいいね! にも使用されます。リソース

/chatter/comments/commentId/likes

/connect/communities/communityId/chatter/comments/commentId/likes



150

Comments リソースChatter REST API リソース

HTTP メソッドGET、POST、または HEAD

GET または HEAD の要求パラメータ

メモ: POST は、要求パラメータもリクエストボディも取りません。

説明型パラメータ名

返すページのページ番号を指定します。

Integerpage

ページあたりの項目数を指定します。有効な値は 1 ～ 100 です。サ

IntegerpageSize

イズを指定しない場合、デフォルトは 25 です。

GET のレスポンスボディLike Page

POST のレスポンスボディLike

関連トピック:

コメントを編集する

Communities リソース

コンテキストユーザが使用できるコミュニティに関する情報、または特定のコミュニティに関する情報。次のリソースを使用できます。

説明リソース


/connect/communities

指定されたコミュニティに関する情報を返します。/connect/communities/communityId

List of Communitiesコンテキストユーザが使用できるすべてのコミュニティリストを返します。ユーザがシステム管理者の場合、絞り込み条件を満たすコミュニティすべてのリストを返します。ユーザがシステム管理者ではない場合、絞り込み条件を満たす有効なコミュニティすべてのリストを返します。リソース


151

Communities リソースChatter REST API リソース




要求パラメータ


28.0特定の状況のコミュニティのみを返します。有

Stringstatus

効な値は、次のとおりです。• Live

• Inactive

• UnderConstruction

「ネットワークの管理」権限が有効化されているユーザのみが、Inactive 状況のコミュニティを表示できます。このパラメータは省略可能です。

レスポンスボディCommunity Page

Community Information指定されたコミュニティに関する情報を返します。リソース

/connect/communities/communityId

指定されたコミュニティの一部であるリソースにアクセスするには、URL のバージョン情報の後、アクセスするリソースの前にこのセグメントを挿入します。たとえば、コミュニティの News Feed リソースにアクセスするには、次の URL を使用します。https://instance_name/services/data/v35.0/connect/communities/communityId/chatter/feeds/news/me/feed-elements

詳細は、「Chatter REST API リソース URL の作成」 (ページ 5)を参照してください。

152

Communities リソースChatter REST API リソース




レスポンスボディCommunity

Communities Moderation リソース

ユーザがフィード要素、コメント、またはファイルに不適切フラグを設定したかどうかに関する情報。フラグの削除にも使用されます。次のリソースを使用できます。

説明リソース

フィード要素のモデレーション機能に関する情報の取得、フィード要素へのモデレーションフラグの追加、

/connect/communities/communityId/chatter/feed-elements/feedElementId/capabilities/moderation またはフィード要素のすべてのモデレーションフラグ

の削除を行います。

コンテキストユーザがコミュニティモデレータの場合、コミュニティメンバーが 1 つのコメントにフラグ

/connect/communities/communityId/chatter/comments/commentId/moderation-flags

を設定した回数を返します。また、モデレーションのためにコメントにフラグを設定したり、コメントのすべてのフラグを削除したりします。コンテキストユーザがコミュニティモデレータでない場合は、ユーザがコメントにフラグを設定したかどうかを返します。また、モデレーションのためにコメントにフラグを設定したり、ユーザが以前に追加したフラグを削除したりします。

コミュニティでフラグが設定されたファイル。コンテキストユーザがコミュニティモデレータの場合、コミュニティメンバーによってフラグが設定されたファイルを返します。

/connect/communities/communityId/chatter/files/moderation

コンテキストユーザがコミュニティモデレータの場合、コミュニティメンバーが 1 つのファイルにフラグ


を設定した回数を返します。また、モデレーションのためにファイルにフラグを設定したり、ファイルのすべてのフラグを削除したりします。

153

Communities Moderation リソースChatter REST API リソース

説明リソース

コンテキストユーザがコミュニティモデレータでない場合は、ユーザがファイルにフラグを設定したかどうかを返します。また、モデレーションのためにファイルにフラグを設定したり、ユーザが以前に追加したフラグを削除したりします。

Moderation Flags on Postsコンテキストユーザが「コミュニティフィードのモデレート」権限を持つコミュニティモデレータの場合、コミュニティメンバーが 1 つの投稿にフラグを設定した回数を返します。また、モデレーションのために投稿にフラグを設定したり、投稿のすべてのフラグを削除したりします。コンテキストユーザがコミュニティモデレータでない場合は、ユーザが投稿にフラグを設定したかどうかを返します。また、モデレーションのために投稿にフラグを設定したり、ユーザが以前に追加したフラグを削除したりします。リソース

/connect/communities/communityId/chatter/feed-items/feedItemId/moderation-flags

使用可能なバージョン29.0 ～ 31.0

重要: バージョン 32.0 以降では、Feed Elements Capability, Moderation を使用します。


HTTP メソッドGET、DELETE、HEAD、POST

GET の要求パラメータ



説明型名前

30.0 ～ 31.0省略可能さまざまなユーザ種別でのフラグの表示動作を指定します。

Stringvisibility

• ModeratorsOnly — フラグは、フラグが付けられた要素または項目に対するモデレーション権限を持つユーザにのみ表示されます。

• SelfAndModerators — フラグは、フラグの作成者とフラグが付けられた要素または項目に対するモデレーション権限を持つユーザに表示されます。

154


POST のリクエストボディルート XML タグ

<moderationFlag>

JSON

{"visibility" : "ModeratorsOnly"

}

プロパティ


説明型名前

30.0さまざまなユーザ種別でのフラグの表示動作を指定します。

Stringvisibility



POST の要求パラメータ



説明型名前

30.0 ～ 31.0省略可能さまざまなユーザ種別でのフラグの表示動作を指定します。

Stringvisibility



155


DELETE の要求パラメータ



説明型名前

29.0

～31.0

省略可能コンテキストユーザの ID。指定されている場合、ユーザが以前に投稿に追加したフラグが削除されます。指定されておらず、コンテキストユーザがコミュニティ

StringuserId

モデレータの場合は、投稿のすべてのフラグが削除されます。

GET および POST のレスポンスボディModeration Flags

Moderation Flags on Commentsコンテキストユーザがコミュニティモデレータの場合、コミュニティメンバーが 1 つのコメントにフラグを設定した回数を返します。また、モデレーションのためにコメントにフラグを設定したり、コメントのすべてのフラグを削除したりします。コンテキストユーザがコミュニティモデレータでない場合は、ユーザがコメントにフラグを設定したかどうかを返します。また、モデレーションのためにコメントにフラグを設定したり、ユーザが以前に追加したフラグを削除したりします。リソース

/connect/communities/communityId/chatter/comments/commentId/moderation-flags




156





説明型名前

30.0省略可能さまざまなユーザ種別でのフラグの表示動作を指定します。

Stringvisibility




<moderationFlag>

JSON


}

プロパティ


説明型名前


Stringvisibility



157





説明型名前


Stringvisibility






説明型名前

29.0省略可能コンテキストユーザの ID。指定されている場合、ユーザが以前にコメントに追加したフラグが削除されま

StringuserId

す。指定されておらず、コンテキストユーザがコミュニティモデレータの場合は、コメントのすべてのフラグが削除されます。


Moderation Flags on Filesコンテキストユーザがコミュニティモデレータの場合、コミュニティメンバーが 1 つのファイルにフラグを設定した回数を返します。また、モデレーションのためにファイルにフラグを設定したり、ファイルのすべてのフラグを削除したりします。コンテキストユーザがコミュニティモデレータでない場合は、ユーザがファイルにフラグを設定したかどうかを返します。また、モデレーションのためにファイルにフラグを設定したり、ユーザが以前に追加したフラグを削除したりします。リソース




158






説明型名前


Stringvisibility




<moderationFlag>

JSON


}

プロパティ


説明型名前


Stringvisibility



159





説明型名前


Stringvisibility






説明型名前

30.0省略可能コンテキストユーザの ID。指定されている場合、ユーザが以前にファイルに追加したフラグが削除されま

StringuserId

す。指定されておらず、コンテキストユーザがコミュニティモデレータの場合は、ファイルのすべてのフラグが削除されます。


Flagged Filesコミュニティでフラグが設定されたファイル。コンテキストユーザがコミュニティモデレータの場合、コミュニティメンバーによってフラグが設定されたファイルを返します。リソース

/connect/communities/communityId/chatter/files/moderation




160





説明型名前

30.0省略可能返すページのページ番号を指定します。Integerpage

30.0省略可能ページあたりの項目数を指定します。有効な値は 1 ～100 です。サイズを指定しない場合、デフォルトは 25

です。

IntegerpageSize

33.0省略可能結果を絞り込むクエリ文字列。文字列にはワイルドカード文字を除いて 2 文字以上が含まれている必要が

Stringq

あります。ワイルドカードについての詳細は、「ワイルドカード」を参照してください。

レスポンスボディFile Summary

Connect リソース

コンテキストユーザの組織と設定に関する情報、およびコンテキストユーザがメンバーであるコミュニティに関する情報。

メモ: これらのリソースの基本 URL は、/services/data/v35.0/chatter ではなく、/services/data/v35.0/connect です。

次のリソースを使用できます。

説明リソース

コンテキストユーザが使用できる組織およびコミュニティのリソースのディレクトリ。

/connect

コンテキストユーザの組織と設定に関する情報。/connect/organization



Connectコンテキストユーザが使用できる組織およびコミュニティのリソースのディレクトリ。リソース

/connect


161

Connect リソースChatter REST API リソース


HTTP メソッドGET および HEAD

レスポンスボディConnect Directory

Organizationコンテキストユーザの組織と設定に関する情報。リソース

/connect/organization




レスポンスボディOrganization

関連トピック:

News Feed リソース

Dashboard Component Snapshot リソース

ダッシュボードコンポーネントのスナップショット。このリソースは、ダッシュボードコンポーネントのスナップショットをユーザ、グループ、またはダッシュボードフィードに投稿して、他のユーザがデータの変更をフォローできるようにするために使用します。リソース

/connect/dashboards/components/componentId/snapshots




162

Dashboard Component Snapshot リソースChatter REST API リソース

リクエストボディルート XML タグ

<dashboardComponentSnapshot>

JSON

{"parentId" : "0F9D00000000I4O","feedItemBody" : {


"text" : "Sales Heat","type" : "Text"

}]

}}

プロパティ


25.0スナップショットの post 送信先となるユーザ、グループ、またはダッシュボードの ID。

StringparentId

25.0省略可能。ダッシュボード絞り込み項目の ID。

StringfilterId1

25.0省略可能。2 つ目のダッシュボード絞り込み項目の ID。

StringfilterId2


StringfilterId3

25.0ダッシュボードコンポーネントスナップショットに関連付

Message Body InputfeedItemBody

けられたフィード項目に付随するテキストが含まれます。

25.0省略可能。ダッシュボードのビューの作成元となるユーザID (作成者以外の場合)。

StringrunningUserId


説明型名前

スナップショットの post 送信先となるユーザ、グループ、またはダッシュボードのID。

StringparentId

163

Dashboard Component Snapshot リソースChatter REST API リソース

説明型名前

省略可能。ダッシュボード絞り込み項目のID。

String。filterId1

省略可能。2 つ目のダッシュボード絞り込み項目の ID。

StringfilterId2

省略可能。3 つ目のダッシュボード絞り込み項目の ID。

StringfilterId3

ダッシュボードコンポーネントスナップショットに付随するテキスト。

StringfeedItemText

省略可能。ダッシュボードのビューの作成元となるユーザ ID (作成者以外の場合)。

StringrunningUserId

レスポンスボディAPI バージョン 23.0 ～ 31.0 では、Feed Item Attachment: Dashboard を返します。API バージョン 32.0 以降では、Dashboard Component Snapshot を返します。

Datacloud リソース

Data.com の取引先責任者または会社を購入するために使用する Datacloud リソースに関する情報。Datacloud リソースを使用してData.comの取引先責任者または会社を購入し、利用できるクレジット数など、購入に関する情報を取得します。

説明リソース

指定された companyIdの会社項目の値を返します。/connect/datacloud/companies/companyId

指定された取引先責任者の取引先責任者情報を返します。

/connect/datacloud/contacts/contactId

指定された注文に含まれるすべての会社に関するすべての情報を返します。

/connect/datacloud/orders/orderId/companies

取引先責任者の特定の orderId の注文情報をすべて返します。

/connect/datacloud/orders/orderId/contacts

リストされた ID の取引先責任者または会社を購入します。POST 要求には取引先責任者 ID または会社 ID を

/connect/datacloud/orders

指定できますが、両方は指定できません。orderInput。

Monthly ユーザまたは Listpool ユーザの利用状況情報を返します。

/connect/datacloud/usage/userId

164

Datacloud リソースChatter REST API リソース

Datacloud Company Information指定された companyId の会社項目の値を返します。リソース

/connect/datacloud/companies/companyId




レスポンスボディDatacloudCompanyRepresentation

Datacloud Contact Information指定された取引先責任者の取引先責任者情報を返します。リソース

/connect/datacloud/contacts/contactId




レスポンスボディDatacloudContactRepresentation

Datacloud OrderId Information特定の orderId の情報を返します。リソース

注文情報には、orderId、orderId で購入したレコード数、注文情報の URL、購入したレコードのリストの URL が含まれます。/connect/datacloud/orders/orderId



165

Datacloud Company InformationChatter REST API リソース


レスポンスボディDatacloudOrderRepresentation

Datacloud Company Order Information指定された注文に含まれるすべての会社に関するすべての情報を返します。orderIdは購入した会社のものである必要があります。取引先責任者の orderIdへの要求は失敗します。注文情報には、orderId、その注文で購入したレコード数、購入した会社の情報、次ページと前ページの URL が含まれます。リソース

/connect/datacloud/orders/orderId/companies








32.0必須項目現在のページの URL として設定するページ番号。

Integerpage

32.0省略可能返すページの数。デフォルトのページサイズは 25 です。

IntegerpageSize

GET のレスポンスボディDatacloudCompanyCollectionRepresentation

Datacloud Contact Order Information取引先責任者の特定の orderId の注文情報をすべて返します。注文情報には、orderId、orderIdで購入したレコード数、注文情報の URL、購入した取引先責任者の詳細が含まれます。orderIdは、購入した取引先責任者のものである必要があります。購入した会社の orderIdを含む要求は失敗します。リソース

/connect/datacloud/orders/orderId/contacts

166

Datacloud Company Order InformationChatter REST API リソース








32.0省略可能返すページの数。Integerpage

32.0省略可能ページごとに返す取引先責任者の数。デフォルトのページサイズは25 です。

IntegerpageSize

GET のレスポンスボディDatacloudContactCollectionRepresentation

Datacloud Ordersリストされた ID の取引先責任者または会社を購入します。POST 要求には取引先責任者 ID または会社 ID を指定できますが、両方は指定できません。orderInput。1 回の POST 要求で取引先責任者または会社を購入し、指定します。リソース

/connect/datacloud/orders





<DatacloudOrder>

JSON の例{

"companyIds":["23456","24548"

167

Datacloud OrdersChatter REST API リソース

],"userType":"Monthly"

}

プロパティ



説明型名前

32.0必須項目購入する会社のリスト。contactIds とcompanyIdsが共に含まれていると、購入は失敗します。

StringcompanyIds

32.0必須項目購入する取引先責任者のリスト。リストには取引先責任者のみを含めることをお勧めしま

StringcontactIds

す。companyIds と contactIds が共に含まれていると、購入は失敗します。

32.0省略可能 —

ユーザ種別Data.com ユーザ種別。StringuserType

• Monthy — Data.comレコードの購入の毎月のポイント制限が割り当てられるユーザが指定され

ていない場種別。毎月のポイントを使用できるのは、合、デフォ割り当てられたユーザのみです。ポインルトはトは、月末に期限切れになります。MonthlyMonthly です。

は、DatacloudUserType のデフォルト設定です。

• Listpool — Data.com レコードを購入するためのポイントをユーザがプールから引き出すことを許可するユーザ種別。





32.0必須項目取引先責任者 ID または会社 ID のリストを含むリクエストボディ。

ObjectorderInput

POST のレスポンスボディDatacloudOrderRepresentation

Datacloud UsageMonthly ユーザまたは Listpool ユーザの利用状況情報を返します。

168

Datacloud UsageChatter REST API リソース

リソース/connect/datacloud/usage/userId




レスポンスボディDatacloudPurchaseUsageRepresentation

Feed Elements リソース

フィード要素に関する情報。フィード要素へのアクセス、フィード要素の編集、投稿、検索、削除を行います。バンドルやそのフィード要素など、フィード要素の機能にアクセスします。使用可能なリソース:

説明リソース

フィード要素の投稿や、組織のすべてのフィード要素の検索を行います。


最大 500 件のフィード要素を一括投稿します。

/chatter/feed-elements/batch

最大 500 個のフィード要素から成るカンマ区切りのリストに関する情報

/chatter/feed-elements/batch/feedElementIds

を取得します。読み込みできないフィード要素のエラーは、結果で返されます。

フィード要素へのアクセス、あるいはその編集または削除を行います。

/chatter/feed-elements/feedElementId

フィード要素の種類のうち、編集可能なのはフィード項目のみです。

フィード要素の機能セットにアクセスします。

/chatter/feed-elements/feedElementId/capabilities

フィード要素の承認機能にアクセスします。

/chatter/feed-elements/feedElementId/capabilities/approval

フィード要素の関連付けられたアクション機能にアクセスします。

/chatter/feed-elements/feedElementId/capabilities/associated-actions

169

Feed Elements リソースChatter REST API リソース

説明リソース

フィード要素のバナー機能にアクセスします。

/chatter/feed-elements/feedElementId/capabilities/banner

フィード要素がブックマークされているかどうかの情報の取得や、

/chatter/feed-elements/feedElementId/capabilities/bookmarks

フィード要素へのブックマークの追加を行います。

フィード要素のバンドル機能にアクセスします。

/chatter/feed-elements/feedElementId/capabilities/bundle

バンドルとして一緒にグループ化されているフィード要素のすべてにアクセスします。

/chatter/feed-elements/feedElementId/capabilities/bundle/feed-elements

フィード要素のキャンバス機能にアクセスします。

/chatter/feed-elements/feedElementId/capabilities/canvas

フィード要素のケースコメント機能にアクセスします。

/chatter/feed-elements/feedElementId/capabilities/case-comment

フィード要素の Chatter のいいね! 機能に関する情報にアクセスします

/chatter/feed-elements/feedElementId/capabilities/chatter-likes

フィード要素のいいね! のページにアクセスするか、フィード要素にいいね! を追加します。

/chatter/feed-elements/feedElementId/capabilities/chatter-likes/items

フィード要素のコメント機能にアクセスします。

/chatter/feed-elements/feedElementId/capabilities/comments

フィード要素のコメントにアクセスするか、フィード要素にコメントを追加します。


フィード要素のコンテンツ機能にアクセスします。

/chatter/feed-elements/feedElementId/capabilities/content

フィード要素のダッシュボードコンポーネント機能にアクセスします。

/chatter/feed-elements/feedElementId/capabilities/dashboard-component-snapshot

コンテキストユーザがフィード要素を編集できるかどうかを示します。

/chatter/feed-elements/feedElementId/capabilities/edit/is-editable-by-me

フィード要素の種類のうち、編集可能なのはフィード項目のみです。

フィード要素のメールメッセージ機能にアクセスします。

/chatter/feed-elements/feedElementId/capabilities/email-message

170


説明リソース

フィード要素の拡張リンク機能にアクセスします。

/chatter/feed-elements/feedElementId/capabilities/enhanced-link

フィード要素のリンク機能にアクセスします。

/chatter/feed-elements/feedElementId/capabilities/link

フィード要素のモデレーション機能に関する情報の取得、フィード要素

/chatter/feed-elements/feedElementId/capabilities/moderation

へのモデレーションフラグの追加、またはフィード要素のすべてのモデレーションフラグの削除を行います。

フィード要素がミュートされているかどうかの情報の取得や、フィード

/chatter/feed-elements/feedElementId/capabilities/mute

要素のミュートまたはミュート解除を行います。

フィード要素の発生源機能にアクセスします。フィード要素にこの機能

/chatter/feed-elements/feedElementId/capabilities/origin

がある場合、そのフィード要素はフィードアクションによって作成されています。

フィード要素のアンケートへのアクセス、アンケートの作成、またはアンケートへの投票を行います。

/chatter/feed-elements/feedElementId/capabilities/poll

フィード要素の質問と回答へのアクセス、またはフィード要素の質問と回答の更新を行います。

/chatter/feed-elements/feedElementId/capabilities/question-and-answers

フィード要素のおすすめ機能にアクセスします。

/chatter/feed-elements/feedElementId/capabilities/recommendations

フィード要素のレコードスナップショット機能にアクセスします。

/chatter/feed-elements/feedElementId/capabilities/record-snapshot

フィード要素の質問と回答へのアクセス、またはフィード要素の質問と回答の更新を行います。

/chatter/feed-elements/feedElementId/capabilities/topics

フィード要素の変更追跡機能にアクセスします。

/chatter/feed-elements/feedElementId/capabilities/tracked-changes

171


Feed Elements, Post and Searchフィード要素の投稿や、組織のすべてのフィード要素の検索を行います。リソース


/connect/communities/communityId/chatter/feed-elements



HTTP メソッドGET、POST





31.0省略可能情報ページの表示に使用されるページトークンを指定します。

Stringpage

ページトークンは、currentPageToken またはnextPageToken のように、応答クラスの一部として返されます。nullを渡すと、最初のページが返されます。

31.0省略可能ページあたりのフィード要素数を指定します。有効な値は 1 ～

IntegerpageSize

100 です。null を渡すと、デフォルトサイズの 25 に設定されます。

31.0必須項目コンテキストユーザに表示されるフィード要素に含まれる 1 つ

Stringq

以上の検索キーワード。検索文字列にはワイルドカード文字を含めることができ、ワイルドカード文字を除く 2 文字以上が含まれている必要があります。「ワイルドカード」を参照してください。

172

Feed Elements, Post and SearchChatter REST API リソース




31.0省略可能フィード要素ごとに返されるコメントの最大数。デフォルト値は 3 です。

IntegerrecentCommentCount

31.0省略可能作成日や最終更新日などで並び替えて返される順序を指定します。

Stringsort

• CreatedDateDesc — 作成日の新しい順に並び替えます。

• LastModifiedDateDesc —

活動の新しい順に並び替えられます。

GET のレスポンスボディFeed Element Page

POST のリクエストボディFeed Item Input





31.0必須項目フィード要素は、フィードに含まれる最上位の項目です。フィードは、フィード要素コンテナです。使用可能な値は FeedItemのみです。

StringfeedElementType

31.0省略可能このフィード要素が共有されている場合、これは元のフィード要素の 18 文字の ID です。

StringoriginalFeedElementId

31.0必須項目このフィード要素が投稿された親の ID。この値は、ユーザ、グルー

StringsubjectId

プ、レコードの ID、またはコンテキストユーザを示す文字列 me になります。

31.0必須項目フィード要素のテキスト。Stringtext

173

Feed Elements, Post and SearchChatter REST API リソース




31.0省略可能フィード要素を表示できるユーザの種別を指定します。

Stringvisibility

• AllUsers — 表示は内部ユーザに限定されません。

• InternalUsers — 表示は内部ユーザに限定されます。

POST のレスポンスボディFeed Item

POST の例次の例では、ユーザにメンションするテキストを投稿します。POST /chatter/feed-elements

{"body" : {


"type" : "Text","text" : "When should we meet for release planning? "

},{


}]},

"feedElementType" : "FeedItem","subjectId" : "005D00000016Qxp"

}

関連トピック:

アクションリンクテンプレートアクションリンクを定義し、フィード要素を使用して投稿するテンプレートのアクションリンクを定義し、フィード要素を使用して投稿するインライン画像を含むフィード要素を投稿する

Feed Elements, Batch Post最大 500 件のフィード要素を一括投稿します。

174

Feed Elements, Batch PostChatter REST API リソース

リソース/chatter/feed-elements/batch

/connect/communities/communityId/chatter/feed-elements/batch



HTTP メソッドPOST、HEAD

POST のリクエストボディBatch Collection Input

このバッチコレクションのリッチ入力は Feed Item Input です。POST のレスポンスボディ

Batch Results

Batch Results レスポンスボディには、それぞれのリクエストボディに対応する Feed Item レスポンスボディが含まれます。Feed Item レスポンスボディは、リクエストボディと同じ順序で返されます。この要求は、要求全体に影響を与えるエラー (解析エラーなど) が発生しない限り、HTTP 200 状況コードを返します。個々のリクエストボディでエラーが発生した場合、Batch Results Item の statusCode プロパティには、該当する HTTP 状況コードが含まれます。

フィード要素の一括投稿この例では、/chatter/feed-elements/batchリソースを使用してフィード要素を一括投稿します。次の例では cURL を使用します。curl -H "X-PrettyPrint: 1" -F'json={"inputs":[{"richInput":{"subjectId":"me","body":{"messageSegments":[{"type":"Text","text":"PostNumber1"}]},"feedElementType":"FeedItem"}},{"richInput":{"subjectId":"me","body":{"messageSegments":[{"type":"Text","text":"PostNumber 2"}]},"feedElementType":"FeedItem"}}]};type=application/json' -X POSThttps://instance_name/services/data/v35.0/chatter/feed-elements/batch -H 'Authorization:OAuth 00DD00000007HoR!...' --insecure

次に、同じ例のリクエストボディのみを示します。{"inputs": [{"richInput": {"subjectId": "me","body": {"messageSegments": [{"type": "Text","text": "Post Number 1"

}]

175


},"feedElementType": "FeedItem"

}},{"richInput": {"subjectId": "me","body": {"messageSegments": [{"type": "Text","text": "Post Number 2"

}]


}}

]}

バイナリファイルを含むフィード要素の一括投稿次の例では、/chatter/feed-elements/batchリソースを使用してフィード要素を一括投稿し、2 つのバイナリファイルをアップロードして、バッチ内のフィード要素に添付します。リクエストボディにはバイナリパートに関する情報を含める必要があります。次の例では cURL を使用します。curl -H "X-PrettyPrint: 1" -F 'json={"inputs":[{"binaryPartNames":["bin1"],"richInput":{"subjectId":"me","body":{"messageSegments":[{"type":"Text","text":"Please accept this receipt"}]},"capabilities":{"content" : {"description": "Receipt for expenses","title":"receipt.pdf"}},"feedElementType":"FeedItem"}},{"binaryPartNames":["bin2"],"richInput":{"subjectId":"me","body":{"messageSegments":[{"type":"Text","text":"PostNumber 2"}]},"capabilities": {"content" : {"description": "Receipt for expenses","title":"receipt2.pdf"}},"feedElementType":"FeedItem"}}]};type=application/json'-F "bin1=@/Users/jsmith/Desktop/receipt.pdf;type=application/octet-stream" -F"bin2=@/Users/jsmith/Desktop/receipt2.pdf;type=application/octet-stream"-X POST https://instance_name/services/data/v35.0/chatter/feed-elements/batch-H 'Authorization: OAuth 00DD00000007HoR44QATPNzhzYEJBfU' --insecure

以下に、上記の例を、リクエストボディパートが確認できる形式に変えた例を示します。POST /services/data/v35.0/chatter/feed-elements/batch HTTP/1.1Authorization: OAuth 00DRR0000000N0g!...User-Agent: Jakarta Commons-HttpClient/3.0.1Host: instance_nameContent-Length: 845Content-Type: multipart/form-data; boundary=a7V4kRcFA8E79pivMuV2tukQ85cmNKeoEgJgqAccept: application/json


176


{"inputs": [{"binaryPartNames": ["bin1"

],"richInput": {"subjectId": "me","body": {"messageSegments": [{"type": "Text","text": "Please accept this receipt"

}]

},"capabilities": {"content": {"description": "Receipt for expenses","title": "receipt.pdf"


}},{"binaryPartNames": ["bin2"

],"richInput": {"subjectId": "me","body": {"messageSegments": [{"type": "Text","text": "Post Number 2"

}]

},"capabilities": {"content": {"description": "Receipt for expenses","title": "receipt2.pdf"


}}

]}

--a7V4kRcFA8E79pivMuV2tukQ85cmNKeoEgJgqContent-Disposition: form-data; name="bin1"; filename="receipt.pdf"Content-Type: application/octet-stream; charset=ISO-8859-1

177



--a7V4kRcFA8E79pivMuV2tukQ85cmNKeoEgJgqContent-Disposition: form-data; name="bin2"; filename="receipt2.pdf"Content-Type: application/octet-stream; charset=ISO-8859-1

...contents of receipt2.pdf...


メモ: binaryPartNamesプロパティ内のバイナリパート名は、バイナリリクエストパートの nameプロパティ内のバイナリパート名と一致する必要があります。

関連トピック:

Chatter REST API 入力の使用Batch リソース

Feed Elements, Batch Get最大 500 個のフィード要素から成るカンマ区切りのリストに関する情報を取得します。読み込みできないフィード要素のエラーは、結果で返されます。リソース

/chatter/feed-elements/batch/feedElementIds

/connect/communities/communityId/chatter/feed-elements/batch/feedElementIds




GET のレスポンスボディBatch Results

Feed Elementフィード要素へのアクセス、あるいはその編集または削除を行います。フィード要素の種類のうち、編集可能なのはフィード項目のみです。リソース

/chatter/feed-elements/feedElementId

/connect/communities/communityId/chatter/feed-elements/feedElementId

178

Feed Elements, Batch GetChatter REST API リソース



HTTP メソッドGET、DELETE、PATCH

PATCH はバージョン 34.0 以降でサポートされます。GET の要求パラメータ




31.0省略可能バンドルあたりの最大フィード要素数。デフォルトおよび最大値は、10 です。

IntegerelementsPerBundle



PATCH のリクエストボディFeed Item Input

PATCH のレスポンスボディFeed Item

GET のレスポンスボディGeneric Feed Element または Feed Item


関連トピック:

フィード投稿を編集する質問のタイトルと投稿を編集する

Feed Element Capabilitiesフィード要素の機能セットにアクセスします。リソース

/chatter/feed-elements/feedElementId/capabilities

/connect/communities/communityId/chatter/feed-elements/feedElementId/capabilities

179

Feed Element CapabilitiesChatter REST API リソース










31.0省略可能フィード要素ごとに返されるコメントの最大数。デフォルト値は 3

です。


GET のレスポンスボディFeed Element Capabilities

Feed Elements Capability, Approvalフィード要素の承認機能にアクセスします。リソース

/chatter/feed-elements/feedElementId/capabilities/approval

/connect/communities/communityId/chatter/feed-elements/feedElementId/capabilities/approval




GET のレスポンスボディApproval Capability

フィード要素がこの機能をサポートしていない場合、応答は 404: Not Found になります。

Feed Elements Capability, Associated Actionsフィード要素の関連付けられたアクション機能にアクセスします。

180

Feed Elements Capability, ApprovalChatter REST API リソース

リソース/chatter/feed-elements/feedElementId/capabilities/associated-actions

/connect/communities/communityId/chatter/feed-elements/feedElementId/capabilities/associated-actions




GET のレスポンスボディAssociated Actions Capability


Feed Elements Capability, Bannerフィード要素のバナー機能にアクセスします。リソース

/chatter/feed-elements/feedElementId/capabilities/banner

/connect/communities/communityId/chatter/feed-elements/feedElementId/capabilities/banner




GET のレスポンスボディBanner Capability


Feed Elements Capability, Bookmarksフィード要素がブックマークされているかどうかの情報の取得や、フィード要素へのブックマークの追加を行います。リソース

/chatter/feed-elements/feedElementId/capabilities/bookmarks

/connect/communities/communityId/chatter/feed-elements/feedElementId/capabilities/bookmarks

181

Feed Elements Capability, BannerChatter REST API リソース



HTTP メソッドGET、PATCH


<bookmarksCapability><isBookmarkedByCurrentUser>true</isBookmarkedByCurrentUser>

</bookmarksCapability>

JSON の例{

"isBookmarkedByCurrentUser": true}

プロパティ



説明型名前

32.0必須項目フィード要素をユーザのためにブックマークする必要があるか

BooleanisBookmarkedByCurrentUser

(true)、否か (false) を指定します。








GET、PATCH のレスポンスボディBookmarks Capability


Feed Elements Capability, Bundleフィード要素のバンドル機能にアクセスします。

182

Feed Elements Capability, BundleChatter REST API リソース

リソース/chatter/feed-elements/feedElementId/capabilities/bundle

/connect/communities/communityId/chatter/feed-elements/feedElementId/capabilities/bundle











です。


GET のレスポンスボディ次のいずれかのレスポンスボディになります。• Generic Bundle Capability

• Tracked Change Bundle Capability


Feed Elements Capability, Bundle Elementsバンドルとして一緒にグループ化されているフィード要素のすべてにアクセスします。

メモ: バンドル投稿にはフィード追跡変更が含まれます。Salesforce1 ダウンロード可能アプリケーションでは、バンドル投稿がレコードフィードのみにあります。

リソース/chatter/feed-elements/feedElementId/capabilities/bundle/feed-elements

connect/communities/communityId/chatter/feed-elements/feedElementId/capabilities/bundle/feed-elements


183

Feed Elements Capability, Bundle ElementsChatter REST API リソース










Stringpage

ページトークンは、currentPageToken またはnextPageToken のように、応答クラスの一部として返されます。nullを渡すと、最初のページが返されます。

31.0省略可能ページあたりのフィード要素数を指定します。有効な値は 1 ～

IntegerpageSize

100 です。null を渡すと、デフォルトサイズの 25 に設定されます。





Feed Elements Capability, Canvasフィード要素のキャンバス機能にアクセスします。リソース

/chatter/feed-elements/feedElementId/capabilities/canvas

/connect/communities/communityId/chatter/feed-elements/feedElementId/capabilities/canvas

184

Feed Elements Capability, CanvasChatter REST API リソース




GET のレスポンスボディCanvas Capability


Feed Elements Capability, Case Commentフィード要素のケースコメント機能にアクセスします。リソース

/chatter/feed-elements/feedElementId/capabilities/case-comment

/connect/communities/communityId/chatter/feed-elements/feedElementId/capabilities/case-comment




GET のレスポンスボディCase Comment Capability


Feed Elements Capability, Chatter Likesフィード要素の Chatter のいいね! 機能に関する情報にアクセスしますリソース

/chatter/feed-elements/feedElementId/capabilities/chatter-likes

/connect/communities/communityId/chatter/feed-elements/feedElementId/capabilities/chatter-likes




185

Feed Elements Capability, Case CommentChatter REST API リソース

応答Chatter Likes Capability


Feed Elements Capability, Chatter Likes Itemsフィード要素のいいね! のページにアクセスするか、フィード要素にいいね! を追加します。リソース

/chatter/feed-elements/feedElementId/capabilities/chatter-likes/items

/connect/communities/communityId/chatter/feed-elements/feedElementId/capabilities/chatter-likes/items








32.0省略可能返すページのページ番号を指定します。値を指定しないと、最初のページが返されます。

Integerpage

32.0省略可能1 ページあたりのいいね! の数を指定します。有効な値は 1 ～ 100 で

IntegerpageSize

す。サイズを指定しない場合、デフォルトは 25 です。


フィード要素がこの機能をサポートしていない場合、応答は 404: Not Found になります。GET のレスポンスボディ

Like Page


Feed Elements Capability, Commentsフィード要素のコメント機能にアクセスします。

186

Feed Elements Capability, Chatter Likes ItemsChatter REST API リソース

リソース/chatter/feed-elements/feedElementId/capabilities/comments

/connect/communities/communityId/chatter/feed-elements/feedElementId/capabilities/comments




GET のレスポンスボディComments Capability


Feed Elements Capability, Comments Itemsフィード要素のコメントにアクセスするか、フィード要素にコメントを追加します。コメントの post 送信についての詳細は、「入力での POST、PATCH、または PUT の使用」を参照してください。コメントに添付するバイナリファイルをアップロードするには、マルチパート/フォームデータ要求に含めて送信する必要があります。コメントのテキストを送信するには、マルチパート/フォームデータ要求に JSON または XML リッチ入力ボディパートを含める方法があります。または、その情報を要求パラメータパートで渡すように選択することもできます。マルチパート/フォームデータメッセージを作成する方法についての詳細は、「バイナリファイルのアップロード」を参照してください。リソース


/connect/communities/communityId/chatter/feed-elements/feedElementId/capabilities/comments/items





<comment>

187

Feed Elements Capability, Comments ItemsChatter REST API リソース

プロパティ


説明型名前




重要: バージョン 32.0 以降では、capabilitiesプロパティを使用します。










32.0必須項目コメントのテキスト。Stringtext





32.0省略可能コメントの次のページへの URL。Stringpage

32.0省略可能ページあたりのコメント数。デフォルト値は 3 です。

IntegerpageSize

GET のレスポンスボディComment Page


188

Feed Elements Capability, Comments ItemsChatter REST API リソース

POST のレスポンスボディComment


Feed Elements Capability, Contentフィード要素のコンテンツ機能にアクセスします。リソース

/chatter/feed-elements/feedElementId/capabilities/content

/connect/communities/communityId/chatter/feed-elements/feedElementId/capabilities/content




GET のレスポンスボディContent Capability


Feed Elements Capability, Dashboard Component Snapshotフィード要素のダッシュボードコンポーネント機能にアクセスします。リソース

/chatter/feed-elements/feedElementId/capabilities/dashboard-component-snapshot

/connect/communities/communityId/chatter/feed-elements/feedElementId/capabilities/dashboard-component-snapshot




GET のレスポンスボディDashboard Component Snapshot Capability


189

Feed Elements Capability, ContentChatter REST API リソース

Feed Elements Capability, Editabilityコンテキストユーザがフィード要素を編集できるかどうかを示します。フィード要素の種類のうち、編集可能なのはフィード項目のみです。リソース

/chatter/feed-elements/feedElementId/capabilities/edit/is-editable-by-me

/connect/communities/communityId/chatter/feed-elements/feedElementId/capabilities/edit/is-editable-by-me




GET のレスポンスボディFeed Entity Is Editable

Feed Elements Capability, Email Messageフィード要素のメールメッセージ機能にアクセスします。リソース

/chatter/feed-elements/feedElementId/capabilities/email-message

/connect/communities/communityId/chatter/feed-elements/feedElementId/capabilities/email-message




GET のレスポンスボディEmail Message Capability


Feed Elements Capability, Enhanced Linkフィード要素の拡張リンク機能にアクセスします。リソース

/chatter/feed-elements/feedElementId/capabilities/enhanced-link

/connect/communities/communityId/chatter/feed-elements/feedElementId/capabilities/enhanced-link

190

Feed Elements Capability, EditabilityChatter REST API リソース




GET のレスポンスボディEnhanced Link Capability


Feed Elements Capability, Linkフィード要素のリンク機能にアクセスします。リソース

/chatter/feed-elements/feedElementId/capabilities/link

/connect/communities/communityId/chatter/feed-elements/feedElementId/capabilities/link




GET のレスポンスボディLink Capability


Feed Elements Capability, Moderationフィード要素のモデレーション機能に関する情報の取得、フィード要素へのモデレーションフラグの追加、またはフィード要素のすべてのモデレーションフラグの削除を行います。リソース

/connect/communities/communityId/chatter/feed-elements/feedElementId/capabilities/moderation



HTTP メソッドGET、POST、DELETE、HEAD

191

Feed Elements Capability, LinkChatter REST API リソース

GET および POST の要求パラメータ




31.0省略可能さまざまなユーザ種別でのフラグの表示動作を指定します。次のいずれかの値にします。

Stringvisibility




<moderationFlag>

JSON


}

プロパティ


説明型名前


Stringvisibility



192

Feed Elements Capability, ModerationChatter REST API リソース

GET および POST のレスポンスボディModeration Capability


Feed Elements Capability, Muteフィード要素がミュートされているかどうかの情報の取得や、フィード要素のミュートまたはミュート解除を行います。リソース

/chatter/feed-elements/feedElementId/capabilities/mute

/connect/communities/communityId/chatter/feed-elements/feedElementId/capabilities/mute



HTTP メソッドGET、HEAD、PATCH


<muteCapability>

JSON の例{

"isMutedByMe": true}

プロパティ



説明型名前

35.0必須項目コンテキストユーザに対してフィード要素がミュートされてい

BooleanisMutedByMe

るかどうかを示します。デフォルト値は false です。






BooleanisMutedByMe

193

Feed Elements Capability, MuteChatter REST API リソース





GET および PATCH のレスポンスボディMute Capability


Feed Elements Capability, Originフィード要素の発生源機能にアクセスします。フィード要素にこの機能がある場合、そのフィード要素はフィードアクションによって作成されています。リソース

/chatter/feed-elements/feedElementId/capabilities/origin

/connect/communities/communityId/chatter/feed-elements/feedElementId/capabilities/origin




GET のレスポンスボディOrigin Capability


Feed Elements Capability, Pollフィード要素のアンケートへのアクセス、アンケートの作成、またはアンケートへの投票を行います。リソース

/chatter/feed-elements/feedElementId/capabilities/poll

/connect/communities/communityId/chatter/feed-elements/feedElementId/capabilities/poll



194

Feed Elements Capability, OriginChatter REST API リソース


PATCH のリクエストボディXML の例

<pollCapability><pollChoices>

<choice>Monday</choice><choice>Tuesday</choice>

</pollChoices></pollCapability>

JSON の例{

"choices" : ["Monday", "Tuesday"

]}

プロパティ



説明型名前

32.0アンケートの作成では必須

新しいアンケートの作成に使用する選択肢。アンケートには 2 個から 10 個のアンケート選択肢を指定する必要があります。

String []choices

32.0アンケートへの投票では必須

フィードアンケートの既存の選択肢の ID。既存のアンケートに投票するために使用されます。

StringmyChoiceId





32.0必須項目アンケート選択肢 ID。StringmyChoiceId

GET、PATCH のレスポンスボディPoll Capability


Feed Elements Capability, Question and Answersフィード要素の質問と回答へのアクセス、またはフィード要素の質問と回答の更新を行います。

195

Feed Elements Capability, Question and AnswersChatter REST API リソース

リソース/chatter/feed-elements/feedElementId/capabilities/question-and-answers

/connect/communities/communityId/chatter/feed-elements/feedElementId/capabilities/question-and-answers





<questionAndAnswersCapability><bestAnswerId>0D7D00000000lMAKAY</bestAnswerId>

</questionAndAnswersCapability>

JSON の例{

"bestAnswerId": "0D7D00000000lMAKAY"}

プロパティ



説明型名前

32.0最良の回答のPATCH では必須。POST 要求ではサポートされていません。

質問フィード要素の最良の回答として使用するコメント ID。最良の回答コメントは、質問フィード要素にすでに存在する必要があります。

StringbestAnswerId

32.0質問の POST または PATCH では必須。

質問フィード要素のタイトル。質問のタイトルを編集するには、/chatter/feed-elements

StringquestionTitle

/feedElementIdに対して PATCH

要求を実行します。質問のタイトルの編集は、バージョン 34.0 以降でサポートされています。

196

Feed Elements Capability, Question and AnswersChatter REST API リソース





32.0必須項目質問フィード要素の最良の回答として使用するコメント ID。最良の

StringbestAnswerId

回答コメントは、質問フィード要素にすでに存在する必要があります。

GET、PATCH のレスポンスボディQuestion and Answers Capability


Feed Elements Capability, Recommendationsフィード要素のおすすめ機能にアクセスします。リソース

/chatter/feed-elements/feedElementId/capabilities/recommendations

/connect/communities/communityId/chatter/feed-elements/feedElementId/capabilities/recommendations




GET のレスポンスボディRecommendations Capability


Feed Elements Capability, Record Snapshotフィード要素のレコードスナップショット機能にアクセスします。リソース

/chatter/feed-elements/feedElementId/capabilities/record-snapshot

/connect/communities/communityId/chatter/feed-elements/feedElementId/capabilities/record-snapshot


197

Feed Elements Capability, RecommendationsChatter REST API リソース



GET のレスポンスボディRecord Snapshot Capability


Feed Elements Capability, Topicsフィード要素に関連付けられたトピックの取得、削除、および投稿を行います。リソース

/chatter/feed-elements/feedElementId/capabilities/topics

/connect/communities/communityId/chatter/feed-elements/feedElementId/capabilities/topics



HTTP メソッドGET、DELETE、POST


<feedItemTopic>

JSON

次の例では、フィード項目に新規のトピックを添付します。{ "topicName": "W3C"}

プロパティ


必須項目/省略可能説明型名前

29.0topicName プロパティが使用されていない場合、既存のトピックに必要です。

既存のトピックの IDStringtopicId

29.0新規のトピック、およびtopicId プロパティが使

新規または既存のトピックの名前 (最大 150 文字)

StringtopicName

198

Feed Elements Capability, TopicsChatter REST API リソース



用されていない場合の既存のトピックに必要です。





32.0topicNameプロパティが使用さ

既存のトピックの ID。StringtopicId

れていない場合、既存のトピックに必要です。

32.0新規のトピック、および

新規または既存のトピックの名前(最大 150 文字)。

StringtopicName

topicIdプロパティが使用されていない場合の既存のトピックに必要です。





32.0必須項目既存のトピック ID。StringtopicId

POST のレスポンスボディTopic

フィード要素がこの機能をサポートしていない場合、応答は 404: Not Found になります。GET のレスポンスボディ

Topics Capability


199

Feed Elements Capability, TopicsChatter REST API リソース

Feed Elements Capability, Tracked Changesフィード要素の変更追跡機能にアクセスします。リソース

/chatter/feed-elements/feedElementId/capabilities/tracked-changes

/connect/communities/communityId/chatter/feed-elements/feedElementId/capabilities/tracked-changes




GET のレスポンスボディTracked Changes Capability

Feed Items リソース

フィード項目に関する情報。フィード項目のアクセス、検索、削除、ブックマーク、いいね! を行います。コメントのアクセスと投稿、アンケートのアクセスと投票、トピックのアクセス、追加、削除を行います。

重要: Feed Item リソースは、バージョン 32.0 以降では使用できません。バージョン 32.0 以降では、Feed

Elements Resources を使用します。

Feed-Items Batchフィード項目のバッチ。複数のフィード項目に関する情報を 1 つの要求で取得します。最大 500 件のフィード項目のカンマ区切りのリストに関する情報を取得します。読み込みできないフィード項目のエラーは、結果に返されます。リソース

/chatter/feed-items/batch/feedItemIds


重要: バージョン 32.0 以降では、Feed Elements, Batch Get を使用します。



GET のレスポンスボディBatch Results

200

Feed Elements Capability, Tracked ChangesChatter REST API リソース

Feed-Items Queryフィード項目のページ設定されたコレクション。このリソースは、フィード項目の検索に使用します。クエリパラメータ (q) が必要です。追跡変更を含む、すべての種別のフィード項目が検索されます。検索では、フィード項目本文に検索語が含まれるフィード項目と、コメントに検索語が含まれるフィード項目を返します。クエリパラメータにワイルドカードを使用することもできます。リソース

/chatter/feed-items?q=searchTerm


重要: バージョン 32.0 以降では、Feed Elements, Post and Search を使用します。




適用開始バージョン



23.0 ～ 31.0省略可能

生成されたトークン。フィード内のフィード項目のビューを示します。

Stringpage

23.0 ～ 31.0省略可能

ページあたりの項目数を指定します。有効な値は 1 ～ 100 です。サイズを指定しない場合、デフォルトは 25 です。

IntegerpageSize

23.0 ～ 31.0必須項目

検索する文字列を指定します。検索文字列にはワイルドカード文字を除いて 2 文字以上が含まれている必要があります。ワイルドカードについての詳細は、「ワイルドカード」を参照してください。クエリパラメータは、追跡変更を含む、すべての種別のフィード項目を検索します。検索では、フィード項目本文に検索語

Stringq

が含まれるフィード項目と、コメントに検索語が含まれるフィード項目を返します。

29.0 ～ 31.0省略可能

フィード項目ごとに含めるコメントの最大数。デフォルト値は 3 です。


28.0 ～ 31.0省略可能

結果の並び替え順。値は次のとおりです。Stringsort

• CreatedDateDesc

• LastModifiedDateDesc

デフォルト値は、CreatedDateDesc です。

201

Feed-Items QueryChatter REST API リソース

レスポンスボディFeed Item Page

Feed-Items, Specific Feed Item特定のフィード項目のアクセス、削除、またはブックマークを行います。リソース

/chatter/feed-items/feedItemId


重要: バージョン 32.0 以降では、Feed Element を使用します。


HTTP メソッドGET、DELETE、PATCH、または HEAD

PATCH のリクエストボディXML ルートタグは <feedItem> です。


現在のユーザのブックマーク済みフィード項目のリストに現在の


フィード項目を追加するには、true を指定します。現在のユーザのブックマーク済みフィード項目のリストからこのフィード項目を削除するには、falseを指定します。



現在のユーザのブックマーク済みフィード項目のリストに現在の


フィード項目を追加するには、true を指定します。現在のユーザのブックマーク済みフィード項目のリストからこのフィード項目を削除するには、falseを指定します。

202

Feed-Items, Specific Feed ItemChatter REST API リソース

GET、PATCH、または HEAD のレスポンスボディFeed Item

例この PATCH 要求はフィード項目をブックマークします。/chatter/feed-items/0D5D0000000JvckKAC?isBookmarkedByCurrentUser=true

Feed Items Commentsフィード項目のコメントにアクセスするか、コメントを post 送信します。デフォルトでは、3 件のコメントが取得されます。コメントをさらに取得するには、pageSize パラメータの値を増やします。コメントの post 送信についての詳細は、「入力での POST、PATCH、または PUT の使用」を参照してください。コメントに添付するバイナリファイルをアップロードするには、マルチパート/フォームデータ要求に含めて送信する必要があります。コメントのテキストを送信するには、マルチパート/フォームデータ要求に JSON または XML リッチ入力ボディパートを含める方法があります。または、その情報を要求パラメータパートで渡すように選択することもできます。マルチパート/フォームデータメッセージを作成する方法についての詳細は、「バイナリファイルのアップロード」を参照してください。コメントには 10,000 文字まで使用できます。リソース

/chatter/feed-items/feedItemId/comments

適用開始バージョン23.0 ～ 31.0

重要: バージョン 32.0 以降では、Feed Elements Capability, Comments Items を使用します。




<comment>

プロパティ


説明型名前




203

Feed Items CommentsChatter REST API リソース


説明型名前







POST の要求パラメータ既存のファイルを添付するためのパラメータ


必須項目/省略可能説明型パラメータ名

27.0 ～ 31.0必須項目添付ファイルの種別。値ExistingContent を含める必要があります。

StringattachmentType

24.0 ～ 31.0必須項目post 送信する既存のファイルの ID。StringcontentDocumentId

23.0 ～ 31.0省略可能コメントのテキスト。Stringtext

テキストを post 送信するためのパラメータ



23.0 ～ 31.0必須項目コメントのテキスト。

Stringtext

204





23.0 ～ 31.0省略可能生成されたトークン。フィード内の

Stringpage

フィード項目のビューを示します。ページトークンは、レスポンスボディの一部として、nextPageURL など、いずれかの URL

パラメータで返されます。

23.0 ～ 31.0省略可能ページあたりの項目数を指定します。有

IntegerpageSize

効な値は 1 ～ 100 です。サイズを指定しない場合、デフォルトは 25 です。このパラメータは、ページあたりのコメント数を指定します。

GET または HEAD のレスポンスボディComment Page

POST のレスポンスボディComment

例: コメントの post 送信この POST 要求では、要求パラメータを使用してフィード項目へのコメントを post 送信します。/chatter/feed-items/0D5D0000000JvckKAC/comments?text=I+completely+agree

例: コメントの post 送信と既存のファイルの添付この POST 要求では、コメントを post 送信し、ユーザの組織にすでにアップロードされているファイルを添付します。/chatter/feed-items/0D5D0000000JvckKAC/comments?text=yes&attachmentType=ExistingContent&contentDocumentId=069D00000001FHF

例: コメントの post 送信とアップロード、新規ファイルの添付「バイナリファイルのアップロード」 (ページ 11)を参照してください。

205


Feed-Items Likes特定のフィード項目のいいね! へのアクセス、または特定の項目へのいいね! の追加に使用されます。リソース

/chatter/feed-items/feedItemId/likes


重要: バージョン 32.0 以降では、Feed Elements Capability, Chatter Likes Items を使用します。




メモ: POST には要求パラメータはありません。


返すページのページ番号を指定します。

Integerpage


IntegerpageSize


GET または HEAD のレスポンスボディLike Page


関連トピック:

フィード項目にいいね! と言う

Feed-Items Polls既存のアンケートにアクセスまたは投票するために使用されます。リソース

/chatter/feed-items/feedItemId/poll

feedItemId は PollPost 型である必要があります。

206

Feed-Items LikesChatter REST API リソース


重要: バージョン 32.0 以降では、Feed Elements Capability, Poll を使用します。


HTTP メソッドGET、PATCH、または HEAD

PATCH を使用して既存のアンケートに投票するか、現在のユーザの投票を変更します。PATCH のリクエストボディ

ルート XML タグ<feedPoll>

プロパティ


26.0 ～ 31.0フィードアンケートの既存の選択肢の ID。現在の

StringmyChoiceId

ユーザが投票するアンケート選択肢の ID を指定するために使用されます。




StringmyChoiceId


レスポンスボディFeed Item Attachment: Poll

207

Feed-Items PollsChatter REST API リソース

Feed-Items Topics特定のフィード項目に関連付けられたトピック。新規または既存のトピックを特定のフィード項目に関連付けます。トピックを特定のフィード項目から削除します。フィード項目で既存のトピックを追加または削除できるのは、「トピックの割り当て」権限を持つユーザのみです。フィード項目に新規のトピックを追加できるのは、「トピックの作成」権限を持つユーザのみです。リソース

/chatter/feed-items/feedItemId/topics


重要: バージョン 32.0 以降では、Feed Elements Capability, Topics を使用します。


HTTP メソッドDELETE、POST




28.0 ～ 31.0必須項目既存のトピックの IDStringtopicId


<feedItemTopic>

JSON


プロパティ







StringtopicName

208

Feed-Items TopicsChatter REST API リソース







28.0 ～ 31.0topicName パラメータが使用されて


いない場合、既存のトピックに必要です。

28.0 ～ 31.0新規のトピック、および topicId パラ

新規または既存のトピックの名前 (最大150 文字)

StringtopicName

メータが使用されていない場合の既存のトピックに必要です。



POST の例この例では、既存のトピックの ID を topidId パラメータで渡してフィード項目に関連付けます。/chatter/feed-items/0D5D0000000JmiB/topics?topicId=0TOD0000000090r

Feed リソース

フィードは、フィード項目で構成されます。さまざまなフィード種別があります。フィード種別ごとに、どのフィード項目を含むかを決めるアルゴリズムがあります。ニュースフィード、レコードフィード、およびユーザプロファイルフィードは GET および POST 要求をサポートしています。その他のすべてのフィードは GET 要求をサポートしています。

209

Feed リソースChatter REST API リソース


Bookmarks Feed リソースコンテキストユーザがブックマークとして保存したフィード要素を含むフィード。Communities Home Feed リソースコミュニティの管理トピックに関連付けられたすべてのフィード要素のリストを返します。Communities Moderation Feed リソースコミュニティでモデレーション用にフラグが設定されたフィード要素とコメントを含むフィード。Company Feed リソース会社全体からのすべてのフィード要素とコメントを含むフィード。Favorites Feed リソースコンテキストユーザが保存したお気に入りを含むフィード。Feeds リソースコンテキストユーザが表示可能なすべてのフィードのリスト。Files Feed リソースコンテキストユーザがフォローしている人またはグループによって投稿されたファイルを含むすべてのフィード要素を含むフィード。Filter Feed リソースフィルタフィードは、指定されたオブジェクト種別の親を持つフィード要素のみが表示されるように絞り込まれたニュースフィードです。Groups Feed リソース現在のユーザが所有するか、メンバーである全グループからのすべてのフィード要素を含むフィード。Mute Feed リソースコンテキストユーザがミュートしたフィード要素を含むフィード。News Feed リソースコンテキストユーザが関心を示しているフィード要素を含むフィード。ニュースフィードへのフィード項目の post 送信に使用できます。People Feed リソースコンテキストユーザがフォローしているすべての人によって投稿されたすべてのフィード要素。Record Feed リソース指定されたレコードのフィード。レコードは、グループ、人、オブジェクト、ファイルなどの場合があります。レコードフィードへのフィード項目の post 送信に使用できます。別のユーザのレコードフィードを取得できます。To Feed リソースコンテキストユーザのすべての @メンションと、コンテキストユーザのフィードに対して行われたすべての投稿を含むフィード。Topics Feed リソース特定のトピックのフィード。

210

Feed リソースChatter REST API リソース

User Profile Feed リソースフィードで追跡可能なレコードをユーザが変更したときに作成されたフィード要素、親がユーザであるフィード要素、およびユーザにメンションしているフィード要素が含まれます。このフィードは、グループ更新など、より多くのフィード項目を返すニュースフィードとは異なります。User-Profile Feed へのフィード項目の post 送信に使用できます。別のユーザのユーザプロファイルフィードを取得できます。

関連トピック:


Bookmarks Feed リソースコンテキストユーザがブックマークとして保存したフィード要素を含むフィード。項目をブックマークするには、PATCH を使用し、Feed Elements Capability, Bookmarks リソースとisBookmarkedByCurrentUser パラメータを指定します。次に例を示します。/chatter/feed-elements/0D5D0000000Ir6zKAC/capabilities/bookmarks?isBookmarkedByCurrentUser=true


説明リソース

コンテキストユーザのブックマークフィードの URL を返します。

/chatter/feeds/bookmarks/me

コンテキストユーザがブックマークしたすべてのフィード要素を返します。

/chatter/feeds/bookmarks/me/feed-elements

Bookmarks Feed URLコンテキストユーザのブックマークフィードの URL を返します。リソース

/chatter/feeds/bookmarks/userId

/connect/communities/communityId/chatter/feeds/bookmarks/userId

メモ: userId は、コンテキストユーザの ID または別名 me である必要があります。




211

Bookmarks Feed リソースChatter REST API リソース



作成日や最終更新日などで並び替えて返される順序を指定します。

Stringsort


• LastModifiedDateDesc — 活動の新しい順に並び替えられます。

デフォルト値は、CreatedDescDate です。

レスポンスボディFeed

Bookmarks Feed Elementsコンテキストユーザがブックマークしたすべてのフィード要素を返します。リソース

/chatter/feeds/bookmarks/userId/feed-elements

/connect/communities/communityId/chatter/feeds/bookmarks/userId/feed-elements









31.0省略可能

フィードの密度。次のいずれかの値にします。

Stringdensity

• AllUpdates — ユーザがフォローする人とレコード、およびユーザがメンバーと

212





なっているグループからのすべての更新が表示されます。

• FewerUpdates — ユーザがフォローする人とレコード、およびユーザがメンバーとなっているグループからのすべての更新が表示されますが、レコードからのシステム生成された更新は非表示になります。

デフォルト値は、AllUpdates です。

31.0省略可能

バンドルに含める最大フィード要素数。値は0 ～ 10 の整数である必要があります。デフォルト値は 3 です。



31.0省略可能

生成されたトークン。フィード内のフィード要素のビューを示します。ページトークンは、レスポンスボディの一部として、nextPageURLなど、いずれかの URL

Stringpage

パラメータで返されます。たとえば、次のようになります。"nextPageUrl":"/services/data/v35.0/chatter/feeds/news/005D0000001GLowIAN/feed-elements?page=2011-03-30T17:34:50Z,0D5D0000000DSv4KAG"

31.0省略可能

ページあたりの要素数を指定します。有効な値は 1 ～ 100 です。サイズを指定しない場合、デフォルトは 25 です。

IntegerpageSize

31.0省略可能

このフィード内のフィード要素の本文とコメントに含まれる 1 つ以上の検索キーワード。検索文字列にはワイルドカード文字を含めることができ、ワイルドカード文字を除く 2 文

Stringq

213





字以上が含まれている必要があります。「ワイルドカード」を参照してください。

31.0省略可能

フィード要素ごとに含めるコメントの最大数。デフォルト値は 3 です。最大値は、25 です。


31.0省略可能


Stringsort



デフォルト値は、CreatedDescDateです。

レスポンスボディFeed Element Page

Bookmarks Feed Itemsコンテキストユーザがブックマークしたすべてのフィード項目を返します。リソース

/chatter/feeds/bookmarks/me/feed-items

または/chatter/feeds/bookmarks/userId/feed-items



重要: バージョン 32.0 以降では、Bookmarks Feed Elements を使用します。



214






29.0 ～ 31.0省略可能


Stringdensity

• AllUpdates — ユーザがフォローする人とレコード、およびユーザがメンバーとなっているグループからのすべての更新が表示されます。



23.0 ～ 31.0省略可能

生成されたトークン。フィード内のフィード項目のビューを示します。ページトークンは、レスポンスボディの一部として、

Stringpage

nextPageURLなど、いずれかの URL パラメータで返されます。たとえば、次のようになります。"nextPageUrl":"/services/data/v35.0/chatter/feeds/news/005D0000001GLowIAN/feed-items?page=2011-03-30T17:34:50Z,0D5D0000000DSv4KAG"

23.0 ～ 31.0省略可能


IntegerpageSize

28.0 ～ 31.0省略可能

このフィード内のフィード項目の本文とコメントに含まれる 1 つ以上の検索キーワード。検索文字列にはワイルドカード文字を含めることができ、ワイルドカード文字を除く 2 文

Stringq


215





29.0 ～ 31.0省略可能

フィード項目ごとに含めるコメントの最大数。デフォルト値は 3 です。最大値は、25 です。


23.0 ～ 31.0省略可能


Stringsort





Bookmarks Feed Items Flatこのリソースは、バージョン 26.0 で廃止されました。フラットフィードを返します。つまり、フィード項目とコメントの間に階層がなく、フィード項目とコメントはすべて同じレベルに配置されます。すべての項目は、時系列に返されます。リソース

/chatter/feeds/bookmarks/me/feed-items/flat

または/chatter/feeds/bookmarks/userId/feed-items/flat





216




返されるフィード項目数を指定します。有効な値は 0 ～ 100 です。

IntegernumFeedItems

デフォルト値は 25 です。フィード項目にはコメントが含まれる場合があるため、25 個のフラットフィード項目を指定しても、実際に返される数がそれより多くなることがあります。たとえば、各フィード項目に 1 つのコメントがあり、recentCommentCount が1 よりも大きい場合、50 個のフラットフィード項目が返されます。

生成されたトークン。フィード内のフィード項目のビューを示しま

Stringpage

す。ページトークンは、レスポンスボディの一部として、nextPageURL など、いずれかのURL パラメータで返されます。

返される最近のコメントの数を指定します。有効な値は 0 ～ 25 です。デフォルト値は 3 です。


返されたフィードを、作成日の昇順、または最終更新日の昇順で並

String。次のいずれかになります。sort

• CreatedDateDescび替えます。デフォルトはLastModifiedDateDesc です。


レスポンスボディFlat Feed

関連トピック:


Communities Home Feed リソースコミュニティの管理トピックに関連付けられたすべてのフィード要素のリストを返します。リソース

/connect/communities/communityId/chatter/feeds/home/feed-elements

217

Communities Home Feed リソースChatter REST API リソース




GET パラメータ




32.0省略可能

フィードの検索条件値を示します。Stringfilter

• AllQuestions — 質問であるフィード要素のみ。

• CommunityScoped — コミュニティを範囲とするフィード要素のみ。現在、これらのフィード要素には、User または Group

親レコードがあります。ただし、今後、他の親レコードタイプがコミュニティを範囲とする可能性があります。すべてのコミュニティで常に表示されるフィード要素は除外されます。この値は、UserProfileフィードでのみ有効です。

• SolvedQuestions — 質問で最良の回答があるフィード要素のみ。

• UnansweredQuestions — 質問で回答がないフィード要素のみ。

• UnsolvedQuestions — 質問で最良の回答がないフィード要素のみ。

29.0省略可能

生成されたトークン。フィード内のフィード要素のビューを示します。ページトークンは、レスポンスボディの一部として、

Stringpage

nextPageURL など、いずれかの URL パラメータで返されます。たとえば、次のようになります。"nextPageUrl":"/services/data/v35.0/chatter/feeds/news/005D0000001GLowIAN/feed-elements?page=2011-03-30T17:34:50Z,0D5D0000000DSv4KAG"

218

Communities Home Feed リソースChatter REST API リソース




29.0省略可能


IntegerpageSize

29.0省略可能

このフィード内のフィード要素の本文とコメントに含まれる 1 つ以上の検索キーワード。検索文字列にはワイルドカード文字を含めることができ、ワイルドカード文字を除く

Stringq

2 文字以上が含まれている必要があります。「ワイルドカード」を参照してください。

29.0省略可能


Stringsort





Communities Moderation Feed リソースコミュニティでモデレーション用にフラグが設定されたフィード要素とコメントを含むフィード。次のリソースを使用できます。

説明リソース

コンテキストユーザが「コミュニティフィードのモデレート」権限を持つコミュニティモデレータの場合、

/connect/communities/communityId/chatter/feeds/moderation/feed-elements

コミュニティメンバーによってフラグが設定された、コミュニティ内のすべてのフィード要素とコメントのリストを返します。デフォルトでは、結果ページごとに 25 件のフィード要素を返します。

219

Communities Moderation Feed リソースChatter REST API リソース

Communities Moderation Feed Elementsコンテキストユーザが「コミュニティフィードのモデレート」権限を持つコミュニティモデレータの場合、コミュニティメンバーによってフラグが設定された、コミュニティ内のすべてのフィード要素とコメントのリストを返します。デフォルトでは、結果ページごとに 25 件のフィード要素を返します。リソース

/connect/communities/communityId/chatter/feeds/moderation/feed-elements




GET パラメータ




29.0省略可能


Stringpage

nextPageURL など、いずれかの URL パラメータで返されます。たとえば、次のようになります。"nextPageUrl":"/services/data/v35.0/chatter/feeds/news/005D0000001GLowIAN/feed-elements?page=2011-03-30T17:34:50Z,0D5D0000000DSv4KAG"

29.0省略可能


IntegerpageSize

29.0省略可能

このフィード内のフィード要素の本文とコメントに含まれる 1 つ以上の検索キーワード。検索文字列にはワイルドカード文字を含めることができ、ワイルドカード文字を除く

Stringq


220





29.0省略可能


Stringsort





フィード要素にコメントが含まれる場合、Comment Page レスポンスボディの totalプロパティにコメント数を示す値が含まれます。ただし、comments プロパティにはコメントのコレクションは含まれません。たとえば、次の応答の抜粋ではコメントが全部で 2 つあることが示されますが、コメントに関する情報は示されません。

"comments": {"comments": [],"currentPageUrl": "/services/data/v35.0/connect/communities/0DBD000000002etOAA

/chatter/feed-elements/0D5D0000000LYi9KAG/comments","nextPageUrl": null,"total": 2

},

Communities Moderation Feed Itemsコンテキストユーザが「コミュニティフィードのモデレート」権限を持つコミュニティモデレータの場合、コミュニティメンバーによってフラグが設定された、コミュニティ内のすべてのフィード要素とコメントのリストを返します。デフォルトでは、結果ページごとに 25 件のフィード項目を返します。リソース

/connect/communities/communityId/chatter/feeds/moderation/feed-items


重要: バージョン 32.0 以降では、Communities Moderation Feed Elements を使用します。



221


GET パラメータ




29.0 ～ 31.0省略可能


Stringpage

nextPageURL など、いずれかの URL パラメータで返されます。たとえば、次のようになります。"nextPageUrl":"/services/data/v35.0/chatter/feeds/news/005D0000001GLowIAN/feed-items?page=2011-03-30T17:34:50Z,0D5D0000000DSv4KAG"

29.0 ～ 31.0省略可能


IntegerpageSize

29.0 ～ 31.0省略可能

このフィード内のフィード項目の本文とコメントに含まれる 1 つ以上の検索キーワード。検索文字列にはワイルドカード文字を含めることができ、ワイルドカード文字を除く

Stringq


29.0 ～ 31.0省略可能


Stringsort




GET のレスポンスボディFeed Item Page

フィード項目にコメントが含まれる場合、Comment Page レスポンスボディの totalプロパティにコメント数を示す値が含まれます。ただし、comments プロパティにはコメントのコレクションは含まれません。

222


たとえば、次の応答の抜粋ではコメントが全部で 2 つあることが示されますが、コメントに関する情報は示されません。

"comments": {"comments": [],"currentPageUrl": "/services/data/v35.0/connect/communities/0DBD000000002etOAA

/chatter/feed-items/0D5D0000000LYi9KAG/comments","nextPageUrl": null,"total": 2

},

GET の例次の例では GET 要求を行います。GET /connect/communities/0DBD000000002etOAA/chatter/feeds/moderation/feed-items

応答は Feed Item Page レスポンスボディです。

関連トピック:


Company Feed リソース会社全体からのすべてのフィード要素とコメントを含むフィード。会社フィードには、以下からの投稿とコメントが含まれます。• 社内のユーザ。ユーザがフォローしている人とフォローしていない人の両方。• 公開グループ。ユーザがメンバーでないグループを含む。• ユーザがメンバーである非公開グループ。• システム管理者がフィード追跡を有効に設定したレコードおよび項目の更新。ユーザがフォローしていな

いものも含む。ただし、ユーザに表示されるのは、ユーザにアクセスが許可されているレコードの更新のみです。

次の点に注意してください。• これらのリソースはコミュニティでは使用できません。次のリソースを使用できます。

説明リソース

会社フィードへの URL を返します。/chatter/feeds/company

会社フィードのフィード要素を返します。/chatter/feeds/company/feed-elements

Company Feed URL会社フィードへの URL を返します。

223

Company Feed リソースChatter REST API リソース

リソース/chatter/feeds/company

/connect/communities/communityId/chatter/feeds/company







Stringsort





Company Feed Elements会社フィードのフィード要素を返します。リソース

/chatter/feeds/company/feed-elements

/connect/communities/communityId/chatter/feeds/company/feed-elements




224






31.0省略可能フィードの密度。次のいずれかの値にします。Stringdensity




31.0省略可能バンドルに含める最大フィード要素数。値は 0

～ 10 の整数である必要があります。デフォルト値は 3 です。


31.0省略可能生成されたトークン。フィード内のフィード要素のビューを示します。ページトークンは、レスポンスボディの一部として、nextPageURLなど、いずれかの URL パラ

Stringpage

メータで返されます。たとえば、次のようになります。"nextPageUrl":"/services/data/v35.0/chatter/feeds/news/005D0000001GLowIAN/feed-elements?page=2011-03-30T17:34:50Z,0D5D0000000DSv4KAG"

31.0省略可能ページあたりの要素数を指定します。有効な値は 1 ～ 100 です。サイズを指定しない場合、デフォルトは 25 です。

IntegerpageSize

31.0省略可能このフィード内のフィード要素の本文とコメントに含まれる 1 つ以上の検索キーワード。検索文字列にはワイルドカード文字を含めることができ、ワイルドカード文字を除く 2 文字以

Stringq

225





上が含まれている必要があります。「ワイルドカード」を参照してください。

31.0省略可能フィード要素ごとに含めるコメントの最大数。デフォルト値は 3 です。最大値は、25 です。



Stringsort



デフォルト値は、CreatedDescDate です。31.0省略可能フィードの変更タイムスタンプと並び替え順を

定義する不透明トークン。このトークンは作成しません。Feed Element Page

レスポンスボディの updatesTokenプロパティから、このトークンを取得します。

StringupdatedSince


Company Feed Items会社フィードのフィード項目を返します。リソース

/chatter/feeds/company/feed-items


重要: バージョン 32.0 以降では、Company Feed Elements を使用します。



226






29.0 ～ 31.0省略可能フィードの密度。次のいずれかの値にします。Stringdensity




23.0 ～ 31.0省略可能生成されたトークン。フィード内のフィード要素のビューを示します。ページトークンは、レスポンスボディの一部として、nextPageURLなど、いずれかの URL パラ

Stringpage


23.0 ～ 31.0省略可能ページあたりの項目数を指定します。有効な値は 1 ～ 100 です。サイズを指定しない場合、デフォルトは 25 です。

IntegerpageSize

28.0 ～ 31.0省略可能このフィード内のフィード要素の本文とコメントに含まれる 1 つ以上の検索キーワード。検索文字列にはワイルドカード文字を含めることができ、ワイルドカード文字を除く 2 文字以

Stringq


29.0 ～ 31.0省略可能フィード項目ごとに含めるコメントの最大数。デフォルト値は 3 です。最大値は、25 です。


227





23.0 ～ 31.0省略可能作成日や最終更新日などで並び替えて返される順序を指定します。

Stringsort




30.0 ～ 31.0省略可能フィードの変更タイムスタンプと並び替え順を定義する不透明トークン。このトークンは作成しません。Feed Element Page


StringupdatedSince


関連トピック:


Favorites Feed リソースコンテキストユーザが保存したお気に入りを含むフィード。お気に入りとは、コンテキストユーザが Chatter のお気に入りとして追加した検索、リストビュー、およびトピックです。次のリソースを使用できます。

説明リソース

コンテキストユーザのすべてのお気に入りを返します。Chatterフィード検索またはトピックのお気に入りを作成します。

/chatter/feeds/favorites/me

指定されたお気に入りのフィードを返します。指定されたお気に入りを削除します。指定されたお気に入りの最終参照日を更新します。

/chatter/feeds/favorites/me/favoriteId

絞り込み済みのフィードを返し、指定されたお気に入りの絞り込まれたフィード要素のみを表示します。

/chatter/feeds/favorites/me/favoriteId/feed-elements

228

Favorites Feed リソースChatter REST API リソース

List of Favoritesコンテキストユーザのすべてのお気に入りを返します。Chatterフィード検索またはトピックのお気に入りを作成します。

メモ: 応答には、Web UI を使用して保存されたフィード検索が含まれます。ただし、Chatter APIを使用してフィード検索を保存することはできません。

リソース/chatter/feeds/favorites/userId

/connect/communities/communityId/chatter/feeds/favorites/userId




HTTP メソッドGET、HEAD、または POST


<favorite>

POST の JSON

{"searchText" : "release","targetId" : "0TOD0000000099d"

}

POST のプロパティ


24.0フィード検索のテキスト。このパラメータは、

StringsearchText

フィード検索にのみ使用します。

28.0トピックの ID。このパラメータは、トピックにのみ使用します。

StringtargetId

229





StringsearchText



StringtargetId

GET のレスポンスボディFavorites Page

POST のレスポンスボディFavorite

Favorite指定されたお気に入りのフィードを返します。指定されたお気に入りを削除します。指定されたお気に入りの最終参照日を更新します。リソース

/chatter/feeds/favorites/userId/favoriteId

/connect/communities/communityId/chatter/feeds/favorites/userId/favoriteId




HTTP メソッドGET、HEAD、PATCH、または DELETE




Stringsort


230






<favorite>

PATCH の JSON

{"updateLastViewDate" : "true"

}

PATCH のプロパティ


24.0指定されたフィードのお気に入りの最終参照日を

BooleanupdateLastViewDate

現在のシステム時刻に設定します。デフォルト値は false です。



指定されたフィードのお気に入りの最終参照日を現在のシステム時


刻に設定します。デフォルト値はfalse です。

GET のレスポンスボディFavorite

PATCH のレスポンスボディFavorite

Favorites Feed Items絞り込み済みのフィードを返し、指定されたお気に入りの絞り込まれたフィード項目のみを表示します。

231


リソース/chatter/feeds/favorites/me/favoriteId/feed-items

または/chatter/feeds/favorites/userId/favoriteId/feed-items



重要: バージョン 32.0 以降では、Favorites Feed Elements を使用します。







29.0 ～ 31.0省略可能


Stringdensity




23.0 ～ 31.0省略可能


Stringpage

nextPageURLなど、いずれかの URL パラメー

232





タで返されます。たとえば、次のようになります。"nextPageUrl":"/services/data/v35.0/chatter/feeds/news/005D0000001GLowIAN/feed-items?page=2011-03-30T17:34:50Z,0D5D0000000DSv4KAG"

23.0 ～ 31.0省略可能


IntegerpageSize

28.0 ～ 31.0省略可能


Stringq


29.0 ～ 31.0省略可能



23.0 ～ 31.0省略可能


Stringsort





関連トピック:


233


Favorites Feed Elements絞り込み済みのフィードを返し、指定されたお気に入りの絞り込まれたフィード要素のみを表示します。リソース

/chatter/feeds/favorites/userId/favoriteId/feed-elements

/connect/communities/communityId/chatter/feeds/favorites/userId/favoriteId/feed-elements












31.0省略可能ページの表示に使用するページトークン。ページトークンは、

Stringpage

currentPageToken またはnextPageToken のように、応答クラスの一部として返されます。null を渡すと、最初のページが返されます。

31.0省略可能ページあたりのフィード要素数を指定します。有効な値は 1 ～ 100

IntegerpageSize

です。null を渡すと、デフォルトサイズの 25 に設定されます。

234






です。



Stringsort



null を渡すと、デフォルト値のCreatedDescDate が使用されます。


Feeds リソースコンテキストユーザが表示可能なすべてのフィードのリスト。ユーザによって表示されるフィードが異なる場合があります。このリソースは、使用可能なフィードを判定するために使用します。さらに、各フィードが一意の URL と表示ラベルを持つ場合があります。表示ラベルの値をハードコードすることは避け、このリソースで返された表示ラベルを使用するようにしてください。リソース

/chatter/feeds/

/connect/communities/communityId/chatter/feeds/




レスポンスボディFeed Directory

235

Feeds リソースChatter REST API リソース

Files Feed リソースコンテキストユーザがフォローしている人またはグループによって投稿されたファイルを含むすべてのフィード要素を含むフィード。次のリソースを使用できます。

説明リソース

コンテキストユーザがフォローしているユーザまたはグループによって投稿されたファイルを含むフィード要素への URL を返します。

/chatter/feeds/files/me

コンテキストユーザがフォローしている人またはグループによって投稿されたファイルを含むすべてのフィード要素を返します。

/chatter/feeds/files/me/feed-elements

Files Feed URLコンテキストユーザがフォローしているユーザまたはグループによって投稿されたファイルを含むフィード要素への URL を返します。リソース

/chatter/feeds/files/userId

/connect/communities/communityId/chatter/feeds/files/userId








Stringsort



236

Files Feed リソースChatter REST API リソース




Files Feed Elementsコンテキストユーザがフォローしている人またはグループによって投稿されたファイルを含むすべてのフィード要素を返します。リソース

/chatter/feeds/files/userId/feed-elements

/connect/communities/communityId/chatter/feeds/files/userId/feed-elements













237









Stringpage



IntegerpageSize


Stringq





Stringsort




238





31.0省略可能フィードの変更タイムスタンプと並び替え順を定義する不透明トークン。このトークンは作成しません。Feed Element Page


StringupdatedSince


Files Feed Itemsコンテキストユーザがフォローしている人またはグループによって投稿されたファイルを含むすべてのフィード項目を返します。リソース

/chatter/feeds/files/me/feed-items

または/chatter/feeds/files/userId/feed-items



重要: バージョン 32.0 以降では、Files Feed Elements を使用します。








• AllUpdates — ユーザがフォローする人とレコード、およびユーザがメンバーとなってい

239





るグループからのすべての更新が表示されます。




Stringpage



IntegerpageSize


Stringq





Stringsort


240









StringupdatedSince


Files Feed Items Flatこのリソースは、バージョン 26.0 で廃止されました。フラットフィードを返します。つまり、フィード項目とコメントの間に階層がなく、フィード項目とコメントはすべて同じレベルに配置されます。すべての項目は、時系列に返されます。リソース

/chatter/feeds/files/me/feed-items/flat

または/chatter/feeds/files/userId/feed-items/flat








IntegernumFeedItems

デフォルト値は 25 です。フィード

241



項目にはコメントが含まれる場合があるため、25 個のフラットフィード項目を指定しても、実際に返される数がそれより多くなることがあります。たとえば、各フィード項目に 1 つのコメントがあり、recentCommentCount が1 よりも大きい場合、50 個のフラットフィード項目が返されます。


Stringpage









関連トピック:


Filter Feed リソースフィルタフィードは、指定されたオブジェクト種別の親を持つフィード要素のみが表示されるように絞り込まれたニュースフィードです。次のリソースを使用できます。

説明リソース

コンテキストユーザが使用できるフィルタフィードに関する情報が含まれる、フィードディレクトリオブジェク

/chatter/feeds/filter/userId

トのコレクション。各オブジェクトには、フィルタフィー

242

Filter Feed リソースChatter REST API リソース

説明リソース

ドの URL、フィルタフィード内のフィード項目またはフィード要素の URL、およびフィードの絞り込みに使用されるオブジェクトを説明する表示ラベルが含まれます。

コンテキストユーザが使用できる特定のフィルタフィードに関する情報が含まれる、フィードオブジェクト。

/chatter/feeds/filter/userId/idPrefix

コンテキストユーザがメンバーであるすべてのグループからのフィード要素など、指定されたキープレフィック

/chatter/feeds/filter/userId/idPrefix/feed-elements

スが含まれる親を持つコンテキストユーザのニュースフィードからのフィード要素。

List of Filter Feed URLsコンテキストユーザが使用できるフィルタフィードに関する情報が含まれる、フィードディレクトリオブジェクトのコレクション。各オブジェクトには、フィルタフィードの URL、フィルタフィード内のフィード項目またはフィード要素の URL、およびフィードの絞り込みに使用されるオブジェクトを説明する表示ラベルが含まれます。各 URL には、キープレフィックスと呼ばれるフィルタオブジェクトの最初の 3 文字が含まれます。これによりオブジェクト種別が示されます。このリソースを使用して、コンテキストユーザが独自のニュースフィードに適用できるキープレフィックスフィルタフィードのリストを返します。「Filter Feed Items」および「Filter Feed Elements」を参照してください。

メモ: フィードディレクトリオブジェクトのコレクションには、User (005) および Group (0F9) オブジェクト種別が含まれることはありません。ただし、これらのオブジェクト種別を使用してフィードを絞り込むことはできます。

リソース/chatter/feeds/filter/userId

/connect/communities/communityId/chatter/feeds/filter/userId

userId は、コンテキストユーザの ID または別名 me である必要があります。適用開始バージョン

23.0



レスポンスボディFeed Directory

レスポンスボディが空である場合、ユーザはどのレコードもフォローしていないということです。

243


Specific Filter Feed URLコンテキストユーザが使用できる特定のフィルタフィードに関する情報が含まれる、フィードオブジェクト。リソース URL 内の keyPrefix はオブジェクト ID の最初の 3 文字であり、オブジェクト種別を示します。リソース

/chatter/feeds/filter/userId/keyPrefix

/connect/communities/communityId/chatter/feeds/filter/userId/keyPrefix

userId は、コンテキストユーザの ID または別名 me である必要があります。適用開始バージョン

23.0






Stringsort





レスポンスボディの例この要求では、User オブジェクト (キープレフィックス 005) で絞り込まれたフィルタフィード項目リソースの URL が返されます。GET /chatter/feeds/filter/me/005

Filter Feed Itemsコンテキストユーザがメンバーであるすべてのグループからのフィード項目など、指定されたキープレフィックスが含まれる親を持つコンテキストユーザのニュースフィードからのフィード項目。キープレフィックスはオブジェクト ID の最初の 3 文字であり、オブジェクト種別を示します。

244


User 親オブジェクトを持つフィード項目で絞り込むには、キープレフィックス 005 を使用します。Group 親オブジェクトを持つフィード項目で絞り込むには、キープレフィックス 0F9 を使用します。コンテキストユーザがフォローしている親オブジェクト (取引先など) を持つフィード項目で絞り込むには、List

of Filter Feed URLs リソースを使用して親オブジェクトを返します。たとえば、コンテキストユーザが 5 つのグループのメンバーであるとします。次のリソースは、それらの 5 つのグループに投稿されたすべてのフィード項目を返します。/chatter/feeds/filter/me/0F9/feed-items

特定のグループに投稿されるフィード項目をすべて返す Record Feed Items リソースへの要求と比べてみましょう。/chatter/feeds/record/0F9XXXXXXXXX/feed-items

フィルタフィードは、コンテキストユーザに表示されるフィード項目のみを返します。最初の例では、リソースはコンテキストユーザがメンバーであるグループのフィード項目を返しません。2 番目の例では、このグループが公開グループであれば、コンテキストユーザがメンバーではなくても、グループのすべてのフィード項目が返されます。リソース

/chatter/feeds/filter/me/keyPrefix/feed-items

または/chatter/feeds/filter/userId/keyPrefix/feed-items

userId は、コンテキストユーザの ID または別名 me である必要があります。使用可能なバージョン

23.0 ～ 31.0

重要: バージョン 32.0 以降では、Filter Feed Elements を使用します。









245








Stringpage



IntegerpageSize


Stringq





Stringsort



246








StringupdatedSince


例この要求では、User オブジェクトである親を持ち、コンテキストユーザに表示されるすべてのフィード項目が取得されます。GET https://instance_name/services/data/v35.0/chatter/feeds/filter/me/005/feed-items

Filter Feed Items Flatこのリソースは、バージョン 26.0 で廃止されました。フラットフィードを返します。つまり、フィード項目とコメントの間に階層がなく、フィード項目とコメントはすべて同じレベルに配置されます。すべての項目は、時系列に返されます。リソース

/chatter/feeds/filter/me/feed-items/flat

または/chatter/feeds/filter/userId/feed-items/flat





247





IntegernumFeedItems



Stringpage









Filter Feed Elementsコンテキストユーザがメンバーであるすべてのグループからのフィード要素など、指定されたキープレフィックスが含まれる親を持つコンテキストユーザのニュースフィードからのフィード要素。キープレフィックスはオブジェクト ID の最初の 3 文字であり、オブジェクト種別を示します。User 親オブジェクトを持つフィード要素で絞り込むには、キープレフィックス 005 を使用します。Group 親オブジェクトを持つフィード要素で絞り込むには、キープレフィックス 0F9 を使用します。コンテキストユーザがフォローしている親オブジェクト (取引先など) を持つフィード要素で絞り込むには、List

of Filter Feed URLs リソースを使用して親オブジェクトを返します。

248


たとえば、コンテキストユーザが 5 つのグループのメンバーであるとします。次のリソースは、それらの 5 つのグループのすべてのフィード要素を返します。/chatter/feeds/filter/me/0F9/feed-elements

フィルタフィードは、コンテキストユーザに表示されるフィード要素のみを返します。この例では、リソースはコンテキストユーザがメンバーとなっていないグループのフィード要素は返しません。リソース

/chatter/feeds/filter/userId/keyPrefix/feed-elements

/connect/communities/communityId/chatter/feeds/filter/userId/keyPrefix/feed-elements

userId は、コンテキストユーザの ID または別名 me である必要があります。使用可能なバージョン

31.0







31.0省略可能Stringdensity • AllUpdates — ユーザがフォローする人とレコード、およびユーザがメンバーとなっているグループからのすべての更新が表示されます。




メモ: バンドル投稿にはフィード追跡変更が含まれます。Salesforce1 ダウンロード可能アプリケーションで

249





は、バンドル投稿がレコードフィードのみにあります。

31.0省略可能ページの表示に使用するページトークン。ページトークンは、

Stringpage

currentPageToken またはnextPageToken のように、応答クラスの一部として返されます。null を渡すと、最初のページが返されます。

31.0省略可能ページあたりのフィード要素数を指定します。有効な値は 1 ～ 100

IntegerpageSize

です。null を渡すと、デフォルトサイズの 25 に設定されます。

31.0省略可能コンテキストユーザに表示されるフィード要素に含まれる 1 つ以上

Stringq

の検索キーワード。検索文字列にはワイルドカード文字を含めることができ、ワイルドカード文字を除く 2 文字以上が含まれている必要があります。「ワイルドカード」を参照してください。


です。



Stringsort



null を渡すと、デフォルト値のCreatedDescDate が使用されます。

31.0省略可能フィードの変更タイムスタンプと並び替え順を定義する不透明トークン。

StringupdatedSince

250



Groups Feed リソース現在のユーザが所有するか、メンバーである全グループからのすべてのフィード要素を含むフィード。次のリソースを使用できます。

説明リソース

現在のサインインユーザがメンバーである全グループのフィード要素への URL を返します。

/chatter/feeds/groups/me

現在のユーザが所有するか、メンバーである全グループの全フィード要素を返します。

/chatter/feeds/groups/me/feed-elements

Groups Feed URL現在のサインインユーザがメンバーである全グループのフィード要素への URL を返します。リソース

/chatter/feeds/groups/userId

/connect/communities/communityId/chatter/feeds/groups/userId



Groups Feed Elements現在のユーザが所有するか、メンバーである全グループの全フィード要素を返します。特定のグループのフィード要素を取得するには、Record Feed リソース(/chatter/feeds/record/recordId/feed-elements) を使用して、recordId にグループ ID を代入します。リソース

/chatter/feeds/groups/userId/feed-elements

/connect/communities/communityId/chatter/feeds/groups/userId/feed-elements



251

Groups Feed リソースChatter REST API リソース















Stringpage



IntegerpageSize

252






Stringq





Stringsort






StringupdatedSince


Groups Feed Items現在のユーザが所有するか、メンバーである全グループの全フィード項目を返します。特定のグループのフィード項目を取得するには、Record Feed リソース(/chatter/feeds/record/recordId/feed-items) を使用して、recordId にグループ ID を代入します。リソース

/chatter/feeds/groups/me/feed-items

または/chatter/feeds/groups/userId/feed-items


253



重要: バージョン 32.0 以降では、Groups Feed Elements を使用します。












Stringpage



IntegerpageSize

254






Stringq





Stringsort






StringupdatedSince


Groups Feed Items Flatこのリソースは、バージョン 26.0 で廃止されました。フラットフィードを返します。つまり、フィード項目とコメントの間に階層がなく、フィード項目とコメントはすべて同じレベルに配置されます。すべての項目は、時系列に返されます。リソース

/chatter/feeds/groups/me/feed-items/flat

または/chatter/feeds/groups/userId/feed-items/flat


255








IntegernumFeedItems



Stringpage








256



関連トピック:

Groups リソースRecord Feed リソースフィードおよびフィード要素の使用

Mute Feed リソースコンテキストユーザがミュートしたフィード要素を含むフィード。項目をミュートするには、PATCH を使用し、Feed Elements Capability, Mute リソースと isMutedByMe パラメータを指定します。以下に例を示します。/chatter/feed-elements/0D5D0000000Ir6zKAC/capabilities/mute?isMutedByMe=true


説明リソース

コンテキストユーザのミュートフィードの URL を返します。

/chatter/feeds/mute/me

コンテキストユーザがミュートしたすべてのフィード要素を返します。

/chatter/feeds/mute/me/feed-elements

Mute Feed URLコンテキストユーザのミュートフィードの URL を返します。リソース

/chatter/feeds/mute/userId

/connect/communities/communityId/chatter/feeds/mute/userId





257

Mute Feed リソースChatter REST API リソース




Stringsort

• CreatedDateDesc — 作成日の新しい順に並び替えられます。




Mute Feed Elementsコンテキストユーザがミュートしたすべてのフィード要素を返します。リソース

/chatter/feeds/mute/userId/feed-elements

/connect/communities/communityId/chatter/feeds/mute/userId/feed-elements





258






31.0省略可能


Stringdensity




31.0省略可能




31.0省略可能


Stringpage


259





31.0省略可能


IntegerpageSize

31.0省略可能


Stringq


31.0省略可能



31.0省略可能


Stringsort





News Feed リソースコンテキストユーザが関心を示しているフィード要素を含むフィード。ニュースフィードへのフィード項目のpost 送信に使用できます。

メモ: このフィードの構成は、Chatter Web UI に表示されているフィードと一致させるために、リリースによって異なる場合があります。


説明リソース

コンテキストユーザの全フィードのフィード要素へのURL を返します。

/chatter/feeds/news/me

260

News Feed リソースChatter REST API リソース

説明リソース

コンテキストユーザが所有するグループかメンバーであるグループすべてからの全フィード要素と、コンテ


キストユーザがフォローしている全ファイル、レコード、およびユーザからの全フィード要素。このリソースは、フィード要素に関する情報を取得し、フィード要素を投稿するために使用します。

News Feed URLコンテキストユーザの全フィードのフィード要素への URL を返します。リソース

/chatter/feeds/news/userId

/connect/communities/communityId/chatter/feeds/news/userId








Stringsort





261


レスポンスボディの例{

"feedElementPostUrl": "/services/data/v35.0/chatter/feed-elements","feedElementsUrl":

"/services/data/v35.0/chatter/feeds/news/005xx000001Sv1mAAB/feed-elements"}

News Feed Elementsコンテキストユーザが所有するグループかメンバーであるグループすべてからの全フィード要素と、コンテキストユーザがフォローしている全ファイル、レコード、およびユーザからの全フィード要素。このリソースは、フィード要素に関する情報を取得し、フィード要素を投稿するために使用します。フィード要素の投稿についての詳細は、「Feed Elements, Post and Search」を参照してください。バイナリファイルのアップロードとフィード要素への添付についての詳細は、「バイナリファイルのアップロード」を参照してください。リソース

/chatter/feeds/news/userId/feed-elements

/connect/communities/communityId/chatter/feeds/news/userId/feed-elements












262










32.0省略可能フィードの検索条件値を示します。Stringfilter


• CommunityScoped — コミュニティを範囲とするフィード要素のみ。現在、これらのフィード要素には、User または Group 親レコードがあります。ただし、今後、他の親レコードタイプがコミュニティを範囲とする可能性があります。すべてのコミュニティで常に表示されるフィード要素は除外されます。この値は、UserProfile フィードでのみ有効です。




31.0省略可能生成されたトークン。フィード内のフィード要素のビューを示します。ページトークンは、レスポンスボディの一部として、nextPageURLなど、いずれかの URL パラメータで返されます。"nextPageUrl":"/services/data/v35.0/

Stringpage

chatter/feeds/news/005D0000001GLowIAN/feed-elements

263





?page=2011-03-30T17:34:50Z,0D5D0000000DSv4KAG"


IntegerpageSize


Stringq





Stringsort






StringupdatedSince


News Feed Itemsコンテキストユーザが所有するグループかメンバーであるグループすべてからの全フィード要素と、コンテキストユーザがフォローしている全ファイル、レコード、およびユーザからの全フィード項目。このリソースは、フィード項目に関する情報の取得と、フィード項目の投稿 (ファイルを添付する、リンク、アンケート、質問を投稿する、投稿を共有するなど) に使用します。

264


フィード項目の post 送信についての詳細は、「入力での POST、PATCH、または PUT の使用」 (ページ 11)を参照してください。バイナリファイルのアップロードとフィード項目への添付についての詳細は、「バイナリファイルのアップロード」 (ページ 11)を参照してください。フィード項目とコメントの本文には、最大 10,000 文字まで含めることができます。リソース

/chatter/feeds/news/userId/feed-items



重要: バージョン 32.0 以降では、News Feed Elements を使用します。


HTTP メソッドGET、POST、HEAD





29.0 ～ 31.0省略可能


Stringdensity




23.0 ～ 31.0省略可能


Stringpage

265





nextPageURLなど、いずれかの URL パラメータで返されます。"nextPageUrl":"/services/data/v35.0/chatter/feeds/news/005D0000001GLowIAN/feed-items?page=2011-03-30T17:34:50Z,0D5D0000000DSv4KAG"

23.0 ～ 31.0省略可能


IntegerpageSize

28.0 ～ 31.0省略可能


Stringq


29.0 ～ 31.0省略可能



23.0 ～ 31.0省略可能


Stringsort




30.0 ～ 31.0省略可能

フィードの変更タイムスタンプと並び替え順を定義する不透明トークン。このトークンは作成しません。Feed Item Page

レスポンスボディの updatesToken プロパティから、このトークンを取得します。

StringupdatedSince

266



<feedItem>

JSON

次の例では、フィード項目にアンケートを添付します。{


{"type":"Text","text":"When should we meet for release planning?"

}]

},"capabilities":{

"poll":{"choices":[

"Monday","Tuesday"

]}

},"feedElementType":"FeedItem","subjectId":"me"

}

フィード項目は複数の機能をサポートします。次の例では、ファイルをフィード項目に添付し、ブックマークします。{


{"type":"Text","text":"Check out the latest marketing collateral."

}]

},"capabilities":{

"bookmarks":{"isBookmarkedByCurrentUser": true

},"content":{

"contentDocumentId": "069D00000001uQO"}


}

267


プロパティ



省略可能attachment パラメータには、次のいずれか 1 つの値のみを

種別によって異なる。

attachment

指定できます。値は次のとおりです。• Attachment Input: Canvas App

(v29.0 ～ 31.0)

• Attachment Input: Existing

Content (v23.0 ～ 31.0)

• Attachment Input: Feed Poll

(v26.0 ～ 31.0)

• Attachment Input: Link (v23.0

～ 31.0)

• Attachment Input: New File

Upload (v23.0 ～ 31.0)

重要: API バージョン32.0 以降では、capabilities プロパティを使用します。

23.0フィード項目にコンテンツ機能また

メッセージ本文の説明。本文には 25 文字まで使用できます。フィード項目を共有するための


はリンク機能がある場合を除き、必須

originalFeedElementId

を指定する場合、body プロパティを使用して最初のコメントをフィード項目に追加します。フィード項目のこのプロパティを編集するには、/chatter/feed-elements

/feedElementId に対してPATCH 要求を実行します。フィード投稿の編集は、バージョン 34.0 以降でサポートされています。

268




31.0省略可能このフィード要素の動作を定義する機能。

Feed ElementCapabilities Input

capabilities

24.0 ～31.0

省略可能新しいフィード項目をユーザのためにブックマークするか(true)、否か (false) を指定


します。デフォルト値は、false です。

重要: API バージョン32.0 以降では、capabilities.bookmarks.isBookmarkedByCurrentUser

プロパティを使用します。

31.0必須項目この入力が表すフィード要素の種別。有効な値は FeedItem のみです。


31.0省略可能フィード要素を共有するには、18 文字の ID を指定します。


メモ: 投稿の共有とファイルのアップロードを同じリクエストボディで行うことはできません。

24.0 ～31.0

省略可能フィード項目を共有するには、18 文字の ID を指定します。

StringoriginalFeedItemId

重要: API バージョン32.0 以降は、originalFeedElementId


31.0必須項目このフィード要素が投稿された親の ID。この値は、ユー

StringsubjectId

ザ、グループ、レコードの

269




ID、またはコンテキストユーザを示す文字列 meになります。

26.0省略可能投稿を表示できるユーザ。有効な値は、次のとおりです。

Stringvisibility

• InternalUsers — コミュニティが有効な場合は、デフォルトの内部コミュニティのメンバーに対してのみフィード項目を表示できます。

• AllUsers — コミュニティが有効な場合は、コミュニティのすべてのメンバーに対してフィード項目を表示できます。

デフォルト値は、次のとおりです。• 外部ユーザの場合、デ

フォルト値は AllUsers

です。外部ユーザが投稿を表示するには、この値を使用する必要があります。

• 内部ユーザの場合、デフォルト値はInternalUsers です。内部ユーザは、この値を受け入れるか、値AllUsers を使用して外部ユーザに投稿の表示を許可します。

フィード項目の親が User または Group の場合、フィード項目の visibility はAllUsersである必要があります。

270


POST の要求パラメータ次のいずれかのパラメータセットを使用します。たとえば、リンクの post 送信とファイルの添付を同じ要求で行うことはできません。既存のファイルを添付するためのパラメータ




27.0 ～31.0

必須項目添付ファイルの種別。値 ExistingContent

を含める必要があります。StringattachmentType

23.0 ～31.0

必須項目既存のファイルの 18 文字の ID。StringcontentDocumentId

26.0 ～31.0

省略可能新しいフィード項目をユーザのためにブックマークするか (true)、否か (false) を指定します。デフォルト値は、false です。


23.0 ～31.0

省略可能フィード項目のテキスト。Stringtext

26.0 ～31.0

省略可能投稿を表示できるユーザ。有効な値は、次のとおりです。

Stringvisibility



デフォルト値は、次のとおりです。• 外部ユーザの場合、デフォルト値は

AllUsersです。外部ユーザが投稿を表示するには、この値を使用する必要があります。

• 内部ユーザの場合、デフォルト値はInternalUsersです。内部ユーザは、この値を受け入れるか、値 AllUsersを使用して外部ユーザに投稿の表示を許可します。

フィード項目の親が User または Group の場合、フィード項目の visibilityは AllUsersである必要があります。

271


新規のファイルを添付するためのパラメータ




27.0 ～31.0

必須項目添付ファイルの種別。値 NewFileを含める必要があります。


23.0 ～26.0

省略可能post 送信するファイルの説明。Stringdesc

注意: このパラメータは、バージョン 27.0

以降では使用しないでください。代わりに description を使用します。

27.0 ～31.0

省略可能post 送信するファイルの説明。Stringdescription

23.0 ～24.0

必須項目post 送信するファイルのファイル名。StringfileName


以降では使用しないでください。代わりに title を使用します。

26.0 ～31.0



23.0 ～31.0


24.0 ～31.0

必須項目アップロードまたは post 送信するファイルのファイル名。

Stringtitle

26.0 ～31.0


Stringvisibility




AllUsersです。外部ユーザが投稿を表示

272





するには、この値を使用する必要があります。

• 内部ユーザの場合、デフォルト値はInternalUsers です。内部ユーザは、この値を受け入れるか、値 AllUsersを使用して外部ユーザに投稿の表示を許可します。


リンクを post 送信するためのパラメータ




27.0 ～31.0

必須項目添付ファイルの種別。値 Link を含める必要があります。


26.0 ～31.0

省略可能新しいフィード項目をユーザのためにブックマークするか (true)、否か (false)

を指定します。デフォルト値は、false

です。


23.0 ～31.0


23.0 ～31.0

必須項目リンクの URL。Stringurl

23.0 ～31.0

省略可能URL の名前。StringurlName

26.0 ～31.0


Stringvisibility


273








• 内部ユーザの場合、デフォルト値はInternalUsers です。内部ユーザは、この値を受け入れるか、値AllUsersを使用して外部ユーザに投稿の表示を許可します。

フィード項目の親が User または Group の場合、フィード項目の visibility はAllUsers である必要があります。

アンケートを post 送信するためのパラメータ




27.0 ～31.0

必須項目添付ファイルの種別。値 Poll を含める必要があります。


26.0 ～31.0



です。


26.0 ～31.0

必須項目この選択肢を使用して、アンケートを含むフィード項目を作成します。アンケートには 2 個から 10 個のアンケート選択肢を指定します。

StringpollChoice1 ～pollChoice10

23.0 ～31.0

必須項目フィード項目のテキスト。Stringtext

274





26.0 ～31.0


Stringvisibility







投稿を共有するためのパラメータ




26.0 ～31.0



275





24.0 ～31.0

必須項目共有するフィード項目の 18 文字の ID。StringoriginalFeedItemId

メモ: 投稿の共有は、ファイルのアップロードよりも優先されます。1 つの POST 内では、投稿の共有とファイルのアップロードの両方は行わないでください。

28.0 ～31.0

省略可能共有されるフィード項目に対するコメント。

Stringtext

26.0 ～31.0


Stringvisibility







テキストのみを post 送信するためのパラメータ

276





26.0 ～31.0



23.0 ～31.0

必須項目フィード項目のテキスト。最大文字数は1000 文字です。

Stringtext

26.0 ～31.0


Stringvisibility







キャンバスアプリケーションを post 送信するためのパラメータ

277





29.0 ～31.0

必須項目添付ファイルの種別。値 Canvas を含める必要があります。


29.0 ～31.0

省略可能キャンバスアプリケーションの説明Stringdescription

29.0 ～31.0

必須項目キャンバスアプリケーションの開発者名 (API

名)

StringdeveloperName

29.0 ～31.0

省略可能キャンバスアプリケーションの高さ (ピクセル単位)。デフォルトの高さは 200 ピクセルです。

Stringheight

29.0 ～31.0



29.0 ～31.0

省略可能キャンバスアプリケーションが作成されたDeveloper Edition 組織の名前空間プレフィックス。

StringnamespacePrefix

29.0 ～31.0

省略可能キャンバスアプリケーションに渡される JSON

形式のパラメータ。JSON は URL でエンコードされている必要があります。parameters={'isUpdated'='true';}"

Stringparameters

29.0 ～31.0

省略可能フィード項目のテキストStringtext

29.0 ～31.0

省略可能キャンバスアプリケーションのサムネイル画像の URL。最大サイズは 120x120 ピクセルです。

StringthumbnailUrl

29.0 ～31.0

省略可能キャンバスアプリケーションへのリンクのタイトル

Stringtitle

29.0 ～31.0


Stringvisibility



278











ファイルポストの例この例では、新しい添付ファイルがある投稿でニュースフィードを更新します。curl https://instance_name/services/data/v31.0/chatter/feeds/news/me/feed-items

--form "feedItemFileUpload=@Desktop/textFile.txt"--form "title=Sample"--form "description=Just a Text File"--form "text=Please review"--form "attachmentType=NewFile"--header 'Authorization: Bearer

00DD0000000Jhd2!AQIAQBgn42jbvCW2SX8JaRO2_JjX1fNKXWBrjYQPXODtDyaT6gT4DJVs4Ki7s6GoxvO8a.Z7gTHKkfqjW6S1.ujlD413PYpF'

これは、ファイルポストでニュースフィードを更新する Java の例です。import java.io.File;

import org.apache.commons.httpclient.*;import org.apache.commons.httpclient.methods.PostMethod;import org.apache.commons.httpclient.methods.multipart.*;

...

String oauthToken = "00Dx0000000X42V!AQgAQClp6UqGWNJUf4d3LQkVCysBIS6a";String url = "https://instance_name/services/data/v31.0/chatter/" +

279


"feeds/user-profile/me/feed-items";String text = "I love posting files to Chatter!";File contentFile = getFile();String description = "This is a test file that I'm posting.";String title = "contentFile";Part[] parts = {

new StringPart("description", description),new StringPart("title", fileName),new StringPart("text", text),new FilePart("feedItemFileUpload", contentFile),

};

final PostMethod postMethod = new PostMethod(url);

try {postMethod.setRequestEntity(new MultipartRequestEntity(parts,

postMethod.getParams()));postMethod.setRequestHeader("Authorization", "Bearer " + oauthToken);postMethod.setRequestHeader("Content-type", "multipart/form-data")postMethod.addRequestHeader("X-PrettyPrint", "1");

HttpClient httpClient = new HttpClient();httpClient.getParams().setSoTimeout(60000);

int returnCode = httpClient.executeMethod(postMethod);

System.out.println(postMethod.getResponseBodyAsString());

assertTrue("Expected return code of: " + HttpStatus.SC_CREATED,returnCode == HttpStatus.SC_CREATED);

} finally {postMethod.releaseConnection();

}

リンクポストの例この要求では、要求パラメータを使用してリンクポストを作成します。/chatter/feeds/news/me/feed-items?text=Did+you+see+this?&url=http://www.chatter.com

次のリクエストボディは、フィード項目投稿内にリンクを作成します。{ "body" : {


"type": "Link","url" : "http://www.chatter.com"

},{

"type": "Text","text" : "Is everyone following this?"

}]

}}

280


次のリクエストボディには、フィード項目投稿への添付ファイルとしてリンクが含まれます。{ "body" : {


"type": "Text","text" : "Is everyone following this?"

}]

},"attachment" :{

"url" : "http://www.chatter.com","urlName" : "The Future of Social Enterprise"

}}

News Feed Items Flatこのリソースは、バージョン 26.0 で廃止されました。フラットフィードを返します。つまり、フィード項目とコメントの間に階層がなく、フィード項目とコメントはすべて同じレベルに配置されます。すべての項目は、時系列に返されます。リソース

/chatter/feeds/news/me/feed-items/flat

または/chatter/feeds/news/userId/feed-items/flat



重要: API バージョン 32.0 以降は、/chatter/feeds/news/userId/feed-elementsを使用します。






IntegernumFeedItems

デフォルト値は 25 です。フィード項目にはコメントが含まれる場合があるため、25 個のフラットフィード項目を指定しても、実際

281



に返される数がそれより多くなることがあります。たとえば、各フィード項目に 1 つのコメントがあり、recentCommentCount が1 よりも大きい場合、50 個のフラットフィード項目が返されます。


Stringpage









関連トピック:


People Feed リソースコンテキストユーザがフォローしているすべての人によって投稿されたすべてのフィード要素。次のリソースを使用できます。

説明リソース

コンテキストユーザがフォローしているすべての人のフィード要素への URL を返します。

/chatter/feeds/people/me

コンテキストユーザがフォローしているすべての人からのすべてのフィード要素を返します。

/chatter/feeds/people/me/feed-elements

282

People Feed リソースChatter REST API リソース

People Feed URLコンテキストユーザがフォローしているすべての人のフィード要素への URL を返します。リソース

/chatter/feeds/people/userId

/connect/communities/communityId/chatter/feeds/people/userId








Stringsort





People Feed Elementsコンテキストユーザがフォローしているすべての人からのすべてのフィード要素を返します。リソース

/chatter/feeds/people/userId/feed-elements

/connect/communities/communityId/chatter/feeds/people/userId/feed-elements


283

















Stringpage


284






IntegerpageSize


Stringq





Stringsort






StringupdatedSince


People Feed Itemsコンテキストユーザがフォローしているすべての人からのすべてのフィード項目を返します。リソース

/chatter/feeds/people/me/feed-items

または/chatter/feeds/people/userId/feed-items

285




重要: バージョン 32.0 以降では、People Feed Elements を使用します。












Stringpage



IntegerpageSize

286






Stringq





Stringsort






StringupdatedSince


People Feed Items Flatこのリソースは、バージョン 26.0 で廃止されました。フラットフィードを返します。つまり、フィード項目とコメントの間に階層がなく、フィード項目とコメントはすべて同じレベルに配置されます。すべての項目は、時系列に返されます。リソース

/chatter/feeds/people/me/feed-items/flat

または/chatter/feeds/people/userId/feed-items/flat


287








IntegernumFeedItems



Stringpage









関連トピック:


288


Record Feed リソース指定されたレコードのフィード。レコードは、グループ、人、オブジェクト、ファイルなどの場合があります。レコードフィードへのフィード項目の post 送信に使用できます。別のユーザのレコードフィードを取得できます。次のリソースを使用できます。

説明リソース

現在のユーザがフォローしているすべてのレコードのフィード要素への URL、または指定された recordId

/chatter/feeds/record/recordId

のすべてのフィード要素への URL を返します。このリソースは、グループフィードを取得するために使用します。

コンテキストユーザがフォローしているすべてのレコードのフィード要素、または指定された recordId

/chatter/feeds/record/recordId/feed-elements

のすべてのフィード要素を返します。このリソースは、フィードの検索や特定のフィード (別のユーザのフィードも含める) のフィード要素の取得に使用します。このリソースを使用してグループのフィード要素を取得するには、グループ ID を recordId として指定します。

Record Feed URL現在のユーザがフォローしているすべてのレコードのフィード要素への URL、または指定された recordIdのすべてのフィード要素への URL を返します。このリソースは、グループフィードを取得するために使用します。リソース

/chatter/feeds/record/recordId

/connect/communities/communityId/chatter/feeds/record/recordId

メモ: recordId がユーザ ID の場合、現在のユーザまたは別名 me と同じである必要があります。




289

Record Feed リソースChatter REST API リソース




Stringsort





Record Feed Elementsコンテキストユーザがフォローしているすべてのレコードのフィード要素、または指定された recordId のすべてのフィード要素を返します。このリソースは、フィードの検索や特定のフィード (別のユーザのフィードも含める) のフィード要素の取得に使用します。このリソースを使用してグループのフィード要素を取得するには、グループ ID を recordId として指定します。リソース

/chatter/feeds/record/recordId/feed-elements

/connect/communities/communityId/chatter/feeds/record/recordId/feed-elements





290






31.0省略可能


Stringdensity




31.0省略可能




32.0省略可能






291







31.0省略可能


Stringpage


31.0省略可能


IntegerpageSize

31.0省略可能


Stringq


31.0省略可能



31.0省略可能

内部 (コミュニティ以外の) ユーザからのフィード要素のみを表示するか (true)、否か(false) を指定します。デフォルト値は、false です。

BooleanshowInternalOnly

292





31.0省略可能


Stringsort



デフォルト値は、CreatedDescDateです。31.0省略可

能フィードの変更タイムスタンプと並び替え順を定義する不透明トークン。このトークンは作成しません。Feed Element

Page レスポンスボディの updatesToken プロパティから、このトークンを取得します。

StringupdatedSince


Record Feed Itemsコンテキストユーザがフォローしているすべてのレコードのフィード項目、または指定された recordId のすべてのフィード項目を返します。このリソースは、新しいフィード項目の post 送信やフィードの検索に使用します。このリソースを使用して特定のグループのフィード項目を取得するには、グループ ID を recordId

として指定します。フィード項目の post 送信についての詳細は、「入力での POST、PATCH、または PUT の使用」を参照してください。バイナリファイルのアップロードとフィード項目への添付についての詳細は、「バイナリファイルのアップロード」を参照してください。

メモ: レコードタイプが ContentDocumentの場合は、レコードフィードへのフィード項目の post 送信はできません。

フィード項目とコメントの本文には、最大 10,000 文字まで含めることができます。リソース

/chatter/feeds/record/me/feed-items

または/chatter/feeds/record/recordId/feed-items


293



重要: バージョン 32.0 以降では、Record Feed Elements を使用します。







29.0 ～ 31.0省略可能


Stringdensity




23.0 ～ 31.0省略可能


Stringpage


294





23.0 ～ 31.0省略可能


IntegerpageSize

28.0 ～ 31.0省略可能


Stringq


29.0 ～ 31.0省略可能



30.0 ～ 31.0省略可能

内部 (コミュニティ以外の) ユーザからのフィード項目のみを表示するか (true)、否か(false) を指定します。デフォルト値は、false です。

BooleanshowInternalOnly

23.0 ～ 31.0省略可能


Stringsort




30.0 ～ 31.0省略可能

フィードの変更タイムスタンプと並び替え順を定義する不透明トークン。このトークンは作成しません。Feed Item Page

レスポンスボディの updatesToken プロパティから、このトークンを取得します。

StringupdatedSince


<feedItem>

295


JSON




}]

},"capabilities":{

"poll":{"choices":[

"Monday","Tuesday"

]}


}




}]

},"capabilities":{


},"content":{



}

296


プロパティ





attachment


(v29.0 ～ 31.0)


Content (v23.0 ～ 31.0)


(v26.0 ～ 31.0)


～ 31.0)


Upload (v23.0 ～ 31.0)









297






capabilities

24.0 ～31.0











24.0 ～31.0






StringsubjectId

ザ、グループ、レコードの

298




ID、またはコンテキストユーザを示す文字列 meになります。


Stringvisibility








299






27.0 ～31.0



23.0 ～31.0


26.0 ～31.0



23.0 ～31.0


26.0 ～31.0


Stringvisibility







300






27.0 ～31.0



23.0 ～26.0




27.0 ～31.0


23.0 ～24.0




26.0 ～31.0



23.0 ～31.0


24.0 ～31.0


Stringtitle

26.0 ～31.0


Stringvisibility




AllUsersです。外部ユーザが投稿を表示

301





するには、この値を使用する必要があります。

• 内部ユーザの場合、デフォルト値はInternalUsers です。内部ユーザは、この値を受け入れるか、値 AllUsersを使用して外部ユーザに投稿の表示を許可します。






27.0 ～31.0



26.0 ～31.0



です。


23.0 ～31.0


23.0 ～31.0


23.0 ～31.0


26.0 ～31.0


Stringvisibility


302














27.0 ～31.0



26.0 ～31.0



です。


26.0 ～31.0



23.0 ～31.0


303





26.0 ～31.0


Stringvisibility











26.0 ～31.0



304





24.0 ～31.0



28.0 ～31.0


Stringtext

26.0 ～31.0


Stringvisibility








305





26.0 ～31.0



23.0 ～31.0


Stringtext

26.0 ～31.0


Stringvisibility








306





29.0 ～31.0



29.0 ～31.0


29.0 ～31.0


名)

StringdeveloperName

29.0 ～31.0


Stringheight

29.0 ～31.0



29.0 ～31.0



29.0 ～31.0



Stringparameters

29.0 ～31.0


29.0 ～31.0


StringthumbnailUrl

29.0 ～31.0


Stringtitle

29.0 ～31.0


Stringvisibility



307











GET の例次の要求は、文字列 track を含むフィード項目を検索します。/chatter/feeds/record/me/feed-items?q=track

Feed Item Page レスポンスボディの feed-items/items/body/text プロパティで、文字列 track が検索されます。

Record Feed Items Flatこのリソースは、バージョン 26.0 で廃止されました。フラットフィードを返します。つまり、フィード項目とコメントの間に階層がなく、フィード項目とコメントはすべて同じレベルに配置されます。すべての項目は、時系列に返されます。リソース

/chatter/feeds/record/me/feed-items/flat

または/chatter/feeds/record/userId/feed-items/flat


308








IntegernumFeedItems



Stringpage








309



関連トピック:

Records リソースフィードおよびフィード要素の使用レコードフィードを取得する他のユーザのフィードを取得する

To Feed リソースコンテキストユーザのすべての @メンションと、コンテキストユーザのフィードに対して行われたすべての投稿を含むフィード。次のリソースを使用できます。

説明リソース

コンテキストユーザのフィードのフィード要素へのURL を返します。

/chatter/feeds/to/me

コンテキストユーザのすべての @メンションのフィード要素と、ユーザのフィードに対して行われたすべての投稿のフィード要素を返します。

/chatter/feeds/to/me/feed-elements

To Feed URLコンテキストユーザのフィードのフィード要素への URL を返します。リソース

/chatter/feeds/to/userId

/connect/communities/communityId/chatter/feeds/to/userId





310

To Feed リソースChatter REST API リソース




Stringsort





To Feed Elementsコンテキストユーザのすべての @メンションのフィード要素と、ユーザのフィードに対して行われたすべての投稿のフィード要素を返します。To Feed には、ユーザにメンションしている投稿と、他のユーザがユーザのウォールに対して行った投稿が含まれます。ユーザ自身の投稿は、コメントがある場合にのみ含まれます。この場合、自分からのコメントと別のユーザからのコメントの両方が対象となります。リソース

/chatter/feeds/to/userId/feed-elements

/connect/communities/communityId/chatter/feeds/to/userId/feed-elements





311






31.0省略可能


Stringdensity




31.0省略可能




31.0省略可能


Stringpage

nextPageURLなど、いずれかの URL パラメータで返されます。たとえば、次のようになります。"nextPageUrl":"/services/data/v35.0/chatter/feeds/news/005D0000001GLowIAN/feed-elements?page=2011-03-30T17:34:50Z,0D5D0000000DSv4KAG"

31.0省略可能

ページあたりのフィード要素数。有効な値は1 ～ 100 です。デフォルトサイズは 25 です。

IntegerpageSize

312





31.0省略可能


Stringq


31.0省略可能



31.0省略可能


Stringsort





To Feed Itemsコンテキストユーザのすべての @メンションのフィード項目と、ユーザのフィードに対して行われたすべての投稿のフィード項目を返します。To Feed には、ユーザにメンションしている投稿と、他のユーザがユーザのウォールに対して行った投稿が含まれます。ユーザ自身の投稿は、コメントがある場合にのみ含まれます。この場合、自分からのコメントと別のユーザからのコメントの両方が対象となります。リソース

/chatter/feeds/to/me/feed-items

または/chatter/feeds/to/userId/feed-items



重要: バージョン 32.0 以降では、To Feed Elements を使用します。

313








29.0 ～ 31.0省略可能


Stringdensity




23.0 ～ 31.0省略可能


Stringpage


23.0 ～ 31.0省略可能


IntegerpageSize

314





28.0 ～ 31.0省略可能


Stringq


29.0 ～ 31.0省略可能



23.0 ～ 31.0省略可能


Stringsort





To Feed Items Flatこのリソースは、バージョン 26.0 で廃止されました。フラットフィードを返します。つまり、フィード項目とコメントの間に階層がなく、フィード項目とコメントはすべて同じレベルに配置されます。すべての項目は、時系列に返されます。リソース

/chatter/feeds/to/me/feed-items/flat

または/chatter/feeds/to/userId/feed-items/flat




315






IntegernumFeedItems



Stringpage









関連トピック:


Topics Feed リソース特定のトピックのフィード。次のリソースを使用できます。

316

Topics Feed リソースChatter REST API リソース

説明リソース

特定のトピックのフィード項目への URL を返します。/chatter/feeds/topics/topicId

コンテキストユーザのすべての @メンションのフィード要素と、ユーザのフィードに対して行われたすべての投稿のフィード要素を返します。

/chatter/feeds/topics/topicId/feed-elements

Topics Feed URL特定のトピックのフィード項目への URL を返します。リソース

/chatter/feeds/topics/topicId

/connect/communities/communityId/chatter/feeds/topics/topicId







Stringsort





Topics Feed Elements指定されたトピックのフィード要素をすべて返します。

317


リソース/chatter/feeds/topics/topicId/feed-elements

/connect/communities/communityId/chatter/feeds/topics/topicId/feed-elements








32.0省略可能








31.0省略可能


Stringpage

nextPageURLなど、いずれかの URL パラメータで返されます。

318





31.0省略可能

ページあたりのフィード要素数を指定します。有効な値は 1 ～ 100 です。デフォルト値は 25 です。

IntegerpageSize

31.0省略可能


Stringsort





Topics Feed Items指定されたトピックのフィード項目をすべて返します。トピックを投稿するには、Feed-Items Topicsリソースを使用します。リソース

/chatter/feeds/topics/topicId/feed-items


重要: バージョン 32.0 以降では、Topics Feed Elements を使用します。







28.0 ～ 31.0省略可能


Stringpage

319





nextPageURLなど、いずれかの URL パラメータで返されます。

28.0 ～ 31.0省略可能


IntegerpageSize

28.0 ～ 31.0省略可能


Stringsort





関連トピック:


User Profile Feed リソースフィードで追跡可能なレコードをユーザが変更したときに作成されたフィード要素、親がユーザであるフィード要素、およびユーザにメンションしているフィード要素が含まれます。このフィードは、グループ更新など、より多くのフィード項目を返すニュースフィードとは異なります。User-Profile Feed へのフィード項目の post

送信に使用できます。別のユーザのユーザプロファイルフィードを取得できます。

メモ: このフィードの構成は、Chatter Web UI に表示されているフィードと一致させるために、リリースによって異なる場合があります。


説明リソース

ユーザプロファイルフィードのフィード要素への URL

を返します。/chatter/feeds/user-profile/me

フィードで追跡可能なレコードをユーザが変更したときに作成されたフィード要素、親がユーザである

/chatter/feeds/user-profile/me/feed-elements

フィード要素、およびユーザにメンションしているフィード要素を返します。このフィードは、グループ

320

User Profile Feed リソースChatter REST API リソース

説明リソース

更新など、より多くのフィード項目を返すニュースフィードとは異なります。User-Profile Feed へのフィード項目の post 送信に使用できます。別のユーザのユーザプロファイルフィードを取得できます。

User Profile Feed URLユーザプロファイルフィードのフィード要素への URL を返します。リソース

/chatter/feeds/user-profile/userId

/connect/communities/communityId/chatter/feeds/user-profile/userId


User Profile Feed Elementsフィードで追跡可能なレコードをユーザが変更したときに作成されたフィード要素、親がユーザであるフィード要素、およびユーザにメンションしているフィード要素を返します。このフィードは、グループ更新など、より多くのフィード項目を返すニュースフィードとは異なります。User-Profile Feed へのフィード項目の post 送信に使用できます。別のユーザのユーザプロファイルフィードを取得できます。リソース

/chatter/feeds/user-profile/userId/feed-elements

/connect/communities/communityId/chatter/feeds/user-profile/userId/feed-elements




321






31.0省略可能


Stringdensity




31.0省略可能




34.0省略可能

値は、CommunityScopedのみです。コミュニティを範囲とするフィード要素のみが含まれるようにフィードを絞り込みます。すべて

Stringfilter

のコミュニティで常に表示されるフィード要素は除外されます。現在、コミュニティを範囲とするフィード要素には、User または Group

親レコードがあります。ただし、今後、他の親レコードタイプがコミュニティを範囲とする可能性があります。

31.0省略可能


Stringpage

322





nextPageURLなど、いずれかの URL パラメータで返されます。"nextPageUrl":"/services/data/v35.0/chatter/feeds/news/005D0000001GLowIAN/feed-elements?page=2011-03-30T17:34:50Z,0D5D0000000DSv4KAG"

31.0省略可能

ページあたりのフィード要素数を指定します。有効な値は 1 ～ 100 です。デフォルト値は 25 です。

IntegerpageSize

31.0省略可能


Stringq


31.0省略可能



31.0省略可能


Stringsort





User Profile Feed Itemsフィードで追跡可能なすべてのレコードに対するすべてのアクションのフィード項目を返します。このリソースは、新しいフィード項目の post 送信にも使用できます。

323


フィード項目の post 送信についての詳細は、「入力での POST、PATCH、または PUT の使用」を参照してください。最大 2 GB (ヘッダーを含める) のバイナリファイルをアップロードするには、マルチパート/フォームデータ要求のボディパートとして送信する必要があります。投稿またはコメントのテキストのような情報を、同じマルチパート/フォームデータ要求の JSON または XML リッチ入力ボディパートとして送信できます。または、その情報を要求パラメータで送信するように選択することもできます。リッチ入力リクエストボディと要求パラメータの両方を渡すと、要求パラメータは無視されます。マルチパート/フォームデータメッセージを作成する方法についての詳細は、「バイナリファイルのアップロード」を参照してください。フィード項目とコメントの本文には、最大 10,000 文字まで含めることができます。API バージョン 23.0 および24.0 では、User Profile Feed Items リソースへの投稿でユーザ状況更新が作成されますが、フィード項目は作成されません。このため、これらの API バージョンでは、User Profile Feed Items リソースの文字制限は引き続き 1000

文字になります。リソース

/chatter/feeds/user-profile/me/feed-items

または/chatter/feeds/user-profile/userId/feed-items


重要: バージョン 32.0 以降では、User Profile Feed Elements を使用します。




<feedItem>

JSON




}]

},"capabilities":{

"poll":{"choices":[

"Monday","Tuesday"

324


]}


}




}]

},"capabilities":{


},"content":{



}

プロパティ





attachment


(v29.0 ～ 31.0)


Content (v23.0 ～ 31.0)


(v26.0 ～ 31.0)


～ 31.0)

325





Upload (v23.0 ～ 31.0)











capabilities

24.0 ～31.0






326









24.0 ～31.0






StringsubjectId

ザ、グループ、レコードのID、またはコンテキストユーザを示す文字列 meになります。


Stringvisibility


• AllUsers — コミュニティが有効な場合は、コ

327




ミュニティのすべてのメンバーに対してフィード項目を表示できます。










27.0 ～31.0



23.0 ～31.0


328





26.0 ～31.0



23.0 ～31.0


26.0 ～31.0


Stringvisibility











27.0 ～31.0



329





23.0 ～26.0




27.0 ～31.0


23.0 ～24.0




26.0 ～31.0



23.0 ～31.0


24.0 ～31.0


Stringtitle

26.0 ～31.0


Stringvisibility





• 内部ユーザの場合、デフォルト値はInternalUsers です。内部ユーザは、この値を受け入れるか、値 AllUsersを使用

330





して外部ユーザに投稿の表示を許可します。






27.0 ～31.0



26.0 ～31.0



です。


23.0 ～31.0


23.0 ～31.0


23.0 ～31.0


26.0 ～31.0


Stringvisibility



デフォルト値は、次のとおりです。

331





• 外部ユーザの場合、デフォルト値はAllUsersです。外部ユーザが投稿を表示するには、この値を使用する必要があります。







27.0 ～31.0



26.0 ～31.0



です。


26.0 ～31.0



23.0 ～31.0


26.0 ～31.0


Stringvisibility

• InternalUsers — コミュニティが有効な場合は、デフォルトの内部コミュ

332





ニティのメンバーに対してのみフィード項目を表示できます。










26.0 ～31.0



24.0 ～31.0



333





28.0 ～31.0


Stringtext

26.0 ～31.0


Stringvisibility











26.0 ～31.0



334





23.0 ～31.0


Stringtext

26.0 ～31.0


Stringvisibility











29.0 ～31.0



29.0 ～31.0


335





29.0 ～31.0


名)

StringdeveloperName

29.0 ～31.0


Stringheight

29.0 ～31.0



29.0 ～31.0



29.0 ～31.0



Stringparameters

29.0 ～31.0


29.0 ～31.0


StringthumbnailUrl

29.0 ～31.0


Stringtitle

29.0 ～31.0


Stringvisibility





336











29.0 ～ 31.0省略可能


Stringdensity




23.0 ～ 31.0省略可能


Stringpage

nextPageURLなど、いずれかの URL パラメータで返されます。たとえば、次のようになります。"nextPageUrl":"/services/data/v35.0/chatter/feeds/news/005D0000001GLowIAN

337





/feed-items?page=2011-03-30T17:34:50Z,0D5D0000000DSv4KAG"

23.0 ～ 31.0省略可能


IntegerpageSize

28.0 ～ 31.0省略可能


Stringq


29.0 ～ 31.0省略可能



23.0 ～ 31.0省略可能


Stringsort






User-Profile Feed Items Flatこのリソースは、バージョン 26.0 で廃止されました。フラットフィードを返します。つまり、フィード項目とコメントの間に階層がなく、フィード項目とコメントはすべて同じレベルに配置されます。すべての項目は、時系列に返されます。リソース

/chatter/feeds/user-profile/me/feed-items/flat

338


または/chatter/feeds/user-profile/userId/feed-items/flat







IntegernumFeedItems



Stringpage








339



関連トピック:

フィードおよびフィード要素の使用他のユーザのフィードを取得する

Files Connect Repository リソース

Files Connect リポジトリは、Salesforceに接続している外部コンテンツリポジトリです。これらのリソースを使用して、リポジトリのリストの取得、リポジトリまたはリポジトリファイルに関する情報の取得、リポジトリファイルのコンテンツの取得を行います。また、リポジトリフォルダ内のファイルとフォルダに関する情報の取得にもこれらのリソースを使用します。これらのリソースを使用して、リポジトリのディレクトリエントリ、権限、権限タイプを取得します。また、リポジトリの権限の更新にもこれらのリソースを使用します。使用可能なリソース:

説明リソース

Files Connect リポジトリのリストを取得します。/connect/content-hub/repositories

Files Connect リポジトリに関する情報を取得します。/connect/content-hub/repositories/repositoryId

リポジトリのユーザおよびグループディレクトリエントリを取得します。

/connect/content-hub/repositories/repositoryId/directory-entries

Files Connect リポジトリファイルに関する情報の取得や、このファイルの更新を行います。

/connect/content-hub/repositories/repositoryId/files/repositoryFileId

外部システムからリポジトリファイルのコンテンツを取得します。コンテンツは、レスポンスボディとしてストリーミングされます。

/connect/content-hub/repositories/repositoryId/files/repositoryFileId/content

リポジトリフォルダ内で作成が許可されている項目種別を返します。

/connect/content-hub/repositories/repositoryId/folders/repositoryFolderId/allowed-item-types

リポジトリフォルダ内のファイルとフォルダに関する情報を取得します。リポジトリフォルダにファイルを作成します。

/connect/content-hub/repositories/repositoryId/folders/repositoryFolderId/items

リポジトリに関連付けられた項目種別に関する情報を返します。

/connect/content-hub/repositories/repositoryId/item-types

リポジトリファイルの権限を取得または更新します。/connect/content-hub/repositories/repositoryId/items/repositoryItemId/permissions

リポジトリファイルの権限タイプを取得します。/connect/content-hub/repositories/repositoryId/items/repositoryItemId/permissions/types

340

Files Connect Repository リソースChatter REST API リソース

リポジトリファイルへの参照を処理するには、次のファイルリソースを使用します。

説明リソース

既存の参照のバージョンの情報取得や更新を行います。


参照の内容を取得します。コンテンツは、レスポンスボディとしてストリーミングされます。

/chatter/files/fileId/content

参照を作成します。/chatter/users/me/files

Files Connect Repository ListFiles Connect リポジトリのリストを取得します。リソース

/connect/content-hub/repositories

/connect/communities/communityId/content-hub/repositories


コミュニティリソースは、バージョン 35.0 以降で使用できます。Chatter が必要かどうか

いいえHTTP メソッド

GET





32.0省略可能参照をサポートするリポジトリのみを取得します。

BooleancanBrowseOnly

32.0省略可能検索をサポートするリポジトリのみを取得します。

BooleancanSearchOnly


Integerpage

ページトークンは、currentPageToken またはnextPageToken のように、応答クラスの一部として返されます。null を渡すと、最初のページが返されます。

341

Files Connect Repository ListChatter REST API リソース




32.0省略可能ページあたりの項目数を指定します。有効な値は 1 ～ 100 です。

IntegerpageSize

null を渡すと、デフォルトの 25

に設定されます。

GET のレスポンスボディFiles Connect Repository Collection

Files Connect リポジトリFiles Connect リポジトリに関する情報を取得します。リソース

/connect/content-hub/repositories/repositoryId

/connect/communities/communityId/content-hub/repositories/repositoryId




GET、HEAD

レスポンスボディFiles Connect Repository

Files Connect Repository Directory Entriesリポジトリのユーザおよびグループディレクトリエントリを取得します。リソース

/connect/content-hub/repositories/repositoryId/directory-entries

/connect/communities/communityId/content-hub/repositories/repositoryId/directory-entries




342

Files Connect リポジトリChatter REST API リソース

GET のレスポンスボディRepository Directory Entry Collection

Files Connect Repository FileFiles Connect リポジトリファイルに関する情報の取得や、このファイルの更新を行います。リソース

/connect/content-hub/repositories/repositoryId/files/repositoryFileId

/connect/communities/communityId/content-hub/repositories/repositoryId/files/repositoryFileId




GET、HEAD、PATCH

PATCH はバージョン 35.0 以降でサポートされます。PATCH のリクエストボディ

ルート XML タグ<contentHubInputItem>

JSON の例{

“itemTypeId” : “GoogleDocument”,“fields” : [{

“name” : “title”,“value” : “Content Hub Simple Create Specs”

},{

“name” : “description”,“value” : “Document explaining the various connect api endpoints required for

simple create”}]

}

プロパティ



説明型名前

35.0ファイル名は必須であるためリ

作成する項目のリスト。Files Connect FieldValue Input[]

fields

ポジトリに

343

Files Connect Repository FileChatter REST API リソース



説明型名前

SharePoint ファイルを作成する場合は必須、それ以外の場合は省略可能

35.0リポジトリにファイルを作成する場合は必須

項目種別の ID。StringitemTypeId

GET および PATCH のレスポンスボディRepository File Detail

Files Connect Repository File Content外部システムからリポジトリファイルのコンテンツを取得します。コンテンツは、レスポンスボディとしてストリーミングされます。リソース

/connect/content-hub/repositories/repositoryId/files/repositoryFileId/content

/connect/communities/communityId/content-hub/repositories/repositoryId/files/repositoryFileId/content




GET、HEAD

レスポンスボディファイルのコンテンツのバイナリストリーム。

Files Connect Repository Folder Allowed Item Typesリポジトリフォルダ内で作成が許可されている項目種別を返します。特定の項目種別に関する情報を取得するには、/connect/content-hub/repositories/repositoryId/item-types/repositoryItemTypeIdに対して GET 要求を実行します。

344

Files Connect Repository File ContentChatter REST API リソース

リソース/connect/content-hub/repositories/repositoryId/folders/repositoryFolderId/allowed-item-types

/connect/communities/communityId/content-hub/repositories/repositoryId/folders/repositoryFolderId/allowed-item-types








35.0省略可能項目種別を示します。Stringfilter

• Any — ファイルとフォルダを含めます

• FilesOnly — ファイルのみを含めます

• FoldersOnly — フォルダのみを含めます

バージョン 35.0 では、FilesOnly

を指定します。

GET のレスポンスボディFiles Connect Allowed Item Type Collection

Files Connect Repository Folder Itemsリポジトリフォルダ内のファイルとフォルダに関する情報を取得します。リポジトリフォルダにファイルを作成します。リソース

/connect/content-hub/repositories/repositoryId/folders/repositoryFolderId/items

/connect/communities/communityId/content-hub/repositories/repositoryId/folders/repositoryFolderId/items


コミュニティリソースは、バージョン 35.0 以降で使用できます。

345

Files Connect Repository Folder ItemsChatter REST API リソース


HTTP メソッドGET、HEAD、POST

POST はバージョン 35.0 以降でサポートされます。GET の要求パラメータ





Integerpage

ページトークンは、currentPageToken またはnextPageToken のように、応答クラスの一部として返されます。null を渡すと、最初のページが返されます。

32.0省略可能ページあたりの項目数を指定します。有効な値は 1 ～ 100 です。

IntegerpageSize

null を渡すと、デフォルトの 25

に設定されます。

GET のレスポンスボディRepository Folder Items Collection


<contentHubInputItem>

JSON の例{



},{


simple create”}]

}

346

Files Connect Repository Folder ItemsChatter REST API リソース

プロパティ



説明型名前



fields

ポジトリにSharePoint ファイルを作成する場合は必須、それ以外の場合は省略可能



POST のレスポンスボディRepository Folder Item

Files Connect Repository Item Typeリポジトリに関連付けられた項目種別に関する情報を返します。リソース

/connect/content-hub/repositories/repositoryId/item-types/repositoryItemTypeId

/connect/communities/communityId/content-hub/repositories/repositoryId/item-types/repositoryItemTypeId




GET のレスポンスボディFiles Connect Item Type Detail

Files Connect Repository Permissionsリポジトリファイルの権限を取得または更新します。

347

Files Connect Repository Item TypeChatter REST API リソース

リソース/connect/content-hub/repositories/repositoryId/items/repositoryItemId/permissions

/connect/communities/communityId/content-hub/repositories/repositoryId/items/repositoryItemId/permissions

repositoryItemId はファイル ID である必要があります。使用可能なバージョン

35.0



GET のレスポンスボディFiles Connect Permission Collection


<contentHubPermissions>

JSON の例{"permissionsToApply": [

{"directoryEntryId" : "Anyone","permissionTypesIds" : ["CanView"]

}],

"permissionsToRemove": [{

"directoryEntryId" : "AnyoneInMyDomain","permissionTypesIds" : ["CanDelete","CanEdit"]

}]

}

プロパティ



説明型名前

35.0permissions

ToRemove が指ファイルに適用する権限のリスト。

Files ConnectPermission Input[]

permissionsToApply

定されていない場合は必須

35.0permissions

ToApply が指ファイルから削除する権限のリスト。


permissionsToRemove

348

Files Connect Repository PermissionsChatter REST API リソース



説明型名前


PATCH のレスポンスボディFiles Connect Permission Collection

Files Connect Repository Permission Typesリポジトリファイルの権限タイプを取得します。リソース

/connect/content-hub/repositories/repositoryId/items/repositoryItemId/permissions/types

/connect/communities/communityId/content-hub/repositories/repositoryId/items/repositoryItemId/permissions/types

repositoryItemId はファイル ID である必要があります。使用可能なバージョン

35.0



GET のレスポンスボディRepository Permission Type Collection

Files リソース

コンテンツ、表示されているバージョン、共有など、ファイルに関する情報。次のリソースを使用できます。

説明リソース

外部ファイルへの参照を含む、指定されたファイルに関する情報を取得します。外部ファイルへの参照を含


む、既存のファイルの新バージョンをアップロードします。ファイルの名称変更、別のフォルダへの移動、ファイルの削除を行います。

外部ファイルへの参照を含む、ファイルのコンテンツを返します。コンテンツは、レスポンスボディとしてストリーミングされます。


349

Files Connect Repository Permission TypesChatter REST API リソース

説明リソース

指定されたファイルの共有先であるオブジェクトに関する情報を返します。オブジェクトはユーザ、グルー

/chatter/files/fileId/file-shares

プ、またはレコードの場合があります。指定されたファイルをユーザと共有する場合にも使用できます。

リンクとして共有されるファイルの説明。ファイルの共有リンクの作成、アクセス、または削除を行います。


ファイルのサポートされているプレビューに関する情報の取得や、ファイルプレビューの生成を行います。

/chatter/files/fileId/previews

ファイルプレビューまたはプレビュー内の特定のページを取得します。

/chatter/files/fileId/previews/previewFormat

ファイルの変換。変換とは、ファイルのバイナリプレビューです。バイナリの形式は、要求で指定された形式によって異なります。

/chatter/files/fileId/rendition

ファイル ID によって指定されたファイルのリストに関する情報。ファイルのリストに関する情報の取得や、ファイルのリストの削除を行います。

/chatter/files/batch/fileIds

File Information外部ファイルへの参照を含む、指定されたファイルに関する情報を取得します。外部ファイルへの参照を含む、既存のファイルの新バージョンをアップロードします。ファイルの名称変更、別のフォルダへの移動、ファイルの削除を行います。既存のファイルの新しいバージョンをアップロードするには、POST 要求を実行します。新しいバージョンは、マルチパート/フォームデータ要求のバイナリパートとしてアップロードする必要があります。「バイナリファイルのアップロード」 (ページ 11)を参照してください。新しいファイルを [ファイル] タブにアップロードするには、/chatter/users/me/files (ページ 462)を使用します。リソース


/connect/communities/communityId/chatter/files/fileId



HTTP メソッドGET、POST、PATCH、DELETE、または HEAD

350

File InformationChatter REST API リソース

メモ: POST、PATCH、および DELETE は、バージョン 26.0 以降で使用できます。

POST のリクエストボディSharePoint 2010 へのアップロードは、最大 3 MB です。ルート XML タグ

<fileInput>

JSON

{"desc" : "Employee Survey Results","title" : "emp_surv_results"

}

プロパティ



説明型名前

32.0省略可能ファイル固有の最終更新日。クライアント側の更新日を設定するために使用できます。

DatecontentModifiedDate

24.0省略可能アップロードするファイルの説明。

Stringdesc

35.0省略可能ファイルを共有するかどうか、外部ファイルに対して使用可能な権

BooleanincludeExternalFilePerimissionsInfo 限タイプなどの、権限情報を含め

るかどうかを示します。このプロパティは、/chatter/users/userId/files

に対する POST 要求では使用できますが、/chatter/files/fileId

に対する POST 要求では使用できません。

31.0省略可能ファイルが Salesforce Files Syncと同期されている場合は true、同期されていない場合は false。

BooleanisInMyFileSync

31.0省略可能ファイルがメジャーバージョンの場合は true、ファイルがマイ

BooleanisMajorVersion

ナーバージョンの場合はfalse。メジャーバージョンを置き換えることはできません。

31.0省略可能収容フォルダの ID。StringparentFolderId

351




説明型名前

32.0省略可能外部ファイルの ID。StringrepositoryFileId

32.0省略可能外部データソースの ID。StringrepositoryId

35.0省略可能ファイルの共有オプション。値は次のとおりです。

StringsharingOption

• Allowed — ファイルの再共有が許可されます。

• Restricted — ファイルの再共有が禁止されます。

24.0省略可能ファイルのタイトル。Stringtitle

POST の要求パラメータSharePoint 2010 へのアップロードは、最大 3 MB です。


説明型名前

26.0アップロードするファイルの説明。Stringdesc

31.0要求は自動クライアントによって自動生成されます。BooleanisDataSync

31.0ファイルがSalesforce Files Syncと同期されている場合はtrue、同期されていない場合は false。


31.0ファイルがメジャーバージョンの場合は true、ファイルがマイナーバージョンの場合はfalse。メジャーバージョンを置き換えることはできません。


35.0ファイルの共有オプション。値は次のとおりです。StringsharingOption

• Allowed — ファイルの再共有が許可されます。• Restricted — ファイルの再共有が禁止されま

す。

26.0ファイルのタイトル。Stringtitle

GET の要求パラメータ指定されたファイルに関する情報を取得します。

352



説明型名前

23.0ファイルの既存のバージョン番号を指定します。指定されていない場合、最新のバージョンが返されます。

IntegerversionNumber

PATCH の要求パラメータファイルのタイトルまたは同期状態の更新や、別のフォルダへのファイルの移動を行います。


説明型名前

32.0ファイルの新しい説明Stringdesc

26.0ファイルの新しいタイトルStringtitle

31.0ファイルが Salesforce Files Sync と同期されている場合は true、同期されていない場合は false。


31.0収容フォルダの IDStringparentFolderId

35.0ファイルの共有オプション。値は次のとおりです。StringsharingOption

• Allowed — ファイルの再共有が許可されます。• Restricted — ファイルの再共有が禁止されま

す。

GET、POST、PATCH、および HEAD のレスポンスボディFile Detail

DELETE のレスポンスボディ状況コード 204 を返します。

例この PATCH 要求は、ファイルのタイトルを更新します。/chatter/files/069D00000001FHF?title=A+New+Title

File Content外部ファイルへの参照を含む、ファイルのコンテンツを返します。コンテンツは、レスポンスボディとしてストリーミングされます。リソース


/connect/communities/communityId/chatter/files/fileId/content

353

File ContentChatter REST API リソース








31.0省略可能要求は自動クライアントによって自動生成されます。

BooleanisDataSync

24.0省略可能ファイルの既存のバージョン番号を指定します。指定されていない


場合、最新のバージョンが返されます。

レスポンスボディファイルのコンテンツのバイナリストリーム。

File Shares指定されたファイルの共有先であるオブジェクトに関する情報を返します。オブジェクトはユーザ、グループ、またはレコードの場合があります。指定されたファイルをユーザと共有する場合にも使用できます。リソース

/chatter/files/fileId/file-shares

/connect/communities/communityId/chatter/files/fileId/file-shares




POST は、バージョン 30.0 以降で使用できます。GET の要求パラメータ

バージョン 30.0 以降の場合、GET 要求で最初に返される共有は組織のレコード共有です。コミュニティの場合、最初に返される共有はネットワークレコード共有です。

354

File SharesChatter REST API リソース

適用開始バージョン必須項目/省略可能説明型名前

24.0省略可能トピックのページを指定する 0

より大きい整数。デフォルト値は、0 です。

Integerpage

24.0省略可能ページあたりの項目数を指定します。有効な値は 1 ～ 100 です。デフォルト値は 25 です。

IntegerpageSize


<fileShares>

JSON の例{"message": "I shared a document with you.","shares": [

{ "id": "005D0000001Az4l", "sharingType": "V" },{ "id": "005D0000001B2ny", "sharingType": "C" }

]}

プロパティ


説明型名前

30.0受信者に送信される非公開のメッセージ本文。Salesforce Communities が有効な場合、非

Stringmessage

公開メッセージではなくメールが送信されます。

30.0Share Input リクエストボディのコレクション。

Share Input[]shares

POST の要求パラメータファイルをユーザと共有するためのパラメータ


30.0必須項目このファイルの共有先である最大 9 個のユーザ ID のリスト。

Stringid(1–9)

このリストは、共有種別のリストと一致する必要があります。

355

File SharesChatter REST API リソース


30.0省略可能受信者に送信される非公開のメッセージ本文。Salesforce

Stringmessage

Communities が有効な場合、非公開メッセージではなくメールが送信されます。

30.0必須項目共有種別のリスト。コラボレータの場合はC、閲覧者の場合は

StringsharingType(1–9)

V です。このリストは、ユーザ ID のリストと一致する必要があります。

GET および POST のレスポンスボディFile Shares Page

POST の例次の例では、要求パラメータを使用してファイルを 2 人のユーザと共有します。POST /chatter/files/069D00000001JDU/file-shares?id1=005D0000001LL8O&id2=005D0000001QdEL&sharingType1=C&sharingType2=V

次の例では、リクエストボディを使用して同じファイルを同じユーザと共有します。POST /chatter/files/069D00000001JDU/file-shares

{"shares": [

{ "id": "005D0000001LL8O", "sharingType": "C" },{ "id": "005D0000001QdEL", "sharingType": "V" }

]}

Files Shares Linkリンクとして共有されるファイルの説明。ファイルの共有リンクの作成、アクセス、または削除を行います。リソース


/connect/communities/communityId/chatter/files/fileId/file-shares/link



HTTP メソッドGET、HEAD、PUT、DELETE

356

Files Shares LinkChatter REST API リソース

GET または PUT のレスポンスボディFile Share Link

DELETE のレスポンスボディ状況コード 204 を返します。

File Previewsファイルのサポートされているプレビューに関する情報の取得や、ファイルプレビューの生成を行います。リソース

/chatter/files/fileId/previews

/connect/communities/communityId/chatter/files/fileId/previews




GET および PATCH のレスポンスボディFile Preview Collection

File Previewファイルプレビューまたはプレビュー内の特定のページを取得します。リソース

/chatter/files/fileId/previews/previewFormat

/connect/communities/communityId/chatter/files/fileId/previews/previewFormat

previewFormat でサポートされている値は、次のとおりです。• pdf — プレビュー形式は PDF です。• svg — プレビュー形式は SVG です。• thumbnail — プレビュー形式は 240×180 の PNG です。• big-thumbnail — プレビュー形式は 720×480 の PNG です。• tiny-thumbnail — プレビュー形式は 120×90 の PNB です。



357

File PreviewsChatter REST API リソース






35.0省略可能ファイルプレビュー URL 範囲の終了ページ番号。

IntegerendPageNumber

35.0省略可能ファイルプレビュー URL 範囲の開始ページ番号。

IntegerstartPageNumber

GET のレスポンスボディFile Preview

File Renditionファイルの変換。変換とは、ファイルのバイナリプレビューです。バイナリの形式は、要求で指定された形式によって異なります。

メモ: 共有ファイルの場合、変換はアップロード後に非同期で処理されます。非公開ファイルの場合、変換は最初にファイルプレビューが要求されたときに処理されるため、ファイルのアップロード直後は使用できません。

リソース/chatter/files/fileId/rendition

/connect/communities/communityId/chatter/files/fileId/rendition





説明型名前

特定のページの変換を指定します。最初のページは 0 です。特定

Integerpage

のページを指定しない場合、最初のページの変換が返されます。

358

File RenditionChatter REST API リソース

説明型名前

PDF ファイルの変換の場合、ドキュメント全体の変換になります。有効な値は 0 のみです。単一ページの変換は取得できません。

返される変換の種別を指定します。デフォルト値は

Stringtype

THUMB120BY90 です。有効な値は、次のとおりです。• FLASH

• PDF

• THUMB120BY90

• THUMB240BY180

• THUMB720BY480

レスポンスボディ変換のバイナリストリーム。

File Information, Batchファイル ID によって指定されたファイルのリストに関する情報。ファイルのリストに関する情報の取得や、ファイルのリストの削除を行います。指定できるファイル ID 数は、URL の長さによって制限されます。通常、カンマ区切りのリストに最大 100 個のファイル ID を指定できます。リソース


/connect/communities/communityId/chatter/files/batch/fileIds



HTTP メソッドGET、DELETE

レスポンスボディBatch Result Item

359

File Information, BatchChatter REST API リソース

Folders リソース

フォルダまたはフォルダの内容に関する情報。フォルダの変更と削除、フォルダへの項目の追加、およびルートフォルダの同期を行います。使用可能なリソース:

説明リソース

指定されたフォルダに関する情報を取得します。フォルダの移動、名前の変更、および削除を行います。ルートフォルダを同期します。


フォルダの内容に関する情報を取得します。フォルダへのファイルの追加や、フォルダの作成を行います。ルートフォルダを同期します。

/chatter/folders/folderId/items

Folder Information指定されたフォルダに関する情報を取得します。フォルダの移動、名前の変更、および削除を行います。ルートフォルダを同期します。フォルダを削除すると、そのフォルダ内のフォルダはすべて削除され、削除されたフォルダからすべてのファイルが削除されるため、同期されなくなります。リソース


メモ: root を folderId として使用できます。



HTTP メソッドGET、HEAD、PATCH、DELETE

PATCH のリクエストボディFolder Input

PATCH の要求パラメータフォルダの移動


必須項目/省略可能説明型パラメータ

33.0省略可能フォルダおよびこのフォルダ内のすべてのフォルダが Salesforce Files Syncと同期されてい


る場合は true、同期されていない場合はfalse。

360

Folders リソースChatter REST API リソース



isInMyFileSync 設定は、ルートフォルダでのみ有効です。一度 trueに設定すると、isInMyFileSyncを falseに設定することはできません。

30.0必須項目新しい親フォルダの ID。null の場合、フォルダは現在のフォルダから削除されます。

StringparentFolderId

指定された ID が root の場合、フォルダはユーザのフォルダ階層のルートに移動します。

フォルダ名の変更





る場合は true、同期されていない場合はfalse。isInMyFileSync 設定は、ルートフォルダでのみ有効です。一度 trueに設定すると、isInMyFileSyncを falseに設定することはできません。

30.0必須項目フォルダの新しい名前Stringname

GET および PATCH のレスポンスボディFolder

Folder Contentsフォルダの内容に関する情報を取得します。フォルダへのファイルの追加や、フォルダの作成を行います。ルートフォルダを同期します。フォルダを作成するには、POST 要求でリクエストボディまたは要求パラメータを使用できます。ファイルを作成するには、マルチパート/フォームデータの POST 要求のボディパートとして送信する必要があります。説明とタイトル情報を送信するには、マルチパート/フォームデータ要求の一部として JSON またはXML リッチ入力ボディに含めます。または、説明、タイトル、および種別を要求パラメータで送信できます。「バイナリファイルのアップロード」 (ページ 11)を参照してください。ファイルを [ファイル] タブに追加するには、/chatter/users/me/filesを使用します。

361


リソース/chatter/folders/folderId/items

メモ: root を folderId として使用できます。







33.0省略可能フォルダ内の項目の検索条件を指定します。値 IsInMyFileSyncは、フォルダで同期されていない項目を除外します。

Stringfilter

30.0省略可能項目のページを指定する整数。デフォルト値は 0 で、最初のページを返します。

Integerpage

30.0省略可能ページあたりの項目数を指定します。有効な値は 1 ～ 100 です。サイズを指定しない場合、デフォルトは 25 です。

IntegerpageSize

GET のレスポンスボディFolder Item Page

POST のリクエストボディFolder Item Input

POST の要求パラメータフォルダへのファイルの追加



30.0省略可能ファイルの説明Stringdesc



る場合は true、同期されていない場合はfalse。isInMyFileSync 設定は、ルートフォルダでのみ有効です。一度 trueに設定すると、

362




isInMyFileSyncを falseに設定することはできません。


StringsharingOption



30.0省略可能ファイルのタイトルStringtitle

30.0必須項目項目の種別。ファイルをフォルダに追加するには、値を Fileにする必要があります。

Stringtype

フォルダの作成



30.0必須項目フォルダへのパスStringfolderPath



る場合は true、同期されていない場合はfalse。isInMyFileSync 設定は、ルートフォルダでのみ有効です。一度 trueに設定すると、isInMyFileSyncを falseに設定することはできません。

30.0必須項目項目の種別。フォルダを作成するには、値を Folder にする必要があります。

Stringtype

POST のレスポンスボディFolder Item

ファイルをフォルダに追加する例{

"file" :{

"description" : "Yearly Report for Universal Containers Box Division","title" : "Yearly.txt"

363


},"type" : "File"

}

フォルダを作成する例{

"folder" :{

"path" : "my_documents/my_folder"},

"type" : "Folder"}

Groups リソース

グループのメンバー、写真、および組織内のグループなど、グループに関する情報。グループの作成および削除、グループへのメンバーの追加、グループの写真の変更を行います。

メモ: groups リソースはフィードではありません。グループのフィードの表示や、グループのフィードへの投稿を行うには、groupId を含む Record Feed リソースを使用してください。


説明リソース

非公開グループに参加するユーザによって要求の状況を更新するか、非公開グループへの参加要求に関する情報を取得します。

/chatter/group-membership-requests/requestId

グループのメンバーに関する情報へのアクセス、グループからのメンバーの削除、およびグループメンバーのロールの更新に使用されます。

/chatter/group-memberships/membershipId

グループメンバーのリストに関する情報へのアクセスに使用されます。

/chatter/group-memberships/batch/membershipIds

グループレコードに関する情報の取得、またはレコードとグループ間の関連付けの削除を行います。

/chatter/group-records/groupRecordId

組織内のすべてのグループのリスト。グループに関する情報を取得するか、グループを作成します。

/chatter/groups/

一度に複数のグループに関する情報を返します。/chatter/groups/batch/group_list

グループに関する情報。/chatter/groups/groupId

指定されたグループに投稿されたお知らせに関する情報。グループへのお知らせの情報取得や投稿を行います。

/chatter/groups/groupId/announcements

364

Groups リソースChatter REST API リソース

説明リソース

指定されたグループに投稿されたファイルに関する情報を返します。

/chatter/groups/groupID/files

指定されたグループのメンバー。メンバーを取得し、グループにメンバーを追加します。メンバーを追加す

/chatter/groups/groupId/members

るには、コンテキストユーザがグループ所有者またはモデレータである必要があります。

非公開グループのメンバーシップを要求するか、非公開グループへの参加要求の状況を取得します。

/chatter/groups/groupId/members/requests

指定されたグループのコンテキストユーザの Chatter

設定に関する情報です。/chatter/groups/groupId/my-settings

指定されたグループの写真。写真を取得、投稿、トリミング、削除します。

/chatter/groups/groupId/photo

グループに関連付けられたレコードのリストを取得します。レコードをグループに関連付けます。

/chatter/groups/groupId/records

指定されたグループで最近使用されたトピックを最大5 個返します。

/chatter/groups/groupId/topics

関連トピック:

Groups Feed リソース

List of Groups組織内のすべてのグループのリスト。グループに関する情報を取得するか、グループを作成します。リソース

/chatter/groups/

/connect/communities/communityId/chatter/groups/


POST は 29.0 で使用可能Chatter が必要かどうか

はいHTTP メソッド

GET、HEAD、POST

365

List of GroupsChatter REST API リソース


使用可能説明型パラメータ名

29.0指定のアーカイブ状況で絞り込まれたグループのリストを返します。

StringarchiveStatus

• All — アーカイブ対象かどうかに関係なく、すべてのグループ。

• Archived — アーカイブ対象のグループのみ。

• NotArchived — アーカイブ対象外のグループのみ。

デフォルト値は、NotArchived です。

23.0項目のページを指定する整数。デフォルト値は 0 で、最初のページを返します。

Integerpage

23.0ページあたりの項目数を指定します。有効な値は 1 ～ 250 です。デフォルト値は 25 です。

IntegerpageSize

23.0検索する文字列を指定します。検索文字列にはワイルドカード文字を除

Stringq

いて 2 文字以上が含まれている必要があります。ワイルドカードについての詳細は、「ワイルドカード」を参照してください。


<group>

JSON

{"announcement" : "0D5D0000000K4XT","canHaveChatterGuests" : "true","description" : "This group is building a powerful API.","information" : {

"text" : "Read this section before you post to the group.","title" : "Information"

},"isArchived" : "false",

366


"isAutoArchiveDisabled" : "false","name" : "Chatter API","owner" : "00590000000DmPw","visibility" : "PublicAccess"

}

プロパティ


説明型名前

31.0お知らせ ID。お知らせは、削除されるか、別のお知らせで置き換えられない限

Stringannouncement

り、その表示期限の 11:59 p.m. までSalesforce UI の指定の場所に表示されます。

29.0このグループで Chatter 顧客を許可している場合は true、それ以外

BooleancanHaveChatterGuests

の場合は false。このプロパティを true に設定した後で、false

に設定することはできません。29.0グループの [説明] セクションStringdescription

28.0グループの [情報] セクション Web

UI では、[情報] セクションは [説明]

Group Information Inputinformation

セクションの上にあります。グループが非公開の場合は、[情報]

セクションはメンバーにのみ表示されます。[説明] セクションは全員に表示されます。

29.0グループがアーカイブ済みの場合は true、それ以外の場合は

BooleanisArchived

false。デフォルトは false です。

29.0グループの自動アーカイブが無効の場合は true、それ以外の場合

BooleanisAutoArchiveDisabled

は false。デフォルトは false

です。29.0グループの名前Stringname

29.0グループ所有者の ID。このプロパティは、PATCH 要求でのみ使用できます。

Stringowner

367



説明型名前

29.0グループの表示種別を指定します。次のいずれかの値になります。

Stringvisibility

• PrivateAccess — グループのメンバーのみが、このグループへの投稿を参照できます。

• PublicAccess — コミュニティのすべてのユーザが、このグループへの投稿を参照できます。

• Unlisted — 今後の使用のために予約されています。


使用可能必須項目/省略可能


29.0省略可能このグループで Chatter 顧客を許可している場合は true、それ以外の場合は false。このプ


ロパティを true に設定した後で、false に設定することはできません。

29.0省略可能グループの [説明] セクションStringdescription

29.0省略可能グループの [情報] セクション内のテキストStringinformationText

29.0省略可能グループの [情報] セクションのタイトルStringinformationTitle

29.0必須項目グループの名前Stringname

29.0必須項目グループの表示種別を指定します。次のいずれかになります。

Stringvisibility




368


GET のレスポンスボディGroup Page

POST のレスポンスボディGroup Detail

POST の例次の要求で公開グループが作成されます。POST /chatter/groups?name=New+Group&visibility=PublicAccess

関連トピック:


Group Informationグループに関する情報。リソース

/chatter/groups/groupId

/connect/communities/communityId/chatter/groups/groupId


PATCH は 28.0 で使用可能Chatter が必要かどうか


GET、DELETE、HEAD、PATCH

DELETE は 29.0 でサポートPATCH は 28.0 でサポート

PATCH のリクエストボディGroup Input

ルート XML タグ<group>

JSON



},

369

Group InformationChatter REST API リソース

"isArchived" : "false","isAutoArchiveDisabled" : "false","name" : "Chatter API","owner" : "00590000000DmPw","visibility" : "PublicAccess"

}

プロパティ


説明型名前

31.0お知らせ ID。お知らせは、削除されるか、別のお知らせで置き換えられない限

Stringannouncement

り、その表示期限の 11:59 p.m. までSalesforce UI の指定の場所に表示されます。

29.0このグループで Chatter 顧客を許可している場合は true、それ以外


の場合は false。このプロパティを true に設定した後で、false

に設定することはできません。29.0グループの [説明] セクションStringdescription

28.0グループの [情報] セクション Web

UI では、[情報] セクションは [説明]

Group Information Inputinformation

セクションの上にあります。グループが非公開の場合は、[情報]

セクションはメンバーにのみ表示されます。[説明] セクションは全員に表示されます。

29.0グループがアーカイブ済みの場合は true、それ以外の場合は

BooleanisArchived


29.0グループの自動アーカイブが無効の場合は true、それ以外の場合


は false。デフォルトは false

です。29.0グループの名前Stringname

370



説明型名前


Stringowner


Stringvisibility




Group Information Input

JSON

{"text" : "Post questions about the API.","title" : "API Questions"

}

プロパティ


説明型名前

28.0グループの [情報] セクション内のテキスト。HTML はサポートされて

Stringtext

いません。最大文字数は 4000 文字(バイト) です。

28.0グループの [情報] セクションのタイトル。最大文字数は 240 文字 (バイト) です。

Stringtitle

371






31.0省略可能お知らせとして使用するフィード項目の ID。お知らせは、削除されるか、別のお知らせで置き換えられない限り、その表示期限の 11:59 p.m. までSalesforce UI の指定の場所に表示されます。

Stringannouncement

29.0省略可能このグループで Chatter 顧客を許可している場合はtrue、それ以外の場合は false。このプロパティ


を trueに設定した後で、falseに設定することはできません。

29.0省略可能グループの [説明] セクションStringdescription

28.0省略可能グループの [情報] セクション。Web UI では、[情報]

セクションは [説明] セクションの上にあります。グStringinformationText

ループが非公開の場合は、[情報] セクションはメンバーにのみ表示されます。[説明] セクションは全員に表示されます。

28.0省略可能グループの [情報] セクションのタイトルStringinformationTitle

29.0省略可能グループがアーカイブ済みの場合は true、それ以外の場合は false。デフォルトは false です。

StringisArchived

29.0省略可能グループの自動アーカイブが無効の場合は true、それ以外の場合は false。デフォルトは false です。


29.0省略可能グループの名前Stringname

29.0省略可能グループ所有者の ID。このプロパティは、PATCH 要求でのみ使用できます。

Stringowner

29.0省略可能グループの表示種別を指定します。次のいずれかの値になります。

Stringvisibility




372


GET および PATCH のレスポンスボディGroup Detail

PATCH の例このリクエストボディは、グループの [情報] セクションのテキストとタイトルを更新します。{

"information" : {"text" : "Post questions about the API to this group. If you have the answer to

a question, please post it. This is a private R&D group.","title" : "API Questions Group"

}}

次は、同じ例に要求パラメータを使用しています。https://instance_name/services/data/35.0/chatter/groups/groupId?informationText=Post+questions+about+the+API+to+this+group.+If+you+have+the+answer+to+a+question%2C%20+please+post+it.+This+is+a+private+R%26amp%3Bamp%3BD+group.&informationTitle=API+Questions+Group

応答は Group Detail レスポンスボディです。

Batch Group Information一度に複数のグループに関する情報を返します。リソース

/chatter/groups/batch/group_list

/connect/communities/communityId/chatter/groups/batch/group_list

group_list は、最大 500 個のグループ ID から成るカンマ区切りのリストです。適用開始バージョン

23.0



レスポンスボディBatch Results

Group Announcements指定されたグループに投稿されたお知らせに関する情報。グループへのお知らせの情報取得や投稿を行います。お知らせは、情報を強調表示するために使用します。ユーザは、グループフィードのお知らせに対するディスカッション、いいね!、コメントの投稿ができます。他の投稿と同様に、お知らせが投稿されると、グループ

373

Batch Group InformationChatter REST API リソース

メンバーは選択したグループメール通知頻度に応じてメール通知を受信します。フィード投稿を削除するとお知らせが削除されます。特定のお知らせに関する情報の取得、お知らせの表示期限の更新、またはお知らせの削除を行うには、Announcements リソース (/chatter/announcements/announcementId) を使用します。リソース

/chatter/groups/groupID/announcements

/connect/communities/communityId/chatter/groups/groupID/announcements





適用開始バージョン説明型パラメータ名

31.0項目のページを指定する整数。デフォルト値は 0

Integerpage

で、最初のページを返します。

31.0ページあたりの項目数を指定します。有効な値は

IntegerpageSize

1 ～ 100 です。サイズを指定しない場合、デフォルトは 25 です。


<announcement>

JSON の例{ "body":

{"messageSegments": [{

"text": "Please install the updates for all iOS devices.","type": "Text"

}]

}"expirationDate": "2014-02-22T00:00:00.000Z",

}

374

Group AnnouncementsChatter REST API リソース

プロパティ



説明型名前

31.0必須項目お知らせのテキスト。Message BodyInput

body

31.0必須項目別のお知らせが最初に投稿されていない限り、この日付の 11:59 p.m.

DateexpirationDate

までSalesforce UI にお知らせが表示されます。Salesforce UI では、expirationDate の時間値は無視されます。ただし、時間値を使用して各自の UI で独自の表示ロジックを作成することはできます。



31.0別のお知らせが最初に投稿されていない限り、こ

DateexpirationDate

の日付の 11:59 p.m. までSalesforce UI にお知らせが表示されます。Salesforce

UI では、expirationDateの時間値は無視されます。ただし、時間値を使用して各自の UI で独自の表示ロジックを作成することはできます。

GET のレスポンスボディAnnouncement Page

POST のレスポンスボディAnnouncement

POST の例次の要求は、グループへのお知らせを投稿します。POST /chatter/groups/0F9D00000000I1d/announcements

375

Group AnnouncementsChatter REST API リソース

レスポンスボディは次のようになります。{ "body":



}]


}

Group Files指定されたグループに投稿されたファイルに関する情報を返します。リソース

/chatter/groups/groupID/files

/connect/communities/communityId/chatter/groups/groupID/files







Integerpage



IntegerpageSize


27.0結果を絞り込むクエリ文字列。文字列にはワイル

Stringq

ドカード文字を除いて 2

文字以上が含まれている必要があります。ワイル

376

Group FilesChatter REST API リソース


ドカードについての詳細は、「ワイルドカード」を参照してください。

レスポンスボディFile Summary Page

Group Members指定されたグループのメンバー。メンバーを取得し、グループにメンバーを追加します。メンバーを追加するには、コンテキストユーザがグループ所有者またはモデレータである必要があります。リソース

/chatter/groups/groupId/members

/connect/communities/communityId/chatter/groups/groupId/members





<member>

プロパティ


29.0メンバーのロール。次のいずれかの値にします。

Stringrole

• GroupManager

• StandardMember

23.0グループに追加するメンバーのユーザ ID。

StringuserId

377

Group MembersChatter REST API リソース


使用可能なバージョン説明型パラメータ名


Stringrole

• GroupManager

• StandardMember

23.0グループに追加するユーザの ID。StringuserId




Integerpage



IntegerpageSize


GET または HEAD のレスポンスボディGroup Member Page

POST のレスポンスボディグループメンバー

例: グループへのメンバーの追加この POST 要求は、グループにメンバーを追加します。/chatter/groups/0F9D00000000I4O/members?userId=005D0000001LLO1

応答は Group Member レスポンスボディです。{

"id": "0FBD00000003LRxOAM","role": "StandardMember","url": "/services/data/v35.0/chatter/group-memberships/0FBD00000003LRxOAM","user": {

"companyName": "Universal Containers","firstName": "Gordon","id": "005D0000001LLO1IAO","isActive": true,"isInThisCommunity": true,

378

Group MembersChatter REST API リソース

"lastName": "Johnson","motif": {


},"mySubscription": {

"id": "0E8D0000000T5ZUKA0","url": "/services/data/v35.0/chatter/subscriptions/0E8D0000000T5ZUKA0"

},"name": "Gordon Johnson","photo": {

"fullEmailPhotoUrl":"https://instance_name/ncsphoto/SqRfG_-PUTY6KtfOp_f0cPhKrC7plNhUw5eOz7Aj1u-oFL0K-ff2oe04ZAmT2MqC",

"largePhotoUrl": "https://instance_name/profilephoto/729D00000000LJL/F","photoVersionId": "729D00000000LJLIA2","smallPhotoUrl": "https://instance_name/profilephoto/729D00000000LJL/T","standardEmailPhotoUrl":

"https://instance_name/ncsphoto/SqRfG_-PUTY6KtfOp_f0cPhKrC7plNhUw5eOz7Aj1u-6d5rE2mNaMaBZfGnFX65O",

"url": "/services/data/v35.0/chatter/users/005D0000001LLO1IAO/photo"},"title": "VP Sales","type": "User","url": "/services/data/v35.0/chatter/users/005D0000001LLO1IAO","userType": "Internal"

}}

メモ: グループが非公開の場合、応答は 403 です。グループへの参加を要求するには、Group

Members—Privateリソース (/chatter/groups/groupId/members/requests) に POST 要求を送信します。

関連トピック:


Group Members—Private非公開グループのメンバーシップを要求するか、非公開グループへの参加要求の状況を取得します。

メモ: 非公開グループのメンバーシップを要求するには、Group Members リソースを使用します。

リソース/chatter/groups/groupId/members/requests

/connect/communities/communityId/chatter/groups/groupId/members/requests


379

Group Members—PrivateChatter REST API リソース


HTTP メソッドGET、HEAD、および POST



27.0省略可能。このパラメータを含めると、指定した

Stringstatus

状況と一致するものを含むように結果が絞り込まれます。有効な値は次のとおりです。• Accepted

• Declined

• Pending

GET または HEAD のレスポンスボディGroup Membership Request Collection

POST のレスポンスボディGroup Membership Request

次の表に、このリソースに固有の HTTP 応答コードの説明を示します。他の HTTP 応答コードの説明は、「状況コードとエラー応答」を参照してください。

説明HTTP 応答コード

次のいずれかになります。201

• 成功• ユーザは、このグループに対してメンバーシップを要求済みです。

ユーザは、すでにこのグループのメンバーです。204

次のいずれかになります。403

• 非公開のグループ: INSUFFICIENT_ACCESS_OR_READONLY

• 外部ユーザ: INSUFFICIENT_ACCESS

GET の例次の例は、この非公開グループに対して承認されたすべての参加要求に関する情報を取得します。/chatter/groups/0F9D00000000izfKAA/members/requests?status=Accepted

380


JSON Group Membership Request Collection レスポンスボディには、ユーザ Gordon Johnson からの 1 つの要求が含まれます。{

"requests": [{"createdDate": "2012-10-19T00:23:23.000Z","id": "0I5D000000002fmKAA","lastUpdateDate": "2012-10-19T00:24:06.000Z","requestedGroup": {

"id": "0F9D00000000izfKAA","url": "/services/data/v35.0/chatter/groups/0F9D00000000izfKAA"

},"responseMessage": null,"status": "Accepted","url": "/services/data/v35.0/chatter/group-membership-requests/0I5D000000002fmKAA",

"user": {"companyName": "Universal Containers","firstName": "Gordon","id": "005D0000001LLO1IAO","isActive": true,"lastName": "Johnson","motif": {



"id": "0E8D0000000T5ZUKA0","url": "/services/data/v35.0/chatter/subscriptions/0E8D0000000T5ZUKA0"

},"name": "Gordon Johnson","photo": {"fullEmailPhotoUrl": "https://instance_name/ncsphoto/SqRfG_-PUTY6KtfOp_f0cPhK

rC7plNhUw5eOz7Aj1u-zWLMxsSybO7lwUPg5_Xne","largePhotoUrl": "https://instance_name/profilephoto/729D00000000LJL/F","photoVersionId": "729D00000000LJLIA2","smallPhotoUrl": "https://instance_name/profilephoto/729D00000000LJL/T",

"standardEmailPhotoUrl": "https://instance_name/ncsphoto/SqRfG_-PUTY6KtfOp_f0cPhKrC7plNhUw5eOz7Aj1u_2Vnyzx4jZ2zFiKBz_sTt2",


}}],"total": 1

}

381


POST の例次の例は、ID が 0F9D00000000lpK である非公開グループのメンバーシップを要求します。/chatter/groups/0F9D00000000lpK/members/requests

JSON 形式の Group Membership Request レスポンスボディです。{

"createdDate": "2013-04-02T23:44:25.000Z","id": "0I5D000000002kOKAQ","lastUpdateDate": "2013-04-02T23:44:25.000Z","requestedGroup": {

"id": "0F9D00000000lpKKAQ","url": "/services/data/v35.0/chatter/groups/0F9D00000000lpKKAQ"

},"responseMessage": null,"status": "Pending","url": "/services/data/v35.0/chatter/group-membership-requests/0I5D000000002kOKAQ","user": {

"companyName": "Universal Containers","firstName": "Gordon","id": "005D0000001LLO1IAO","isActive": true,"isInThisCommunity": true,"lastName": "Johnson","motif": {


},"mySubscription": null,"name": "Gordon Johnson","photo": {


"largePhotoUrl": "https://instance_name/profilephoto/729D00000000LJL/F","photoVersionId": "729D00000000LJLIA2","smallPhotoUrl": "https://instance_name/profilephoto/729D00000000LJL/T","standardEmailPhotoUrl":



382


}}

関連トピック:

非公開グループへの参加を要求する

Group Membership Requests—Private非公開グループに参加するユーザによって要求の状況を更新するか、非公開グループへの参加要求に関する情報を取得します。/chatter/groups/groupId/members/requests への POST 要求のGroup Membership Request

応答から、requestId の値を取得します。リソース

/chatter/group-membership-requests/requestId

/connect/communities/communityId/chatter/group-membership-requests/requestId



HTTP メソッドGET、HEAD、および PATCH

PATCH のリクエストボディGroup Membership Request Update



27.0このプロパティを使用して、メンバーシップ要求が却下された場合にユーザ

StringresponseMessage

に表示するメッセージを指定します。このプロパティの値は、statusプロパティの値が Declined の場合にのみ使用されます。最大文字数は 756 文字です。

27.0有効な値は次のとおりです。Stringstatus

• Accepted

• Declined

PATCH のレスポンスボディGroup Membership Request

383

Group Membership Requests—PrivateChatter REST API リソース

GET または HEAD のレスポンスボディGroup Membership Request

PATCH の例次の例は、非公開グループへの参加要求を Pending から Accepted に更新します。/chatter/group-membership-requests/0I5D000000002fwKAA?status=Accepted

この要求は、Group Membership Request レスポンスボディを返します。

関連トピック:


Group Memberships リソースChatter グループのメンバーシップに関する情報。次のリソースを使用できます。

説明リソース

グループのメンバーに関する情報へのアクセス、グループからのメンバーの削除、およびグループメンバーのロールの更新に使用されます。


グループメンバーのリストに関する情報へのアクセスに使用されます。


Group Memberships Informationグループのメンバーに関する情報へのアクセス、グループからのメンバーの削除、およびグループメンバーのロールの更新に使用されます。メンバーシップ ID は /chatter/groups/groupId/membershipsリソースから返されます。リソース


/connect/communities/communityId/chatter/group-memberships/membershipId



HTTP メソッドGET、DELETE、HEAD、PATCH

PATCH は 29.0 でサポート

384

Group Memberships リソースChatter REST API リソース


<member>

JSON の例{

"role" : "GroupManager","userId" : "005B0000000Ge16"

}

プロパティ



Stringrole

• GroupManager

• StandardMember


StringuserId

メモ: PATCH 要求でグループメンバーのロールを更新するには、userId プロパティは渡さずに role

プロパティのみを渡します。PATCH の要求パラメータ



Stringrole

• GroupManager

• StandardMember

GET または PATCH のレスポンスボディグループメンバー

Batch Group Membershipsグループメンバーのリストに関する情報へのアクセスに使用されます。メンバーは同じグループに属す必要はありません。各メンバーシップ ID は、特定のグループに関連付けられています。メンバーシップ ID は、複数の groups リソースのレスポンスボディで返されます。

385


次の groups リソースでは、グループ内のすべてのメンバーがそのGroup Memberレスポンスボディにリストされます。すべての Group Member レスポンスボディの id プロパティには、メンバーシップ ID が含まれます。/chatter/groups/groupId/members

リソース/chatter/group-memberships/batch/membershipIds

/connect/communities/communityId/chatter/group-memberships/batch/membershipIds

membershipIds は、最大 500 個のメンバーシップ ID から成るカンマ区切りのリストです。適用開始バージョン

27.0



GET または HEAD のレスポンスボディBatch Results

GET の例次の要求は、2 人のユーザのグループメンバーシップ情報を取得します。/chatter/group-memberships/batch/0FBD00000003GAPOA2,0FBD00000003GAKOA

これは、ネストされた User Summary レスポンスボディを含む Batch Results レスポンスボディです。{

"hasErrors": true,"results": [

{"result": {

"id": "0FBD00000003GAPOA2","role": "StandardMember","url": "/services/data/v35.0/chatter/group-memberships/0FBD00000003GAPOA2",

"user": {"companyName": "Universal Containers","firstName": "Gordon","id": "005D0000001LLO1IAO","isActive": true,"isInThisCommunity": true,"lastName": "Johnson","motif": {



"id": "0E8D0000000T5ZUKA0",

386


"url": "/services/data/v35.0/chatter/subscriptions/0E8D0000000T5ZUKA0"

},"name": "Gordon Johnson","photo": {


"largePhotoUrl": "https:/instance_name/profilephoto/729D00000000LJL/F",

"photoVersionId": "729D00000000LJLIA2","smallPhotoUrl":

"https://instance_name/profilephoto/729D00000000LJL/T","standardEmailPhotoUrl":



}},"statusCode": 200

},{

"result": [{"errorCode": "NOT_FOUND","message": "The requested resource does not exist"


}]

}

2 つ目のグループメンバーシップが見つかっていません。バッチ要求は、サブ要求ごとの状況コードを返します。

Group Photo指定されたグループの写真。写真を取得、投稿、トリミング、削除します。[ファイル] ページからの画像をグループの写真 (既存のコンテンツ) として使用するには、リクエストボディのfileId プロパティまたは fileId 要求パラメータでファイル ID を渡します。[グループ] ページでアップロードした画像にはファイル ID は含まれず、fileId としては使用できません。バイナリファイルをグループの写真としてアップロードするには、マルチパート/フォームデータメッセージでそのファイルを送信する必要があります。マルチパート/フォームデータメッセージを作成する方法についての詳細は、「バイナリファイルのアップロード」を参照してください。

387

Group PhotoChatter REST API リソース

リソース/chatter/groups/groupId/photo

/connect/communities/communityId/chatter/groups/groupId/photo



HTTP メソッドGET、POST、DELETE、または HEAD


<photo>

JSON の例{ "cropSize" : "120",


}

プロパティ



29.0アップロードされたファイルまたは既存のファイルを

トリミングする正方形の任意の境界の長さ (ピクセル単位)。

IntegercropSize

トリミングする必要があります。


画像の左端を起点とした、トリミングする正方形の開始位

IntegercropX


置 X (ピクセル単位)。左上の位置は (0,0) です。


画像の上端を起点とした、トリミングする正方形の開始位

IntegercropY


置 Y (ピクセル単位)。左上の位置は (0,0) です。

388




25.0既存のファイルを選択する必要があります。

既存のファイルの 18 文字のID。キープレフィックスは069、ファイルサイズは 2 MB

未満にする必要があります。

StringfileId

メモ: グループページおよびユーザページにアップロードされた画像にはファイル ID がないため、使用できません。

25.0省略可能既存のファイルのバージョン番号。指定されていない場


合、最新のバージョンが使用されます。




29.0アップロードされたファイルまたは既存


IntegercropSize

のファイルをトリミングする必要があります。


画像の左端を起点とした、トリミングす

IntegercropX

のファイルをトリミる正方形の開始位置ングする必要があります。

X (ピクセル単位)。左上の位置は (0,0) です。


画像の上端を起点とした、トリミングす

IntegercropY


Y (ピクセル単位)。左上の位置は (0,0) です。

389





既存のファイルの 18

文字の ID。キープレフィックスは 069、ファイルサイズは 2

StringfileId

MB 未満にする必要があります。

メモ: [グループ] ページおよび [ユーザプロファイル] ページでアップロードしたファイルにはファイル ID は含まれず、投稿やトリミングはできません。[ファイル] ページでアップロードしたファイルにはファイルID は含まれず、投稿やトリミングはできません。

25.0省略可能既存のコンテンツのバージョン番号。指


定されていない場合、最新のバージョンが使用されます。

メモ: 写真は非同期に処理され、すぐには表示されない場合があります。

GET または HEAD のレスポンスボディPhoto

390


POST のレスポンスボディPhoto

関連トピック:

グループの写真を更新およびトリミングする

Group Recordsグループに関連付けられたレコードのリストを取得します。レコードをグループに関連付けます。リソース

/chatter/groups/groupID/records

/connect/communities/communityId/chatter/groups/groupID/records




POST はバージョン 34.0 以降でサポートされます。GET の要求パラメータ



Integerpage

33.0ページあたりの項目数を指定します。有効な値は 1 ～ 100 です。サイズを指定しない場合、デフォルトは 25 です。

IntegerpageSize


<groupRecord>

JSON の例

{"recordId" : "001D000000Io9cD"}

391

Group RecordsChatter REST API リソース

プロパティ



説明型名前

34.0必須項目レコードの ID。StringrecordId



34.0レコードの ID。StringrecordId

GET のレスポンスボディGroup Record Page

POST のレスポンスボディGroup Record

Group Recordグループレコードに関する情報の取得、またはレコードとグループ間の関連付けの削除を行います。リソース

/chatter/group-records/groupRecordId

/connect/communities/communityId/chatter/group-records/groupRecordId




GET のレスポンスボディGroup Record


Group Settings指定されたグループのコンテキストユーザの Chatter 設定に関する情報です。

392

Group RecordChatter REST API リソース

リソース/chatter/groups/groupId/my-settings

/connect/communities/communityId/chatter/groups/groupId/my-settings



HTTP メソッドGET、HEAD、または PATCH


<groupChatterSettings>

プロパティユーザの Chatter 設定。


説明型名前

27.0グループメンバーがグループからメールを受信する頻度。有効な値は、次のとおりです。

StringemailFrequency

• EachPost

• DailyDigest

• WeeklyDigest

• Never

コミュニティでは、グループメンバーが 10,000 人を超えると [各投稿のメール] オプションが無効になります。このオプションを選択したすべてのメンバーは、自動的に [毎日のダイジェスト] に切り替わります。



27.0グループメンバーがグループからメールを受信


393

Group SettingsChatter REST API リソース


する頻度。有効な値は、次のとおりです。• EachPost

• DailyDigest

• WeeklyDigest

• Never

GET、HEAD、または PATCH のレスポンスボディGroup Chatter Settings

Group Topics指定されたグループで最近使用されたトピックを最大 5 個返します。リソース

/chatter/groups/groupID/topics

/connect/communities/communityId/chatter/groups/groupID/topics




レスポンスボディTopic Collection

Influence リソース

組織のユーザを Chatter での影響度によって分類するために使用するパーセントしきい値のリスト。ユーザは、自分が行った投稿とコメントの数、および受け取ったコメントといいね! の数に基づいてランク付けされます。カテゴリに関連付けられたパーセントは、そのインフルエンサーカテゴリの下限しきい値を表します。たとえば、0.25 は、Active Influencer カテゴリの下限値です。つまり、影響度ランクが 25% 以上で次に高いカテゴリしきい値未満のユーザがこのカテゴリに含まれます。

394

Group TopicsChatter REST API リソース

Influence Thresholdsリソース

/chatter/influence/thresholds

/connect/communities/communityId/chatter/influence/thresholds




レスポンスボディInfluence Thresholds

レスポンスボディの例{"thresholds": [

{"name": "Top Influencer","threshold": "0.8",

}{

"name": "Active Influencer","threshold": "0.25",

}{

"name": "Observer","threshold": "0.0",

}]}

Likes リソース

指定されたいいね! に関する情報。いいね! の削除にも使用されます。ニュースフィードやレコードフィードなど、任意のフィードから特定のいいね! の ID を検索できます。

Likeリソース

/chatter/likes/likeId

/connect/communities/communityId/chatter/likes/likeId


395

Likes リソースChatter REST API リソース


HTTP メソッドGET、DELETE、または HEAD

GET または HEAD のレスポンスボディLike

Managed Topics リソース

コミュニティの管理トピック。管理トピックのリストを取得します。コミュニティの管理トピックの作成、削除、または並び替えを行います。使用可能なリソース:

説明リソース

コミュニティのすべての管理トピックを取得します。管理トピックを作成します。管理トピックを並び替えます。


コミュニティの管理トピックの情報取得または削除を行います。

/connect/communities/communityId/managed-topics/managedTopicId

Managed Topicsコミュニティのすべての管理トピックを取得します。管理トピックを作成します。管理トピックを並び替えます。コミュニティマネージャ (「コミュニティの作成および設定」または「コミュニティの管理」権限を持つユーザ) のみが、管理トピックの作成または並び替えを行うことができます。リソース




HTTP メソッドGET、POST、PATCH、HEAD

396

Managed Topics リソースChatter REST API リソース





35.0省略可能整数 1 ～ 3 を指定します。1 を指定すると、Managed Topic レスポンス

Integerdepth

ボディの childrenプロパティはnull になります。2 を指定すると、Managed Topic レスポンスボディのchildren プロパティには管理トピックの直接の子である管理トピック (存在する場合) が含まれます。3 を指定すると、直接の子である管理トピックとその子管理トピック (存在する場合) が取得されます。depth が指定されていない場合、デフォルトは 1 です。

32.0省略可能recordId または depthを指定する場合は必須

管理トピックの種別。StringmanagedTopicType • Featured — コミュニティホー

ムページなどの主要トピック。ただし、全体的なナビゲーションは提供しません。

• Navigational — コミュニティのナビゲーションメニューに表示されるトピック。

1 つのトピックは最大 2 つの種別の管理トピックに関連付けることができるため、1 つのトピックをFeatured トピックとNavigationalトピックの両方にすることができます。

35.0省略可能管理トピックに関連付けられたトピックの ID。

StringrecordId

GET のレスポンスボディManaged Topic Collection


<managedTopic>

397

Managed TopicsChatter REST API リソース

JSON の例{"managedTopicType" :"Navigational","parentId” : "0TOD00000000cxl","recordId" :"0TOD00000000cwk"}

プロパティ



説明型名前

32.0必須項目管理トピックの種別。StringmanagedTopicType • Featured — コミュニティ

ホームページなどの主要トピック。ただし、全体的なナビゲーションは提供しません。


1 つのトピックは最大 2 つの種別の管理トピックに関連付けることができるため、1 つのトピックをFeatured トピックとNavigational トピックの両方にすることができます。managedTopicType につき、最大 25 個の管理トピックを作成できます。子管理トピックを作成するには、managedTopicType としてNavigational を指定し、parentId を指定します。

32.0新規トピックでは必須name またはrecordIdを指

管理トピックの名前。Stringname

定する必要があります。両方を指定することはできません。

398




説明型名前

35.0省略可能親管理トピックの ID。parentId を指定する場合は、managedTopicType として

StringparentId

Navigational も指定する必要があります。最大 3 レベル (親、直接の子、その子) の管理トピックを作成でき、管理トピックにつき最大 10

個の子管理トピックを作成できます。

32.0Name プロパティが使用され

管理トピックになるレコードのID。バージョン 32.0 では、recordId

はトピック ID である必要があります。

StringrecordId

ていない場合、既存のトピックに必要です。name またはrecordIdを指定する必要があります。両方を指定することはできません。





32.0必須項目管理トピックの種別。StringmanagedTopicType • Featured — コミュニティホー



1 つのトピックは最大 2 つの種別の管理トピックに関連付けることができるため、1 つのトピックをFeatured トピックと

399





Navigationalトピックの両方にすることができます。managedTopicTypeにつき、最大25 個の管理トピックを作成できます。子管理トピックを作成するには、managedTopicType としてNavigational を指定し、parentId を指定します。

32.0新規トピックでは必須name またはrecordId を指




StringparentId

Navigationalも指定する必要があります。最大 3 レベル (親、直接の子、その子) の管理トピックを作成でき、管理トピックにつき最大 10 個の子管理トピックを作成できます。




StringrecordId

ていない場合は必須name またはrecordId を指定する必要があります。両方を指定することはできません。

400


POST のレスポンスボディManaged Topic


<managedTopicPositionCollection>

JSON の例{"managedTopicPositions" : [{"managedTopicId" :"0mtD0000000001aIAA","position" :"0"

},{"managedTopicId" :"0mtD0000000002qIAA","position" :"2"

}]

}

プロパティ



説明型名前

32.0必須項目Managed Topic Position リクエストボディのコレクション。このコレク

Managed TopicPosition Input[]

managedTopicPositions

ションには、Featured およびNavigational 管理トピックを含めることができます。また、すべての管理トピックを含める必要はありません。managedTopicPositions にすべての管理トピックを含めない場合、管理トピックはmanagedTopicPositions で指示された位置に従って並び替えられ、managedTopicPositions

に含まれない管理トピックは次に空いている位置まで順序を下げられます。「管理トピックの並び替えの例」を参照してください。

管理トピックの並び替えの例次の管理トピックがあるとします。

401


位置管理トピック

0ManagedTopicA

1ManagedTopicB

2ManagedTopicC

3ManagedTopicD

4ManagedTopicE

Managed Topic Position Collection Input に次の情報を含めて管理トピックを並び替えます。


0ManagedTopicD

2ManagedTopicE

結果は次のとおりです。


0ManagedTopicD

1ManagedTopicA

2ManagedTopicE

3ManagedTopicB

4ManagedTopicC

PATCH のレスポンスボディManaged Topic Collection

Managed Topicコミュニティの管理トピックの情報取得または削除を行います。コミュニティマネージャ (「コミュニティの作成および設定」または「コミュニティの管理」権限を持つユーザ) のみが、管理トピックを削除できます。リソース

/connect/communities/communityId/managed-topics/managedTopicId


402

Managed TopicChatter REST API リソース







35.0省略可能整数 1 ～ 3 を指定します。1 を指定すると、Managed Topic レスポンス

Integerdepth

ボディの childrenプロパティはnull になります。2 を指定すると、Managed Topic レスポンスボディのchildren プロパティには管理トピックの直接の子である管理トピック (存在する場合) が含まれます。3 を指定すると、直接の子である管理トピックとその子管理トピック (存在する場合) が取得されます。depth が指定されていない場合、デフォルトは 1 です。

GET のレスポンスボディManaged Topic


Mentions リソース

フィード項目またはコメントの本文でメンション可能なユーザおよびグループに関する情報。ユーザまたはグループは、メンションされると通知を受け取ります。メンション提案のリストを取得するには、Mentions Completions リソースを使用します。コンテキストユーザに対して有効な提案を判定するには、Mentions Validations リソースを使用します。


Mentions Completions

フィード項目またはコメントの本文でメンションするユーザおよびグループに関する情報。ユーザが選択できる提案メンションのリストを生成するには、このリソースを使用します。メンションは、ユーザ名またはグループ名の前にある「@」文字で示されます。ユーザまたはグループは、メンションされると通知を受け取ります。

403

Mentions リソースChatter REST API リソース

Mentions Validations

指定されたメンションがコンテキストユーザに対して有効であるかどうかを示す情報。たとえば、コンテキストユーザは自分が属していない非公開グループにメンションできません。そのようなグループがメンションの検証のリストに含まれていると、Mention Validations レスポンスボディの hasErrors プロパティはtrueになり、そのメンションの検証で Disallowedの validationStatusがグループに設定されます。

Mentions Completionsフィード項目またはコメントの本文でメンションするユーザおよびグループに関する情報。ユーザが選択できる提案メンションのリストを生成するには、このリソースを使用します。メンションは、ユーザ名またはグループ名の前にある「@」文字で示されます。ユーザまたはグループは、メンションされると通知を受け取ります。リソース

/chatter/mentions/completions

/connect/communities/communityId/chatter/mentions/completions







29.0省略可能検索結果を絞り込むフィード項目 ID (コメント内のメンションの場合) または

StringcontextId

フィード件名 ID (フィード項目内のメンションの場合) であり、最も的確な結果が最初に表示されます。

29.0省略可能返すページの数。番号付けは 0 から開始します。0を渡すか、このプロパティを

Integerpage

省略すると、最初のページが返されます。結果が 500 件を超えるページを試行すると、空の応答が返されます。

404

Mentions CompletionsChatter REST API リソース



29.0省略可能ページあたりの項目数。有効な値は 1 ～100 です。デフォルトサイズは 25 です。500 件を超える結果を取得しようとすると、空の応答が返されます。

IntegerpageSize

29.0必須項目検索語。一致するユーザおよびグループの名前を検索します。ユーザを検索する

Stringq

場合、1 文字以上を指定する必要があります。グループを検索する場合、2 文字以上を指定する必要があります。このパラメータではワイルドカードは使用できません。

29.0省略可能メンションの補完の種類。次のいずれかの値にします。

Stringtype

• All — メンションで参照するレコードタイプに無関係の、すべてのメンションの補完。

• Group — グループのメンションの補完。

• User — ユーザのメンションの補完。デフォルト値は、All です。

GET のレスポンスボディMention Completion Page

GET の例この例では、contextIdパラメータでフィード項目 ID を指定し、フィード項目のコメントのメンションの補完を要求します。GET /chatter/mentions/completions?contextId=0D5D0000000Hwky&q=g

これは、レスポンスボディです。{

"currentPageUrl":"/services/data/v35.0/chatter/mentions/completions?contextId=0D5D0000000Hwky&q=g",

"mentionCompletions": [{

"additionalLabel": null,"description": "VP Sales","name": "Gordon Johnson","photoUrl": "https://instance_name/profilephoto/729D00000000LJL/T",

405

Mentions CompletionsChatter REST API リソース

"recordId": "005D0000001LLO1IAO"},{

"additionalLabel": null,"description": "A place for constructive cr...","name": "Airing of Grievances","photoUrl": "https://instance_name/profilephoto/0F9/T","recordId": "0F9D00000000izfKAA"

}],"nextPageUrl": null,"previousPageUrl": null

}

関連トピック:


Mentions Validations指定されたメンションがコンテキストユーザに対して有効であるかどうかを示す情報。たとえば、コンテキストユーザは自分が属していない非公開グループにメンションできません。そのようなグループがメンションの検証のリストに含まれていると、Mention Validations レスポンスボディの hasErrors プロパティは true になり、そのメンションの検証で Disallowed の validationStatus がグループに設定されます。リソース

/chatter/mentions/validations

/connect/communities/communityId/chatter/mentions/validations







29.0必須項目フィード項目の親 ID (新しいフィード項目の場合) またはフィード項目 ID (コメントの場合)。

StringparentId

29.0必須項目メンションする ID のカンマ区切りのリスト。最大値は、25 です。

String[]recordIds

406

Mentions ValidationsChatter REST API リソース



29.0必須項目フィード項目を表示できるユーザの種別を指定します。

Stringvisibility

• AllUsers — 表示は内部ユーザに限定されません。

• InternalUsers — 表示は内部ユーザに限定されます。

GET のレスポンスボディMention Validation

使用方法まず、Mentions Completionsを要求し、提案メンションのリストを取得します。これらの提案メンションを Mentions

Validations リソースに渡し、メンションがコンテキストユーザに対して有効であるかどうかを判定します。

関連トピック:


Motifs リソース

小、中、大の一連の motif アイコンの URL を返します。レコードの一連の motif アイコンは、レコードタイプによって異なります。motif にはレコードタイプのベース色を含めることもできます。次のリソースを使用できます。

説明リソース

指定したレコードの小、中、大の一連の motif アイコンを返します。指定されたレコードのベース色を返すこともできます。

/connect/motifs/idOrPrefix

指定した複数のレコードの小、中、大の一連の motif

アイコンを返します。指定された各レコードのベース色を含めることもできます。

/connect/motifs/batch/idOrPrefixList

Motifs リソース指定したレコードの小、中、大の一連の motif アイコンを返します。指定されたレコードのベース色を返すこともできます。

407

Motifs リソースChatter REST API リソース

idOrPrefix の ID またはキープレフィックスのいずれかを指定します。リソース

/connect/motifs/idOrPrefix

/connect/communities/communityId/motifs/idOrPrefix




レスポンスボディMotif

GET の例ユーザの motifs の要求: /connect/motifs/005D0000001LLO1

応答:

{"color": "1797C0","largeIconUrl": "/img/icon/profile64.png","mediumIconUrl": "/img/icon/profile32.png","smallIconUrl": "/img/icon/profile16.png"

}

Batch Motifs リソース指定した複数のレコードの小、中、大の一連の motif アイコンを返します。指定された各レコードのベース色を含めることもできます。idOrPrefixList の ID とキープレフィックスのカンマ区切りのリストを指定します。ID とキープレフィックスは、同じ要求に混在できます。リソース


/connect/communities/communityId/motifs/batch/idOrPrefixList





408

Motifs リソースChatter REST API リソース

GET の例ユーザおよびファイルの motifs の要求: /connect/motifs/batch/005D0000001LLO1,069D00000001FHF

応答:

{"results": [{

"result": {"color": "1797C0","largeIconUrl": "/img/icon/profile64.png","mediumIconUrl": "/img/icon/profile32.png","smallIconUrl": "/img/icon/profile16.png"

},"statusCode": 200

},{

"result": {"color": "993333","largeIconUrl": "/img/content/content64.png","mediumIconUrl": "/img/content/content32.png","smallIconUrl": "/img/icon/files16.png"

},"statusCode": 200

}]}

Push Notifications リソース

モバイル転送通知をユーザのデバイスの接続アプリケーションに送信します。受信者の接続アプリケーションと同じ組織で開発された、または同じパッケージにインストールされた接続アプリケーションでセッションが確立されている場合にのみこのリソースにアクセスできます。リソース

/connect/notifications/push





<pushNotification>

JSON の例{ "appName" : "TestApp",

"namespace" : "abc",

409

Push Notifications リソースChatter REST API リソース

"userIds" : ["005x00000013dPK", "005x00000013dPL"],"payload" : "{'aps':{'alert':'test', 'badge':0, 'sound':'default'}}"

}

プロパティ



説明型名前

31.0必須項目転送通知の送信先の接続アプリケーションの API 名。

StringappName

31.0必須項目 (名前空間が設定されている場合)

転送通知の送信先の接続アプリケーションの名前空間。

Stringnamespace

31.0必須項目JSON 形式の転送通知ペイロード。Stringpayload

31.0必須項目転送通知受信者のユーザ ID。String []userIds






StringappName



Stringnamespace



Question and Answers Suggestions リソース

質問および回答の提案を取得します。リソース

/connect/question-and-answers/suggestions

/connect/communities/communityId/question-and-answers/suggestions


410

Question and Answers Suggestions リソースChatter REST API リソース







32.0省略可能検索結果にナレッジ記事を含める場合は、true を指定します。質

BooleanincludeArticles

問のみを返す場合は、falseを指定します。

32.0省略可能項目種別ごとに返す結果の最大数。有効な値は 1 ～ 10 です。デフォルト値は 5 です。

IntegermaxResults

32.0必須項目検索する文字列を指定します。検索文字列にはワイルドカード文字

Stringq

を除いて 2 文字以上が含まれている必要があります。「ワイルドカード」を参照してください。最大文字数は 255 文字です。

32.0省略可能そのオブジェクトに関する質問のみを検索するには、件名 ID を指定

StringsubjectId

します。ID がトピックまたはユーザの場合、ID は無視されます。

GET のレスポンスボディQuestion and Answers Suggestion Collection

Recommendation Audience Resources

カスタムおすすめの特定の利用者を対象にします。これらのリソースは、おすすめ利用者の情報取得、作成、更新、削除に使用します。コミュニティマネージャ (「コミュニティの作成および設定」または「コミュニティの管理」権限を持つユーザ) は、コミュニティのおすすめ利用者、おすすめ定義、およびスケジュール済みおすすめに対するアクセス、作成、削除を行うことができます。「すべてのデータの編集」権限を持つユーザも、おすすめ利用者、おすすめ定義、およびスケジュール済みおすすめに対するアクセス、作成、削除を行うことができます。これらのおすすめは、Salesforce1 モバイルブラウザアプリケーションのコミュニティのフィードに直接表示されます。また、デフォルトでホームページの右側と、コミュニティマネージャがコミュニティビルダーでSummer '15 以降のバージョンの Napili テンプレートを使用して追加した場所にも表示されます。

411

Recommendation Audience ResourcesChatter REST API リソース


説明リソース

おすすめ利用者のリストを取得し、おすすめ利用者を作成します。

/connect/recommendation-audiences

おすすめ利用者の情報取得、更新、または削除を行います。

/connect/recommendation-audiences/recommendationAudienceId

おすすめ利用者のメンバーを取得します。/connect/recommendation-audiences/recommendationAudienceId/members


Recommendation Audiences

おすすめ利用者のリストを取得し、おすすめ利用者を作成します。Recommendation Audience

おすすめ利用者の情報取得、更新、または削除を行います。Recommendation Audience Members

おすすめ利用者のメンバーを取得します。

Recommendation Audiencesおすすめ利用者のリストを取得し、おすすめ利用者を作成します。コミュニティマネージャ (「コミュニティの作成および設定」または「コミュニティの管理」権限を持つユーザ) は、コミュニティのおすすめ利用者、おすすめ定義、およびスケジュール済みおすすめに対するアクセス、作成、削除を行うことができます。「すべてのデータの編集」権限を持つユーザも、おすすめ利用者、おすすめ定義、およびスケジュール済みおすすめに対するアクセス、作成、削除を行うことができます。これらのおすすめは、Salesforce1 モバイルブラウザアプリケーションのコミュニティのフィードに直接表示されます。また、デフォルトでホームページの右側と、コミュニティマネージャがコミュニティビルダーでSummer '15 以降のバージョンの Napili テンプレートを使用して追加した場所にも表示されます。リソース

/connect/recommendation-audiences

/connect/communities/communityId/recommendation-audiences




412

Recommendation AudiencesChatter REST API リソース





35.0省略可能開始値 0 でページ番号にインデックスを付けます。指定されていな

Integerpage

い場合、ページ 0 が使用されます。

35.0省略可能ページあたりの項目数。デフォルトは 25 です。

IntegerpageSize

GET のレスポンスボディRecommendation Audience Collection


<recommendationAudience>

おすすめ利用者を作成する JSON 例{


プロパティ



説明型名前

35.0おすすめ利用者を更新する場合は必須おすすめ利用者の作成では

利用者メンバーに対して実行する操作。値は次のとおりです。

StringmemberOperationType

• Add — 指定されたメンバーを利用者に追加します。

• Remove — 指定されたメンバーを利用者から削除します。

null を使用または指定しないでください


ユーザ ID のコレクション。利用者を更新する場合、最大50,000 人のメンバーを含めることができます。利用者には最大100,000 人のメンバーを含めるこ

User ID CollectionInput

members

null を使用まとができ、各コミュニティには最

413

Recommendation AudiencesChatter REST API リソース



説明型名前

大 10,000 人の利用者を含めることができます。

たは指定しないでください

35.0おすすめ利用者を更新する場合は省略可能おすすめ利用者を作成する場合は必須

おすすめ利用者の一意の名前。Stringname





35.0必須項目おすすめ利用者の一意の名前。Stringname

POST のレスポンスボディRecommendation Audience

関連トピック:


Recommendation Audienceおすすめ利用者の情報取得、更新、または削除を行います。コミュニティマネージャ (「コミュニティの作成および設定」または「コミュニティの管理」権限を持つユーザ) は、コミュニティのおすすめ利用者、おすすめ定義、およびスケジュール済みおすすめに対するアクセス、作成、削除を行うことができます。「すべてのデータの編集」権限を持つユーザも、おすすめ利用者、おすすめ定義、およびスケジュール済みおすすめに対するアクセス、作成、削除を行うことができます。これらのおすすめは、Salesforce1 モバイルブラウザアプリケーションのコミュニティのフィードに直接表示されます。また、デフォルトでホームページの右側と、コミュニティマネージャがコミュニティビルダーでSummer '15 以降のバージョンの Napili テンプレートを使用して追加した場所にも表示されます。リソース

/connect/recommendation-audiences/recommendationAudienceId

/connect/communities/communityId/recommendation-audiences/recommendationAudienceId


414

Recommendation AudienceChatter REST API リソース


HTTP メソッドGET、HEAD、DELETE、PATCH

GET のレスポンスボディRecommendation Audience



おすすめ利用者を更新する JSON 例{



},"name" : "New Hires"

}

プロパティ



説明型名前





• Remove — 指定されたメンバーを利用者から削除します。

null を使用または指定しないでください


ユーザ ID のコレクション。利用者を更新する場合、最大50,000 人のメンバーを含めることができます。利用者には最大100,000 人のメンバーを含めるこ


members

null を使用まとができ、各コミュニティには最大 10,000 人の利用者を含めることができます。


415

Recommendation AudienceChatter REST API リソース



説明型名前







35.0必須項目おすすめ利用者の一意の名前。Stringname

PATCH のレスポンスボディRecommendation Audience


関連トピック:


Recommendation Audience Membersおすすめ利用者のメンバーを取得します。コミュニティマネージャ (「コミュニティの作成および設定」または「コミュニティの管理」権限を持つユーザ) は、コミュニティのおすすめ利用者、おすすめ定義、およびスケジュール済みおすすめに対するアクセス、作成、削除を行うことができます。「すべてのデータの編集」権限を持つユーザも、おすすめ利用者、おすすめ定義、およびスケジュール済みおすすめに対するアクセス、作成、削除を行うことができます。これらのおすすめは、Salesforce1 モバイルブラウザアプリケーションのコミュニティのフィードに直接表示されます。また、デフォルトでホームページの右側と、コミュニティマネージャがコミュニティビルダーでSummer '15 以降のバージョンの Napili テンプレートを使用して追加した場所にも表示されます。リソース

/connect/recommendation-audiences/recommendationAudienceId/members

/connect/communities/communityId/recommendation-audiences/recommendationAudienceId/members


416

Recommendation Audience MembersChatter REST API リソース







35.0省略可能開始値 0 でページ番号にインデックスを付けます。指定されていな

Integerpage

い場合、ページ 0 が使用されます。

35.0省略可能ページあたりの項目数。デフォルトは 25 です。

IntegerpageSize

GET のレスポンスボディUser Reference Collection

おすすめ定義リソース

おすすめ定義を使用すると、コミュニティに表示されるカスタムおすすめを作成して、ユーザに動画の閲覧やトレーニングの受講などを促すことができます。これらのリソースは、おすすめ定義の情報取得、作成、変更、削除に使用します。また、おすすめ定義の写真の情報取得、アップロード、変更、および削除にも使用します。コミュニティマネージャ (「コミュニティの作成および設定」または「コミュニティの管理」権限を持つユーザ) は、コミュニティのおすすめ利用者、おすすめ定義、およびスケジュール済みおすすめに対するアクセス、作成、削除を行うことができます。「すべてのデータの編集」権限を持つユーザも、おすすめ利用者、おすすめ定義、およびスケジュール済みおすすめに対するアクセス、作成、削除を行うことができます。これらのおすすめは、Salesforce1 モバイルブラウザアプリケーションのコミュニティのフィードに直接表示されます。また、デフォルトでホームページの右側と、コミュニティマネージャがコミュニティビルダーでSummer '15 以降のバージョンの Napili テンプレートを使用して追加した場所にも表示されます。使用可能なリソース:

説明リソース

おすすめ定義のリストの取得、おすすめ定義の作成を行います。

/connect/recommendation-definitions

おすすめ定義に関する情報の取得、おすすめ定義の変更または削除を行います。

/connect/recommendation-definitions/recommendationDefinitionId

417

おすすめ定義リソースChatter REST API リソース

説明リソース

おすすめ定義の写真に情報取得、アップロード、変更または削除を行います。


Recommendation Definitionsおすすめ定義のリストの取得、おすすめ定義の作成を行います。コミュニティマネージャ (「コミュニティの作成および設定」または「コミュニティの管理」権限を持つユーザ) は、コミュニティのおすすめ利用者、おすすめ定義、およびスケジュール済みおすすめに対するアクセス、作成、削除を行うことができます。「すべてのデータの編集」権限を持つユーザも、おすすめ利用者、おすすめ定義、およびスケジュール済みおすすめに対するアクセス、作成、削除を行うことができます。これらのおすすめは、Salesforce1 モバイルブラウザアプリケーションのコミュニティのフィードに直接表示されます。また、デフォルトでホームページの右側と、コミュニティマネージャがコミュニティビルダーでSummer '15 以降のバージョンの Napili テンプレートを使用して追加した場所にも表示されます。リソース

/connect/recommendation-definitions

/connect/communities/communityId/recommendation-definitions




POST のリクエストボディJSON の例

{"actionUrl" : "https://www.example.com","actionUrlName" : "Launch","explanation" : "Click this link to learn more!","name" : "Corporate Training Project","title" : "Want to learn more about Corporate Training Project?"}

プロパティ



説明型名前

33.0必須項目おすすめに基づいて行動するための URL （グループに参加するための URL など）。

StringactionUrl

418

Recommendation DefinitionsChatter REST API リソース



説明型名前

34.0必須項目ユーザインターフェースのアクション URL のテキストラベル("Launch" など)。

StringactionUrlName

33.0必須項目おすすめの説明 (本文)。Stringexplanation

33.0必須項目おすすめ定義の名前。この名前が[設定] に表示されます。

Stringname

33.0省略可能おすすめ定義のタイトル。Stringtitle





33.0必須項目おすすめに基づいて行動するための URL （グループに参加するための URL など）。

StringactionUrl

34.0必須項目ユーザインターフェースのアクション URL のテキストラベル("Launch" など)。

StringactionUrlName

33.0必須項目おすすめの説明 (本文)。Stringexplanation

33.0必須項目おすすめ定義の名前。この名前が[設定] に表示されます。

Stringname


POST のレスポンスボディRecommendation Definition

GET のレスポンスボディRecommendation Definition Collection

関連トピック:


Recommendation Definitionおすすめ定義に関する情報の取得、おすすめ定義の変更または削除を行います。コミュニティマネージャ (「コミュニティの作成および設定」または「コミュニティの管理」権限を持つユーザ) は、コミュニティのおすすめ利用者、おすすめ定義、およびスケジュール済みおすすめに対するアクセス、

419

Recommendation DefinitionChatter REST API リソース

作成、削除を行うことができます。「すべてのデータの編集」権限を持つユーザも、おすすめ利用者、おすすめ定義、およびスケジュール済みおすすめに対するアクセス、作成、削除を行うことができます。これらのおすすめは、Salesforce1 モバイルブラウザアプリケーションのコミュニティのフィードに直接表示されます。また、デフォルトでホームページの右側と、コミュニティマネージャがコミュニティビルダーでSummer '15 以降のバージョンの Napili テンプレートを使用して追加した場所にも表示されます。リソース

/connect/recommendation-definitions/recommendationDefinitionId

/connect/communities/communityId/recommendation-definitions/recommendationDefinitionId




PATCH のリクエストボディJSON の例


プロパティ



説明型名前

33.0省略可能おすすめに基づいて行動するための URL （グループに参加するための URL など）。

StringactionUrl

34.0省略可能ユーザインターフェースのアクション URL のテキストラベル("Launch" など)。

StringactionUrlName

33.0省略可能おすすめの説明 (本文)。Stringexplanation

33.0省略可能おすすめ定義の名前。この名前が[設定] に表示されます。

Stringname


420

Recommendation DefinitionChatter REST API リソース





33.0省略可能おすすめに基づいて行動するための URL （グループに参加するための URL など）。

StringactionUrl

34.0省略可能ユーザインターフェースのアクション URL のテキストラベル("Launch" など)。

StringactionUrlName

33.0省略可能おすすめの説明 (本文)。Stringexplanation

33.0省略可能おすすめ定義の名前。この名前が[設定] に表示されます。

Stringname


GET および PATCH のレスポンスボディRecommendation Definition


Recommendation Definition Photoおすすめ定義の写真に情報取得、アップロード、変更または削除を行います。コミュニティマネージャ (「コミュニティの作成および設定」または「コミュニティの管理」権限を持つユーザ) は、コミュニティのおすすめ利用者、おすすめ定義、およびスケジュール済みおすすめに対するアクセス、作成、削除を行うことができます。「すべてのデータの編集」権限を持つユーザも、おすすめ利用者、おすすめ定義、およびスケジュール済みおすすめに対するアクセス、作成、削除を行うことができます。これらのおすすめは、Salesforce1 モバイルブラウザアプリケーションのコミュニティのフィードに直接表示されます。また、デフォルトでホームページの右側と、コミュニティマネージャがコミュニティビルダーでSummer '15 以降のバージョンの Napili テンプレートを使用して追加した場所にも表示されます。[ファイル] ページからの画像をおすすめ定義の写真 (既存のコンテンツ) として使用するには、リクエストボディの fileId プロパティまたは fileId 要求パラメータでファイル ID を渡します。バイナリファイルをおすすめ定義の写真としてアップロードするには、マルチパート/フォームデータメッセージでそのファイルを送信する必要があります。マルチパート/フォームデータメッセージを作成する方法についての詳細は、「バイナリファイルのアップロード」を参照してください。リソース



421

Recommendation Definition PhotoChatter REST API リソース


HTTP メソッドGET、HEAD、PUT、DELETE

PUT のリクエストボディルート XML タグ

<photo>



}

プロパティ





IntegercropSize




IntegercropX





IntegercropY






StringfileId




422





PUT の要求パラメータ





IntegercropSize




IntegercropX





IntegercropY






StringfileId


メモ: [グループ] ページおよび [ユーザプロファイル] ページでアップロードしたファイルにはファイル ID は含まれず、投

423




稿やトリミングはできません。[ファイル] ページでアップロードしたファイルにはファイルID は含まれず、投稿やトリミングはできません。





GET および PUT のレスポンスボディPhoto

関連トピック:


Records リソース

レコードをフォローしている人に関する情報を取得します。レコードに対するトピックの追加や削除を行います。次のリソースを使用できます。


Followers on Records リソース指定されたレコードをフォローしている人に関する情報を取得します。

424

Records リソースChatter REST API リソース

Topics on Records リソースレコードまたはフィード項目に割り当てられたトピック。レコードまたはフィード項目に割り当てられたトピックに関する情報を取得し、レコードまたはフィード項目のトピックを追加、削除、置換します。レコードまたはフィード項目からトピックを削除したり、レコードまたはフィード項目に既存のトピックを追加できるのは、「トピックの割り当て」権限を持つユーザのみです。レコードまたはフィード項目に新規のトピックを追加できるのは、「トピックの作成」権限を持つユーザのみです。ユーザがオブジェクト種別のレコードにトピックを追加できるようにするには、事前にシステム管理者がそのオブジェクトでトピックを有効化しておく必要があります。

関連トピック:

Record Feed リソース

Followers on Records リソース指定されたレコードをフォローしている人に関する情報を取得します。リソース

/chatter/records/recordId/followers

/connect/communities/communityId/chatter/records/recordId/followers

バージョン 29.0 では、recordId にトピック ID を使用できます。適用開始バージョン

23.0





項目のページを指定する整数。デフォルト値は 0 で、最初のページを返します。

Integerpage


IntegerpageSize


レスポンスボディSubscription Page

425

Followers on Records リソースChatter REST API リソース

Topics on Records リソースレコードまたはフィード項目に割り当てられたトピック。レコードまたはフィード項目に割り当てられたトピックに関する情報を取得し、レコードまたはフィード項目のトピックを追加、削除、置換します。レコードまたはフィード項目からトピックを削除したり、レコードまたはフィード項目に既存のトピックを追加できるのは、「トピックの割り当て」権限を持つユーザのみです。レコードまたはフィード項目に新規のトピックを追加できるのは、「トピックの作成」権限を持つユーザのみです。ユーザがオブジェクト種別のレコードにトピックを追加できるようにするには、事前にシステム管理者がそのオブジェクトでトピックを有効化しておく必要があります。リソース

/connect/records/recordId/topics

/connect/communities/communityId/records/recordId/topics



HTTP メソッドGET、DELETE、POST、PUT

PUT はバージョン 35.0 以降でサポートされます。DELETE の要求パラメータ



30.0必須項目既存のトピックの IDStringtopicId



<topicAssignment>

JSON

次の例では、トピックをレコードに割り当てます。{ "topicId": "0TOD0000000090r"}

426

Topics on Records リソースChatter REST API リソース

プロパティ






新規または既存のトピックの名前。

StringtopicName





30.0topicName パラメータが使用されて


いない場合、既存のトピックに必要です。

30.0新規のトピック、および topicId パラ

新規または既存のトピックの名前

StringtopicName

メータが使用されていない場合の既存のトピックに必要です。


POST の例この例では、既存のトピックの ID を topidId パラメータで渡して商談レコードに関連付けます。POST /connect/records/006D000000CtYBc/topics?topicId=0TOD0000000090r

PUT のリクエストボディPUT 要求は、レコードまたはフィード項目のすべてのトピックを再割り当てします。つまり、レコードまたはフィード項目のすべての割り当て済みトピックを異なるトピックで置換します。ルート XML タグ

<topicNamesCollection>

427

Topics on Records リソースChatter REST API リソース

JSON の例{ "topicNames": ["API", "Chatter REST API", "ConnectApi"]}

プロパティ



説明型名前

35.0必須項目フィード項目の最大 10 個のトピック名を含むリスト、またはレ

String []topicNames

コードの最大 100 個のトピック名を含むリスト。

PUT のレスポンスボディTopic Collection

スケジュール済みおすすめリソース

スケジュール済みおすすめに関する情報の取得、スケジュール済みおすすめの作成、変更、削除を行います。コミュニティマネージャ (「コミュニティの作成および設定」または「コミュニティの管理」権限を持つユーザ) は、コミュニティのおすすめ利用者、おすすめ定義、およびスケジュール済みおすすめに対するアクセス、作成、削除を行うことができます。「すべてのデータの編集」権限を持つユーザも、おすすめ利用者、おすすめ定義、およびスケジュール済みおすすめに対するアクセス、作成、削除を行うことができます。これらのおすすめは、Salesforce1 モバイルブラウザアプリケーションのコミュニティのフィードに直接表示されます。また、デフォルトでホームページの右側と、コミュニティマネージャがコミュニティビルダーでSummer '15 以降のバージョンの Napili テンプレートを使用して追加した場所にも表示されます。使用可能なリソース:

説明リソース

スケジュール済みおすすめのリストの取得、スケジュール済みおすすめの作成を行います。

/connect/scheduled-recommendations

スケジュール済みおすすめに関する情報の取得、スケジュール済みおすすめの更新または削除を行います。

/connect/scheduled-recommendations/scheduledRecommendationId

スケジュール済みおすすめスケジュール済みおすすめのリストの取得、スケジュール済みおすすめの作成を行います。コミュニティマネージャ (「コミュニティの作成および設定」または「コミュニティの管理」権限を持つユーザ) は、コミュニティのおすすめ利用者、おすすめ定義、およびスケジュール済みおすすめに対するアクセス、

428

スケジュール済みおすすめリソースChatter REST API リソース

作成、削除を行うことができます。「すべてのデータの編集」権限を持つユーザも、おすすめ利用者、おすすめ定義、およびスケジュール済みおすすめに対するアクセス、作成、削除を行うことができます。これらのおすすめは、Salesforce1 モバイルブラウザアプリケーションのコミュニティのフィードに直接表示されます。また、デフォルトでホームページの右側と、コミュニティマネージャがコミュニティビルダーでSummer '15 以降のバージョンの Napili テンプレートを使用して追加した場所にも表示されます。リソース

/connect/scheduled-recommendations

/connect/communities/communityId/scheduled-recommendations




POST のリクエストボディ新しいスケジュール済みおすすめを作成する JSON の例

{"rank" : "2","recommendationDefinitionId" : "0RDD00000004CEhOAM"}

既存のスケジュール済みおすすめを更新する JSON の例{ "rank" : "2"}

プロパティ



説明型名前

34.0省略可能スケジュールが有効になっているかどうかを示します。trueの場

Booleanenabled

合、おすすめが有効になり、コミュニティに表示されます。false の場合、Salesforce1 モバイルブラウザアプリケーションでのフィードのおすすめは削除されませんが、新しいおすすめは表示されなくなります。Summer '15 以降のバージョンの Napili テンプレートを使用したコミュニティでは、無効にしたおすすめは表示されなくなります。

429

スケジュール済みおすすめChatter REST API リソース



説明型名前

33.0省略可能スケジュール済みおすすめの相対的なランク。1 から開始する昇順の整数で示されます。ランクを設定することと、順序付きリストに挿入することは同じで

Integerrank

す。スケジュール済みおすすめは、rankで指定された位置に挿入されます。それ以降のすべてのスケジュール済みおすすめのrank が 1 つずつ下がります。「スケジュール済みおすすめにランクを付ける場合の例」を参照してください。指定された rankがリストのサイズよりも大きい場合は、スケジュール済みおすすめがリストの末尾に配置されます。スケジュール済みおすすめの rankには、指定された値の代わりにリストのサイズが指定されます。rank が指定されていない場合は、スケジュール済みおすすめがリストの末尾に配置されます。

35.0省略可能このスケジュール済みおすすめの利用者の ID。スケジュール済みおすすめを更新する場合、おすすめ利用者とスケ

StringrecommendationAudienceId

ジュール済みおすすめ間の関連付けを削除するには、ALL を指定します。

33.0スケジュール済みおすすめを作

このスケジュール済みおすすめによってスケジュールされたおすすめ定義の ID。

StringrecommendationDefinitionId

成する場合は必須です。既存のスケジュール済みおすすめを更新する場合は、recommendation

430




説明型名前

DefinitionId

を指定できません。





34.0省略可能スケジュールが有効になっているかどうかを示します。true の場

Booleanenabled

合、おすすめが有効になり、コミュニティに表示されます。falseの場合、Salesforce1 モバイルブラウザアプリケーションでのフィードのおすすめは削除されませんが、新しいおすすめは表示されなくなります。Summer '15 以降のバージョンの Napili テンプレートを使用したコミュニティでは、無効にしたおすすめは表示されなくなります。


Integerrank

す。スケジュール済みおすすめは、rank で指定された位置に挿入されます。それ以降のすべてのスケジュール済みおすすめのrank

が 1 つずつ下がります。「スケジュール済みおすすめにランクを付ける場合の例」を参照してください。指定された rank がリストのサイズよりも大きい場合は、スケジュール済みおすすめがリストの末尾に配置されます。スケジュール済みおすすめの rank には、指

431





定された値の代わりにリストのサイズが指定されます。rankが指定されていない場合は、スケジュール済みおすすめがリストの末尾に配置されます。

35.0省略可能このスケジュール済みおすすめの利用者の ID。


33.0必須項目このスケジュール済みおすすめによってスケジュールされたおすすめ定義の ID。


POST のレスポンスボディスケジュール済みおすすめ

GET のレスポンスボディScheduled Recommendation Collection

関連トピック:


Scheduled Recommendationスケジュール済みおすすめに関する情報の取得、スケジュール済みおすすめの更新または削除を行います。コミュニティマネージャ (「コミュニティの作成および設定」または「コミュニティの管理」権限を持つユーザ) は、コミュニティのおすすめ利用者、おすすめ定義、およびスケジュール済みおすすめに対するアクセス、作成、削除を行うことができます。「すべてのデータの編集」権限を持つユーザも、おすすめ利用者、おすすめ定義、およびスケジュール済みおすすめに対するアクセス、作成、削除を行うことができます。これらのおすすめは、Salesforce1 モバイルブラウザアプリケーションのコミュニティのフィードに直接表示されます。また、デフォルトでホームページの右側と、コミュニティマネージャがコミュニティビルダーでSummer '15 以降のバージョンの Napili テンプレートを使用して追加した場所にも表示されます。リソース

/connect/scheduled-recommendations/scheduledRecommendationId

/connect/communities/communityId/scheduled-recommendations/scheduledRecommendationId



432

Scheduled RecommendationChatter REST API リソース


PATCH のリクエストボディ新しいスケジュール済みおすすめを作成する JSON の例



プロパティ



説明型名前

34.0省略可能スケジュールが有効になっているかどうかを示します。trueの場

Booleanenabled



Integerrank

す。スケジュール済みおすすめは、rankで指定された位置に挿入されます。それ以降のすべてのスケジュール済みおすすめのrank が 1 つずつ下がります。「スケジュール済みおすすめにランクを付ける場合の例」を参照してください。指定された rankがリストのサイズよりも大きい場合は、スケ

433




説明型名前

ジュール済みおすすめがリストの末尾に配置されます。スケジュール済みおすすめの rankには、指定された値の代わりにリストのサイズが指定されます。rank が指定されていない場合は、スケジュール済みおすすめがリストの末尾に配置されます。







成する場合は必須です。既存のスケジュール済みおすすめを更新する場合は、recommendationDefinitionId







Booleanenabled

合、おすすめが有効になり、コミュニティに表示されます。falseの場合、Salesforce1 モバイルブラウザアプリケーションでの

434





フィードのおすすめは削除されませんが、新しいおすすめは表示されなくなります。Summer '15 以降のバージョンの Napili テンプレートを使用したコミュニティでは、無効にしたおすすめは表示されなくなります。


Integerrank


が 1 つずつ下がります。「スケジュール済みおすすめにランクを付ける場合の例」を参照してください。指定された rank がリストのサイズよりも大きい場合は、スケジュール済みおすすめがリストの末尾に配置されます。スケジュール済みおすすめの rank には、指定された値の代わりにリストのサイズが指定されます。rankが指定されていない場合は、スケジュール済みおすすめがリストの末尾に配置されます。




435


PATCH のレスポンスボディスケジュール済みおすすめ





35.0省略可能true の場合、おすすめ定義の最後のスケジュール済みおすすめに

BooleandeleteDefinitionIfLast

対して DELETE 要求を行うと、おすすめ定義が削除されます。デフォルトは false です。

DELETE のレスポンスボディ204: DELETE が成功しましたスケジュール済みおすすめの削除は、順序付きリストでの削除に相当します。スケジュール済みおすすめを削除すると、削除されたものの後にあるすべてのスケジュール済みおすすめが自動的に上位に順位付けされます。

Subscriptions リソース

指定された登録に関する情報。登録の削除 (レコードまたはトピックのフォロー解除など) にも使用されます。登録 ID は、follower リソースと following リソースのレスポンスボディの一部として返されます。たとえば、/records/recordId/followersのようになります。さらに、登録 ID は、グループサマリーやユーザサマリーなど、多くのサマリーレスポンスボディでも返されます。リソース

/chatter/subscriptions/subscriptionId

/connect/communities/communityId/chatter/subscriptions/subscriptionId




GET のレスポンスボディSubscription

関連トピック:

レコードのフォローを停止する

436

Subscriptions リソースChatter REST API リソース

Topics リソース

組織のトピックのリスト、指定されたテキスト文字列、フィード項目、またはレコードの推奨トピックのリスト、組織のトピックのトレンドのリスト、指定されたトピックに関する情報、指定されたトピックの支持、指定されたトピックに最近投稿されたファイルに関する情報、指定されたトピックに最近投稿したグループに関する情報、指定されたトピックに関する知識のあるユーザ、および指定されたトピックに関連するトピックのリスト。使用可能なリソース:

説明リソース

組織のトピックのリスト。/connect/topics

指定されたトピックに関する情報。トピックに関する情報の取得、トピックの名前または説明の更新、トピックのマージおよび削除を行います。

/connect/topics/topicId

指定されたテキスト文字列、フィード項目、またはレコードの推奨トピックのリスト。

/connect/topics/suggestions

組織のトピックのトレンド上位 5 つのリスト。/connect/topics/trending

指定されたトピックに関する知識のあるユーザへの支持。指定されたトピックに関する支持の取得、および

/connect/topics/topicId/endorsements

指定されたトピックに関するユーザへの支持を行います。

支持。支持に関する情報の取得と、支持の削除を行います。

/connect/topic-endorsements/endorsementId

指定されたトピックに最近投稿された 5 つのファイルに関する情報を返します。

/connect/topics/topicId/files

指定されたトピックに最近投稿した 5 つのグループに関する情報を返します。

/connect/topics/topicId/groups

トピックに関する知識のあるユーザ。指定されたトピックに関する知識のあるユーザのリストを取得します。

/connect/topics/topicId/knowledgeable-users

指定されたトピックへの関連性が最も強い 5 つのトピックのリスト。

/connect/topics/topicId/related-topics

トピックからの除外。指定されたトピックについてトピックからの除外のリストを取得します。指定された

/connect/topics/topicId/topic-opt-outs

トピックの [知識のあるユーザ] リストで自分を非表示にします。

トピックからの除外。[知識のあるユーザ] リストで自分を非表示にした後、再度表示します。

/connect/topic-opt-outs/topicOptOutId

437

Topics リソースChatter REST API リソース

List of Topics組織のトピックのリスト。リソース

/connect/topics

/connect/communities/communityId/topics


バージョン 28.0 では、/chatter/topics を使用します。Chatter が必要かどうか


GET または HEAD




28.0省略可能大文字と小文字を含め、完全一致する名

BooleanexactMatch

前でトピックを検索する場合は、true

を指定し、q パラメータと一緒に使用します。完全一致がない場合に最近名前が変更されたトピックから一致するものを検索する場合は、true を指定し、q

パラメータおよびtrue に設定されたfallBackToRenamed

Topicsパラメータと一緒に使用します。デフォルト値はfalse です。

35.0省略可能qパラメータおよびtrue に設定された

BooleanfallBackToRenamedTopics

exactMatch パラメータと一緒に使用します。完全一致が

438

List of TopicsChatter REST API リソース



なく、fallBackToRenamed

Topics が true に設定されている場合は、最近名前が変更されたトピックから一致するものが返されます。一致する名前が変更されたトピックが複数ある場合は、最新のもののみが返されます。名前が変更されたトピックに一致するものがない場合は、空のコレクションが返されます。

28.0省略可能トピックのページを指定する 0 より大き

Integerpage

い整数。デフォルト値は、0 です。

28.0省略可能ページあたりの項目数を指定します。有

IntegerpageSize

効な値は 1 ～ 100 です。デフォルト値は25 です。

28.0省略可能結果を絞り込むクエリ文字列。文字列に

Stringq

はワイルドカード文字を除いて 2 文字以上が含まれている必要があります。

28.0省略可能次のいずれかの値になります。

Stringsort

• popularDesc:

トピックを人気順に並び替えます。この値がデフォルトです。

439

List of TopicsChatter REST API リソース



• alphaAsc: トピックをアルファベット順に並び替えます。


GET の例この例では、アルファベット順に並び替えられたトピックのリストを要求します。/connect/topics?sort=alphaAsc

Topics Suggestions指定されたテキスト文字列、フィード項目、またはレコードの推奨トピックのリスト。リソース

/connect/topics/suggestions

/connect/communities/communityId/topics/suggestions


バージョン 28.0 では、/chatter/topics/suggestions を使用します。Chatter が必要かどうか


GET または HEAD



省略可能返される推奨トピックの最大数。デフォルト値は

IntegermaxResults

5 です。値は 1 以上 25 以下で指定する必要があります。

text パラメータが使用されていない場合に必要です。

トピックの抽出元になるフィード項目またはレコードの18 文字の ID。オブジェクト種別のレコー

StringrecordId

440

Topics SuggestionsChatter REST API リソース


ドについてトピックの提案を表示するには、システム管理者がそのオブジェクトでトピックを有効化しておく必要があります。オブジェクトのトピックは、バージョン30.0 で使用できます。

recordId パラメータが使用されていない場合に必要です。

トピックの抽出元のテキスト。

Stringtext

レスポンスボディTopic Suggestion Collection

GET の例この例では、テキスト “Working on the planning meeting for our new initiative.” について推奨トピックを取得します。/connect/topics/suggestions?text=Working+on+the+planning+meeting+for+our+new+initiative.

Trending Topics組織のトピックのトレンド上位 5 つのリスト。ユーザが投稿やコメントの中で特定のトピックを追加したり、同じトピックの投稿にコメントしたりいいね!

と言う頻度が短時間で高くなるほど、トレンドトピックになる可能性が高まります。たとえば、同僚が近々Dreamforce の会議に出席することになっており、Chatter でそれについての議論を開始すると、「Dreamforce」がトピックのトレンドとして表示されます。トピックのトレンドは、人気度のみに基づくのではなく、通常は、会議やプロジェクトの期限など、活動の急な増加を伴う、頻繁には行われない 1 回限りの行動に関連するトピックが表示されます。

メモ: API バージョン 28.0 以前では、トピックはハッシュタグ (#) で開始していました。

リソース/connect/topics/trending

/connect/communities/communityId/topics/trending


バージョン 24.0 ～ 28.0 では、/chatter/topics/trending および/connect/communities/communityId/chatter/topics/trending を使用します。

441

Trending TopicsChatter REST API リソース




説明値パラメータ名

返されるトピックのトレンドの最大数。デフォルト値は 5 です。値

IntegermaxResults

は 1 以上 100 未満で指定する必要があります。


レスポンスボディの例 (バージョン 28.0 以降)。{"currentPageUrl" : "/services/data/v35.0/connect/topics/trending?maxResults=5","nextPageUrl" : null,"topics" : [

{"createdDate": "2013-01-01T20:43:31.000Z","id" : "0TOD0000000090qOAA","description" : "Application Programming Interface","talkingAbout" : 527,"name" : "API","url": "/services/data/v35.0/connect/topics/0TOD0000000090qOAA"

},{

"createdDate": "2012-11-14T05:24:23.000Z","id" : "0TOD000000006RxOAI","description" : "The cloud computing event of the year.","talkingAbout" : 424,"name" : "Dreamforce","url": "/services/data/v35.0/connect/topics/0TOD000000006RxOAI"

},{

"createdDate": "2013-02-25T10:47:51.000Z","id" : "0TOD0000000090rOAA","description" : "All things related to mobile.","talkingAbout" : 87,"name" : "Mobile","url": "/services/data/v35.0/connect/topics/0TOD0000000090rOAA"

}]}

レスポンスボディの例 (バージョン 24.0 ～ 27.0)

{"topics" : [{

442

Trending TopicsChatter REST API リソース

"name" : "#API"},{

"name" : "#Dreamforce"},{

"name" : "#Mobile"}

]}

Topic指定されたトピックに関する情報。トピックに関する情報の取得、トピックの名前または説明の更新、トピックのマージおよび削除を行います。「トピックを編集」または「すべてのデータの編集」権限を持つユーザは、トピックの名前および説明を編集できます。「トピックの削除」または「すべてのデータの編集」権限を持つユーザは、トピックをマージおよび削除できます。リソース

/connect/topics/topicId

/connect/communities/communityId/topics/topicId


バージョン 28.0 では、/chatter/topics/topicId を使用します。Chatter が必要かどうか


GET、PATCH、DELETE、および HEAD


<topic>

JSON

{"description" : "World Wide Web Consortium (W3C) is the main international standards

organization for the Web.""name" : "W3C"}

プロパティ


28.0トピックのテキストによる説明

Stringdescription

443

TopicChatter REST API リソース


33.0トピックにマージする最大 5 個のトピック ID のリスト。

String []idsToMerge

28.0トピックの名前トピック名の大文字、小文字、スペースのみを変

Stringname

更するには、このプロパティを使用します。



28.0トピックのテキストによる説明Stringdescription


String []idsToMerge

28.0トピックの名前トピック名の大文字、小文字、スペースのみを変更するには、このプロパティを使用します。

Stringname

GET、HEAD、または PATCH のレスポンスボディTopic

DELETE のレスポンスボディ204: DELETE が成功しましたトピックの削除は非同期です。削除の完了前にトピックを要求した場合、応答は200: Successfulになり、バージョン 33.0 以降では Topic 出力の isBeingDeletedプロパティが trueになります。削除の完了後にトピックを要求した場合、応答は 404: Not found になります。

PATCH の例この例では、要求パラメータを使用してトピックの説明を更新します。/connect/topics/0TOD000000006RxOAI?description=Edit+requests

これは、同じ要求に JSON リクエストボディを使用しています。/connect/topics/0TOD000000006RxOAI

{"description" : "Edit requests"

}

444

TopicChatter REST API リソース

Topics, Endorse People指定されたトピックに関する知識のあるユーザへの支持。指定されたトピックに関する支持の取得、および指定されたトピックに関するユーザへの支持を行います。リソース

/connect/topics/topicId/endorsements

/connect/communities/communityId/topics/topicId/endorsements





適用開始バージョン必須項目/省略可能説明型パラメータ名

31.0省略可能支持を受け取ったユーザの ID を指定します。

StringendorseeId

31.0省略可能他のユーザを支持したユーザの ID を指定します。

StringendorserId

30.0省略可能支持のページを指定する 0 より大きい整

Integerpage

数。デフォルト値は、0 です。


IntegerpageSize



<topicEndorsement>

JSON

{"userId" : "005B0000000Ge16"

}

445

Topics, Endorse PeopleChatter REST API リソース

プロパティ



30.0必須項目指定したトピックについて支持されるユーザの ID。

StringuserId



30.0支持するユーザの IDStringuserId

GET のレスポンスボディTopic Endorsement Collection

POST のレスポンスボディTopic Endorsement

Topic Endorsements支持。支持に関する情報の取得と、支持の削除を行います。リソース

/connect/topic-endorsements/endorsementId

/connect/communities/communityId/topic-endorsements/endorsementId



HTTP メソッドGET、HEAD、DELETE

GET のレスポンスボディTopic Endorsement


DELETE の例トピックについて他のユーザを支持すると、キープレフィックス 0enの支持レコードが作成されます。支持を削除するには、この支持レコードを削除します。DELETE /connect/topic-endorsements/0enD0000000003UIAQ

446

Topic EndorsementsChatter REST API リソース

次にレスポンスボディを示します。HTTP 204

Topic Files指定されたトピックに最近投稿された 5 つのファイルに関する情報を返します。リソース

/connect/topics/topicId/files

/connect/communities/communityId/topics/topicId/files


バージョン 28.0 では、/chatter/topics/topicId/files を使用します。Chatter が必要かどうか


GET または HEAD


レスポンスボディの例この GET 要求は、指定されたトピックのすべてのファイルに関する情報を返します。/connect/topics/0TOD000000009Q2/files

応答は次のようになります。{

"currentPageUrl": null,"files": [{

"checksum": "a65b71bc6a31fa95dd0a9232c9f58c86","contentSize": 100377,"contentUrl": null,"description": null,"downloadUrl":

"/services/data/v35.0/chatter/files/069D00000001E32IAE/content?versionNumber=1","fileExtension": "png","fileType": "Png","flashRenditionStatus": "Na","id": "069D00000001E32IAE","isInMyFileSync": false,"mimeType": "image/png","modifiedDate": "2012-07-17T21:47:27.000Z","motif": {

"color": "993333","largeIconUrl": "/img/content/content64.png","mediumIconUrl": "/img/content/content32.png","smallIconUrl": "/img/icon/files16.png"

447

Topic FilesChatter REST API リソース


"id": "0E8D0000000T5JrKAK","url": "/services/data/v35.0/chatter/subscriptions/0E8D0000000T5JrKAK"

},"name": "Recruitment Poster","origin": "Chatter","owner": {

"companyName": "SeattleApps","firstName": "Rene","id": "005D0000001LFNnIAO","isActive": true,"lastName": "Holmes","motif": {

"color": "1797C0","largeIconUrl": "/img/icon/profile64.png","mediumIconUrl": "/img/icon/profile.png","smallIconUrl": "/img/icon/profile.png"

},"mySubscription": null,"name": "Rene Holmes","photo": {

"fullEmailPhotoUrl":"https://instance_name/ncsphoto/SqRfG_-PUTY6KtfOp_f0cEw-MQI3xmkJ21oNEOQ-5sZVyX4qlsJTXfOWM77RW7yt",

"largePhotoUrl": "https://instance_name/profilephoto/729D00000000BDV/F","photoVersionId": "729D00000000BDV","smallPhotoUrl": "https://instance_name/profilephoto/729D00000000BDV/T","standardEmailPhotoUrl":

"https://instance_name/ncsphoto/SqRfG_-PUTY6KtfOp_f0cEw-MQI3xmkJ21oNEOQ-5sbktFTIf9vWhFTTALJiaFz_",

"url": "/services/data/v35.0/chatter/users/005D0000001LL8OIAW/photo"},"title": null,"type": "User","url": "/services/data/v35.0/chatter/users/005D0000001LFNnIAO","userType": "Internal"

},"parentFolder" : "null","pdfRenditionStatus": "Na","renditionUrl": "/services/data/v35.0/chatter/files/069D00000001E32IAE/rendition",

"thumb120By90RenditionStatus": "Success","thumb240By180RenditionStatus": "Success","thumb720By480RenditionStatus": "Success","title": "Recruitment Poster","type": "ContentDocument","url": "/services/data/v35.0/chatter/files/069D00000001E32IAE?versionNumber=1","versionNumber": "1"

}],"nextPageUrl": null,"previousPageUrl": null

}

448

Topic FilesChatter REST API リソース

Topic Groups指定されたトピックに最近投稿した 5 つのグループに関する情報を返します。リソース

/connect/topics/topicId/groups

/connect/communities/communityId/topics/topicId/groups


バージョン 28.0 では、/chatter/topics/topicId/groups を使用します。Chatter が必要かどうか


GET または HEAD

レスポンスボディGroup Page

Topics, Knowledgeable People Listトピックに関する知識のあるユーザ。指定されたトピックに関する知識のあるユーザのリストを取得します。リソース

/connect/topics/topicId/knowledgeable-users

/connect/communities/communityId/topics/topicId/knowledgeable-users








Integerpage



IntegerpageSize

449

Topic GroupsChatter REST API リソース




レスポンスボディKnowledgeable People Collection

Related Topics指定されたトピックへの関連性が最も強い 5 つのトピックのリスト。同じフィード項目に 3 回以上割り当てられている 2 つのトピックが関連付けられます。リソース

/connect/topics/topicId/related-topics

/connect/communities/communityId/topics/topicId/related-topics


バージョン 28.0 では、/chatter/topics/topicId/relatedtopics を使用します。Chatter が必要かどうか


GET または HEAD


Topics, Opt Outs from Knowledgeable People Listトピックからの除外。指定されたトピックについてトピックからの除外のリストを取得します。指定されたトピックの [知識のあるユーザ] リストで自分を非表示にします。リソース

/connect/topics/topicId/topic-opt-outs

/connect/communities/communityId/topics/topicId/topic-opt-outs



450

Related TopicsChatter REST API リソース


GET のレスポンスボディTopic Opt Out Collection

POST のレスポンスボディTopic Opt Out

Topics, Opt Out from Knowledgeable People Listトピックからの除外。[知識のあるユーザ] リストで自分を非表示にした後、再度表示します。リソース

/connect/topic-opt-outs/topicOptOutId

/connect/communities/communityId/topic-opt-outs/topicOptOutId



HTTP メソッドGET、HEAD、DELETE

GET のレスポンスボディTopic Opt Out


DELETE の例トピックの [知識のあるユーザ] リストから自分を除外すると、キープレフィックス 0eb の Topic Opt Out レコードが作成されます。[知識のあるユーザ] リストから自分を除外した後に再度表示するには、この Topic

Opt Out レコードを削除します。DELETE /connect/topic-opt-outs/0ebD0000000003oIAA

次にレスポンスボディを示します。HTTP 204

User Profiles リソース

ユーザのプロファイルに関する詳細を返します。このユーザプロファイルデータが、プロファイルページ(Chatterプロファイルページとも呼ばれる) に入力されます。このデータには、ユーザ情報 (住所、マネージャ、電話番号など)、一部のユーザ機能 (権限)、および一連のサブタブアプリケーション (プロファイルページのカスタムタブ) が含まれます。

451

Topics, Opt Out from Knowledgeable People ListChatter REST API リソース

サブタブアプリケーションについての詳細は、help.salesforce.com で「サブタブアプリケーション」を検索してください。機能情報には、別のユーザ (件名ユーザと呼ばれる) に対するコンテキストユーザの機能に関する情報が含まれます。たとえば、コンテキストユーザが件名ユーザとチャットできるかどうかや、コンテキストユーザが件名ユーザに直接メッセージを送信できるかどうかが機能情報でわかります。件名ユーザを userIDとして指定します。リソース

/connect/user-profiles/userID

/connect/communities/communityId/user-profiles/userID




パラメータ


29.0ユーザの IDStringuserId

29.0コミュニティの IDStringcommunityId

GET のレスポンスボディUser Profile

Users リソース

ユーザをフォローしている人、ユーザのファイルやおすすめなど、ユーザに関する情報。フィード項目の post

送信と会話状況の更新にも使用されます。次のリソースを使用できます。

説明リソース

組織のすべてのユーザに関する情報を返します。

/chatter/users

コンテキストユーザまたは指定されたユーザの Chatterプロファイルに関する情報。

/chatter/users/me

452

Users リソースChatter REST API リソース

http://help.salesforce.com

説明リソース

指定されたユーザのプロファイルに関する情報を返します。

/chatter/users/batch/user_list

コンテキストユーザの非公開の会話をすべて返します。すべての会話を対象とした検索にも使用されます。

/chatter/users/me/conversations

コンテキストユーザの指定された非公開の会話に関する情報を返します。特定の会話内の検索にも使用されます。

/chatter/users/me/conversations/conversationId

指定された会話の状況を変更します。/chatter/users/me/conversations/conversationId/mark-read

コンテキストユーザまたは指定されたユーザについて未読メッセージがある会話の数を返します。

/chatter/users/me/conversations/unread-count

外部ファイルへの参照を含む、Salesforce

Files Syncへのファイルの投稿、またはユー/chatter/users/me/files/

ザが所有するファイルに関する情報の取得を行います。ユーザと共有されているファイル、ユーザがフォローしているファイル、一般的な組織ファイルは対象外です。

指定されたユーザがメンバーであるグループに投稿されたファイルに関する情報を返します。

/chatter/users/me/files/filter/groups

指定されたユーザと共有されているファイルに関する情報を返します。

/chatter/users/me/files/filter/sharedwithme

指定されたユーザをフォローしている人に関する情報を返します。

/chatter/users/me/followers

指定されたユーザがフォローしている人、グループ、レコード、トピック、

/chatter/users/me/following

ファイルに関するリストを返します。レコードのフォローにも使用されます。

指定されたユーザがメンバーであるグループ。

/chatter/users/me/groups

指定されたユーザが知識のあるトピック。指定されたユーザについてトピックのリストを取得します。

/chatter/users/me/knowledgeable-about-topics

コンテキストユーザのすべての非公開会話のすべてのメッセージを返します。す

/chatter/users/me/messages

453


説明リソース

べてのメッセージを対象とした検索や、メッセージの投稿にも使用されます。

指定された Chatter非公開メッセージを返します。

/chatter/users/me/messages/messageId

ユーザの写真。写真を取得、投稿およびトリミングします。

/chatter/users/me/photo

コンテキストユーザへのユーザ、グループ、ファイル、レコード、カスタムのお

/chatter/users/me/recommendations

すすめ、および静的なおすすめを返します。

コンテキストユーザへの指定されたアクションのおすすめを返します。

/chatter/users/me/recommendations/action

コンテキストユーザへの指定されたアクションおよびオブジェクトカテゴリのおすすめを返します。

/chatter/users/me/recommendations/action/objectCategory

コンテキストユーザへの指定されたアクションおよびキープレフィックスのおすすめを返します。

/chatter/users/me/recommendations/action/idPrefix

コンテキストユーザへの指定されたアクションおよびオブジェクト ID のおすすめ

/chatter/users/me/recommendations/action/objectID

を返します。おすすめの削除にも使用されます。

コンテキストユーザへの指定されたアクションおよびオブジェクト種別の静的な

/chatter/users/userId/recommendations/action/objectEnum

おすすめを返します。静的なおすすめの削除にも使用されます。

指定されたコミュニティユーザの評価を返します。

/connect/communities/communityId/chatter/users/userId/reputation

コンテキストユーザのグローバル Chatter

設定に関する情報を返します。/chatter/users/me/settings

ユーザの最新の状況フィード項目を返します。ユーザの状況の更新または削除にも使用されます。

/chatter/users/me/status

指定されたユーザが最近使用したトピック。指定されたユーザが最近使用したトピックを最大 5 個取得します。

/chatter/users/me/topics

454


User Information組織のすべてのユーザに関する情報を返します。リソース

/chatter/users

/connect/communities/communityId/chatter/users






説明型パラメータ


Integerpage

23.0ページあたりの項目数。有効な値は 1 ～ 250 です。デフォルト値は 25 です。

IntegerpageSize

23.0検索する文字列を指定します。検索文字列にはワイルドカード文字を除いて 2 文字以上が含まれている必要があり

Stringq

ます。ワイルドカードについての詳細は、「ワイルドカード」を参照してください。このパラメータが検索するのはユーザ名で、メールアドレス、役職などは検索しません。

28.0検索結果のコンテキストを提供するフィード項目 ID を指定します。このパラメータは、@メンションのコンプリートに使用します。searchContextIdにフィード項目 ID を渡すと、返

StringsearchContextId

されたコレクションのスレッドで前にメンションされているユーザが照合されます。このパラメータを使用する場合、クエリできる結果は 500

以下で、検索語にワイルドカードは使用できません。

レスポンスボディUser Page

455

User InformationChatter REST API リソース

28.0 より前のバージョンでは、User Page レスポンスボディの user プロパティには User Summary または User

Detail レスポンスボディを含めることができます。バージョン 28.0 以降では、常に User Detail が含まれます。コンテキストユーザへの表示が許可されない項目は、null に設定されます。

User Profile Informationコンテキストユーザまたは指定されたユーザの Chatter プロファイルに関する情報。リソース

/chatter/users/userId

/connect/communities/communityId/chatter/users/userId


PATCH は 29.0 で使用可能Chatter が必要かどうか


GET、HEAD、PATCH


<user>

プロパティ


29.0User Detail レスポンスボディの aboutMe プロパ

StringaboutMe

ティ。最大文字数は 1000

文字です。このプロパティが、コミュニティまたは組織のすべてのメンバーに表示されるユーザプロファイルの [自己紹介] セクションに入力されます。

JSON の例{

"aboutMe": "Staff Technical Writer responsible for the Connect API and Connect inApex documentation."}

456

User Profile InformationChatter REST API リソース




StringaboutMe



GET のレスポンスボディ• User Detail — バージョン 26.0 以降。外部ユーザの場合、User Detail レスポンスボディが User Summary レスポ

ンスボディと共有するプロパティに null 以外の値を設定できます。その他のプロパティは常に null です。

• User Summary — バージョン 25.0 以前。PATCH のレスポンスボディ

User Detail

PATCH の要求パラメータの例この例では、パラメータを使用して aboutMeプロパティを更新します。UI では、このプロパティがユーザプロファイルの [自己紹介] セクションに入力されます。/chatter/users/me?aboutMe=Staff+Technical+Writer+at+Seattle+Apps

PATCH のリクエストボディの例この例では、リクエストボディを使用して aboutMe プロパティを更新します。/chatter/users/me

リクエストボディ:

{"aboutMe": "Staff Technical Writer at Seattle Apps"

}

関連トピック:

ユーザの Chatter 活動の統計情報を取得するユーザプロファイルを更新する

457

User Profile InformationChatter REST API リソース

Batch User Information指定されたユーザのプロファイルに関する情報を返します。リソース

/chatter/users/batch/user_list

/connect/communities/communityId/chatter/users/batch/user_list

user_list は、最大 500 個のユーザ ID から成るカンマ区切りのリストです。適用開始バージョン

23.0




関連トピック:

複数のユーザのユーザ情報を取得する

User Conversations, Generalコンテキストユーザの非公開の会話をすべて返します。すべての会話を対象とした検索にも使用されます。「User Conversations, Specific」 (ページ 460)および「User Messages, General」 (ページ 473)を参照してください。リソース

/chatter/users/userId/conversations

/connect/communities/communityId/chatter/users/userId/conversations





458

Batch User InformationChatter REST API リソース



説明必須項目/省略可能型パラメータ名

23.0取得を開始する場所を示すページトーク

省略可能Stringpage

ン。レスポンスボディのNextPageUrl プロパティからこのトークンを取得します。

23.0ページあたりの項目数を指定します。有

省略可能IntegerpageSize

効な値は 1 ～ 100 です。サイズを指定しない場合、デフォルトは 25 です。

24.0検索する文字列を指定します。検索文字

省略可能Stringq

列にはワイルドカード文字を除いて 2 文字以上が含まれている必要があります。ワイルドカードについての詳細は、「ワイルドカード」を参照してください。このパラメータは省略可能です。

メモ: クエリパラメータが検索するのはメッセージテキスト本文のみで、ユーザ名、役職などは検索しません。

レスポンスボディConversation Summary Collection

459

User Conversations, GeneralChatter REST API リソース

User Conversations, Specificコンテキストユーザの指定された非公開の会話に関する情報を返します。特定の会話内の検索にも使用されます。

メモ: Conversations リソースを使用して、指定された会話の状況を変更することもできます。「Change Status

of Conversations」 (ページ 461)を参照してください。リソース

/chatter/users/userId/conversations/conversationId

/connect/communities/communityId/chatter/users/userId/conversations/conversationId




HTTP メソッドGET、PATCH、または HEAD





省略可能Stringq

列にはワイルドカード文字を除いて 2 文字以上が含まれている必要があります。ワイルドカードについての詳細は、「ワイルドカード」を参照してください。このパラメータは省略可能です。

メモ: クエリパラメータが検索するのはメッセージテキスト本文のみで、ユーザ名、役職など

460

User Conversations, SpecificChatter REST API リソース



は検索しません。


<conversation>

プロパティ


24.0会話状況を未読 (false)

または既読 (true) に変更します。

Booleanread



会話状況を未読 (false) または既読 (true) に変更します。

Booleanread

GET または HEAD のレスポンスボディConversation Detail

Change Status of Conversations指定された会話の状況を変更します。「入力での POST、PATCH、または PUT の使用」も参照してください。conversations リソースに PATCH を使用しても、指定された会話の状況を変更できます。リソース

/chatter/users/me/conversations/conversationId/mark-read



HTTP メソッドPOST または PUT

461

Change Status of ConversationsChatter REST API リソース

リクエストボディルート XML タグ

<conversation>

プロパティ




Booleanread



会話状況を未読 (false) または既読 (true) に変更します。

Booleanread

Get Unread Count for Conversationsコンテキストユーザまたは指定されたユーザについて未読メッセージがある会話の数を返します。リソース

/chatter/users/userId/conversations/unread-count

/connect/communities/communityId/chatter/users/userId/conversations/unread-count



リクエストボディConversation Unread Count

Users Files, General外部ファイルへの参照を含む、Salesforce Files Sync へのファイルの投稿、またはユーザが所有するファイルに関する情報の取得を行います。ユーザと共有されているファイル、ユーザがフォローしているファイル、一般的な組織ファイルは対象外です。ファイルを post 送信すると、[ファイル] タブに非公開ファイルとしてアップロードされ、ファイル所有者のみが使用できるようになります。ファイルをアップロードするには、マルチパート/フォームデータ要求で送信する必要があります。ファイルの説明とタイトルをマルチパート/フォームデータ要求に JSON または XML リクエストボディとして含めること

462

Get Unread Count for ConversationsChatter REST API リソース

ができます。情報を要求パラメータとして送信することもできます。マルチパート/フォームデータメッセージを作成する方法についての詳細は、「バイナリファイルのアップロード」を参照してください。

重要: このリソースは、大量のデータを返す場合があり、その場合は処理に時間がかかることがあります。

リソース/chatter/users/userId/files

/connect/communities/communityId/chatter/users/userId/files




POST のリクエストボディこのリクエストボディでは、新しいファイル入力について説明します。ファイルをアップロードするには、name="fileData"のマルチパート/フォームデータボディパートにそのバイナリファイルを含める必要があります。「バイナリファイルのアップロード」を参照してください。

ルート XML タグ<fileInput>

JSON

{"desc":"Employee Survey Results","title":"emp_surv_results"

}

プロパティ



説明型名前




Stringdesc




463

Users Files, GeneralChatter REST API リソース



説明型名前

に対する POST 要求では使用できますが、/chatter/files/fileId


31.0省略可能ファイルが Salesforce Files Syncと同期されている場合は true、同期されていない場合は false。


31.0省略可能ファイルがメジャーバージョンの場合は true、ファイルがマイ


ナーバージョンの場合はfalse。メジャーバージョンを置き換えることはできません。





StringsharingOption







説明型名前



24.0省略可能ファイルの説明Stringdesc

464




説明型名前

35.0省略可能ファイルを共有するかどうか、外部ファイルに対して使用可能な権限タイプなどの、権限情報を含めるかどうかを示します。

BooleanincludeExternalFilePerimissionsInfo

31.0省略可能要求は自動クライアントによって自動生成されます。

BooleanisDataSync

31.0省略可能ファイルが Salesforce Files Sync と同期されている場合は true、同期されていない場合は false。デフォルト値は、falseです。


31.0省略可能ファイルがメジャーバージョンの場合はtrue、ファイルがマイナーバージョンの場


合は false。メジャーバージョンを置き換えることはできません。デフォルト値は、false です。




StringsharingOption



24.0省略可能ファイルのタイトルStringtitle




Integerpage



IntegerpageSize


465




Stringq


文字以上が含まれている必要があります。ワイルドカードについての詳細は、「ワイルドカード」を参照してください。

GET のレスポンスボディFile Summary Page

POST のレスポンスボディFile Summary

POST 要求の例次の例では、新しいファイルを作成し、Salesforce Files Sync にアップロードします。この例は、マルチパート/フォームデータ要求のボディパートを示します。最初のボディパートは File Input リクエストボディです。2 つ目は、ファイルのコンテンツです。詳細は、「バイナリファイルのアップロード」を参照してください。POST /services/data/v35.0/chatter/users/me/files

Authorization: OAuth00DD0000000Jhd2!AQIAQC.lh4qTQcBhOPm4TZom5IaOOZLVPVK4wI_rPYJvmE8r2VW8XA.OZ7S29JEM_7Ctq1lst2dzoV.owisJc0KacUbDxyaeUser-Agent: Jakarta Commons-HttpClient/3.0.1Host: instance_nameContent-Length: 489Content-Type: multipart/form-data; boundary=a7V4kRcFA8E79pivMuV2tukQ85cmNKeoEgJgqAccept: application/json


{"title":"BoatPrices"

}

--a7V4kRcFA8E79pivMuV2tukQ85cmNKeoEgJgqContent-Disposition: form-data; name="fileData"; filename="BoatPrices.txt"Content-Type: application/octet-stream; charset=ISO-8859-1

...contents of BoatPrices.txt...


466


User Files, Filtered by Group指定されたユーザがメンバーであるグループに投稿されたファイルに関する情報を返します。リソース

/chatter/users/userId/files/filter/groups

/connect/communities/communityId/chatter/users/userId/files/filter/groups







Integerpage



IntegerpageSize



Stringq




User Files, Filtered by Sharing指定されたユーザと共有されているファイルに関する情報を返します。

467

User Files, Filtered by GroupChatter REST API リソース

リソース/chatter/users/userId/files/filter/shared-with-me

/connect/communities/communityId/chatter/users/userId/files/filter/shared-with-me

メモ: このリソースは、最後のキーワード「shared-with-me」を 1 語にしてもアクセスできます。/chatter/users/userid/files/filter/sharedwithme







Integerpage



IntegerpageSize



Stringq




User Followers指定されたユーザをフォローしている人に関する情報を返します。

468

User FollowersChatter REST API リソース

リソース/chatter/users/userId/followers

/connect/communities/communityId/chatter/users/userId/followers






返すページ番号を指定します。デフォルト値は 0 で、最初のページを返します。

Integerpage


IntegerpageSize


レスポンスボディFollower Page

Following指定されたユーザがフォローしている人、グループ、レコード、トピック、ファイルに関するリストを返します。レコードのフォローにも使用されます。「入力での POST、PATCH、または PUT の使用」を参照してください。

メモ: users リソースを使用して、ユーザをグループに追加することはできません。代わりに、groups リソースを使用してください。

リソース/chatter/users/userId/following

/connect/communities/communityId/chatter/users/userId/following


トピックのフォローは、バージョン 29.0 以降で使用できます。

469

FollowingChatter REST API リソース




<following>

プロパティ


23.0

トピック ID は 29.0 で使用できます。

フォローする対象の ID。たとえば、ユーザ ID、レコード ID、ファイル ID、トピック ID などがあります。

StringsubjectId

メモ: グループにメンバーを追加する場合には Group

Member Inputを使用します。


使用可能説明型パラメータ名

23.0


ユーザが指定されたレコードをフォローできるようにします。ユーザID、ファイル ID、トピッ

StringsubjectId

ク ID などの場合があります。

GET または HEAD の要求パラメータすべてのパラメータは省略可能です。


返されるオブジェクトの種別を絞り込みするためのキープレフィッ

StringfilterType

クスを指定します。キープレフィックスは、オブジェクト ID に

470

FollowingChatter REST API リソース


含まれる 3 文字のプレフィックスコードです。オブジェクト ID はオブジェクト型を示す 3 文字のコードが先頭に付けられます。たとえば、User オブジェクトのプレフィックスは 005、Group オブジェクトのプレフィックスは 0F9 です。自分でキープレフィックスを生成する必要はありません。使用可能なキープレフィックスを確認するには、List of Filter Feed URLsを使用します。

返すページ番号を指定します。デフォルト値は 0 で、最初のページを返します。

Integerpage


IntegerpageSize


GET または HEAD のレスポンスボディFollowing Page

POST のレスポンスボディSubscription

関連トピック:

レコードをフォローするユーザがフォローしているレコードのリストを取得する

User Groups指定されたユーザがメンバーであるグループ。リソース

/chatter/users/userId/groups

/connect/communities/communityId/chatter/users/userId/groups


471

User GroupsChatter REST API リソース







23.0省略可能生成されたトークン。フィード項目のビューを示します。ページトークンは、レスポンスボディの

Tokenpage

一部として、nextPageURLなど、いずれかの URL

パラメータで返されます。23.0省略可能ページあたりの項目数を指定します。有効な値は


IntegerpageSize

30.0省略可能検索する文字列を指定します。検索文字列にはワイルドカード文字を除いて 2 文字以上が含まれて

Stringq

いる必要があります。「ワイルドカード」を参照してください。

レスポンスボディUser Group Page

例次の GET 要求は、コンテキストユーザがメンバーであるグループのうち、その名前または説明に文字 coが含まれるすべてのグループに関する情報を返します。/chatter/users/me/groups?q=co

Topics a User is Knowledgeable About指定されたユーザが知識のあるトピック。指定されたユーザについてトピックのリストを取得します。リソース

/chatter/users/userId/knowledgeable-about-topics

/connect/communities/communityId/chatter/users/userId/knowledgeable-about-topics


472

Topics a User is Knowledgeable AboutChatter REST API リソース







Integerpage



IntegerpageSize


レスポンスボディTopics People Are Knowledgeable About Collection

User Messages, Generalコンテキストユーザのすべての非公開会話のすべてのメッセージを返します。すべてのメッセージを対象とした検索や、メッセージの投稿にも使用されます。「入力での POST、PATCH、または PUT の使用」を参照してください。「User Conversations, General」 (ページ 458)も参照してください。リソース

/chatter/users/userId/messages

/connect/communities/communityId/chatter/users/userId/messages





473

User Messages, GeneralChatter REST API リソース


<message>

プロパティ


23.0メッセージ本文のテキスト

Stringbody

23.0このメッセージが含まれる会話を識別する既存の

StringinReplyTo

メッセージの ID。recipients またはinReplyTo を指定する必要があります。両方ではなく、どちらか一方を指定する必要があります。

23.0目的のメッセージ受信者であるユーザ (最大 9 人)

User Message Recipient ListInput

recipients

のリスト。ユーザ ID のカンマ区切りのリスト。recipients またはinReplyTo を指定する必要があります。両方ではなく、どちらか一方を指定する必要があります。

XML 形式の例:

<message><body>Text of the message</body><recipients>

<recipient>userID</recipient><recipient>userID</recipient>

</recipients><inReplyTo>messageID</inReplyTo>

</message>

JSON 形式の例:

{"body": "Text of the message","recipients": ["userID","userID"],

474


"inReplyTo": "messageID"}




23.0このメッセージが含まれる会話を識別す

recipientsまたはinReplyTo を指定

StringinReplyTo

る既存のメッセージの ID

する必要があります。両方を指定することはできません。

23.0目的のメッセージ受信者であるユーザ

recipientsまたはinReplyTo を指定

Stringrecipients

(最大 9 人) のリスする必要がありまト。ユーザ ID のカす。両方を指定する

ことはできません。ンマ区切りのリスト。

23.0メッセージのテキスト (最大 10,000 文字)

必須項目Stringtext




23.0取得を開始する場所を示すページトーク

省略可能Stringpage

ン。レスポンスボディのNextPageUrl プロパティからこのトークンを取得します。

23.0ページあたりの項目数を指定します。有

省略可能IntegerpageSize

効な値は 1 ～ 100 です。サイズを指定しない場合、デフォルトは 25 です。


省略可能Stringq

列にはワイルドカード文字を除いて 2 文

475




字以上が含まれている必要があります。ワイルドカードについての詳細は、「ワイルドカード」を参照してください。このパラメータは省略可能です。

メモ: クエリパラメータが検索するのはメッセージテキスト本文のみで、ユーザ名、役職などは検索しません。

GET または HEAD のレスポンスボディMessage Collection

POST のレスポンスボディMessage

GET または HEAD のレスポンスボディの例{

"currentPageUrl": "/services/data/v35.0/chatter/users/me/messages","messages": [

{"body": {

"messageSegments": [],"text": "Will you be able to meet about your Dreamforce presentation this

week?"},"conversationId": "03MD000000002LTMAY","conversationUrl":

"/services/data/v35.0/chatter/users/me/conversations/03MD000000002LTMAY","id": "03JD000000003XGMAY","recipients": [

{"companyName": "SeattleApps","firstName": "Rene","id": "005D0000001LFNnIAO","isActive": true,"lastName": "Holmes",

476


"motif": {"color": "1797C0","largeIconUrl": "/img/icon/profile64.png","mediumIconUrl": "/img/icon/profile32.png","smallIconUrl": "/img/icon/profile16.png"



"largePhotoUrl":"https://instance_name/profilephoto/729D00000000XA5/F",

"photoVersionId": "729D00000000XA5","smallPhotoUrl":

"https://instance_name/profilephoto/729D00000000XA5/T","standardEmailPhotoUrl":


"url": "/services/data/v35.0/chatter/users/005D0000001LLO6IAO/photo"},"title": "Senior Manager","type": "User","url": "/services/data/v35.0/chatter/users/005D0000001LFNnIAO","userType": "Internal"

},{

"companyName": null,"firstName": "Desmond","id": "005D0000001LJvOIAW","isActive": true,"lastName": "Catillo","motif": {


},"mySubscription": null,"name": "Desmond Catillo","photo": {






477


"url": "/services/data/v35.0/chatter/users/005D0000001LLO1IAO/photo"},"title": "Senior Manager","type": "User","url": "/services/data/v35.0/chatter/users/005D0000001LJvOIAW","userType": "Internal"

}],"sender": {





"largePhotoUrl": "https://instance_name/profilephoto/729D00000000XA5/F",

"photoVersionId": "729D00000000XA5","smallPhotoUrl": "https://instance_name/profilephoto/729D00000000XA5/T",

"standardEmailPhotoUrl":"https://instance_name/ncsphoto/SqRfG_-PUTY6KtfOp_f0cEw-MQI3xmkJ21oNEOQ-5sbktFTIf9vWhFTTALJiaFz_",


},"sentDate": "2012-07-20T21:27:07.000Z","url": "/services/data/v35.0/chatter/users/me/messages/03JD000000003XGMAY"

},{

"body": {"messageSegments": [],"text": "Rene Holmes has shared Recruitment Poster.png with you on

Chatter.\n\nPlease review.\n\nTo view the file, go to:https://na1-blitz01.soma.salesforce.com/069D00000001E32"

},"conversationId": "03MD000000002LTMAY","conversationUrl":

"/services/data/v35.0/chatter/users/me/conversations/03MD000000002LTMAY","id": "03JD000000003VAMAY",

478


"recipients": [{









"url": "/services/data/v35.0/chatter/users/005D0000001LLO6IAO/photo"

},"title": "Senior Manager","type": "User","url": "/services/data/v35.0/chatter/users/005D0000001LFNnIAO","userType": "Internal"

},{

"companyName": null,"firstName": "Desmond","id": "005D0000001LJvOIAW","isActive": true,"lastName": "Catillo","motif": {


},"mySubscription": null,"name": "Desmond Catillo","photo": {


"largePhotoUrl":

479


"https://instance_name/profilephoto/729D00000000XA5/F","photoVersionId": "729D00000000XA5","smallPhotoUrl":



"url": "/services/data/v35.0/chatter/users/005D0000001LLO1IAO/photo"},"title": "Senior Manager","type": "User","url": "/services/data/v35.0/chatter/users/005D0000001LJvOIAW","userType": "Internal"

}],"sender": {





"largePhotoUrl": "https://instance_name/profilephoto/729D00000000XA5/F",

"photoVersionId": "729D00000000XA5","smallPhotoUrl": "https://instance_name/profilephoto/729D00000000XA5/T",

"standardEmailPhotoUrl":"https://instance_name/ncsphoto/SqRfG_-PUTY6KtfOp_f0cEw-MQI3xmkJ21oNEOQ-5sbktFTIf9vWhFTTALJiaFz_",


},"sentDate": "2012-07-18T19:01:51.000Z","url": "/services/data/v35.0/chatter/users/me/messages/03JD000000003VAMAY"

},

480


"nextPageUrl": null}

関連トピック:


User Messages, Specific指定された Chatter 非公開メッセージを返します。リソース

/chatter/users/userId/messages/messageId

/connect/communities/communityId/chatter/users/userId/messages/messageId





レスポンスボディMessage

User Photoユーザの写真。写真を取得、投稿およびトリミングします。[ファイル] ページからの画像をユーザの写真として使用するには、リクエストボディの fileIdプロパティまたは fileId要求パラメータでファイル ID を渡します。[ユーザ] ページでアップロードした画像にはファイルID は含まれず、fileId としては使用できません。バイナリファイルをユーザの写真としてアップロードするには、マルチパート/フォームデータメッセージでそのファイルを送信する必要があります。マルチパート/フォームデータメッセージを作成する方法についての詳細は、「バイナリファイルのアップロード」を参照してください。ユーザプロファイルの写真をフィードに表示するには、ユーザの写真をキャッシュします。次に、Photo レスポンスボディの photoVersionId プロパティを使用して、いつ写真を更新する必要があるかを判断します。この方法により、制限を超えて実行することを避け、モバイルクライアントのパフォーマンスを改善できる場合があります。リソース

/chatter/users/userId/photo

/connect/communities/communityId/chatter/users/userId/photo

481

User Messages, SpecificChatter REST API リソース





<photo>



}

プロパティ





IntegercropSize




IntegercropX





IntegercropY






StringfileId


482

User PhotoChatter REST API リソース











IntegercropSize




IntegercropX





IntegercropY






StringfileId


メモ: [グループ] ページおよび [ユーザプロファイル] ページでアップロードしたファイルには

483

User PhotoChatter REST API リソース



ファイル ID は含まれず、投稿やトリミングはできません。[ファイル] ページでアップロードしたファイルにはファイルID は含まれず、投稿やトリミングはできません。





GET または HEAD のレスポンスボディPhoto

POST のレスポンスボディPhoto

関連トピック:

ユーザの写真を更新およびトリミングする

User Recommendations, Generalコンテキストユーザへのユーザ、グループ、ファイル、レコード、カスタムのおすすめ、および静的なおすすめを返します。リソース

/chatter/users/userId/recommendations

/connect/communities/communityId/chatter/users/userId/recommendations


484

User Recommendations, GeneralChatter REST API リソース






33.0ユーザが直前に実行したアクション。サポートさ

StringcontextAction

れている値は、次のとおりです。• follow

• view

直前に実行されたアクションに基づいて新しいおすすめを取得するには、contextAction とcontextObjectId を一緒に使用します。

33.0ユーザが直前に実行したアクションのオブジェクトの ID。

StringcontextObjectId

• contextAction がfollow の場合、contextObjectId

は、ユーザ ID、ファイル ID、またはレコードID になります。

• contextAction がview の場合、contextObjectId

は、ユーザ ID、ファイル ID、グループ ID、またはレコード ID になります。

直前に実行されたアクションに基づいて新しいおすすめを取得するには、contextAction と

485

User Recommendations, GeneralChatter REST API リソース


contextObjectId を一緒に使用します。

23.0 ～ 32.0ユーザの ID。このユーザID のコンテキストに基づ

Stringfollowed

いて新しいおすすめを提供します。

重要: バージョン33.0 以降では、contextActionおよびcontextObjectId

を使用します。

23.0おすすめの結果の最大数。デフォルトは 10 で

IntegermaxResults

す。値は 0 よりも大きくする必要があります。

23.0 ～ 33.0ファイルの ID。このファイル ID のコンテキストに

Stringviewed

基づいて新しいおすすめを提供します。



レスポンスボディRecommendations

User Recommendations for a Specific Actionコンテキストユーザへの指定されたアクションのおすすめを返します。リソース

/chatter/users/userId/recommendations/action

/connect/communities/communityId/chatter/users/userId/recommendations/action


486

User Recommendations for a Specific ActionChatter REST API リソース

action の有効値と、その結果返されるおすすめは次のようになります。• follow は、フォローするユーザ、ファイル、およびレコードのおすすめを返します。• join は、参加するグループのおすすめを返します。• view は、表示するユーザ、ファイル、グループ、およびレコードのおすすめを返します (バージョン

25.0 以降)。バージョン 34.0 以降、view はカスタムのおすすめを返します。バージョン 35.0 以降、view

は静的なおすすめを返します。適用開始バージョン

24.0






StringcontextAction


• view







は、ユーザ ID、ファイル ID、グループ ID、ま

487

User Recommendations for a Specific ActionChatter REST API リソース


たはレコード ID になります。



Stringfollowed





IntegermaxResults



Stringviewed




レスポンスボディRecommendations

User Recommendations for a Specific Action and Object Categoryコンテキストユーザへの指定されたアクションおよびオブジェクトカテゴリのおすすめを返します。

488

User Recommendations for a Specific Action and ObjectCategory


リソース/chatter/users/userId/recommendations/action/objectCategory

/connect/communities/communityId/chatter/users/userId/recommendations/action/objectCategory


• action の有効値は次のとおりです。– follow

– join

– view (バージョン 25.0 以降)

• objectCategory の有効値は次のとおりです。– action が follow の場合、objectCategory は users、files、または records になります。– action が join の場合、objectCategory は groups になります。– action が view の場合、objectCategory は users、files、groups、records、custom (バー

ジョン 34.0 以降)、または apps (バージョン 35.0 以降) になります。







StringcontextAction


• view


489












Stringfollowed





IntegermaxResults



Stringviewed


490






GET のレスポンスボディRecommendations

直前に実行されたアクションに基づいて新しいおすすめを取得するための要求 URL の例ユーザ ID が 005D0000001GLowIAB である Pam を直前にフォローした場合、次の URL を使用します。/chatter/users/me/recommendations/follow/users?contextAction=follow&contextObjectId=005D0000001GLowIAB

これにより、Pam をフォローするユーザがフォローしているユーザのおすすめのみが取得されます。この例では、John が Pam をフォローしており、John は Suzanne もフォローしているため、Suzanne をフォローするためのおすすめが取得されます。

自分が参照中のファイルを参照したユーザが参照したファイルのリストを取得するための要求 URL の例次の URL では、所定のファイル ID のファイル詳細ページの [ユーザがその他に参照しているもの] 領域に表示されるリストが表示されます。/chatter/users/me/recommendations/view/files?contextAction=view&contextObjectId=069D00000000xNXIAY

関連トピック:

フォローするユーザのおすすめを取得する

491



User Recommendations for a Specific Action and Key Prefixコンテキストユーザへの指定されたアクションおよびキープレフィックスのおすすめを返します。リソース

/chatter/users/userId/recommendations/action/idPrefix

/connect/communities/communityId/chatter/users/userId/recommendations/action/idPrefix



– join

– view

• キープレフィックス、つまりリソース URL 内の idPrefix はオブジェクト ID の最初の 3 文字であり、オブジェクト種別を示します。この URL の idPrefix の有効値は次のとおりです。– action が follow の場合、idPrefix はユーザ (005)、ファイル (069)、またはレコード (001 や 003 な

ど) のキープレフィックスです。– action が join の場合、idPrefix はグループ (0F9) のキープレフィックスです。– action が view の場合、idPrefix は、ユーザ (005)、ファイル (069)、グループ (0F9)、レコード (001

や 003 など)、カスタムのおすすめ (0RD) (バージョン 34.0 以降)、または静的なおすすめ (T) (バージョン35.0 以降) のキープレフィックスです。







StringcontextAction


• view

直前に実行されたアクションに基づいて新しい

492

User Recommendations for a Specific Action and Key PrefixChatter REST API リソース


おすすめを取得するには、contextAction とcontextObjectId を一緒に使用します。









Stringfollowed





IntegermaxResults


493

User Recommendations for a Specific Action and Key PrefixChatter REST API リソース



Stringviewed




リクエスト URL の例/chatter/users/me/recommendations/view/001


User Recommendations for a Specific Action and Object IDコンテキストユーザへの指定されたアクションおよびオブジェクト ID のおすすめを返します。おすすめの削除にも使用されます。リソース

/chatter/users/userId/recommendations/action/objectId

/connect/communities/communityId/chatter/users/userId/recommendations/action/objectId



– join

– view (バージョン 25.0 以降)

• objectId の有効値は次のとおりです。– action が follow の場合、objectId は、ユーザ ID、ファイル ID、またはレコード ID です。– action が join の場合、objectId はグループ ID です。– action が view の場合、objectId は、ユーザ ID、ファイル ID、グループ ID、レコード ID、カスタ

ムのおすすめ ID (バージョン 34.0 以降)、または静的なおすすめの Today (バージョン 35.0 以降) です。


494

User Recommendations for a Specific Action and Object IDChatter REST API リソース



DELETE は、おすすめの削除に使用され、次のリソースでのみ有効です。• /chatter/users/userId/recommendations/follow/recommendedUserId

• /chatter/users/userId/recommendations/follow/recommendedFileId

• /chatter/users/userId/recommendations/follow/recommendedRecordId

• /chatter/users/userId/recommendations/join/recommendedGroupId

• /chatter/users/userId/recommendations/view/customRecommendationId

• /chatter/users/userId/recommendations/view/Today




User Recommendations for a Specific Action and Object Typeコンテキストユーザへの指定されたアクションおよびオブジェクト種別の静的なおすすめを返します。静的なおすすめの削除にも使用されます。リソース

/chatter/users/userId/recommendations/action/objectEnum

/connect/communities/communityId/chatter/users/userId/recommendations/action/objectEnum


• action の有効値は次のとおりです。– view

• objectEnum の有効値は次のとおりです。– Today — ID のない静的なおすすめ (Today アプリケーションのおすすめなど)。




495

User Recommendations for a Specific Action and Object TypeChatter REST API リソース



User Reputation指定されたコミュニティユーザの評価を返します。リソース

/connect/communities/communityId/chatter/users/userId/reputation




レスポンスボディReputation

User Settingsコンテキストユーザのグローバル Chatter 設定に関する情報を返します。リソース

/chatter/users/userId/settings

/connect/communities/communityId/chatter/users/userId/settings




HTTP メソッドGET、HEAD、または PATCH


<userChatterSettings>

496

User ReputationChatter REST API リソース

プロパティ


説明型名前

27.0ユーザが参加するグループからメールを受信するデフォルトの頻度。有効な値は、次のとおりです。

StringdefaultGroupEmailFrequency

• EachPost

• DailyDigest

• WeeklyDigest

• Never




27.0ユーザが参加するグループからメールを受信する


デフォルトの頻度。この設定は、ユーザがすでにメンバーであるグループには影響しません。有効な値は、次のとおりです。• EachPost

• DailyDigest

• WeeklyDigest

• Never

GET、HEAD、または PATCH のレスポンスボディUser Chatter Settings

GET のレスポンスボディの例{"defaultGroupEmailFrequency": "Never"}

497

User SettingsChatter REST API リソース

User Statusメモ: このリソースは、バージョン 25.0 以降、使用できなくなります。代わりに、/chatter/feeds/news/me/feed-items など、フィード項目 (feed-items) を指定した Feeds リソースを使用してください。

ユーザの最新の状況フィード項目を返します。ユーザの状況の更新または削除にも使用されます。「入力でのPOST、PATCH、または PUT の使用」を参照してください。リソース

/chatter/users/me/status

または/chatter/users/userId/status



HTTP メソッドGET、DELETE、POST、または HEAD


<userStatus>

プロパティ


23.0 ～ 24.0メッセージ本文の説明。Message Body Inputbody


説明型名前

ユーザの状況に post 送信する項目のテキスト

String 投稿するテキストtext

GET または POST のレスポンスボディUser Status

Topics Recently Used指定されたユーザが最近使用したトピック。指定されたユーザが最近使用したトピックを最大 5 個取得します。

498

User StatusChatter REST API リソース

リソース/chatter/users/userId/topics

/connect/communities/communityId/chatter/users/userId/topics





Zones リソース

Chatter アンサーゾーンに関する情報。使用可能なリソース:

説明リソース

組織の Chatter アンサーゾーンのリスト。コンテキストユーザが使用できるゾーンに関する情報を取得します。

/connect/zones

指定された Chatter アンサーゾーンに関する情報。/connect/zones/zoneId

Chatter アンサーゾーン内の検索の検索結果。/connect/zones/zoneId/searchResults

List of Zones組織のChatter アンサーゾーンのリスト。コンテキストユーザが使用できるゾーンに関する情報を取得します。リソース

/connect/zones/

/connect/communities/communityId/zones/




499

Zones リソースChatter REST API リソース





Integerpage


IntegerpageSize

GET のレスポンスボディZone Page

Zone Information指定された Chatter アンサーゾーンに関する情報。リソース

/connect/zones/zoneId

/connect/communities/communityId/zones/zoneId




GET のレスポンスボディZone

Zone Search ResultsChatter アンサーゾーン内の検索の検索結果。リソース

/connect/zones/zoneId/search-results

/connect/communities/communityId/zones/zoneId/search-results



500

Zone InformationChatter REST API リソース






Integerpage


IntegerpageSize

GET のレスポンスボディZone Search Result

501

Zone Search ResultsChatter REST API リソース

第 6 章 Chatter REST API リクエストボディPOST、PATCH、または PUT 要求を実行するには、クエリパラメータを渡すか、XML または JSON 形式のリクエストボディを作成します。この章には、リクエストボディのリストが記載されています。クエリパラメータは、各リソースと一緒にリストに含まれています。JSON リクエストボディを作成するには、JSON 形式でリクエストボディのプロパティを指定します。Comment リクエストボディの例を次に示します。{"body" : "Let's look for a new solution."}

最上位レベルのリクエストボディの場合は、ルート XML タグが表示されます。XML リクエストボディを作成するには、プロパティをルート XML タグの内部に XML タグとしてネストします。同じ Connect リクエストボディに XML 形式を使用すると次のようになります。<comment><body>Let's look for a new solution.</body></comment>

Action Link Definition Input

アクションリンクの定義。アクションリンクは、フィード要素上のボタンです。アクションリンクをクリックすると、ユーザを特定の Web ページに移動したり、ファイルダウンロードを開始したり、Salesforceまたは外部サーバへの API コールを呼び出したりできます。アクションリンクには、URL と HTTP メソッドが含まれ、リクエストボディとヘッダー情報 (認証用の OAuth トークンなど) を含めることができます。アクションリンクを使用してSalesforceおよびサードパーティサービスをフィードに統合することで、ユーザはアクションを実行して生産性を高め、イノベーションを促進できます。

使用方法コンテキスト変数は、actionUrl、headers、および requestBodyプロパティで使用できます。コンテキスト変数を使用して、アクションリンクを実行したユーザに関する情報をサーバ側のコードに渡すことができます。アクションリンクが実行されたときに、Salesforce によって値が代入されます。使用可能なコンテキスト変数は次のとおりです。



502





{!communityId}


{!communityUrl}



ルート XML タグ<actionLinkDefinition>

JSON の例次の例ではテンプレートを使用していません。

{"actionType":"Api","actionUrl":"/services/data/v35.0/chatter/feed-elements","groupDefault":"true","labelKey":"Post","method":"Post","requiresConfirmation":"true","requestBody":"{\"subjectId\": \"me\",\"feedElementType\": \"FeedItem\",\"body\":

{\"messageSegments\": [{\"type\": \"Text\",\"text\": \"Testing a post created via anAPI action link.\"}]}}",

"headers":[{

"name":"Content-Type", "value":"application/json"}]

}

次の例ではテンプレートを使用しています。{

"templateId":"07gD00000004C9r","templateBindings":[

{"key":"Bindings.version","value":"v33.0"

}]

}

503

Action Link Definition InputChatter REST API リクエストボディ

プロパティ



説明型名前

33.0必須項目アクションリンクテンプレート

アクションリンクの種別を定義します。値は次のとおりです。

StringactionType

• Api — アクションリンクは、アクション URL で同期 API をに定義できま

す。コールします。Salesforce は、サーバから返された HTTP 状況コードに基づいて状況をSuccessfulStatus またはFailedStatus に設定します。

• ApiAsync — アクションリンクは、アクション URL で非同期API をコールします。アクションは、非同期操作の完了時にサードパーティが/connect/action-links/actionLinkId

への要求を行って状況をSuccessfulStatus またはFailedStatus に設定するまで、PendingStatus状態のままになります。

• Download — アクションリンクは、アクション URL からファイルをダウンロードします。

• Ui — アクションリンクはアクション URL の Web ページをユーザに表示します。

ユーザがアクションを実行する前にページを読み込む必要がある場合、Uiを使用します。たとえば、アクションの実行前にユーザが入力を行う場合やユーザに情報を表示したりする場合などです。


アクションリンクの URL。たとえば、Ui アクションリンク URL はWeb ページになります。Download

アクションリンク URL は、ダウン

StringactionUrl

に定義できます。ロードするファイルへのリンクに

504




説明型名前

なります。Ui および Download

アクションリンク URL がクライアントに提供されます。Api またはApiAsync アクションリンク URL

は REST リソースになります。Api

および ApiAsyncアクションリンク URL はクライアントに提供されません。Salesforce へのリンクは、相対リンクにすることができます。他のすべてのリンクは、https:// で始まる絶対リンクにする必要があります。

ヒント: API のアップグレードや機能変更が原因の問題を回避するために、actionUrl にはバージョン管理された API を使用することをお勧めします(https://www.example.com/api/v1/exampleResource

など)。API がバージョン管理されていない場合、Action Link

Group Definition Input のexpirationDate プロパティを使用して API のアップグレードや機能変更による問題を避けることができます。

33.0省略可能[ユーザ表示設定] および [カ

アクションの実行から除外する単一ユーザの ID。excludedUserId

を指定した場合、userId を指定できません。

StringexcludedUserId

スタムユーザ(別名)] 項目を使用してアクションリンクテンプレートに定義できます。

505




説明型名前

33.0省略可能アクションリンクテンプレート

このアクションがアクションリンクグループのデフォルトアクションリンクである場合は true、それ以外の場合は false。各アク

BooleangroupDefault

に定義できます。ションリンクグループに含めるこ

とができるデフォルトアクションリンクは 1 つだけです。Salesforce

UI では、デフォルトアクションリンクには区別しやすいスタイルが適用されます。


Apiおよび ApiAsyncアクションリンク種別の要求ヘッダー。「認証」を参照してください。

Request HeaderInput[]

headers

に定義できます。


ユーザインターフェースに表示される表示ラベルのセットのキー。セットには、NewStatus、PendingStatus、SuccessStatus、

StringlabelKey

に定義できます。FailedStatus の状態の表示ラベルが

含まれます。たとえば、Approve

キーを使用する場合、[承認]、[待機中]、[承認済み]、[失敗] の表示ラベルが含まれます。キーおよび表示ラベルの完全なリストについては、「アクションリンクの表示ラベル」を参照してください。アクションリンクに適した定義済み表示ラベルがない場合は、カスタム表示ラベルを使用します。カスタム表示ラベルを使用するには、アクションリンクテンプレートを作成します。「アクションリンクテンプレートの作成」を参照してください。

506




説明型名前


次のいずれかの HTTP メソッド。Stringmethod

• HttpDelete — 成功した場合は HTTP 204 を返します。レスポ


ンスボディまたは出力クラスは空です。

• HttpGet — 成功した場合はHTTP 200 を返します。

• HttpHead — 成功した場合はHTTP 200 を返します。レスポンスボディまたは出力クラスは空です。

• HttpPatch — 成功した場合はHTTP 200 を返し、レスポンスボディまたは出力クラスが空の場合は HTTP 204 を返します。

• HttpPost — 成功した場合はHTTP 201 を返し、レスポンスボディまたは出力クラスが空の場合は HTTP 204 を返します。例外は、成功時に HTTP 200 を返すバッチ投稿リソースおよびメソッドです。

• HttpPut — 成功した場合はHTTP 200 を返し、レスポンスボディまたは出力クラスが空の場合は HTTP 204 を返します。


Apiおよび ApiAsyncアクションリンク種別のリクエストボディ。

StringrequestBody

メモ: requestBody 値の疑問符文字をエスケープします。



ユーザにアクションを確認するように要求する場合は true、それ以外の場合は false。

BooleanrequiresConfirmation


507




説明型名前

33.0省略可能[ユーザ表示設定] および [カ

アクションを実行できるユーザのID。指定しない場合や null の場合、すべてのユーザがアクションを実行できます。userId を指定

StringuserId

スタムユーザ(別した場合、excludedUserIdを指定できません。名)] 項目を使

用してアクションリンクテンプレートに定義できます。

関連トピック:


Action Link Group Definition Input

アクションリンクグループの定義。すべてのアクションリンクはグループに属している必要があります。1 つのグループ内のアクションリンクは、相互排他的で、同じプロパティを共有します。各自のアクショングループでスタンドアロンアクションを定義します。アクションリンク定義の情報はサードパーティの機密情報 (OAuth ベアラトークンヘッダーなど) である可能性があります。そのため、アクションリンク定義を作成した接続アプリケーション経由で実行された要求のみが定義を参照、変更、または削除できます。さらに、要求を実行するユーザは、定義を作成したユーザか、「すべてのデータの参照」権限を持つユーザである必要があります。ルート XML タグ

<actionLinkGroup>

JSON の例次の例では、テンプレートを使用せずにアクションリンクグループ定義をインスタンス化しています。{"actionLinks": [{"actionType": "Api","labelKey": "Like","groupDefault": "true","actionUrl": "https://test.com/this","method": "HttpPost","requiresConfirmation": "false"

},{"actionType": "Api","labelKey": "Unlike","groupDefault": "false","actionUrl": "https://test.com/that",

508

Action Link Group Definition InputChatter REST API リクエストボディ

"method": "HttpPost","requiresConfirmation": "false"

}],"executionsAllowed": "OncePerUser","expirationDate": "2014-07-07T23:59:11.168Z","category": "Primary"

}

次の例では、テンプレートからアクションリンクグループ定義をインスタンス化しています。{

"templateId":"07gD00000004C9r","templateBindings":[

{"key":"Bindings.version","value":"v33.0"

}]

}

プロパティ



説明型名前

33.0テンプレートを使用せずにアク

グループ内の各アクションリンク。アクションリンクグループ内では、アクションリンクは、Action

Action LinkDefinition Input[]

actionLinks

ションリンクグループをインスタンス化する場合は必須。テンプレートからインスタンス

Link Group Definition Input リクエストボディの actionLinks プロパティにリストされる順序で表示されます。フィード項目内で

化する場合は、は、アクションリンクグループ値を指定しないでください。

は、Associated Actions Capability Input

リクエストボディのactionLinkGroupIds プロパティに指定された順序で表示されます。


関連付けられたフィード項目内でのアクションリンクの優先度

Stringcategory

ションリンクグおよび相対位置を示します。値は次のとおりです。ループをインス

タンス化する場合は必須。テンプレートからインスタンス

• Primary — アクションリンクグループは、フィード要素の本文に表示されます。

509




説明型名前

化する場合は、値を指定しないでください。

• Overflow — アクションリンクグループは、フィード要素のオーバーフローメニューに表示されます。

Primary グループには最大 3

個、Overflowグループには最大4 個のアクションリンクを作成できます。


アクションリンクを実行できる回数を定義します。値は次のとおりです。

StringexecutionsAllowed

ションリンクグループをインス• Once — アクションリンク

は、すべてのユーザで 1 回のみ実行できます。

タンス化する場合は必須。テンプレートからインスタンス

• OncePerUser — アクションリンクは、各ユーザで 1 回のみ実行できます。化する場合は、

値を指定しないでください。

• Unlimited — アクションリンクは、各ユーザで無制限に実行できます。アクションリンクの actionType が Api

または ApiAsyncの場合、この値を使用できません。


このアクションリンクグループが関連付けられたフィード項目

DateexpirationDate

ションリンクグから削除され、実行できなくなループをインスる日時を表す ISO 8601 日付文字列タンス化する場合は必須。テンプレートからインスタンス

(例: 2011-02-25T18:24:31.000Z)。expirationDate は、作成日から 1 年以内の日時である必要があります。アクションリンクグループ定義に OAuth トークンが含まれる場

化する場合は省略可能。

合、アクションリンクグループの有効期限を OAuth トークンの有効期限と同じ値に設定することをお勧めします。そうすれば、ユーザがアクションリンクを実

510




説明型名前

行できず、OAuth エラーは発生しません。テンプレートからインスタンス化するときに日付を設定する場合は、「アクションリンクグループの有効期限の設定」を参照してください。

33.0テンプレートを使用せずにイン

アクションリンクテンプレートからバインド変数値またはカス

Action LinkTemplate BindingInput[]

templateBindings

スタンス化するタムユーザ別名に入力されるキー場合は、値を指- 値のペアのコレクション。バイ定しないでください。バインド変数を使用するテンプ

ンド変数を使用するアクションリンクテンプレートからこのアクションリンクグループをインスタンス化するには、すべての変数の値を指定する必要がありレートからこのます。「バインド変数の定義」を参照してください。

アクションリンクグループをインスタンス化する場合は必須。

33.0テンプレートを使用せずにイン

このアクションリンクグループのインスタンス化に使用された

StringtemplateId

スタンス化するアクションリンクグループテンプレートの ID。場合は、値を指

定しないでください。テンプレートからこのアクションリンクグループをインスタンス化する場合は必須。

関連トピック:

アクションリンクを定義し、フィード要素を使用して投稿するアクションリンクを定義し、フィード要素を使用して投稿するテンプレートのアクションリンクを定義し、フィード要素を使用して投稿する

511


Action Link Input

アクションリンクの想定される実行状況。ルート XML タグ

<actionLink>

JSON の例{ "status" : "SuccessfulStatus" }

プロパティ



説明型名前

33.0必須項目アクションの現在の実行状況。値は次のとおりです。

Stringstatus


• NewStatus — アクションリンクの実行の準備が整っています。Download および Ui アクションリンクでのみ使用できます。

• PendingStatus — アクションリンクが実行されています。この値を選択すると、ApiおよびApiAsyncアクションリンクのAPI コールがトリガされます。


関連トピック:


Action Link Template Binding Input

アクションリンクテンプレートのバインド変数値に入力されるキー - 値ペア。JSON の例

{"key":"version",

512

Action Link InputChatter REST API リクエストボディ

"value":"33.0"}

プロパティ



説明型名前

33.0必須項目[設定] でアクションリンクテンプレートに指定されたバインド変数

Stringkey

キーの名前。たとえば、テンプレートのバインド変数が{!Binding.firstName} の場合、キーは firstName です。

33.0必須項目バインド変数キーの値。たとえば、キーが firstName の場合、この値は Joan などになります。

Stringvalue

Announcement Input

お知らせは、削除されるか、別のお知らせで置き換えられない限り、その表示期限の 11:59 p.m. までSalesforce UI

の指定の場所に表示されます。ルート XML タグ

<announcement>

JSON の例{ "body":



}]


}

プロパティ



説明型名前

31.0必須項目お知らせのテキスト。Message Body Inputbody

31.0必須項目別のお知らせが最初に投稿されていない限り、この日付の 11:59 p.m.

DateexpirationDate

まで Salesforce UI にお知らせが表示

513

Announcement InputChatter REST API リクエストボディ



説明型名前

されます。Salesforce UI では、expirationDateの時間値は無視されます。ただし、時間値を使用して各自の UI で独自の表示ロジックを作成することはできます。

Associated Actions Capability Input

フィード要素で作成または更新できるアクションリンクを記述します。アクションリンクグループをフィード要素に関連付けるには、クライアントがアクションリンクグループ定義を作成したものと同じ接続アプリケーションで、ユーザが定義を作成したユーザまたは「すべてのデータの参照」権限を持つユーザである必要があります。アクションリンクは、フィード要素上のボタンです。アクションリンクをクリックすると、ユーザを特定のWeb ページに移動したり、ファイルダウンロードを開始したり、Salesforce または外部サーバへの API コールを呼び出したりできます。アクションリンクには、URL と HTTP メソッドが含まれ、リクエストボディとヘッダー情報 (認証用の OAuth トークンなど) を含めることができます。アクションリンクを使用して Salesforce およびサードパーティサービスをフィードに統合することで、ユーザはアクションを実行して生産性を高め、イノベーションを促進できます。JSON の例

"associatedActions": {"actionLinkGroupIds":["0Agxx00000000d1CAA", "0Agxx00000000d2DFY"]

}

プロパティ



説明型名前

33.0必須項目フィード要素に関連付けるアクションリンクグループ ID。1 つの

String []actionLinkGroupIds

Primaryアクションリンクグループを含め、合計で最大 10 個のアクションリンクグループをフィード項目に関連付けます。アクションリンクグループは、このプロパティに指定された順序で返されます。/connect/action-link-group-definitionsへの要求の応答からアクションリンクグループ ID を取得します。

514

Associated Actions Capability InputChatter REST API リクエストボディ

Async Query Input

非同期クエリジョブを作成します。


ルート XML タグ<asyncQueryInput>

JSON の例{

"query":"select NewValue from FieldHistoryArchive where ArchiveFieldName = 'NumberOfEmployees'",

"targetFieldMap": {"NewValue":"TargetNewValue__c"

},"targetObject":"MyResult__c"

}

プロパティ



説明型名前

35.0必須項目SOQL クエリ文字列。パイロットリリースでは、これらの SOQL 機

Stringquery

能が、WHERE ステートメント、単純な等式の検索条件、AND および OR 句、1 レベルのリレーション項目 (サブクエリなし)、GROUP BY、集計関数COUNT(field)、SUM()、AVG()

でサポートされます。35.0必須項目どの SOQL クエリ項目がどの対象

オブジェクト項目に対応するかを示す対応付け。

StringtargetFieldMap

515

Async Query InputChatter REST API リクエストボディ



説明型名前

35.0必須項目SOQL クエリの結果が保存されるオブジェクト。このオブジェク

StringtargetObject

トは、標準またはカスタムSalesforce オブジェクト、Big

Object、または外部オブジェクトにすることができます。

関連トピック:

Async Query

Attachment Input: Canvas App

重要: このリクエストボディは、バージョン 32.0 以降では使用できません。バージョン 32.0 以降では、Canvas Capability Input を使用してください。

XML

XML リクエストボディでは、attachmentType は <attachment> 要素の属性です。<attachment attachmentType="Canvas">

<developerName>TravelApp</developerName></attachment>

JSON

{"attachment" :{"attachmentType" : "Canvas","developerName" : "TravelApp","namespacePrefix" : "dev_org","parameters" : "{"itinerary":"123"}","height" : "250px","title" : "TravelItinerary",

}}

プロパティ


説明型名前

29.0 ～ 31.0添付ファイルの種別。値 Canvasを含める必要があります。


29.0 ～ 31.0省略可能。キャンバスアプリケーションの説明。Stringdescription

29.0 ～ 31.0キャンバスアプリケーションの開発者名 (API 名)StringdeveloperName

516

Attachment Input: Canvas AppChatter REST API リクエストボディ


説明型名前

29.0 ～ 31.0省略可能。キャンバスアプリケーションの高さ (ピクセル単位)。デフォルトの高さは 200 ピクセルです。

Stringheight

29.0 ～ 31.0省略可能。キャンバスアプリケーションが作成されたDeveloper Edition 組織の名前空間プレフィックス。


29.0 ～ 31.0省略可能。キャンバスアプリケーションに渡されるJSON 形式のパラメータ。JSON はエスケープする必要があります。

Stringparameters

29.0 ～ 31.0省略可能。キャンバスアプリケーションのサムネイル画像の URL。最大サイズは 120x120 ピクセルです。

StringthumbnailUrl

29.0 ～ 31.0省略可能。キャンバスアプリケーションのコールに使用されるリンクのタイトル。

Stringtitle

Attachment Input: Existing Content

重要: このリクエストボディは、バージョン 32.0 以降では使用できません。バージョン 32.0 以降では、Content Capability Input を使用してください。

XML

XML リクエストボディでは、attachmentType は <attachment> 要素の属性です。<attachment attachmentType="ExistingContent">

<contentDocumentId>069...</contentDocumentId></attachment>

JSON

{ "attachment":{

"attachmentType":"ExistingContent","contentDocumentId": "069D00000001FHF"

}}

プロパティ


27.0 ～ 31.0添付ファイルの種別。値ExistingContent を含める必要があります。


23.0 ～ 31.0既存のコンテンツの IDStringcontentDocumentId

517

Attachment Input: Existing ContentChatter REST API リクエストボディ

Attachment Input: Feed Poll

重要: このリクエストボディは、バージョン 32.0 以降では使用できません。バージョン 32.0 以降では、Poll

Capability Input を使用してください。XML

XML では、アンケートの選択肢はそれぞれ <choice> 要素にラップされ、attachmentType は<attachment> 要素の属性です。例:

<attachment attachmentType="Poll"><pollChoices>

<choice>One</choice><choice>Two</choice>

</pollChoices></attachment>

JSON

{ "attachment":{

"attachmentType":"Poll","pollChoices": [

"Monday","Tuesday"

]}

}

プロパティ


27.0 ～ 31.0添付ファイルの種別。値Poll を含める必要があります。


26.0 ～ 31.0フィードアンケートに使用される選択肢のリスト。

String[]pollChoices

Attachment Input: Link

重要: このリクエストボディは、バージョン 32.0 以降では使用できません。バージョン 32.0 以降では、Link

Capability Input を使用してください。XML

attachmentType プロパティは、<attachment> 要素の属性です。たとえば、次のように使用します。<attachment attachmentType="Link">

<url>http://www.google.com</url>

518

Attachment Input: Feed PollChatter REST API リクエストボディ

<urlName>A search engine</urlName></attachment>

JSON

{ "attachment":{

"attachmentType":"Link","url": "http://www.salesforce.com","urlName": "Salesforce"

}}

プロパティ


27.0 ～ 31.0添付ファイルの種別。値Link を含める必要があります。


23.0 ～ 31.0添付ファイルに含まれるURL。

Stringurl

23.0 ～ 31.0省略可能。URL の名前。指定されない場合、名前

StringurlName

は URL のドメイン名から生成されます。

Attachment Input: New File Upload

重要: このリクエストボディは、バージョン 32.0 以降では使用できません。バージョン 32.0 以降では、Content Capability Input を使用してください。

新しいファイルをアップロードするには、name="feedItemFileUpload" のマルチパート/フォームデータボディパートにそのバイナリファイルを含める必要があります。「バイナリファイルのアップロード」を参照してください。

XML

attachmentType プロパティは、<attachment> 要素の属性です。たとえば、次のように使用します。<attachment attachmentType="NewFile">

<description>TPS Report (with cover)</description><title>TPS.txt</title>

</attachment>

JSON

{ "attachment":{

"attachmentType":"NewFile","description":"TPS Report (with cover)",

519

Attachment Input: New File UploadChatter REST API リクエストボディ

"title":"TPS.txt"}

}

プロパティ


説明型名前

27.0 ～ 31.0添付ファイルの種別。値 NewFile


23.0 ～ 26.0ファイルの説明。Stringdesc

注意: このパラメータは、バージョン 27.0 以降では使用しないでください。代わりに、description を使用してください。

27.0 ～ 31.0省略可能。ファイルの説明。Stringdescription

24.0 ～ 31.0ファイルのタイトル。Stringtitle

Batch Collection Input

バッチ要求用の入力のコレクションを記述します。JSON の例

{"inputs": [{

"richInput": {"subjectId": "me","body": {

"messageSegments": [{

"type": "Text","text": "Post Number 1"

}]},"feedElementType": "FeedItem"

}}, {

"richInput": {"subjectId": "me","body": {


"type": "Text",

520

Batch Collection InputChatter REST API リクエストボディ

"text": "Post Number 2"}]


}}]

}

プロパティ



説明型名前

32.0必須項目一緒に処理される入力 (リクエストボディ) のコレクション。

Batch Input[]inputs

すべての Batch Input リクエストボディの richInput プロパティには、同じ種別のリクエストボディが含まれている必要があります。

Batch Input

Batch Collection Input 内にネストされる個別のバッチ入力。JSON の例

バイナリパートのない例:

{"richInput": {

"subjectId": "me","body": {


"type": "Text","text": "Post Number 1"

}]},"feedElementType": "FeedItem"

}}

バイナリパートのある例:

{"binaryPartNames": ["bin1"

],"richInput": {"subjectId": "me","body": {

521

Batch InputChatter REST API リクエストボディ

"messageSegments": [{"type": "Text","text": "Please accept this receipt"

}]

},"capabilities": {"content": {"description": "Receipt for expenses","title": "receipt.pdf"


}}

この例では、バイナリボディパートの Content-Dispositionヘッダー内の nameパラメータの値が bin1

である必要があります。プロパティ



説明型名前

32.0省略可能この入力で含めるバイナリボディパートのContent-Dispositionヘッダー内の name

String []binaryPartNames

パラメータのリスト。この値が存在する場合、対応するバイナリパートが要求に含まれている必要があります。

メモ:/chatter/feed-elements/batchリソースとともに使用する場合、このプロパティに設定できる値は 1 つのみで、値のリストではありません。

32.0必須項目要求の入力ボディ (リクエストボディ)。richInputプロパティには、リソースが想

richInput

定するリクエストボディが含まれている必要があります。/chatter/feed-elements/batchリソースでは、Feed Item Input リクエストボディを想定します。

Bookmarks Capability Input

フィード要素のブックマークを作成または更新します。

522

Bookmarks Capability InputChatter REST API リクエストボディ

ルート XML タグ<bookmarksCapability>

<isBookmarkedByCurrentUser>true</isBookmarkedByCurrentUser></bookmarksCapability>

JSON の例{

"isBookmarkedByCurrentUser": true}

プロパティ



説明型名前




Canvas Capability Input

フィード要素に関連付けられたキャンバスアプリケーションを作成または更新します。ルート XML タグ

<canvasCapability><developerName>true</developerName><title>true</title>

</canvasCapability>

JSON の例{

"developerName": "myNewApp","title": "My New App"

}

プロパティ



説明型名前

32.0省略可能キャンバスアプリケーションの説明。最大サイズは 255 文字です。

Stringdescription

32.0必須項目接続アプリケーションの API 名 (開発者名)。

StringdeveloperName

523

Canvas Capability InputChatter REST API リクエストボディ



説明型名前

32.0省略可能キャンバスアプリケーションの高さ (ピクセル単位)。

Stringheight

32.0省略可能キャンバスアプリケーションの一意の名前空間プレフィックス。


32.0省略可能キャンバスアプリケーションに渡される JSON パラメータ。

Stringparameters

32.0省略可能プレビュー画像へのサムネイルURL。最大サムネイルサイズは、120 × 120 ピクセルです。

StringthumbnailUrl

32.0必須項目キャンバスリンクのタイトル。Stringtitle

Comment Input

ルート XML タグ<comment>

JSON

次の例では、コメントに既存のファイルを添付します。{

"body" : {"messageSegments" : [{

"text" : "FY14 Sales Projections","type" : "Text"

}]

},"capabilities": {

"contentDocumentId":"069D00000001FHF"}

}

プロパティ


説明型名前




524

Comment InputChatter REST API リクエストボディ


説明型名前

重要: バージョン 32.0 以降は、capabilities プロパティを使用します。






関連トピック:

コメントを投稿するコメントを投稿し、Salesforce のファイルを含める@メンションを投稿する複数の @メンションを投稿するコメントを編集する

Comment Capabilities Input

ルート XML タグ<commentCapabilities>

プロパティ


説明型名前

32.0添付ファイル。Content Capability Inputcontent

Content Capability Input

フィード要素に関連付けられたファイルを作成または更新します。

525

Comment Capabilities InputChatter REST API リクエストボディ

ルート XML タグ<contentCapability>

<contentDocumentId>069D00000001pyS</contentDocumentId></contentCapability>

JSON の例{

"contentDocumentId": "069D00000001pyS"}

プロパティ



説明型名前

32.0既存のコンテンツでは必須新規コンテンツではサポート対象外

既存のコンテンツの ID。StringcontentDocumentId

32.0新規コンテンツでは省略可能既存のコンテンツではサポート対象外

アップロードするファイルの説明。

Stringdescription


StringsharingOption



32.0新規コンテンツでは必須既存のコンテンツではサポート対象外

ファイルのタイトル。この値は、新しいコンテンツのファイル名として使用されます。たとえば、タイトルが「My Title」で、ファイルが .txt ファイルの場合、ファイル名は My Title.txt になります。

Stringtitle

Datacloud Order Input

特定の userType によって取引先責任者または会社の購入に使用される Data.com 識別番号のリスト。

526

Datacloud Order InputChatter REST API リクエストボディ

ルート XML タグ<DatacloudOrder>

JSON の例{

"companyIds":["23456","24548"

],"userType":"Monthly"

}

プロパティ



説明型名前

32.0必須項目購入する会社のリスト。contactIds とcompanyIds が共に含まれていると、購入は失敗します。

StringcompanyIds

32.0必須項目購入する取引先責任者のリスト。リストには取引先責任者のみを含めることをお勧めしま

StringcontactIds

す。companyIds と contactIds が共に含まれていると、購入は失敗します。

32.0省略可能 —

ユーザ種別がData.com ユーザ種別。StringuserType

• Monthy — Data.com レコードの購入の毎月のポイント制限が割り当てられるユーザ種指定されてい

ない場合、デ別。毎月のポイントを使用できるのは、割フォルトはり当てられたユーザのみです。ポイントMonthly です。

は、月末に期限切れになります。Monthly

は、DatacloudUserTypeのデフォルト設定です。

• Listpool — Data.com レコードを購入するためのポイントをユーザがプールから引き出すことを許可するユーザ種別。

Dashboard Component Snapshot Input

ルート XML タグ<dashboardComponentSnapshot>

JSON

{"parentId" : "0F9D00000000I4O",

527

Dashboard Component Snapshot InputChatter REST API リクエストボディ

"feedItemBody" : {"messageSegments" : [{

"text" : "Sales Heat","type" : "Text"

}]

}}

プロパティ


25.0スナップショットの post 送信先となるユーザ、グループ、またはダッシュボードの ID。

StringparentId

25.0省略可能。ダッシュボード絞り込み項目の ID。

StringfilterId1


StringfilterId2


StringfilterId3

25.0ダッシュボードコンポーネントスナップショットに関連付

Message Body InputfeedItemBody

けられたフィード項目に付随するテキストが含まれます。

25.0省略可能。ダッシュボードのビューの作成元となるユーザID (作成者以外の場合)。

StringrunningUserId

Feed Element Capabilities Input

新しいフィード要素を作成するときに含めることができるすべての機能のコンテナ。API バージョン 30.0 以前では、各フィード項目にコメント、いいね!、トピックなどを含めることができました。バージョン 31.0 以降では、各フィード項目 (およびフィード要素) に一意の機能セットを含めることができます。フィード要素に機能プロパティが存在する場合、機能プロパティに値がなくてもその機能を使用できます。たとえば、ChatterLikes機能プロパティがフィード要素に存在している場合、(値の有無に関係なく) コンテキストユーザはそのフィード要素にいいね! と言うことができます。機能プロパティが存在しない場合、そのフィード要素にいいね! と言うことはできません。機能には、関連データを含めることもできます。たとえば、Moderation 機能には、モデレーションフラグに関するデータが含まれます。

528

Feed Element Capabilities InputChatter REST API リクエストボディ

XML の例<capabilities>

<associatedActions><actionLinkGroupIds>

<actionLinkGroupId/>0Agxx00000000d1CAA<actionLinkGroupId/><actionLinkGroupId/>0Agxx00000000d2DFY<actionLinkGroupId/>

</actionLinkGroupIds></associatedActions><bookmarksCapability>

<isBookmarkedByCurrentUser>false</isBookmarkedByCurrentUser></bookmarksCapability><contentCapability>

<contentDocumentId>069D00000001pyS</contentDocumentId></contentCapability>

</capabilities>

JSON の例"capabilities": {

"associatedActions": {"actionLinkGroupIds":["0Agxx00000000d1CAA", "0Agxx00000000d2DFY"]

},"bookmarks": {

"isBookmarkedByCurrentUser": false},"content": {

"contentDocumentId": "069D00000001pyS"}

}

プロパティ



説明型名前

31.0省略可能フィード要素で作成または更新できるアクションリンクを記述しま

Associated ActionsCapability Input

associatedActions

す。アクションリンクグループをフィード要素に関連付けるには、クライアントがアクションリンクグループ定義を作成したものと同じ接続アプリケーションで、ユーザが定義を作成したユーザまたは「すべてのデータの参照」権限を持つユーザである必要があります。

32.0省略可能フィード要素のブックマークを作成または更新します。

BookmarksCapability Input

bookmarks

529

Feed Element Capabilities InputChatter REST API リクエストボディ



説明型名前

32.0省略可能フィード要素に関連付けられたキャンバスアプリケーションを作成または更新します。

Canvas CapabilityInput

canvas

32.0省略可能フィード要素を使用してファイルを添付または更新します。このク

Content CapabilityInput

content

ラスを使用して、新しいファイルを添付したり、すでに Salesforce にアップロードされているファイルを更新したりします。

32.0省略可能フィード要素に添付されたリンクを作成または更新します。

Link Capability Inputlink

32.0省略可能フィード要素に添付されたアンケートの作成、更新、または投票を行います。

Poll Capability Inputpoll

32.0省略可能質問フィード要素を作成または編集するか、既存の質問フィード要素の最良の回答を設定します。

Question andAnswers CapabilityInput

questionAndAnswers

関連トピック:


Feed Favorite Input

ルート XML タグ<favorite>

POST の JSON

{"searchText" : "release","targetId" : "0TOD0000000099d"

}

POST のプロパティ



StringsearchText


530

Feed Favorite InputChatter REST API リクエストボディ



StringtargetId

PATCH の JSON

{"updateLastViewDate" : "true"

}

PATCH のプロパティ


24.0指定されたフィードのお気に入りの最終参照日を


現在のシステム時刻に設定します。デフォルト値は false です。

Feed Item Input

ルート XML タグ<feedItem>

JSON




}]

},"capabilities":{

"poll":{"choices":[

"Monday","Tuesday"

]}


}

531

Feed Item InputChatter REST API リクエストボディ




}]

},"capabilities":{


},"content":{



}

プロパティ



省略可能attachment パラメータには、次のいずれか 1 つの値のみを指


attachment

定できます。値は次のとおりです。• Attachment Input: Canvas App

(v29.0 ～ 31.0)


Content (v23.0 ～ 31.0)


(v26.0 ～ 31.0)

• Attachment Input: Link (v23.0 ～31.0)


Upload (v23.0 ～ 31.0)

重要: API バージョン 32.0

以降では、capabilities プロパティを使用します。

532




23.0フィード項目にコンテンツ機能またはリ

メッセージ本文の説明。本文には 25 文字まで使用できます。フィード項目を共有するための originalFeedElementId


ンク機能がある場合を除き、必須





capabilities

24.0 ～ 31.0省略可能新しいフィード項目をユーザのためにブックマークするか


(true)、否か (false) を指定します。デフォルト値は、false です。


以降では、capabilities.bookmarks.isBookmarkedByCurrentUser


31.0必須項目この入力が表すフィード要素の種別。有効な値は FeedItemのみです。


533







24.0 ～ 31.0省略可能フィード項目を共有するには、18 文字の ID を指定します。



以降では、originalFeedElementId



StringsubjectId

ザ、グループ、レコードのID、またはコンテキストユーザを示す文字列 me になります。

534





Stringvisibility



デフォルト値は、次のとおりです。• 外部ユーザの場合、デフォ

ルト値は AllUsers です。外部ユーザが投稿を表示するには、この値を使用する必要があります。

• 内部ユーザの場合、デフォルト値は InternalUsers

です。内部ユーザは、この値を受け入れるか、値AllUsersを使用して外部ユーザに投稿の表示を許可します。


535


関連トピック:

フィード項目を投稿するフィード要素を投稿し、Salesforce のファイルを含めるインライン画像を含むフィード要素を投稿する@メンションを投稿する複数の @メンションを投稿するアクションリンクを定義し、フィード要素を使用して投稿するテンプレートのアクションリンクを定義し、フィード要素を使用して投稿するフィード投稿を編集する質問のタイトルと投稿を編集するフィード項目を共有するグループに投稿する

Feed Item Topic Input

ルート XML タグ<feedItemTopic>

JSON


プロパティ







StringtopicName


Feed Poll Input

重要: このリクエストボディは、バージョン 32.0 以降では使用できません。バージョン 32.0 以降では、Poll

Capability Input を使用してください。

536

Feed Item Topic InputChatter REST API リクエストボディ

ルート XML タグ<feedPoll>

プロパティ



StringmyChoiceId


File Input

このリクエストボディでは、新しいファイル入力について説明します。ファイルをアップロードするには、name="fileData" のマルチパート/フォームデータボディパートにそのバイナリファイルを含める必要があります。「バイナリファイルのアップロード」を参照してください。

ルート XML タグ<fileInput>

JSON

{"desc":"Employee Survey Results","title":"emp_surv_results"

}

プロパティ



説明型名前




Stringdesc




に対する POST 要求では使用できま

537

File InputChatter REST API リクエストボディ



説明型名前

すが、/chatter/files/fileId


31.0省略可能ファイルが Salesforce Files Sync と同期されている場合は true、同期されていない場合は false。


31.0省略可能ファイルがメジャーバージョンの場合はtrue、ファイルがマイナー


バージョンの場合は false。メジャーバージョンを置き換えることはできません。





StringsharingOption




File Shares Input

ルート XML タグ<fileShares>

JSON の例{"message": "I shared a document with you.","shares": [

{ "id": "005D0000001Az4l", "sharingType": "V" },{ "id": "005D0000001B2ny", "sharingType": "C" }

]}

538

File Shares InputChatter REST API リクエストボディ

プロパティ


説明型名前

30.0受信者に送信される非公開のメッセージ本文。Salesforce Communitiesが有効な場合、非公

Stringmessage

開メッセージではなくメールが送信されます。

30.0Share Input リクエストボディのコレクション。Share Input[]shares

Files Connect Field Value Input

項目種別の項目。ルート XML タグ

<fields>

JSON の例{


}

プロパティ



説明型名前

35.0必須項目項目の名前。Stringname

35.0必須項目項目の値。Stringvalue

Files Connect Item Input

項目種別の項目種別 ID と項目。ルート XML タグ

<contentHubInputItem>

JSON の例{



539

Files Connect Field Value InputChatter REST API リクエストボディ

},{


simple create”}]

}

プロパティ



説明型名前



fields

ポジトリにSharePoint ファイルを作成する場合は必須、それ以外の場合は省略可能



Files Connect Permission Collection Input

適用または削除する権限のコレクション。ルート XML タグ

<contentHubPermissions>

JSON の例{"permissionsToApply": [

{"directoryEntryId" : "Anyone","permissionTypesIds" : ["CanView"]

}],

"permissionsToRemove": [{

"directoryEntryId" : "AnyoneInMyDomain","permissionTypesIds" : ["CanDelete","CanEdit"]

}]

}

540

Files Connect Permission Collection InputChatter REST API リクエストボディ

プロパティ



説明型名前

35.0permissions

ToRemove が指ファイルに適用する権限のリスト。


permissionsToApply


35.0permissions

ToApplyが指定ファイルから削除する権限のリスト。


permissionsToRemove

されていない場合は必須

Files Connect Permission Input

権限。ルート XML タグ

<contentHubPermission>

JSON の例{"directoryEntryId" : "AnyoneInMyDomain","permissionTypesIds" : ["CanView","CanEdit"]}

プロパティ



説明型名前

35.0必須項目ユーザまたはグループの ID。StringdirectoryEntryId

35.0必須項目権限タイプの ID のリスト。String []permissionTypesIds

Folder Input

ルート XML タグ<folderInput>

541

Files Connect Permission InputChatter REST API リクエストボディ

JSON の例{

"path" : "my_documents/my_folder"}

プロパティ


説明型名前

33.0フォルダおよびこのフォルダ内のすべてのフォルダが Salesforce Files Syncと同期されてい


る場合は true、同期されていない場合はfalse。isInMyFileSync 設定は、ルートフォルダでのみ有効です。一度 trueに設定すると、isInMyFileSync を false に設定することはできません。

30.0フォルダの名前。path または name のいずれかが必要です。両方を指定すると、pathが使用され、name

が無視されます。

Stringname

30.0親フォルダの ID。parentFolderId または path のいずれかが必要です。両方を含めることはできません。

StringparentFolderId

30.0フォルダのパス。たとえば、my

documents/folder です。Stringpath

Folder Item Input

ルート XML タグ<folderItem>

JSON の例{

"file" :{

"desc" : "Yearly Report for Universal Containers Box Division","title" : "Yearly.txt"

},

542

Folder Item InputChatter REST API リクエストボディ

"type" : "File"}

プロパティ



30.0File の POST では必須項目。フォルダ内のファイル。

File Inputfile

30.0Folderの POST では必須項目。フォルダ内フォルダ。Folder Inputfolder

30.0必須項目項目の種別。次のいずれかの値にします。

Stringtype

• File

• Folder

Following Input

ルート XML タグ<following>

プロパティ


23.0


フォローする対象の ID。たとえば、ユーザ ID、レコード ID、ファイル ID、トピック ID などがあります。

StringsubjectId

メモ: グループにメンバーを追加する場合には Group

Member Input を使用します。

関連トピック:

レコードをフォローする

543

Following InputChatter REST API リクエストボディ

Generic Batch Collection Input

ルート XML タグ<batch>

JSON

{"batchRequests" : [{


},{


}]

}

プロパティ


説明型名前

28.0実行するサブ要求の URL を含む、Batch

Request Input リクエストボディのコレクション。

Generic Batch Input[]batchRequests

544

Generic Batch Collection InputChatter REST API リクエストボディ


説明型名前

28.0デフォルト値は、false です。値が falseで、バッチ内のサブ要求が完了しない場合、Salesforce は、バッチ

BooleanhaltOnError

内の後続のサブ要求を実行しようと試みます。値が true で、HTTP 応答 400 番台または 500 番台のエラーが含まれるためにバッチ内のサブ要求が完了しない場合、Salesforceは実行を停止します。バッチ内にある後続のサブ要求の実行は試みず、後続のサブ要求ごとに HTTP 412

状況コードと前の要求が失敗したことを示す BATCH_PROCESSING_HALTED

エラーメッセージを返します。/connect/batchへの最上位要求は、HTTP 200 を返し、応答内のhasErrorsプロパティが trueに設定されます。

関連トピック:

フィード項目にいいね! と言い、いいね! の総数を返す

Generic Batch Input

ルート XML タグ<request>

JSON

{"method" : "Get","url" : "/v28.0/chatter/feeds/news/me"

}

545

Generic Batch InputChatter REST API リクエストボディ

プロパティ


説明型名前

28.0マルチパート要求のバイナリパートの名前。1 つのバッチ要求で複数のバイナリパートがアップロードされると、この値が

StringbinaryPartName

要求とバイナリパートの対応付けに使用されます。名前の競合を防止するために、バッチ要求内の各binaryPartNameプロパティには一意の値を使用します。このプロパティは省略可能です。この値が存在する場合、binaryPartNameAlias値も存在する必要があります。

28.0バイナリボディパートのContent-Disposition ヘッダーの nameパラ

StringbinaryPartNameAlias

メータ。リソースごとに異なる値を使用します。「バイナリファイルのアップロード」を参照してください。このプロパティは省略可能です。この値が存在する場合、binaryPartName

値も存在する必要があります。

28.0次のいずれかの HTTP メソッド。Stringmethod

• HttpDelete — 成功した場合は HTTP

204 を返します。レスポンスボディまたは出力クラスは空です。

• HttpGet — 成功した場合は HTTP 200

を返します。• HttpHead — 成功した場合は HTTP

200 を返します。レスポンスボディまたは出力クラスは空です。

• HttpPatch — 成功した場合は HTTP

200 を返し、レスポンスボディまたは出力クラスが空の場合は HTTP 204

を返します。• HttpPost — 成功した場合は HTTP

201 を返し、レスポンスボディまた

546



説明型名前

は出力クラスが空の場合は HTTP 204

を返します。例外は、成功時に HTTP

200 を返すバッチ投稿リソースおよびメソッドです。

• HttpPut — 成功した場合は HTTP 200

を返し、レスポンスボディまたは出力クラスが空の場合は HTTP 204 を返します。

28.0要求の入力ボディ。型は urlプロパティに指定された要求に応じて異なります。

richInput

このプロパティは省略可能です。

28.0要求するChatter APIリソース。この値はサブ要求と呼ばれます。サブ要求 URL は次のように開始できます。

Stringurl

• /services/data/version (例:/services/data/v35.0

/chatter/users/me)。• /version (例: /v35.0/chatter

/users/me)。バージョン番号は、/connect/batch要求 URL に指定された要求のバージョン以下にする必要があります。

サブ要求に関する追加情報は、次のとおりです。• URL には、サブ要求がサポートする

クエリ文字列パラメータを含めることができます。クエリ文字列は、URL 符号化されている必要があります。

• パラメータを使用して、レスポンスボディの絞り込みを行うことができます。

• サブ要求レベルでヘッダーを適用することはできません。

547


Group Chatter Settings Input

ルート XML タグ<groupChatterSettings>

プロパティユーザの Chatter 設定。


説明型名前

27.0グループメンバーがグループからメールを受信する頻度。有効な値は、次のとおりです。


• EachPost

• DailyDigest

• WeeklyDigest

• Never


Group Information Input

JSON

{"text" : "Post questions about the API.","title" : "API Questions"

}

プロパティ


説明型名前

28.0グループの [情報] セクション内のテキスト。HTML はサポートされてい

Stringtext

ません。最大文字数は 4000 文字 (バイト) です。

548

Group Chatter Settings InputChatter REST API リクエストボディ


説明型名前

28.0グループの [情報] セクションのタイトル。最大文字数は 240 文字 (バイト) です。

Stringtitle

Group Input

ルート XML タグ<group>

JSON



},"isArchived" : "false","isAutoArchiveDisabled" : "false","name" : "Chatter API","owner" : "00590000000DmPw","visibility" : "PublicAccess"

}

プロパティ


説明型名前

31.0お知らせ ID。お知らせは、削除されるか、別のお知らせで置き換えられない限り、そ

Stringannouncement

の表示期限の 11:59 p.m. までSalesforce

UI の指定の場所に表示されます。

29.0このグループで Chatter 顧客を許可している場合は true、それ以外の


場合は false。このプロパティをtrueに設定した後で、falseに設定することはできません。

29.0グループの [説明] セクションStringdescription

549

Group InputChatter REST API リクエストボディ


説明型名前

28.0グループの [情報] セクションWeb UI

では、[情報] セクションは [説明] セGroup Information Inputinformation

クションの上にあります。グループが非公開の場合は、[情報] セクションはメンバーにのみ表示されます。[説明] セクションは全員に表示されます。

29.0グループがアーカイブ済みの場合はtrue、それ以外の場合は false。デフォルトは false です。

BooleanisArchived

29.0グループの自動アーカイブが無効の場合は true、それ以外の場合は



29.0グループの名前Stringname


Stringowner


Stringvisibility




関連トピック:


Group Member Input

ルート XML タグ<member>

550

Group Member InputChatter REST API リクエストボディ

JSON の例{

"role" : "GroupManager","userId" : "005B0000000Ge16"

}

プロパティ



Stringrole

• GroupManager

• StandardMember


StringuserId

関連トピック:


Group Membership Request Update

ルート XML タグ<groupMembershipRequestUpdate>

プロパティ


27.0このプロパティを使用して、メンバーシップ要求が却下された場合にユーザ


に表示するメッセージを指定します。このプロパティの値は、statusプロパティの値が Declined の場合にのみ使用されます。最大文字数は 756 文字です。

551

Group Membership Request UpdateChatter REST API リクエストボディ


27.0有効な値は次のとおりです。Stringstatus

• Accepted

• Declined

関連トピック:


Group Record Input

Chatter グループに追加するレコード。ルート XML タグ

<groupRecord>

JSON の例

{"recordId" : "001D000000Io9cD"}

プロパティ



説明型名前

34.0必須項目レコードの ID。StringrecordId

Link Capability Input

フィード要素に添付されたリンクを作成または更新します。ルート XML タグ

<linkCapability><url>http://www.example.com</url><urlName>Example</urlName>

</linkCapability>

JSON の例{

"url": "http://www.example.com","urlName": "Example"

}

552

Group Record InputChatter REST API リクエストボディ

プロパティ



説明型名前

32.0必須項目リンクの URL。Stringurl

32.0省略可能リンクの名前。StringurlName

Managed Topic Input

管理トピック。ルート XML タグ

<managedTopic>

JSON の例{"managedTopicType" :"Navigational","parentId” : "0TOD00000000cxl","recordId" :"0TOD00000000cwk"}

プロパティ



説明型名前

32.0必須項目管理トピックの種別。StringmanagedTopicType • Featured — コミュニティホー



1 つのトピックは最大 2 つの種別の管理トピックに関連付けることができるため、1 つのトピックをFeatured トピックとNavigationalトピックの両方にすることができます。managedTopicTypeにつき、最大25 個の管理トピックを作成できます。

553

Managed Topic InputChatter REST API リクエストボディ



説明型名前

子管理トピックを作成するには、managedTopicType としてNavigational を指定し、parentId を指定します。

32.0新規トピックでは必須name またはrecordId を指




StringparentId

Navigationalも指定する必要があります。最大 3 レベル (親、直接の子、その子) の管理トピックを作成でき、管理トピックにつき最大 10 個の子管理トピックを作成できます。




StringrecordId

ていない場合、既存のトピックに必要です。name またはrecordId を指定する必要があります。両方を指定することはできません。

Managed Topic Position Collection Input

管理トピックの相対位置のコレクション。

554

Managed Topic Position Collection InputChatter REST API リクエストボディ

ルート XML タグ<managedTopicPositionCollection>

JSON の例{"managedTopicPositions" : [{"managedTopicId" :"0mtD0000000001aIAA","position" :"0"

},{"managedTopicId" :"0mtD0000000002qIAA","position" :"2"

}]

}

プロパティ



説明型名前

32.0必須項目Managed Topic Position リクエストボディのコレクション。このコレク

Managed TopicPosition Input[]

managedTopicPositions

ションには、Featured およびNavigational管理トピックを含めることができます。また、すべての管理トピックを含める必要はありません。managedTopicPositionsにすべての管理トピックを含めない場合、管理トピックはmanagedTopicPositionsで指示された位置に従って並び替えられ、managedTopicPositionsに含まれない管理トピックは次に空いている位置まで順序を下げられます。「Managed Topic Position

Collection Input」を参照してください。

管理トピックの並び替えの例次の管理トピックがあるとします。

位置Managed Topic

0ManagedTopicA

555

Managed Topic Position Collection InputChatter REST API リクエストボディ

位置Managed Topic

1ManagedTopicB

2ManagedTopicC

3ManagedTopicD

4ManagedTopicE

Managed Topic Position Collection Input に次の情報を含めて管理トピックを並び替えます。


0ManagedTopicD

2ManagedTopicE



0ManagedTopicD

1ManagedTopicA

2ManagedTopicE

3ManagedTopicB

4ManagedTopicC

Managed Topic Position Input

管理トピックの相対位置。ルート XML タグ

<managedTopicPosition>

JSON の例{"managedTopicId" :"0mtD0000000001aIAA","position" :"0"}

プロパティ



説明型名前

32.0必須項目既存の管理トピックの ID。StringmanagedTopicId

556

Managed Topic Position InputChatter REST API リクエストボディ



説明型名前

32.0必須項目管理トピックの相対的位置。ゼロから開始する昇順の整数でインデックスが付けられます。

Integerposition

Message Body Input


23.0種別に基づくメッセージセグメントのコレクショ

Segments[]messageSegments

ン。セグメントは次のいずれかになります。• Message Segment Input:

Hash Tag

• Message Segment Input:

Inline Image (バージョン35.0 以降)

• Message Segment Input:Link


Markup Begin (バージョン 35.0 以降)


Markup End (バージョン35.0 以降)

• Message Segment Input:Mention

• Message Segment Input:Text

関連トピック:

コメントを編集するフィード投稿を編集する質問のタイトルと投稿を編集する

557

Message Body InputChatter REST API リクエストボディ

Message Segment Input: Hash Tag

インラインハッシュタグを表します。ハッシュタグもテキストセグメントから解析されるため、このセグメントの使用は省略可能です。


23.0

複数語のハッシュタグは、バージョン 28.0 で使用できます。

ハッシュタグを除いたハッシュタグのテキスト。

Stringtag

メモ: ハッシュタグテキストでは、閉じる角括弧 ( ] ) はサポートされていません。テキストに閉じる角括弧 ( ] ) が含まれていると、ハッシュタグはその括弧で終了します。

23.0値は Hashtag です。Stringtype

Message Segment Input: Inline Image

インライン画像セグメント。プロパティ



説明型名前

35.0省略可能指定されていない場合、インラ

インライン画像の代替テキスト。StringaltText

イン画像ファイルのタイトルが代替テキストとして使用されます。

35.0必須項目インライン画像ファイルの ID。StringfileId

35.0必須項目値は InlineImage です。Stringtype

558

Message Segment Input: Hash TagChatter REST API リクエストボディ

Message Segment Input: Link

URL へのインラインリンクを表します。先頭に空白テキストのないリンクが入力として指定された場合、空白が挿入されます。末尾に空白テキストのないリンクが入力として指定された場合も、空白が挿入されます。リンクもテキストセグメントから解析されるため、このセグメントの使用は省略可能です。


23.0値は Link です。Stringtype

23.0リンクに使用する URL。URLurl

Message Segment Input: Markup Begin

リッチテキストマークアップの開始タグ。プロパティ



説明型名前

35.0必須項目リッチテキストマークアップの種別を示します。

StringmarkupType

• Bold - 太字タグ。• Italic - 斜体タグ。• ListItem — リスト項目タグ。• OrderedList — 順序付きリス

トタグ。• Paragraph — パラグラフタ

グ。• StrikeThrough — 取り消し線

タグ。• Underline - 下線タグ。• UnorderedList — 順序なしリ

ストタグ。

35.0必須項目値は MarkupBegin です。Stringtype

Message Segment Input: Markup End

リッチテキストマークアップの終了タグ。

559

Message Segment Input: LinkChatter REST API リクエストボディ

プロパティ



説明型名前

35.0必須項目リッチテキストマークアップの種別を示します。

StringmarkupType


トタグ。• Paragraph — パラグラフタ

グ。• StrikeThrough — 取り消し線


ストタグ。

35.0必須項目値は MarkupEnd です。Stringtype

Message Segment Input: Mention

ユーザまたはグループのインラインメンションを表します。ユーザまたはグループの ID を指定する必要があります。空白は追加されません。フィード項目またはコメントを作成する場合、最大 25 個のメンションを含めることができます。


23.0

グループは 29.0 で使用できます。

メンションされるユーザまたはグループの ID。

Stringid

23.0値は MentionStringtype

Message Segment Input: Text

プレーンインラインテキストを表します。リンクのような外見で、前後に空白のあるテキストは、リンクセグメントに変換されます。プレフィックスとしてハッシュが付加され、前後が角括弧 ([]) で囲まれたテキストは、ハッシュタグセグメントに変換されます。複数語のハッシュタグは、バージョン 28.0 以上で使用できます。

560

Message Segment Input: MentionChatter REST API リクエストボディ


23.0このセグメントのプレーンテキスト。

Stringtext

23.0値は Text のみ。Stringtype

関連トピック:

コメントを編集するフィード投稿を編集する質問のタイトルと投稿を編集する

Moderation Flag Input

ルート XML タグ<moderationFlag>

JSON


}

プロパティ


説明型名前


Stringvisibility



Mute Capability Input

フィード要素のミュートまたはミュート解除。ルート XML タグ

<muteCapability>

561

Moderation Flag InputChatter REST API リクエストボディ

JSON の例{

"isMutedByMe": true}

プロパティ



説明型名前


BooleanisMutedByMe


Photo Input

写真入力について説明します。ルート XML タグ

<photo>



}

プロパティ





IntegercropSize




IntegercropX





IntegercropY



562

Photo InputChatter REST API リクエストボディ




既存のファイルの 18 文字のID。キープレフィックスは069、ファイルサイズは 2 MB 未満にする必要があります。

StringfileId


25.0省略可能既存のファイルのバージョン番号。指定されていない場合、


最新のバージョンが使用されます。

関連トピック:

グループの写真を更新およびトリミングするユーザの写真を更新およびトリミングするカスタムのおすすめを作成し、利用者を使用してスケジュールする

Poll Capability Input

フィード要素に添付されたアンケートの作成、更新、または投票を行います。XML の例

<pollCapability><pollChoices>

<choice>Monday</choice><choice>Tuesday</choice>

</pollChoices></pollCapability>

JSON の例{

"choices" : ["Monday", "Tuesday"

]}

563

Poll Capability InputChatter REST API リクエストボディ

プロパティ



説明型名前

32.0アンケートの作成では必須

新しいアンケートの作成に使用する選択肢。アンケートには 2 個から 10 個のアンケート選択肢を指定する必要があります。

String []choices

32.0アンケートへの投票では必須

フィードアンケートの既存の選択肢の ID。既存のアンケートに投票するために使用されます。

StringmyChoiceId

Push Notification Input

転送通知。ルート XML タグ

<pushNotification>

JSON の例{ "appName" : "TestApp",

"namespace" : "abc","userIds" : ["005x00000013dPK", "005x00000013dPL"],"payload" : "{'aps':{'alert':'test', 'badge':0, 'sound':'default'}}"

}

プロパティ



説明型名前


StringappName



Stringnamespace



Question and Answers Capability Input

質問フィード要素を作成または編集するか、既存の質問フィード要素の最良の回答を設定します。

564

Push Notification InputChatter REST API リクエストボディ

ルート XML タグ<questionAndAnswersCapability>

<bestAnswerId>0D7D00000000lMAKAY</bestAnswerId></questionAndAnswersCapability>

JSON の例{

"bestAnswerId": "0D7D00000000lMAKAY"}

プロパティ



説明型名前

32.0最良の回答のPATCH では必須。POST 要求ではサポートされていません。

質問フィード要素の最良の回答として使用するコメント ID。最良の回答コメントは、質問フィード要素にすでに存在する必要があります。

StringbestAnswerId

32.0質問の POST または PATCH では必須。

質問フィード要素のタイトル。質問のタイトルを編集するには、/chatter/feed-elements

StringquestionTitle

/feedElementId に対して PATCH

要求を実行します。質問のタイトルの編集は、バージョン 34.0 以降でサポートされています。

関連トピック:


Recommendation Audience Input

おすすめ利用者。ルート XML タグ


おすすめ利用者を更新する JSON 例{


"userIds" : [

565

Recommendation Audience InputChatter REST API リクエストボディ

"005B0000000Ge16","005D0000001GpHp"]

},"name" : "New Hires"

}

おすすめ利用者を作成する JSON 例{


プロパティ



説明型名前





• Remove — 指定されたメンバーを利用者から削除します。 null を使用ま



ユーザ ID のコレクション。利用者を更新する場合、最大 50,000

人のメンバーを含めることができます。利用者には最大 100,000 人のメンバーを含めることができ、各


members

null を使用まコミュニティには最大 10,000 人の利用者を含めることができます。たは指定しない

でください



関連トピック:


566

Recommendation Audience InputChatter REST API リクエストボディ

Recommendation Definition Input

おすすめ定義。JSON の例


プロパティ



説明型名前

33.0おすすめ定義を作成する場合は必須です。既存のおすすめ定義を更新する

おすすめに基づいて行動するための URL （グループに参加するための URL など）。

StringactionUrl

場合は省略可能です。


ユーザインターフェースのアクション URL のテキストラベル("Launch" など)。

StringactionUrlName



おすすめの説明 (本文)。Stringexplanation



おすすめ定義の名前。この名前が[設定] に表示されます。

Stringname

567

Recommendation Definition InputChatter REST API リクエストボディ



説明型名前



関連トピック:


Request Header Input

HTTP 要求ヘッダー名と値のペア。JSON の例

{"name": "Content-Type","value": "application/json"

}

プロパティ



説明型名前

33.0必須項目要求ヘッダーの名前。Stringname

33.0必須項目要求ヘッダーの値。Stringvalue

Scheduled Recommendation Input

スケジュール済みおすすめ。新しいスケジュール済みおすすめを作成する JSON の例



568

Request Header InputChatter REST API リクエストボディ

プロパティ



説明型名前


Booleanenabled

合、おすすめが有効になり、コミュニティに表示されます。falseの場合、Salesforce1 モバイルブラウザアプリケーションでのフィードのおすすめは削除されませんが、新しいおすすめは表示されなくなります。Summer '15 以降のバージョンの Napili テンプレートを使用したコミュニティでは、無効にしたおすすめは表示されなくなります。


Integerrank


が 1 つずつ下がります。「スケジュール済みおすすめにランクを付ける場合の例」を参照してください。指定された rank がリストのサイズよりも大きい場合は、スケジュール済みおすすめがリストの末尾に配置されます。スケジュール済みおすすめの rank には、指定された値の代わりにリストのサイズが指定されます。rankが指定されていない場合は、スケジュール済みおすすめがリストの末尾に配置されます。

569

Scheduled Recommendation InputChatter REST API リクエストボディ



説明型名前







成する場合は必須です。既存のスケジュール済みおすすめを更新する場合は、recommendationDefinitionId


スケジュール済みおすすめにランクを付ける場合の例次のようなスケジュール済みおすすめがあり、

ランクスケジュール済みおすすめ

1ScheduledRecommendationA

2ScheduledRecommendationB

3ScheduledRecommendationC

Scheduled Recommendation Input に次の情報を含めるとします。


2ScheduledRecommendationD


570

Scheduled Recommendation InputChatter REST API リクエストボディ


1ScheduledRecommendationA

2ScheduledRecommendationD

3ScheduledRecommendationB

4ScheduledRecommendationC

関連トピック:


Share Input

JSON の例{"id": "005D0000001Az4l","sharingType": "V"

}

プロパティ


説明型名前

30.0ファイルの共有先のユーザ IDStringid

30.0コラボレータの場合は C、閲覧者の場合は VStringsharingType

Topic Assignment Input

フィード項目またはレコードに割り当てるトピックを表します。ユーザがオブジェクト種別のレコードにトピックを追加できるようにするには、事前にシステム管理者がそのオブジェクトでトピックを有効化しておく必要があります。ルート XML タグ

<topicAssignment>

JSON

次の例では、トピックをレコードに割り当てます。{ "topicId": "0TOD0000000090r"}

571

Share InputChatter REST API リクエストボディ

プロパティ






新規または既存のトピックの名前。

StringtopicName


Topic Endorsement Input

トピックに関する知識のあるユーザを支持します。ルート XML タグ

<topicEndorsement>

JSON

{"userId" : "005B0000000Ge16"

}

プロパティ



30.0必須項目指定したトピックについて支持されるユーザの ID。

StringuserId

Topic Input

ルート XML タグ<topic>

JSON

{"description" : "World Wide Web Consortium (W3C) is the main international standards

organization for the Web.""name" : "W3C"}

572

Topic Endorsement InputChatter REST API リクエストボディ

プロパティ


28.0トピックのテキストによる説明

Stringdescription


String []idsToMerge

28.0トピックの名前トピック名の大文字、小文字、スペースのみを変

Stringname

更するには、このプロパティを使用します。

Topic Names Input

トピック名のリスト。ルート XML タグ

<topicNamesCollection>

JSON の例{ "topicNames": ["API", "Chatter REST API", "ConnectApi"]}

プロパティ



説明型名前

35.0必須項目フィード項目の最大 10 個のトピック名を含むリスト、またはレコー

String []topicNames

ドの最大 100 個のトピック名を含むリスト。

User Chatter Settings Input

ユーザのグローバル Chatter 設定。ルート XML タグ

<userChatterSettings>

573

Topic Names InputChatter REST API リクエストボディ

プロパティ


説明型名前

27.0ユーザが参加するグループからメールを受信するデフォルトの頻度。有効な値は、次のとおりです。


• EachPost

• DailyDigest

• WeeklyDigest

• Never


User ID Collection Input

ユーザ ID のコレクション。ルート XML タグ

<userIds>

JSON の例{


}

プロパティ



説明型名前

35.0必須項目ユーザ ID のリスト。String []userIds

User Input

ルート XML タグ<user>

574

User ID Collection InputChatter REST API リクエストボディ

プロパティ



StringaboutMe



JSON の例{

"aboutMe": "Staff Technical Writer responsible for the Connect API and Connect inApex documentation."}

関連トピック:

ユーザプロファイルを更新する

User Message

ルート XML タグ<message>

プロパティ


23.0メッセージ本文のテキスト

Stringbody

23.0このメッセージが含まれる会話を識別する既存の

StringinReplyTo

メッセージの ID。recipients またはinReplyTo を指定する必要があります。両方ではなく、どちらか一方を指定する必要があります。

575

User MessageChatter REST API リクエストボディ


23.0目的のメッセージ受信者であるユーザ (最大 9 人)

User Message Recipient ListInput

recipients

のリスト。ユーザ ID のカンマ区切りのリスト。recipients またはinReplyTo を指定する必要があります。両方ではなく、どちらか一方を指定する必要があります。

XML 形式の例:

<message><body>Text of the message</body><recipients>

<recipient>userID</recipient><recipient>userID</recipient>

</recipients><inReplyTo>messageID</inReplyTo>

</message>

JSON 形式の例:

{"body": "Text of the message","recipients": ["userID","userID"],"inReplyTo": "messageID"

}

関連トピック:


User Message Recipient Input

ルート XML タグ<recipient>

プロパティ


23.0メッセージを受信するユーザの 18 文字の ID。

Stringrecipient

576

User Message Recipient InputChatter REST API リクエストボディ

User Message Recipient List Input

ルート XML タグ<message>

プロパティ


23.0メッセージを受信する受信者のコレクション。

User Message Recipient Input[]recipients

User Status Input

メモ: User Status Input を使用したユーザ状況の設定は、バージョン 25.0 以降使用できなくなります。代わりに、Feed Item Input を使用してフィードにフィード項目を post 送信してください。

ルート XML タグ<userStatus>

プロパティ


23.0 ～ 24.0メッセージ本文の説明。Message Body Inputbody

User Stream (Conversation) Input

ルート XML タグ<conversation>

プロパティ




Booleanread

577

User Message Recipient List InputChatter REST API リクエストボディ

第 7 章 Chatter REST API レスポンスボディChatter REST API リソースへの要求の実行が成功すると、JSON または XML 形式でレスポンスボディが返される場合があります。Chatter REST API リソースへの要求では、要求が成功したかどうかに関係なく、常に HTTP 応答コードが返されます。

Action Link Definition

アクションリンクの定義。この情報を参照するには、アクションリンク定義の作成時に使用した接続アプリケーションを要求で使用する必要があります。



説明型プロパティ名

33.0Small、33.0アクションリンクの URL。たとえば、Uiアクションリンク URL は Web

StringactionUrl

ページになります。Downloadアクションリンク URL は、ダウンロードするファイルへのリンクになります。Uiおよび Downloadアクションリンク URL がクライアントに提供されます。Api または ApiAsync

アクションリンク URL は REST リソースになります。Api およびApiAsyncアクションリンク URL はクライアントに提供されません。Salesforceへのリンクは、相対リンクにすることができます。他のすべてのリンクは、https://で始まる絶対リンクにする必要があります。

33.0Small、33.0ISO 8601 形式の日付文字列 (例:

2011-02-25T18:24:31.000Z)。DatecreatedDate

33.0Small、33.0アクションの実行から除外する単一ユーザの ID。excludedUserId

StringexcludedUserId

を指定した場合、userIdを指定できません。

578




33.0Small、33.0このアクションがアクションリンクグループのデフォルトアクショ

BooleangroupDefault

ンリンクである場合は true、それ以外の場合は false。各アクションリンクグループに含めることができるデフォルトアクションリンクは 1 つだけです。Salesforce UI では、デフォルトアクションリンクには区別しやすいスタイルが適用されます。

33.0Big、33.0Api および ApiAsync アクションリンク種別の要求ヘッダー。

Request Header[]headers

33.0Small、33.0アクションリンク定義の 18 文字のID。

Stringid

34.0Small、34.0アクションリンクボタンに表示するカスタムの表示ラベル。label

Stringlabel

値は、アクションリンクテンプレートでのみ設定できます。アクションリンクには、NewStatus、PendingStatus、SuccessStatus、FailedStatus の 4 つの状況があります。次の文字列が、各状況の表示ラベルに追加されます。• 表示ラベル• 表示ラベル待機中• 表示ラベル成功• 表示ラベル失敗たとえば、label の値が「See

Example」の場合、4 つのアクションリンクの状態の値は「See

Example」、「See Example 待機中」、「See Example 成功」、および「See

Example 失敗」になります。アクションリンクでは、表示ラベル名の生成に label またはlabelKey を使用できますが、両方は使用できません。label に値がある場合、labelKey の値は

579

Action Link DefinitionChatter REST API レスポンスボディ




None になります。labelKey にNone以外の値がある場合、label

の値は null になります。

33.0Small、33.0ユーザインターフェースに表示される表示ラベルのセットのキー。

StringlabelKey

セットには、NewStatus、PendingStatus、SuccessStatus、FailedStatus の状態の表示ラベルが含まれます。たとえば、Approve

キーを使用する場合、[承認]、[待機中]、[承認済み]、[失敗] の表示ラベルが含まれます。「アクションリンクの表示ラベル」を参照してください。

33.0Medium、33.0HTTP メソッド。次のいずれかの値にします。

Stringmethod

• HttpDelete — 成功した場合はHTTP 204 を返します。レスポンスボディまたは出力クラスは空です。

• HttpGet — 成功した場合は HTTP

200 を返します。• HttpHead — 成功した場合は

HTTP 200 を返します。レスポンスボディまたは出力クラスは空です。

• HttpPatch — 成功した場合はHTTP 200 を返し、レスポンスボディまたは出力クラスが空の場合は HTTP 204 を返します。

• HttpPost — 成功した場合はHTTP 201 を返し、レスポンスボディまたは出力クラスが空の場合は HTTP 204 を返します。例外は、成功時に HTTP 200 を返すバッチ投稿リソースおよびメソッドです。

580





• HttpPut — 成功した場合は HTTP

200 を返し、レスポンスボディまたは出力クラスが空の場合はHTTP 204 を返します。

33.0Small、33.0ISO8601 の日付文字列 (例:

2011—02—25T18:24:31.000Z)。DatemodifiedDate

33.0Big、33.0Api および ApiAsync アクションリンク種別のリクエストボディ。

StringrequestBody

33.0Small、33.0ユーザにアクションを確認するように要求する場合は true、それ以外の場合は false。

BooleanrequiresConfirmation

33.0Medium、33.0このアクションリンクのインスタンス化に使用されたアクションリ

StringtemplateId

ンクテンプレートの ID。アクションリンクがテンプレートに関連付けられていない場合、値は null です。

33.0Small、33.0アクションリンクの種別を定義します。値は次のとおりです。

Stringtype

• Api — アクションリンクは、アクション URL で同期 API をコールします。Salesforce は、サーバから返された HTTP 状況コードに基づいて状況をSuccessfulStatus またはFailedStatusに設定します。

• ApiAsync — アクションリンクは、アクション URL で非同期 API

をコールします。アクションは、非同期操作の完了時にサードパーティが/connect/action-links/actionLinkId

への要求を行って状況をSuccessfulStatus またはFailedStatus に設定するまで、PendingStatus 状態のままになります。

581







33.0Small、33.0アクションを実行できるユーザのID。指定しない場合や null の場

StringuserId

合、すべてのユーザがアクションを実行できます。userIdを指定した場合、excludedUserId を指定できません。

Action Link Diagnostic

アクションリンクが実行されたときに REST エンドポイントから返された診断情報。診断情報は、アクションリンクにアクセスできるユーザに対してのみ提供されます。




33.0Small、33.0アクションリンクが実行されたときに REST エンドポイントから返さ

StringdiagnosticInfo

れた診断情報。診断情報は、アクションリンクにアクセスできるユーザに対してのみ提供されます。

33.0Small、33.0このアクションリンク診断情報のChatter REST API URL。

Stringurl

Action Link Group Definition

アクションリンクグループの定義。すべてのアクションリンクはグループに属している必要があります。1 つのグループ内のアクションリンクは、相互排他的で、同じプロパティを共有します。各自のアクショングループでスタンドアロンアクションを定義します。

582

Action Link DiagnosticChatter REST API レスポンスボディ




33.0Medium、33.0アクションリンクグループを構成するアクションリンク定義のコレクション。アクションリンクグループ内では、アクションリンクは、Action Link

Action LinkDefinition[]

actionLinks

Group Definition Input リクエストボディの actionLinksプロパティにリストされる順序で表示されます。フィード項目内では、アクションリンクグループは、Associated Actions

Capability Input リクエストボディのactionLinkGroupIdsプロパティに指定された順序で表示されます。

33.0Medium、33.0アクションリンクの優先度および位置を示します。値は次のとおりです。

Stringcategory



33.0Small、33.0ISO8601 の日付文字列 (例:2011-02-25T18:24:31.000Z)

DatecreatedDate

33.0Medium、33.0アクションリンクを実行できる回数を定義します。値は次のとおりです。

StringexecutionsAllowed

• Once — アクションリンクは、すべてのユーザで 1 回のみ実行できます。

• OncePerUser — アクションリンクは、各ユーザで 1 回のみ実行できます。

• Unlimited — アクションリンクは、各ユーザで無制限に実行できます。アクションリンクのactionType が Api または

583

Action Link Group DefinitionChatter REST API レスポンスボディ




ApiAsync の場合、この値を使用できません。

33.0Medium、33.0このアクショングループの有効期限が切れて実行できなくなる日時

DateexpirationDate

を表す ISO 8601 日付文字列 (例:

2011-02-25T18:24:31.000Z)。値が null

の場合、有効期限はありません。33.0Small、33.0アクションリンクグループ定義の

18 文字の ID

Stringid


DatemodifiedDate

33.0Medium、33.0このアクションリンクグループをインスタンス化するアクションリ

StringtemplateId

ンクグループテンプレートの ID。または、このグループがテンプレートに関連付けられていない場合はnull。

33.0Small、33.0このアクションリンクグループ定義の Chatter REST API URL。

Stringurl

Address




23.0Small、29.0市区郡の名前Stringcity

23.0Small、29.0国の名前Stringcountry

25.0Small、29.0ロケールに従って書式設定された住所StringformattedAddress

23.0Small、29.0都道府県などの名前Stringstate

23.0Small、29.0町名・番地Stringstreet

23.0Small、29.0郵便番号Stringzip

584

AddressChatter REST API レスポンスボディ

Announcement

お知らせは、削除されるか、別のお知らせで置き換えられない限り、その表示期限の 11:59 p.m. までSalesforce UI

の指定の場所に表示されます。




31.0Small、31.0別のお知らせが最初に投稿されていない限り、この日付の 11:59 p.m.

DateexpirationDate

まで Salesforce UI にお知らせが表示されます。Salesforce UI では、expirationDate の時間値は無視されます。ただし、時間値を使用して各自の UI で独自の表示ロジックを作成することはできます。

31.0Small、31.0お知らせの本文およびそれに関連するコメントやいいね! などを含むフィード要素。

Feed ItemfeedElement

31.0Small、31.0お知らせの 18 文字の ID。Stringid

33.0Small、33.0お知らせへの URL。Stringurl

Announcement Page

Announcement レスポンスボディのページ設定されたコレクション。




31.0Small、31.0Announcement レスポンスボディのコレクション。お知らせは、削除さ

Announcement[]announcements

れるか、別のお知らせで置き換えられない限り、その表示期限の 11:59

p.m. までSalesforce UI の指定の場所に表示されます。

31.0Medium、31.0現在のページを識別するChatter REST

API URL。StringcurrentPageUrl

31.0Small、31.0次のページを識別する Chatter REST

API URL。次のページがない場合はStringnextPageUrl

null。別のページを取得する前に、この値が nullであるかどうかを確認します。ページが存在しな

585

AnnouncementChatter REST API レスポンスボディ




い場合は、ConnectApi.NotFoundException

エラーが返されます。31.0Medium、31.0前のページを識別する Chatter REST

API URL。前のページがない場合はnull。

StringpreviousPageUrl

Approval Capability

フィード要素にこの機能がある場合、承認に関する情報が含まれています。




32.0Small、32.0作業項目 ID。承認レコードに関連付けられた保留中の作業項目がない場合、作業項目 ID は null です。

Stringid

32.0Small、32.0承認投稿テンプレート項目の詳細。Approval PostTemplate Field[]

postTemplateFields

32.0Small、32.0プロセスインスタンスステップ ID。関連付けられたレコードが承認プ

StringprocessInstanceStepId

ロセスの 1 つのステップを表します。

32.0Small、32.0承認の状況。次のいずれかの値にします。

Stringstatus

• Approved

• Fault

• Held

• NoResponse

• Pending

• Reassigned

• Rejected

• Removed

• Started

586

Approval CapabilityChatter REST API レスポンスボディ

Approval Post Template Field

承認投稿テンプレート項目の説明。




28.0Small、29.0項目名StringdisplayName

28.0Small、29.0項目値。項目が nullに設定されている場合は null。

StringdisplayValue

28.0Small、29.0レコード ID

レコードが存在しない場合、または参照がnull の場合、この値は null になります。

Referencerecord

Article Item

質問および回答の検索結果に含まれる記事項目。




32.0Small、32.0記事 ID。Stringid

32.0Small、32.0記事の評価。Doublerating

32.0Small、32.0記事のタイトル。Stringtitle

32.0Small、32.0記事のリンク URL。StringurlLink

32.0Small、32.0記事への投票数。IntegerviewCount

Associated Actions Capability

フィード要素にこの機能がある場合、フィード要素にプラットフォームアクションが関連付けられています。




33.0Medium、33.0フィード要素に関連付けられたプラットフォームアクショングルー

Platform ActionGroup[]

platformActionGroups

プ。プラットフォームアクショングループは、Associated Actions

587

Approval Post Template FieldChatter REST API レスポンスボディ




Capability Input リクエストボディに指定された順序で返されます。

Async Query

非同期 SOQL クエリジョブの結果。





35.0Big、35.0ジョブ ID。非同期クエリジョブの状況を取得するには、Async Query の

StringjobId

Status 要求でこの ID を使用します(/async-queries/jobId)。

35.0Big、35.0SOQL クエリ文字列。パイロットリリースでは、これらの SOQL 機能

Stringquery

が、WHERE ステートメント、単純な等式の検索条件、ANDおよび OR

句、1 レベルのリレーション項目 (サブクエリなし)、GROUP BY、集計関数 COUNT(field)、SUM()、AVG()

でサポートされます。35.0Big、35.0非同期クエリジョブの状況。次の

いずれかの値になります。Stringstatus

• Complete — ジョブは完了しました。

• Error — ジョブにエラーがあります。

• New — 新規ジョブです。• Running — ジョブは実行中で

す。

588

Async QueryChatter REST API レスポンスボディ




• Scheduled — ジョブはスケジュールされました。

35.0Big、35.0どの SOQL クエリ項目がどの対象オブジェクト項目に対応するかを示す対応付け。

StringtargetFieldMap

35.0Big、35.0SOQL クエリの結果が保存されるオブジェクト。このオブジェクトは、

StringtargetObject

標準またはカスタム Salesforce オブジェクト、Big Object、または外部オブジェクトにすることができます。

関連トピック:

Async Query

Async Query, Status

Banner Capability

このフィード要素にこの機能がある場合、フィード要素にバナーのモチーフとスタイルが含まれます。




31.0Small、31.0バナーのモチーフ。Motifmotif

31.0Small、31.0色とアイコンセットでフィード項目を装飾します。

Stringstyle

• Announcement — お知らせは、削除されるか、別のお知らせで置き換えられない限り、その表示期限の 11:59 p.m. まで Salesforce

UI の指定の場所に表示されます。

589

Banner CapabilityChatter REST API レスポンスボディ

Batch Result Item




Small、29.0バッチの種別によって異なります。値は次のいずれかになる可能性があります。

種別は、バッチのオブジェクト種別によって異なります。

result

• /chatter/feed-elements/batch (v32.0)

のフィード項目重要: 結果がエラーの

• Error Message (v23.0)

• File Summary


場合、種別はコレクションです。 (v26.0)

• Group Member


(v27.0)

• Group

/chatter/groups/batch/groupIds

(v23.0)

• Motif


(v27.0)

• User Detail

/chatter/users/batch/userIds

(v23.0)

• /connect/batchの場合、値はバッチ内のサブ要求に応じて、どのレスポンスボディにもなる可能性があります。(v28.0)

23.0Small、29.0バッチ内のこの個別要求の状況を示す HTTP

状況コードIntegerstatusCode

590

Batch Result ItemChatter REST API レスポンスボディ

Batch Results




28.0Small、29.0結果セットに HTTP 状況コードが 400 番台または 500 番台の結果が 1 つ以上ある場合はtrue、それ以外の場合は false

BooleanhasErrors

23.0Small、29.0バッチの結果項目のコレクションBatch Result Item[]results

Bookmarks Capability

フィード要素にこの機能がある場合、コンテキストユーザがそのフィード要素をブックマークできます。




32.0Small、32.0現在のユーザがフィード要素をブックマークしているか (true )、否か(false) を示します。


Case Comment Capability

フィード要素にこの機能がある場合、ケースフィードにケースコメントが含まれます。




32.0Small、32.0コメントを行ったユーザの種別を示します。

StringactorType

• Customer — Chatter 顧客がコメントを行った場合

• CustomerService — サービス担当者がコメントを行った場合

32.0Small、32.0コメントを作成したユーザに関する情報。

User Detail またはUser Summary

createdBy



591

Batch ResultsChatter REST API レスポンスボディ




32.0Small、32.0ケースフィードのコメントのイベントタイプを示します。

StringeventType

• NewInternal — 新しく「社内のみ」とマークされたケースコメント。

• NewPublished — 新しく公開されたケースコメント。

• NewPublishedByCustomer —

新しく公開された、顧客によるケースコメント。

• PublishExisting — 再公開された既存のケースコメント。

• PublishExistingByCustomer

— 再公開された、顧客による既存のケースコメント。

• UnpublishExistingByCustomer

— 非公開にされた、顧客による既存のケースコメント。

• UnpublishExsiting — 非公開にされた既存のケースコメント。

メモ: この入力ミスは、ドキュメントではなくコードに含まれています。コードでこのスペルを使用してください。

32.0Small、32.0ケースコメントの 18 文字の ID。Stringid

32.0Small、32.0コメントが公開されたかどうかを示します。

Booleanpublished

32.0Small、32.0ケースコメントのテキスト。Stringtext

Canvas Capability

フィード要素にこの機能がある場合、キャンバスアプリケーションが表示されます。

592

Canvas CapabilityChatter REST API レスポンスボディ




32.0Small、32.0キャンバスアプリケーションの説明。最大サイズは 255 文字です。

Stringdescription

32.0Small、32.0接続アプリケーションの API 名 (開発者名)。

StringdeveloperName

32.0Small、32.0キャンバスアプリケーションの高さ (ピクセル単位)。

Stringheight

32.0Small、32.0キャンバスアプリケーションのアイコン。

ConnectApi.Iconicon

32.0Small、32.0キャンバスアプリケーションの一意の名前空間プレフィックス。


32.0Small、32.0キャンバスアプリケーションに渡される JSON パラメータ。

Stringparameters

32.0Small、32.0プレビュー画像へのサムネイルURL。最大サムネイルサイズは、120

× 120 ピクセルです。

StringthumbnailUrl

32.0Small、32.0キャンバスリンクのタイトル。Stringtitle

Chatter Activity




23.0Small、29.0ユーザが行った組織またはコミュニティ内のコメントの合計数

IntegercommentCount

23.0Small、29.0ユーザが受け取った組織またはコミュニティ内のコメントの合計数

IntegercommentReceivedCount

23.0Small、29.0ユーザが受け取った組織またはコミュニティ内の投稿とコメントに対するいいね! の合計数

IntegerlikeReceivedCount

23.0Small、29.0ユーザが行った組織またはコミュニティ内の投稿の合計数

IntegerpostCount

593

Chatter ActivityChatter REST API レスポンスボディ

Chatter Directory




24.0Small、29.0組織のフィードの一般リソースへの URL を返します。

Stringfeeds

24.0Small、29.0組織のグループの一般リソースへの URL を返します。

Stringgroups

24.0 ～ 26.0Stringorganizationメモ: このプロパティは、バージョン26.0 以降、使用できなくなります。代わりに、Connect Directory でorganizationプロパティを使用します。

接続組織の一般リソースへの URL を返します。

24.0Small、29.0組織のユーザの一般リソースへの URL を返します。

Stringusers

Chatter Influence




24.0Small、29.0組織またはコミュニティ内でのユーザの影響度ランクを示すパーセント値

Stringpercentile

24.0Small、29.0組織またはコミュニティ内の他の全ユーザに対するユーザの相対的な影響度ランクを示す数値

Integerrank

Chatter Likes Capability

フィード要素にこの機能がある場合、コンテキストユーザがいいね! と言うことができます。既存のいいね! に関する情報が公開されます。

594

Chatter DirectoryChatter REST API レスポンスボディ




32.0Small、32.0現在のユーザがフィード要素にいいね! と言っているか (true)、否か(false) を示します。

BooleanisLikedByCurrentUser

32.0Small、32.0このフィード要素のいいね! 情報。Like Pagepage

32.0Small、32.0フィード要素にいいね! と言ったユーザを説明するメッセージ本文。

Like Message BodylikesMessage

32.0Medium、32.0コンテキストユーザがフィード要素にいいね! と言った場合はこのプ

ReferencemyLike

ロパティがその特定のいいね! への参照になり、それ以外の場合はnull になります。

ClientInfo




23.0Small、29.0認証に使用される接続アプリケーションの名前詳細は、「接続アプリケーションについて」を参照してください。

StringapplicationName

23.0Small、29.0認証に使用される接続アプリケーションの[情報 URL] 項目の値

StringapplicationUrl

Comment




24.0 ～ 31.0Medium、29.0コメントに添付ファイルが含まれないか、添付ファイルが使用できない場合、nullを返

コメントの種別によって異なる

attachment

します。それ以外の場合は、Feed Item

Attachment: Content を返します。


595

ClientInfoChatter REST API レスポンスボディ




23.0Small、29.0コメントのメッセージ本文Feed Item Bodybody

32.0Medium、32.0コメントに関連付けられた機能。CommentCapabilities

capabilities

23.0Medium、29.0接続の認証に使用される接続アプリケーションに関する情報

ClientInfoclientInfo


StringcreatedDate

32.0Medium、32.0コメントが投稿されたフィード要素。ReferencefeedElement

23.0 ～ 31.0Medium、29.0コメントが投稿されたフィード項目。ReferencefeedItem

重要: バージョン 32.0 以降では、feedElement プロパティを使用します。

23.0Small、29.0コメントの 18 文字の IDStringid

23.0 ～ 24.0BooleanisDeletableメモ: このプロパティは、バージョン25.0 以降、使用できなくなります。代わりに、isDeleteRestricted プロパティを使用してください。

コンテキストユーザがコメントを削除できるかどうかを示します。

25.0Medium、29.0コンテキストユーザがコメントを削除できない場合は true を返します。false が返さ

BooleanisDeleteRestricted

れた場合は、コンテキストユーザがコメントを削除できる可能性があります。

24.0Medium、29.0コメントに関連付けられたいいね! のページLike Pagelikes

27.0Medium、29.0コメントにいいね! と言ったユーザを説明するメッセージ本文


23.0Medium、29.0コンテキストユーザがコメントにいいね! と言った場合は、そのいいね! への参照を返します。それ以外の場合は nullを返します。

ReferencemyLike

23.0Big、29.0このコメントに関連付けられたフィード項目の親に関する情報

Referenceparent

596

CommentChatter REST API レスポンスボディ




28.0Medium、29.0相対的なローカライズされた文字列として書式設定された作成日 (「17 分前」、「昨日」など)

StringrelativeCreatedDate

24.0Small、29.0コメントの種別を示します。有効な値は、次のとおりです。

Stringtype

• ContentComment — コメントに添付ファイルが含まれる

• TextComment — コメントにテキストのみが含まれる

23.0Small、29.0このコメントへの URLStringurl

23.0Small、29.0コメント作成者に関する情報User Summaryuser

Comment Capabilities

コメントに含めることができるすべての機能のコンテナ。




32.0Small、32.0このフィード要素に関連付けられたコンテンツ (添付ファイルなど)。フィード要素からコンテンツが削除された場合、またはアクセス権

Content Capabilitycontent

が非公開に変更された場合、ほとんどの Content Capability プロパティは null になります。

34.0Small、34.0コメントにこの機能がある場合、権限を持つユーザはコメントを編集できます。

Edit Capabilityedit

597

Comment CapabilitiesChatter REST API レスポンスボディ

Comment Page




23.0 ～ 31.0Small、29.0コメントのコレクションComment[]comments


23.0Medium、29.0コメントの現在のページ、つまり最新のコメントの URL。デフォルトの 1 ページあたりのコメント数は 25 個です。

StringcurrentPageUrl

32.0Small、32.0コメントのコレクションComment[]items

23.0Small、29.0コメントの次のページ、つまり以前のコメントへの URL。デフォルトの 1 ページあたりのコメント数は 25 個です。検索結果にコメントをさらに読み込むと、検索語と一致するコメントだけでなく、スレッ

StringnextPageUrl

ド内のすべてのコメントが更新されます。コメントが更新されるまで、nextPageUrlを使用しないでください。

23.0Small、29.0親フィード項目の全ページのコメント合計数Integertotal

Comments Capability

フィード要素にこの機能がある場合、コンテキストユーザはコメントを追加できます。




32.0Small、32.0このフィード要素のコメント情報。Comment Pagepage

598

Comment PageChatter REST API レスポンスボディ

Community




31.0Small、31.0ゲストユーザがログインせずにコミュニティの公開グループにアクセスできるかどうかを指定します。

BooleanallowChatterAccessWithoutLogin

30.0Small、30.0コミュニティのメンバーがコンテンツにフラグを設定できるかどうかを指定します。

BooleanallowMembersToFlag

26.0Small、29.0コミュニティの説明Stringdescription

26.0Small、29.0コミュニティの 18 文字の IDStringid

26.0Small、29.0コミュニティのメンバーが他のメンバーをコミュニティに招待できるかどうかを示しま

BooleaninvitationsEnabled

す。できる場合は true、できない場合はfalse となります。

30.0Small、30.0トピックについて、知識のあるユーザと支持を使用できるか (true)、否か (false) を指定します。

BooleanknowledgeableEnabled

26.0Small、29.0コミュニティ名Stringname

32.0Small、32.0コミュニティでニックネームを表示するかどうかを指定します。

BooleannicknameDisplayEnabled

30.0Small、30.0同じコミュニティのメンバー同士が互いに非公開のメッセージを送受信できるか (true)、否か (false) を指定します。

BooleanprivateMessagesEnabled

31.0Small、31.0コミュニティのメンバーに対する評価が計算および表示されるかどうかを指定します。

BooleanreputationEnabled

26.0Small、29.0お知らせメールが自動的に生成されて、新しいメンバーに送信されるかどうかを示しま

BooleansendWelcomeEmail

す。メールが送信される場合は true、送信されない場合は false となります。

26.0Small、29.0お知らせメールが自動的に生成されて、新しいメンバーに送信されるかどうかを示しま

BooleansendWelcomeEmail

す。メールが送信される場合は true、送信されない場合は false となります。

30.0Small、30.0コミュニティのサイト URL (カスタムドメイン + URL プレフィックス)。

StringsiteUrl

599

CommunityChatter REST API レスポンスボディ




28.0Small、29.0コミュニティの状況。値は次のとおりです。Stringstatus

• Live

• Inactive

• UnderConstruction

26.0Small、29.0コミュニティに固有の URL プレフィックスStringurlPathPrefix

26.0Small、29.0コミュニティへのフル URLStringurl

Community Page




26.0Small、29.0現在のユーザが使用できるコミュニティのリスト

Community[]communities

26.0Small、29.0コミュニティの合計数Integertotal

Connect Directory




26.0Small、29.0現在の組織内のコミュニティのリストCommunity[]communities

25.0Small、29.0Chatter 組織への URLStringorganization

Content Capability

フィード要素にこの機能がある場合、添付ファイルがあります。投稿されたフィード要素からコンテンツが削除された場合、またはコンテンツへのアクセス権が非公開に変更された場合、Content Capability は存在しますが、そのプロパティのほとんどが null になります。

600

Community PageChatter REST API レスポンスボディ




32.0Small、32.0ファイルの MD5 チェックサム。Stringchecksum

32.0Small、32.0このファイルに関連付けられた外部データソース、または、外部ファ

Files Connect リポジトリ

contentHubRepository

イルを指し示していない場合はnull。

32.0Small、32.0リンクおよび Google ドキュメントのコンテンツの URL。

StringcontentUrl

32.0Small、32.0添付ファイルの説明。Stringdescription

32.0Small、32.0コンテンツへの URL。StringdownloadUrl

32.0Small、32.0このファイルが指し示す外部 URL、または、外部ファイルを指し示していない場合は null。

StringexternalDocumentUrl

32.0Small、32.0ファイルの拡張子。StringfileExtension

32.0Small、32.0ファイルのサイズ (バイト)。サイズを判定できない場合は、Unknown

を返します。

StringfileSize

32.0Small、32.0ファイルの種類。StringfileType

32.0Medium、32.0ファイルで PDF プレビューを使用できる場合は true。それ以外の場合は false。

BooleanhasPdfPreview

32.0Small、32.0コンテンツの 18 文字の ID。Stringid

32.0Small、32.0ファイルが Salesforce Files Syncと同期されている場合は true、同期されていない場合は false。


32.0Small、32.0ファイルの MIME タイプ。StringmimeType

32.0Small、32.0ファイルの変換リソースへの URL。変換は非同期で処理され、ファイ

StringrenditionUrl

ルのアップロード直後は使用できない場合があります。

32.0Small、32.0ファイルの 240×180 サイズの変換リソースへの URL。変換は非同期で処

StringrenditionUrl240By180

理され、ファイルのアップロード直後は使用できない場合があります。

601

Content CapabilityChatter REST API レスポンスボディ




32.0Small、32.0ファイルの 720 × 480 サイズの変換リソースへの URL。変換は非同期で


処理され、ファイルのアップロード直後は使用できない場合があります。

32.0Small、32.0外部リポジトリファイルのプロパティへのアクセスを提供するChatter

StringrepositoryFileUrl

REST APIリソースの URL。このファイルが外部ファイルを参照していない場合は null。

35.0Medium、35.0ファイルの共有オプション。値は次のとおりです。

StringsharingOption



32.0Big、32.0可能な場合はファイルのテキストプレビュー、それ以外の場合は

StringtextPreview

null です。最大文字数は 200 文字です。

32.0Medium、32.0ファイルの 120×90 ピクセルサイズのプレビュー画像の表示状況。

Stringthumb120By90RenditionStatus

Processing (処理中)、Failed (失敗)、Success (成功)、NA (使用不可の場合)

のいずれかになります。32.0Medium、32.0ファイルの 240 × 180 ピクセルサイ

ズのプレビュー画像の表示状況。Stringthumb240By180

RenditionStatus


のいずれかになります。32.0Medium、32.0ファイルの 720 × 480 ピクセルサイ

ズのプレビュー画像の表示状況。Stringthumb720By480

RenditionStatus


のいずれかになります。32.0Small、32.0ファイルのタイトル。Stringtitle

32.0Medium、32.0ファイルのバージョン ID。StringversionId

602

Content CapabilityChatter REST API レスポンスボディ

Conversation Detail




23.0Medium、29.0会話の 18 文字の IDStringconversationId

23.0Small、29.0会話詳細ページへの URLStringconversationUrl

23.0Small、29.0この会話に参加しているユーザのコレクション

UserSummary[]

members

23.0Small、29.0この会話に含まれるメッセージMessageCollection

messages

23.0Small、29.0この会話内にコンテキストユーザが未読のメッセージがあるかどうか

Booleanread

Conversation Summary




23.0Small、29.0会話の 18 文字の IDStringid

23.0Small、29.0この会話の最新メッセージメッセージlatestMessage

23.0Small、29.0会話に参加しているユーザのコレクションUser Summary[]members

23.0Small、29.0この会話内にコンテキストユーザが未読のメッセージがあるかどうか

Booleanread

23.0Small、29.0会話詳細ページへの URLStringurl

Conversation Summary Collection




23.0Small、29.00 個以上の会話のコレクションConversationSummary[]

conversations

23.0Medium、29.0会話の現在のページへの URLStringcurrentPageUrl

603

Conversation DetailChatter REST API レスポンスボディ




23.0Small、29.0会話の次のページ、つまり、以前の会話へのURL

StringnextPageUrl

Conversation Unread Count




23.0Small、29.0実際の未読会話数が 50 を超えている場合はtrue、50 以下の場合は false

BooleanhasMore

23.0Small、29.0未読会話、つまり未読メッセージを含む会話の数。未読会話数が 50 以下の場合は正確な

IntegerunreadCount

値が返され、50 を超えている場合は 50 が返されます。

Dashboard Component Snapshot

ダッシュボードコンポーネント値がしきい値を超えたときに受信する、ダッシュボードコンポーネントスナップショットとアラートの両方を表します。




32.0Small、32.0ダッシュボードコンポーネントの18 文字の ID。

StringcomponentId

32.0Small、32.0ダッシュボードコンポーネント名。StringcomponentName

32.0Small、32.0このテキストをフィード要素のアクターの横に表示します。このテ

StringdashboardBodyText

キストは、デフォルトの本文テキストの代わりに使用します。

32.0Small、32.0ダッシュボードの 18 文字の ID。StringdashboardId

32.0Small、32.0ダッシュボード名。StringdashboardName

32.0Small、32.0スナップショットのフルサイズ画像を取得するためのソース URL。こ

StringfullSizeImageUrl

604

Conversation Unread CountChatter REST API レスポンスボディ




の URL には、OAuth ログイン情報でアクセスします。

32.0Small、32.0このダッシュボードコンポーネントの最終更新日を示す ISO-8601 形式の日付。

DatelastRefreshDate

32.0Small、32.0最終更新日の表示テキスト (「最終更新 2013 年 10 月 31 日」など)。

StringlastRefreshDateDisplayText

32.0Small、32.0スナップショットが投稿された時点のダッシュボードの実行ユーザ。

User SummaryrunningUser

この値は、nullになる場合があります。各ダッシュボードには実行ユーザがおり、そのユーザのセキュリティ設定によってダッシュボードに表示されるデータが決まります。

32.0Small、32.0スナップショットのサムネイル画像を取得するためのソース URL。こ

StringthumbnailUrl

の URL には、OAuth ログイン情報でアクセスします。

Dashboard Component Snapshot Capability

フィード要素にこの機能がある場合、ダッシュボードコンポーネントスナップショットがあります。スナップショットとは、特定の時点でのダッシュボードコンポーネントの静的な画像です。




32.0Small、32.0ダッシュボードコンポーネントのスナップショット。

DashboardComponentSnapshot

dashboardComponentSnapshot

Datacloud Company

Data.com会社レコード。会社レコードを所有している場合は、すべての項目が表示されます。会社レコードを所有していない場合は、一部の項目が非表示になりアスタリスク (***) が示されます。

605

Dashboard Component Snapshot CapabilityChatter REST API レスポンスボディ




32.0Small、32.0会社の有効な取引先責任者の数。

IntegeractiveContacts

32.0Small、32.0会社の住所。ConnectApi.Addressaddress

32.0Small、32.0会社の 1 年間の売上。DoubleannualRevenue

32.0Small、32.0会社の一意の数値識別子。StringcompanyId

32.0Small、32.0会社の説明。Stringdescription

32.0Small、32.0一意の事業所を識別するために Dun & Bradstreet (D&B) が割り

StringdunsNumber

当てる、ランダムに生成された 9 桁の数値。

32.0Small、32.0会社が事業を行っている重点領域の説明。

Stringindustry

32.0Small、32.0会社情報がもはや正確ではないか (true)、最新の情報か(false)。

BooleanisInactive

32.0Small、32.0自分または所属する組織によって会社が購入されたか(true)、否か (false)。

BooleanisOwned

32.0Small、32.0North American Industry

Classification System (NAICS) コーStringnaicsCode

ドは、企業のサービス指向の詳細を示すために作成されました。このコードの説明は、業務内容に焦点が絞られています。

32.0Small、32.0NAICS 分類の説明。StringnaicsDescription

32.0Small、32.0会社名。Stringname

32.0Small、32.0会社の従業員数。IntegernumberOfEmployees

32.0Small、32.0会社形態の種別。Stringownership

• 公開• 非公開• 政府機関• その他

606

Datacloud CompanyChatter REST API レスポンスボディ




32.0Small、32.0会社の代表電話番号を含む数値文字列。

ConnectApi.PhoneNumberphoneNumbers

32.0Small、32.0Standard Industrial Codes (SIC) は、会社が提供するサービス種別を示す採番規則。

Stringsic

32.0Small、32.0SIC 分類の説明。StringsicDescription

32.0Small、32.0会社の所在地の種類 (「本社」など)。

Stringsite

32.0Small、32.0公開証券取引所で取引される、会社を一意に識別する記号。

StringtickerSymbol

32.0Small、32.0公開証券取引所で取引される、会社を一意に識別する記号。

StringtradeStyle

32.0Small、32.0この会社の情報の最終更新日。

DateupdatedDate

32.0Small、32.0会社の Web サイトへの URL。Stringwebsite

32.0Small、32.0会社の創立年。StringyearStarted

Datacloud Company Collection

特定の注文で購入されたすべての会社の購入の詳細。




32.0Small、32.0特定の注文のすべての会社のリスト。

ConnectApi.DatacloudCompanycompanies

32.0Medium、32.0会社の現在のページへの URL。StringcurrentPageUrl

32.0Small、32.0会社の次のページへの URL。次のページがない場合、値はnull です。

StringnextPageUrl

607

Datacloud Company CollectionChatter REST API レスポンスボディ




32.0Medium、32.0会社の前のページへの URL。前のページがない場合、値はnull です。


32.0Small、32.0注文に含まれる会社数。ユーザは、1 ページにつき何件の会

Integertotal

社を表示するかを設定できます。デフォルトのページサイズは 25 です。

Datacloud Contact

Data.comの取引先責任者に関する情報。取引先責任者を所有している場合は、すべての項目が表示されます。取引先責任者を所有していない場合は、一部の項目が非表示になりアスタリスク (***) が示されます。




32.0Small、32.0この取引先責任者が勤務する会社の郵送先住所。

ConnectApi.Address[]address

32.0Small、32.0取引先責任が勤務する会社の一意の数値識別子。

StringcompanyId

32.0Small、32.0取引先責任者が勤務する会社の名前。

StringcompanyName

32.0Small、32.0取引先責任者の一意の数値識別子。

StringcontactId

32.0Small、32.0取引先責任者が所属する部門の名前。

Stringdepartment

32.0Small、32.0この取引先責任者のメールアドレス。

Stringemail

32.0Small、32.0取引先責任者の名。StringfirstName

32.0Small、32.0true または false の応答。true はレコードがもう有効で

BooleanisInactive

はないことを示します。false

は、取引先責任者がまだ有効であることを示します。

608

Datacloud ContactChatter REST API レスポンスボディ




32.0Small、32.0組織がこの取引先責任者を所有しているかどうかを示します。

BooleanisOwned

32.0Small、32.0取引先責任者の姓。StringlastName

32.0Small、32.0会社での人の役職レベルを指定する人事の表示ラベル。

Stringlevel

32.0Small、32.0取引先責任者の直通電話番号を含む数値文字列。

ConnectApi.PhoneNumber[]phoneNumbers

32.0Small、32.0取引先責任者の役職。Stringtitle

32.0Small、32.0この取引先責任者の情報の更新日。

DateupdatedDate

Datacloud Contact Collection

特定の注文で購入されたすべての取引先責任者の購入の詳細。




32.0Small、32.0特定の orderIdのすべての取引先責任者のリスト。

ConnectApi.DatacloudContact[]contacts

32.0Medium、32.0取引先責任者の現在のページ。

StringcurrentPageUrl

32.0Small、32.0取引先責任者の次のページへの URL。取引先責任者に 1 ペー

StringnextPageUrl

ジしかない場合、値は null です。

32.0Medium、32.0取引先の前のページへの URL。取引先責任者に 1 ページしかない場合、値は null です。


32.0Small、32.0この注文に関連付けられた取引先責任者の数。取引先責任

Integertotal

者の総数は、1 ページに表示される取引先責任者の数よりも多くなる可能性があります。

609

Datacloud Contact CollectionChatter REST API レスポンスボディ

Datacloud Order

購入した Data.com レコードに関する情報と購入の詳細。




32.0Small、32.0特定の注文で購入されたレコードのリストへの URL。

StringentityUrl

32.0Small、32.0特定の注文を識別する orderId。Stringid

32.0Small、32.0この注文で購入されたレコードの数。

IntegerpurchaseCount

32.0Small、32.0レコードが購入された日付。DatepurchaseDate

32.0Small、32.0特定の注文の注文情報への URL。Stringurl

Datacloud Purchase Usage

組織のData.com購入利用状況に関する情報。月次ユーザおよびリストプールユーザの使用済みのクレジットおよび使用可能なクレジットを示します。




32.0Small、32.0リストプールグループのすべてのユーザが使用できるリストプールクレジット。

IntegerlistpoolCreditsAvailable

32.0Small、32.0リストプールグループのすべてのユーザによって使用されたリストプールクレジット。

IntegerlistpoolCreditsUsed

32.0Small、32.0特定のユーザに割り当てられた 1 か月あたりのクレジット。

IntegermonthlyCreditsAvailable

32.0Small、32.0特定のユーザによって 1 か月間に使用されたクレジット。

IntegermonthlyCreditsUsed

Edit Capability

フィード要素またはコメントにこの機能がある場合、権限を持つユーザはフィード要素またはコメントを編集できます。

610

Datacloud OrderChatter REST API レスポンスボディ




34.0Small、34.0このフィード要素またはコメントの編集が制限されているかどうか

BooleanisEditRestricted

を指定します。trueの場合、コンテキストユーザはこのフィード要素またはコメントを編集できません。false の場合、コンテキストユーザにこのフィード要素またはコメントを編集する権限がある場合とない場合があります。コンテキストユーザがフィード要素またはコメントを編集できるかどうかを判別するには、Feed Elements,

Editability または Comment Capability,

Editability リソースを使用します。34.0Medium、34.0コンテキストユーザがこのフィー

ド要素またはコメントを編集できStringisEditable

ByMeUrl

るかどうかをチェックするためのURL。

34.0Small、34.0このフィード要素またはコメントを最後に編集したユーザ。

User DetaillastEditedBy

34.0Small、34.0このフィード要素またはコメントの最終編集日。

DatelastEditedDate

34.0Small、34.0このフィード要素またはコメントの最新リビジョン。

IntegerlatestRevision

34.0Small、34.0相対的な最終編集日 (「2 時間前」など)。

StringrelativeLastEditedDate

Email Address

ケースフィードのケースレコードから送信されたメールメッセージのメールアドレス。




29.0Small、29.0メールアドレスの表示名StringdisplayName

29.0Small、29.0メールアドレスStringemailAddress

611

Email AddressChatter REST API レスポンスボディ

Email Message Capability

フィード要素にこの機能がある場合、ケースからのメールメッセージが含まれます。




32.0Small、32.0メールメッセージの方向。値は次のとおりです。

Stringdirection

• Inbound — インバウンドメッセージ (顧客が送信)。

• Outbound — アウトバウンドメッセージ (サポートエージェントが顧客に送信)。

32.0Small、32.0メールメッセージの ID。StringemailMessageId

32.0Small、32.0メールメッセージの件名。Stringsubject

32.0Big、32.0メールメッセージの本文。StringtextBody

32.0Small、32.0メールメッセージの宛先アドレス。Email Address[]toAddresses

Enhanced Link Capability

フィード要素にこの機能がある場合、アイコン、タイトル、説明などの補足情報を表示するリンクがあります。




32.0Small、32.0最大 500 文字の説明。Stringdescription

32.0Small、32.0アイコン。Iconicon

32.0Small、32.0リンク URL がSalesforceレコードを参照する場合に、そのリンクに関連付けられた ID。

StringlinkRecordId

32.0Small、32.0使用可能なコンテンツをインライン表示できない場合の詳細ページへのリンク URL。

StringlinkUrl

32.0Small、32.0詳細ページのタイトル。Stringtitle

612

Email Message CapabilityChatter REST API レスポンスボディ

Error Message




23.0Small、29.0エラーに関する情報を示すエラーコード(INSUFFICIENT_PRIVILEGES など)

StringerrorCode

23.0Small、29.0エラーの説明Stringmessage

Error with Output




27.0Small、29.0エラーの説明Stringmessage

27.0Small、29.0要求されたリソースで記述されるレスポンスボディ。たとえば、要求に成功すると Like レ

任意のレスポンスボディ

output

スポンスボディが返され、エラーが発生すると Error with Output レスポンスボディが返される場合、output プロパティの値は Like レスポンスボディになります。

Explanation Details

一部のおすすめの詳細説明を表します。




24.0Small、29.0おすすめの詳細情報。typeプロパティの値によって返される内容が異なります。

不特定data

• UserFollowsSameUsers — ユーザとおすすめユーザの両方がフォローしている人。「User Summary」を参照してください。

• GroupMembersFollowed — おすすめグループのメンバーのうち、ユーザがフォローしている人。「User Summary」を参照してください。

613

Error MessageChatter REST API レスポンスボディ




• UserViewingSameRecords — ユーザとおすすめユーザが最近表示したレコード。「Record Summary」を参照してください。

• RecordParentOfFollowed — おすすめレコードの子レコードのうち、ユーザがフォローしているレコード。「Record

Summary」を参照してください。

24.0Small、29.0おすすめの概要説明。Stringsummary

24.0Small、29.0おすすめの理由を示します。Stringtype

• Custom — カスタムのおすすめ。• FilePopular — フォロワー数または参

照数の多いファイル• FileViewedTogether — コンテキスト

ユーザが参照している他のファイルと同時に参照されることが多いファイル

• FollowedTogetherWithFollowees —

コンテキストユーザがフォローしているユーザと共にフォローされることが多いユーザ

• GroupMembersFollowed — コンテキストユーザがフォローしているメンバーのグループ

• GroupNew — 最近作成されたグループ• GroupPopular — 多くの有効なメンバー

がいるグループ• ItemViewedTogether — コンテキスト

ユーザが参照している他のレコードと同時に参照されることが多いレコード

• PopularApp — 人気のあるアプリケーション

• RecordOwned — コンテキストユーザが所有するレコード

• RecordParentOfFollowed — コンテキストユーザがフォローしているレコードの親レコード

614

Explanation DetailsChatter REST API レスポンスボディ




• RecordViewed — コンテキストユーザが最近参照したレコード

• UserDirectReport — コンテキストユーザの直属の部下

• UserFollowedTogether — コンテキストユーザがフォローしている他のユーザと同時にフォローされることが多いユーザ

• UserFollowsSameUsers — コンテキストユーザと同じユーザをフォローしているユーザ

• UserManager — コンテキストユーザのマネージャ

• UserNew — 最近作成されたユーザ• UserPeer — コンテキストユーザと同じ

マネージャに直属するユーザ• UserPopular — フォロワー数の多いユー

ザ• UserViewingSameRecords — コンテキ

ストユーザと同じレコードを参照しているユーザ

Explanation Summary

おすすめの概要説明を表します。




24.0Small、29.0説明の詳細の URL。おすすめに詳細説明がない場合は null。

StringdetailsUrl

23.0Small、29.0おすすめの概要説明。Stringsummary

24.0Small、29.0おすすめの理由を示します。Stringtype

• Custom — カスタムのおすすめ。• FilePopular — フォロワー数または参

照数の多いファイル

615

Explanation SummaryChatter REST API レスポンスボディ




• FileViewedTogether — コンテキストユーザが参照している他のファイルと同時に参照されることが多いファイル

• FollowedTogetherWithFollowees —

コンテキストユーザがフォローしているユーザと共にフォローされることが多いユーザ

• GroupMembersFollowed — コンテキストユーザがフォローしているメンバーのグループ

• GroupNew — 最近作成されたグループ• GroupPopular — 多くの有効なメンバー

がいるグループ• ItemViewedTogether — コンテキスト

ユーザが参照している他のレコードと同時に参照されることが多いレコード

• PopularApp — 人気のあるアプリケーション

• RecordOwned — コンテキストユーザが所有するレコード

• RecordParentOfFollowed — コンテキストユーザがフォローしているレコードの親レコード

• RecordViewed — コンテキストユーザが最近参照したレコード

• UserDirectReport — コンテキストユーザの直属の部下

• UserFollowedTogether — コンテキストユーザがフォローしている他のユーザと同時にフォローされることが多いユーザ

• UserFollowsSameUsers — コンテキストユーザと同じユーザをフォローしているユーザ

• UserManager — コンテキストユーザのマネージャ

• UserNew — 最近作成されたユーザ

616

Explanation SummaryChatter REST API レスポンスボディ




• UserPeer — コンテキストユーザと同じマネージャに直属するユーザ

• UserPopular — フォロワー数の多いユーザ

• UserViewingSameRecords — コンテキストユーザと同じレコードを参照しているユーザ

External File Permission Information

外部ファイルの権限情報。




35.0Small、35.0外部ファイルの親フォルダに対して使用可能な権限タイプ。外部ファ

Files ConnectPermission Type[]

externalFilePermissionTypes イル以外か、

includeExternalFilePermissionsInfo

が false の場合は null。35.0Small、35.0外部ファイル情報の取得に失敗し

たか、Booleanexternal

FilePermissionsFailure includeExternalFilePermissionsInfo

が false の場合は true。それ以外の場合は false。

35.0Small、35.0includeExternalFilePermissionsInfo

が trueで、障害が発生した場合はStringexternal

FilePermissionsInfoFailureReason 障害の説明。それ以外の場合は

null。35.0Small、35.0外部ファイルの現在の共有状況を

示します。値は次のとおりです。Stringexternal

FileSharingStatus

• DomainSharing — ファイルはドメインと共有されています。

• PrivateSharing — ファイルは非公開か、個人とのみ共有されています。

617

External File Permission InformationChatter REST API レスポンスボディ




• PublicSharing — ファイルは公開され、共有されています。

値は、外部ファイル以外か、includeExternalFilePermissionsInfo

が false の場合は、null です。35.0Small、35.0外部リポジトリ内の使用可能な公

開グループ。外部ファイル以外か、Repository GroupSummary[]

repositoryPublicGroups


が false の場合は null。

Favorite




26.0Medium、29.0コミュニティに関する情報。デフォルトのコミュニティにお気に入りが存在するか、コ

Referencecommunity

ミュニティが無効である場合は、nullが返されます。

24.0Medium、29.0お気に入りの最初の作成者に関する情報User SummarycreatedBy

24.0Small、29.0このお気に入りのフィード項目への URLStringfeedUrl

24.0Small、29.0お気に入りの 18 文字の IDStringid

24.0Medium、29.0ISO8601 の日付文字列 (例:2011-02-25T18:24:31.000Z)

StringlastViewDate

24.0Small、29.0お気に入りの名前Stringname

24.0Medium、29.0お気に入りが検索に基づく場合は検索テキストが含まれ、それ以外の場合は nullになります。

StringsearchText

28.0Small、29.0該当する場合はトピックへの参照、それ以外の場合は null

Referencetarget

24.0Small、29.0次のいずれかの値になります。Stringtype

• ListView

• Search

• Topic

618

FavoriteChatter REST API レスポンスボディ




24.0Small、29.0このお気に入りへの URLStringurl

24.0Medium、29.0このお気に入りを保存したユーザに関する情報

User Summaryuser

Favorites Page




24.0Small、29.01 つ以上のお気に入りのコレクションFavorite[]favorites

24.0Small、29.0お気に入りの合計数Integertotal

Features

コンテキストユーザが使用できる機能。機能が無効な場合は、その機能に関連付けられたリソースを使用できず、オブジェクトの機能に関連する一部のプロパティが null に設定されます。




27.0Small、29.0組織で Chatter が有効になっているかどうかを指定します。

Booleanchatter

24.0Small、29.0ユーザの詳細に Chatter 活動に関する情報が含まれるかどうかを示します。

BooleanchatterActivity

29.0Small、29.0Chatter アンサーが有効になっているかどうかを示します。

BooleanchatterAnswers

24.0Small、29.0ユーザの詳細にグローバル Chatter 活動が含まれるかどうかを示します。

BooleanchatterGlobalInfluence

33.0Small、33.0Chatter グループにレコードを関連付けられるかどうかを指定します。

BooleanchatterGroupRecords

33.0Small、33.0Chatter レコードがグループに追加されたとき、そのレコードがグループメンバー間で暗黙的に共有されるかどうかを指定します。

BooleanchatterGroupRecordSharing

619

Favorites PageChatter REST API レスポンスボディ




24.0Small、29.0Chatterメッセージが組織で有効になっているかどうかを示します。

BooleanchatterMessages

28.0Small、29.0Chatterトピックが有効かどうかを示します。BooleanchatterTopics

31.0Small、31.0Salesforce Communitiesが有効になっているかどうかを示します。

BooleancommunitiesEnabled

29.0Small、29.0この組織でコミュニティモデレーションが有効になっているかどうかを示します。

BooleancommunityModeration

32.0Small、32.0この組織のコミュニティで評価が有効になっているかどうかを示します。

BooleancommunityReputation

24.0Small、29.0ユーザがダッシュボードコンポーネントスナップショットを投稿できるかどうかを示します。

BooleandashboardComponentSnapshots

28.0Small、29.0デフォルト通貨の ISO コード。multiCurrency が false に設定されている場合のみ有効です。

StringdefaultCurrencyIsoCode

24.0Small、29.0将来の使用のために予約されています。BooleanfeedPolling

24.0Small、29.0ファイルが Chatter REST API のリソースとして機能できるかどうかを示します。

Booleanfiles

24.0Small、29.0ファイルをコメントに添付できるかどうかを示します。

BooleanfilesOnComments

28.0 ～ 29.0Small、29.0将来の使用のために予約されています。BooleangroupsCanFollow

29.0Small、29.0アイデアが有効になっているかどうかを示します。

Booleanideas

32.0Small、32.0コミュニティホームフィードと管理トピックフィードへのアクセスを示します。

BooleanmanagedTopicsEnabled

29.0Small、29.0将来の使用のために予約されています。BooleanmobileNotificationsEnabled

28.0Small、29.0ユーザの組織がマルチ通貨を使用するか(true)、否か (false) を示します。falseの

BooleanmultiCurrency

場合、defaultCurrencyIsoCodeはデフォルト通貨の ISO コードを示します。

28.0Small、29.0パブリッシャーアクションが有効かどうかを示します。

BooleanpublisherActions

620

FeaturesChatter REST API レスポンスボディ




30.0Small、30.0Salesforce1 ダウンロード可能アプリケーションがモバイルデバイス上の安全な永続スト

BooleanstoreDataOnDevicesEnabled レージを使用してデータをキャッシュできる

かどうかを示します。24.0Small、29.0トピックのトレンドが有効かどうかを示しま

す。BooleantrendingTopics

24.0Small、29.0既存の Chatter ユーザが同僚を Chatter に招待できるかどうかを示します。

BooleanviralInvitesAllowed

Feed




31.0Small、31.0この件名に対するフィード要素を投稿するための URL

HTTP ヘッダー X-Connect-Bearer-Urls:

trueを含む要求によって返される場合、URL

StringfeedElementPostUrl

にベアラートークンが含まれます。このベアラートークン URL を使用して、POST 要求を実行します。

31.0Small、31.0フィード要素の URLStringfeedElementsUrl

23.0 ～ 31.0Small、29.0フィード項目の URLStringfeedItemsUrl

23.0Small、29.0将来の使用のために予約されています。StringisModifiedUrl

35.0Small、35.0フィードでミュート機能が考慮されるかどうかを示します。true の場合は、

BooleanrespectsMute

isMutedByMe の値に応じて、各要素をミュートまたはミュート解除する機能がフィードに表示されます。組織でミュート機能が無効になっている場合は null。

621

FeedChatter REST API レスポンスボディ

Feed Directory




24.0Small、29.0コンテキストユーザが保存したお気に入りのコレクション。

Favorite[]favorites

23.0Small、29.0コンテキストユーザに表示が許可されているフィードディレクトリ項目のコレクション。

Feed Directory Item[]feeds

Feed Directory Item

フィードの定義。




31.0Small、31.0特定のフィードのフィード要素のリソースへの URL。次に例を示します。/chatter/feeds/files/me/feed-elements

StringfeedElementsUrl

23.0 ～ 31.0Small、29.0特定のフィードのフィード項目のリソースへの URL。次に例を示します。/chatter/feeds/files/me/feed-elements

StringfeedItemsUrl

30.0Big、30.0フィード種別。次のいずれかの値にします。StringfeedType

• Bookmarks — コンテキストユーザがブックマークとして保存したすべてのフィード項目が含まれます。

• Company — 種別 TrackedChange のフィード項目を除くすべてのフィード項目が含まれます。ユーザがフィード項目を表示するには、親への共有アクセス権が必要です。

• Files — コンテキストユーザがフォローしている人またはグループによって投稿されたファイルを含むすべてのフィード項目が含まれます。

• Filter — 指定したオブジェクト種別の親を持つフィード項目を含むように絞り

622

Feed DirectoryChatter REST API レスポンスボディ




込まれたニュースフィードが含まれます。

• Groups — コンテキストユーザが所有するか、メンバーであるすべてのグループのすべてのフィード項目が含まれます。

• Home — コミュニティの管理トピックに関連付けられたすべてのフィード項目が含まれます。

• Moderation — モデレーション用にフラグが設定されたすべてのフィード項目が含まれます。このコミュニティモデレーションフィードは、「コミュニティフィードのモデレート」権限を持つユーザのみが使用できます。

• Mute — コンテキストユーザがミュートしたすべてのフィード項目が含まれます。

• News — コンテキストユーザがフォローする人、ユーザがメンバーとなっているグループ、およびユーザがフォローするファイルとレコードからのすべての更新が含まれます。また、親がコンテキストユーザであるレコード、およびコンテキストユーザをメンションするかコンテキストユーザがメンバーとなっているグループをメンションするすべてのフィード項目とコメントのすべての更新も含まれます。

• People — コンテキストユーザがフォローしているすべての人によって投稿されたすべてのフィード項目が含まれます。

• Record — 親が指定したレコードであるすべてのフィード項目が含まれます。レコードは、グループ、ユーザ、オブジェクト、ファイル、その他の標準またはカスタムオブジェクトの場合があります。レコードがグループの場合、フィードにはそのグループにメンションしているフィード項目も含まれます。レコードが

623

Feed Directory ItemChatter REST API レスポンスボディ




ユーザの場合、フィードにはそのユーザに対するフィード項目のみが含まれます。別のユーザのレコードフィードを取得できます。

• To — コンテキストユーザのメンションを含むすべてのフィード項目、コンテキストユーザがコメントしたフィード項目、コンテキストユーザが作成し、コメントされたフィード項目が含まれます。

• Topics — 指定したトピックを含むすべてのフィード項目が含まれます。

• UserProfile — フィードで追跡可能なレコードをユーザが変更したときに作成されたフィード項目、親がユーザであるフィード項目、およびユーザに @メンションしているフィード項目が含まれます。このフィードは、グループ更新など、より多くのフィード項目を返すニュースフィードとは異なります。別のユーザのユーザプロファイルフィードを取得できます。

23.0Small、29.0特定のフィードのリソースへの URL。次に例を示します。/services/data/v35.0/chatter/feeds/files/me

StringfeedUrl

30.0Big、30.0条件フィードの場合、この値は、このフィードの絞り込みに使用されるエンティティ種別

StringkeyPrefix

に関連付けられたキープレフィックスです。このフィードのすべてのフィード項目では、親のエンティティ種別がこのキープレフィックス値と一致します。条件以外のフィードの場合、この値は null です。キープレフィックスは、レコード ID の先頭3 文字で、エンティティ種別を示します。

23.0Small、29.0グループ、人、会社など、フィードの名前Stringlabel

624

Feed Directory ItemChatter REST API レスポンスボディ

Feed Element Capabilities

フィード要素に含めることができるすべての機能のコンテナ。API バージョン 30.0 以前では、各フィード項目にコメント、いいね!、トピックなどを含めることができました。バージョン 31.0 以降では、各フィード項目 (およびフィード要素) に一意の機能セットを含めることができます。フィード要素に機能プロパティが存在する場合、機能プロパティに値がなくてもその機能を使用できます。たとえば、ChatterLikes機能プロパティがフィード要素に存在している場合、(値の有無に関係なく) コンテキストユーザはそのフィード要素にいいね! と言うことができます。機能プロパティが存在しない場合、そのフィード要素にいいね! と言うことはできません。機能には、関連データを含めることもできます。たとえば、Moderation 機能には、モデレーションフラグに関するデータが含まれます。




32.0Small、32.0フィード要素にこの機能がある場合、承認に関する情報が含まれています。

Approval Capabilityapproval

31.0Small、31.0フィード要素にこの機能がある場合、フィード要素にプラット

Associated ActionsCapability

associatedActions

フォームアクションが関連付けられています。

31.0Small、31.0このフィード要素にこの機能がある場合、フィード要素にバナーの

Banner Capabilitybanner

モチーフとスタイルが含まれます。

31.0Small、31.0フィード要素にこの機能がある場合、コンテキストユーザがその

BookmarksCapability

bookmarks

フィード要素をブックマークできます。

31.0Small、31.0フィード要素にこの機能がある場合、フィード要素は 1 つのフィー

Generic BundleCapability

または

bundle

ド要素に集約された他のフィード要素のグループとなることができます。

Tracked ChangeBundle Capability

32.0Small、32.0フィード要素にこの機能がある場合、キャンバスアプリケーションを表示します。

Canvas Capabilitycanvas

32.0Small、32.0フィード要素にこの機能がある場合、ケースフィード上にケースコメントがあります。

Case CommentCapability

caseComment

625

Feed Element CapabilitiesChatter REST API レスポンスボディ




31.0Small、31.0フィード要素にこの機能がある場合、コンテキストユーザはいいね!

Chatter LikesCapability

chatterLikes

と言うことができます。既存のいいね! に関する情報が公開されます。

31.0Small、31.0フィード要素にこの機能がある場合、コンテキストユーザはコメントを追加できます。

CommentsCapability

comments

32.0Small、32.0フィード要素にこの機能がある場合、添付ファイルがあります。フィード要素からコンテンツが削除された場合、またはアクセス権

Content Capabilitycontent

が非公開に変更された場合、ほとんどの Content Capability プロパティは null になります。

32.0Small、32.0フィード要素にこの機能がある場合、ダッシュボードコンポーネン

DashboardComponentSnapshot Capability

dashboardComponentSnapshot

トのスナップショットがあります。スナップショットとは、特定の時点でのダッシュボードコンポーネントの静的な画像です。

34.0Small、34.0フィード要素にこの機能がある場合、権限を持つユーザはフィード要素を編集できます。

Edit Capabilityedit

32.0Small、32.0フィード要素にこの機能がある場合、ケースからのメールメッセージがあります。

Email MessageCapability

emailMessage

32.0Small、32.0フィード要素にこの機能がある場合、このフィード要素には、アイ

Enhanced LinkCapability

enhancedLink

コン、タイトル、説明などの補足情報が表示されるリンクがあります。

32.0Small、32.0フィード要素にこの機能がある場合、リンクがあります。

Link Capabilitylink

31.0Small、31.0フィード要素にこの機能がある場合、コミュニティのユーザは

ModerationCapability

moderation

フィード要素にモデレーションフ

626





ラグを設定できます。このレスポンスボディには、フラグが設定されたコンテンツに関する情報も含まれます。

35.0Small、35.0フィード要素にこの機能がある場合、ユーザがフィード要素をミュートできます。

Mute Capabilitymute

31.0Small、31.0フィード要素にこの機能がある場合、フィード要素に投票のアンケートを含めることができます。

Poll Capabilitypoll

33.0Small、33.0フィード要素にこの機能がある場合、そのフィード要素はフィード

Origin Capabilityorigin

アクションによって作成されています。

31.0Small、31.0フィード要素にこの機能がある場合、質問があり、フィード要素の

Question andAnswers Capability

questionAndAnswers

コメントはその質問への回答です。

32.0Small、32.0フィード要素にこの機能がある場合、おすすめがあります。

RecommendationsCapability

recommendations

32.0Small、32.0フィード要素にこの機能がある場合、1 つのレコード作成イベントに

Record SnapshotCapability

recordSnapshot

ついて、レコードのスナップショットとして取得された項目すべてが含まれます。

31.0Small、31.0フィード要素にこの機能がある場合、コンテキストユーザはトピッ

Topics Capabilitytopics

クを追加できます。トピックは、ユーザが会話を整理して検索するために役立ちます。

32.0Small、32.0フィード要素にこの機能がある場合、1 つの変更追跡イベントについ

Tracked ChangesCapability

trackedChanges

て、レコードへのすべての変更が含まれます。

627


Feed Element Page

ページ設定された結果を含むフィード要素のコンテナ。




31.0Medium、31.0現在のページを識別するChatter

REST API URL。StringcurrentPageUrl

31.0Small、31.0フィード要素のコレクション。フィード要素は次のいずれかになります。

elements

• 汎用フィード要素• Feed Item

31.0Medium、31.0将来の使用のために予約されています。

StringisModifiedToken

31.0Medium、31.0将来の使用のために予約されています。

StringisModifiedUrl

31.0Small、31.0次のページを識別するトークン。次のページがない場合はnull。

StringnextPageToken

31.0Small、31.0次のページを識別する Chatter

REST API URL。次のページがないStringnextPageUrl

場合は null。別のページを取得する前に、この値が null であるかどうかを確認します。ページが存在しない場合は、ConnectApi.NotFoundException

エラーが返されます。31.0Big、31.0updatedSinceパラメータで使

用するトークン。使用できないStringupdatesToken

場合は null です。ニュースフィードがいつ最終更新されたのかを記述する不透明ポーリングトークン。これは、/chatter/feeds/news/me/feed-elementsリソースの updatedSince 要求パラメータの値として使用します。

628

Feed Element PageChatter REST API レスポンスボディ




31.0Big、31.0フィードの更新以降に更新されたフィード要素を含む

StringupdatesUrl


リソース。フィードが更新のポーリングをサポートしていない場合、値は null です。

Feed Entity Is Editable

コンテキストユーザがフィード要素またはコメントを編集できるかどうかを示します。




34.0Small、34.0フィード要素またはコメントのURL。

StringfeedEntityUrl

34.0Small、34.0コンテキストユーザがフィード要素またはコメントを編集できる場

BooleanisEditableByMe

合は true、それ以外の場合はfalse。

Feed Item

フィードは、フィード要素で構成されます。フィード項目は、フィード要素の種類の 1 つです。




Small、29.0フィード項目を作成したエンティティ。値は次のとおりです。

親によって異なる

actor

• Record Summary — レコードの場合 (23.0)

• User Summary — ユーザの場合 (23.0)

• Unauthenticated User — Chatter 顧客の場合(24.0)

メモ: アクターがユーザである場合、User Summary レスポンスボディが返さ

629

Feed Entity Is EditableChatter REST API レスポンスボディ




れ、ユーザ種別の Record Summary は返されません。

Medium、29.0添付ファイルの type 値によって異なります。次のような値があります。

種別によって異なる

attachment

• Approval – Feed Item Attachment: Approval

(v27.0 ～ 31.0)

• BasicTemplate – Feed Item Attachment: Basic

Template (v27.0 ～ 31.0)

• Canvas – Feed Item Attachment: Canvas

Template (v29.0 ～ 31.0)

• CaseComment – Feed Item Attachment: Case

Comment (v24.0 ～ 31.0)

• Content – Feed Item Attachment: Content。コンテンツを使用できない場合は null

(v23.0 ～ 31.0)

• DashboardComponent – Feed Item

Attachment: Dashboard (v24.0 ～ 31.0)

• EmailMessage – Feed Item Attachment: Email

Message (v29.0 ～ 31.0)

• Link – Feed Item Attachment: Link (v23.0 ～ 31.0)

• Poll – Feed Item Attachment: Poll (v26.0 ～ 31.0)

• RecordSnapshot – Feed Item Attachment:

Record Snapshot (v29.0 ～ 31.0)

• TrackedChange – Feed Item Attachment:

Tracked Change (v29.0 ～ 31.0)

重要: API バージョン 32.0 以降では、capabilitiesプロパティを使用します。

23.0Small、29.0フィード項目に関する情報。API バージョン 28.0 以前では、/body/text

プロパティをテキスト表示のデフォルトケー

Feed Item Bodybody

スとして使用します。API バージョン 29.0 ～30.0 では、/preamble/textプロパティをテキスト表示のデフォルトケースとして使用します。API バージョン 31.0 以降で

630

Feed ItemChatter REST API レスポンスボディ




は、/header/text プロパティをテキスト表示のデフォルトケースとして使用します。

31.0Medium、31.0フィード要素に関する補助情報。フィード要素の特性は、これらの機能で構成されます。

Feed ElementCapabilities

capabilities

27.0Medium、29.0フィード項目を共有できる場合は true、それ以外の場合は false

BooleancanShare

23.0Medium、29.0接続の認証に使用される接続アプリケーションに関する情報

ClientInfoclientInfo

23.0 ～ 31.0Small、29.0このフィード項目へのコメント。Comment Pagecomments

重要: API バージョン 32.0 以降では、capabilities.comments.pageプロパティを使用します。


StringcreatedDate

23.0 ～ 24.0ReferencecurrentUserLikeメモ: このプロパティは、バージョン24.0 以降、使用できなくなります。代わりに、myLike プロパティを使用してください。

該当する場合は Like オブジェクトへの参照、それ以外の場合は null。

23.0Medium、29.0フィード項目が行動の変更によって作成された場合は true、それ以外の場合は false

Booleanevent

31.0Small、31.0フィード要素は、フィードに含まれる最上位のオブジェクトです。フィード要素の種類


は、このフィード要素の特徴を記述します。次のいずれかの値にします。• Bundle — フィード要素のコンテナ。バ

ンドルには、メッセージセグメントを構成する本文も含まれます。メッセージセグメントは、テキストのみの値に常に適切に分解できます。

• FeedItem — フィード項目には 1 つの親があり、その範囲は 1 つのコミュニティまたはすべてのコミュニティになりま

631





す。フィード項目にはブックマーク、キャンバス、コンテンツ、コメント、リンク、アンケートなどの機能を設定できます。フィード項目には、メッセージセグメントを構成する本文が含まれます。メッセージセグメントは、テキストのみの値に常に適切に分解できます。

• Recommendation — おすすめは、おすすめ機能を備えたフィード要素です。おすすめは、コンテキストユーザに、フォローするレコード、参加するグループ、または役に立つアプリケーションを推奨します。

31.0Medium、31.0ヘッダーは投稿のタイトルです。このプロパティには、メッセージのすべてのセグメント

Feed Item Bodyheader

に対する表示可能なプレーンテキストが含まれます。クライアントでフィード要素の種類の表示方法がわからない場合、このテキストが表示されます。

23.0Small、29.0フィード項目の 18 文字の IDStringid

24.0 ～ 31.0Medium、29.0現在のユーザがこのフィード項目をブックマークしている場合は true、それ以外の場合は false。


重要: API バージョン 32.0 以降では、capabilities.bookmarks.isBookmarkedByCurrentUser


25.0Medium、29.0コンテキストユーザがフィード項目を削除できない場合は true を返します。false が

BooleanisDeleteRestricted

返された場合、コンテキストユーザがコメントを削除できる可能性があります。

23.0 ～ 31.0Medium、29.0現在のユーザがこのフィード項目にいいね!

と言った場合は true、それ以外の場合はfalse。

BooleanisLikedByCurrentUser

重要: API バージョン 32.0 以降では、capabilities.chatterLikes.isLikedByCurrentUser


632





23.0 ～ 31.0Medium、29.0このフィード項目へのいいね!。Like Pagelikes

重要: API バージョン 32.0 以降では、capabilities.chatterLikes.page


27.0 ～ 31.0Small、29.0フィード項目にいいね! と言ったユーザを説明するメッセージ本文。


重要: API バージョン 32.0 以降では、capabilities.chatterLikes.likesMessage



StringmodifiedDate

29.0 ～ 31.0Big、29.0このフィード項目のフラグ。コミュニティモデレータは、フラグ付き項目を表示したり、

Moderation FlagsmoderationFlags

フラグ付き項目に対してアクションを実行したりできます。Features レスポンスボディのcommunityModeration プロパティがfalse の場合、このプロパティは null になります。

重要: API バージョン 32.0 以降では、capabilities.moderation.moderationFlags


23.0 ～ 31.0Medium、29.0コンテキストユーザがコメントにいいね! と言った場合はその特定のいいね! への参照、それ以外の場合は null。

ReferencemyLike

重要: API バージョン 32.0 以降では、capabilities.chatterLikes.myLike


24.0Small、29.0このフィード項目が共有フィード項目の場合は、元のフィード項目への参照、それ以外の場合は null

ReferenceoriginalFeedItem

633





24.0Medium、29.0値は元のフィード項目の種別によって異なります。値は次のとおりです。


originalFeedItemActor

• Record Summary – 元のフィード項目がレコードの場合

• User Summary – 元のフィード項目がユーザの場合

• Unauthenticated User — 元のフィード項目がChatter 顧客からのものである場合

• このフィード項目が共有フィード項目ではない場合は null

23.0Medium、29.0値は親の種別によって異なります。値は次のとおりです。


parent

• File Summary – 親がファイルの場合• Group – 親がグループの場合• Record Summary – 親がレコードの場合• User Summary – 親がユーザの場合

メモ: 親がユーザである場合、User

Summary レスポンスボディが返され、ユーザ種別の Record Summary は返されません。グループとファイルの両方についても同様です。

23.0Medium、29.0フィード項目に関連付けられた写真の URLStringphotoUrl

27.0 ～ 30.0Medium、29.0preamble は投稿のタイトルです。このプロパティには、「App Builders - Pam Jones」など、

Feed Item PreambleMessage Body

preamble

メッセージのすべてのセグメントに対する表示可能なプレーンテキストが含まれます。API バージョン 28.0 以前では、/body/text

プロパティをテキスト表示のデフォルトケースとして使用します。API バージョン 29.0 ～30.0 では、/preamble/textプロパティをテキスト表示のデフォルトケースとして使用します。API バージョン 31.0 以降では、/header/text プロパティをテキスト表示のデフォルトケースとして使用します。

634






StringrelativeCreatedDate

28.0 ～ 31.0Medium、29.0このフィード項目のトピック。Feed Items Topicstopics

重要: API バージョン 32.0 以降では、capabilities.topics.items プロパティを使用します。

23.0Small、29.0typeプロパティは、API バージョンに関係なく、常にすべての種別を返します。ただし、

Stringtype

すべての API バージョンですべての種別が有効なわけではありません。

重要: API バージョン 32.0 以降では、capabilitiesプロパティを使用してフィード項目の機能を判断できます。「機能」を参照してください。

値は次のとおりです。• ActivityEvent — フィードが有効になっ

ている親レコードに関連付けられた行動または ToDo が作成または更新されるときに、ケースフィードに生成されるフィード項目。

• AdvancedTextPost — 高度に書式設定されたフィード項目 (グループへのお知らせの投稿など)。

• ApprovalPost — 承認機能のあるフィード項目。承認者は、フィード項目の親で操作を実行できます。

• AttachArticleEvent — ケースフィードのケースに記事が添付されているときに生成されるフィード項目。

• BasicTemplateFeedItem — 拡張リンク機能のあるフィード項目。

• CallLogPost — ケースフィードのケースに活動ログが保存されたときに生成されるフィード項目。

• CanvasPost — パブリッシャーのキャンバスアプリケーションまたは Chatter REST

APIまたはChatter in Apexによって生成され

635





るフィード項目。投稿自体は、キャンバスアプリケーションへのリンクです。

• CaseCommentPost — ケースフィードにケースコメントが保存されたときに生成されるフィード項目。

• ChangeStatusPost — ケースの状況がケースフィードで変更されたときに生成されるフィード項目。

• ChatTranscriptionPost — Live Agent

チャットのトランスクリプトがケースに保存されたときにケースフィードで生成されるフィード項目。

• CollaborationGroupCreated — 新しい公開グループが作成されたときに生成されるフィード項目。新しいグループへのリンクが含まれます。

• CollaborationGroupUnarchived — 非推奨。アーカイブされたグループが有効化されたときに生成されるフィード項目。

• ContentPost — コンテンツ機能のあるフィード項目。

• CreateRecordEvent — パブリッシャーで作成されたレコードを説明するフィード項目。

• DashboardComponentAlert — ダッシュボードアラートのあるフィード項目。

• DashboardComponentSnapshot — ダッシュボードコンポーネントスナップショット機能のあるフィード項目。

• EmailMessageEvent — ケースフィードのケースからメールが送信されたときに生成されるフィード項目。

• FacebookPost — 非推奨。ケースフィードのケースから Facebook 投稿が作成されたときに生成されるフィード項目。

• LinkPost — いいね! 機能のあるフィード項目。

636





• MilestoneEvent — ケースマイルストンが完了したか、違反状況になったときに生成されるフィード項目。ケースマイルストンへのリンクが含まれます。

• PollPost —アンケート機能のあるフィード項目。フィード項目の閲覧者がアンケートの選択肢に投票できます。

• ProfileSkillPost — スキルがユーザのプロファイルに追加されたときに生成されるフィード項目。

• QuestionPost — 質問が行われたときに生成されるフィード項目。API バージョン 33.0 以降では、この種別のフィード項目には、コンテンツ機能とリンク機能を設定できます。

• ReplyPost — Chatter アンサーの返信によって生成されるフィード項目。

• RypplePost — ユーザが感謝を投稿したときに生成されるフィード項目。

• SocialPost — ケースフィードのケースからソーシャル投稿が作成されたときに生成されるフィード項目。

• TextPost — テキストのみを含むフィード項目。

• TrackedChange — レコードの 1 つ以上の項目が変更されたときに作成されるフィード項目。

• UserStatus — 非推奨。ユーザ自身のプロファイルへの投稿。

23.0Small、29.0このフィード項目への URLStringurl

26.0Small、29.0このフィード項目を表示できるユーザ。値は次のとおりです。

Stringvisibility


637






Feed Item Attachment: Approval

承認添付ファイル。

重要: このレスポンスボディは、バージョン 32.0 以降では使用できません。バージョン 32.0 以降では、Approval Capability が使用されます。




27.0 ～ 31.0Small、29.0作業項目 IDStringid

30.0 ～ 31.0Small、30.0プロセスインスタンスステップ ID。関連付けられたレコードが承認プロセスの 1 つのステップを表します。

StringprocessInstanceStepId

27.0 ～ 31.0Small、29.0承認の状況。値は次のとおりです。Stringstatus

• Approved

• Fault

• Held

• NoResponse

• Pending

• Reassigned

• Rejected

• Removed

• Started

28.0 ～ 31.0Small、29.0承認投稿テンプレート項目のコレクションApproval PostTemplate Field[]

postTemplateFields

27.0 ～ 31.0Small、29.0ApprovalStringtype

638

Feed Item Attachment: ApprovalChatter REST API レスポンスボディ

Feed Item Attachment: Basic Template

重要: このレスポンスボディは、バージョン 32.0 以降では使用できません。バージョン 32.0 以降では、Enhanced Link Capability が使用されます。




27.0 ～ 31.0Small、29.0最大 500 文字の説明 (省略可能)Stringdescription

27.0 ～ 31.0Small、29.0アイコン (省略可能)Iconicon

28.0 ～ 31.0Small、29.0linkURL が Salesforce レコードを参照する場合、linkRecordId にはそのレコードの ID

が含まれます。

StringlinkRecordId

27.0 ～ 31.0Small、29.0使用可能なコンテンツをインライン表示できない場合の詳細ページへのリンクの URL (省略可能)

StringlinkUrl

27.0 のみこのプロパティは 28.0

Big、29.0基本テンプレートのフィード項目に関連付けられたサブタイプ。値は次のとおりです。

Stringsubtype

• CollaborationGroupCreated

で廃止され、それより前のバージョンのクライアントには常にNone を返します。

27.0 ～ 31.0Small、29.0詳細ページのタイトル (省略可能)Stringtitle

27.0 ～ 31.0Small、29.0BasicTemplateStringtype

Feed Item Attachment: Canvas Template

重要: このレスポンスボディは、バージョン 32.0 以降では使用できません。バージョン 32.0 以降では、Canvas Capability が使用されます。

639

Feed Item Attachment: Basic TemplateChatter REST API レスポンスボディ




29.0 ～ 31.0Small、29.0省略可能。キャンバスアプリケーションの説明。この項目の文字数は 500 文字までです。

Stringdescription

29.0 ～ 31.0Small、29.0キャンバスアプリケーションの開発者名 (API

名)

StringdeveloperName

29.0 ～ 31.0Small、29.0省略可能。キャンバスアプリケーションの高さ (ピクセル単位)。デフォルトの高さは 200

ピクセルです。

Stringheight

29.0 ～ 31.0Small、29.0キャンバスアプリケーションのアイコンIconicon

29.0 ～ 31.0Small、29.0省略可能。キャンバスアプリケーションが作成された Developer Edition 組織の名前空間プレフィックス。


29.0 ～ 31.0Small、29.0省略可能。キャンバスアプリケーションに渡される JSON 形式のパラメータ。例:

{'isUpdated'='true'}

Stringparameters

29.0 ～ 31.0Small、29.0省略可能。キャンバスアプリケーションのサムネイル画像の URL。最大サイズは 120x120

ピクセルです。

StringthumbnailUrl

29.0 ～ 31.0Small、29.0キャンバスアプリケーションのコールに使用されるリンクのタイトル。

Stringtitle

29.0 ～ 31.0Small、29.0CanvasStringtype

Feed Item Attachment: Case Comment

重要: このレスポンスボディは、バージョン 32.0 以降では使用できません。バージョン 32.0 以降では、Case

Comment Capability が使用されます。




24.0 ～ 31.0Small、29.0コメントを行ったユーザの種別を示します。有効な値は、次のとおりです。

StringactorType

• Customer — Chatter顧客がコメントを行った場合

640

Feed Item Attachment: Case CommentChatter REST API レスポンスボディ




• CustomerService — サービス担当者がコメントを行った場合

24.0 ～ 31.0Small、29.0コメントを作成したユーザに関する情報User SummarycreatedBy

24.0 ～ 31.0Small、29.0ISO8601 の日付文字列 (例:2011-02-25T18:24:31.000Z)

StringcreatedDate

29.0 ～ 31.0Small、29.0ケースフィードのコメントのイベントタイプを示します。次のいずれかの値にします。

StringeventType

• NewInternal — 新しく「社内のみ」とマークされたケースコメント。

• NewPublished — 新しく公開されたケースコメント。

• NewPublishedByCustomer — 新しく公開された、顧客によるケースコメント。

• PublishExisting — 再公開された既存のケースコメント。

• PublishExistingByCustomer — 再公開された、顧客による既存のケースコメント。

• UnpublishExistingByCustomer — 非公開にされた、顧客による既存のケースコメント。

• UnpublishExsiting — 非公開にされた既存のケースコメント。

メモ: この入力ミスは、ドキュメントではなくコードに含まれています。コードでこのスペルを使用してください。

24.0 ～ 31.0Small、29.0ケースコメントの 18 文字の IDStringid

24.0 ～ 31.0Small、29.0コメントが公開されたかどうかを示します。Booleanpublished

24.0 ～ 31.0Small、29.0ケースコメントのテキストStringtext

27.0 ～ 31.0Small、29.0CaseCommentStringtype

641

Feed Item Attachment: Case CommentChatter REST API レスポンスボディ

Feed Item Attachment: Content

フィード項目コンテンツ添付ファイルの説明。

重要: このレスポンスボディは、バージョン 32.0 以降では使用できません。バージョン 32.0 以降では、Content Capability が使用されます。




26.0 ～ 31.0Small、29.0ファイルの MD5 チェックサムStringcheckSum

31.0 ～ 31.0Small、31.0リンクファイルおよび Google ドキュメントの URL。それ以外の場合、値は null です。

StringcontentUrl

23.0 ～ 31.0Small、29.0添付ファイルの説明Stringdescription

23.0 ～ 31.0Small、29.0ファイルの URL。コンテンツがリンクまたはGoogle ドキュメントの場合、この値は null

です。

StringdownloadUrl

26.0 ～ 31.0Small、29.0ファイルの拡張子StringfileExtension

23.0 ～ 31.0Small、29.0ファイルのサイズ (バイト)。サイズを判定できない場合は、unknown を返します。

StringfileSize

23.0 ～ 31.0Small、29.0ファイルの種類StringfileType

23.0 ～ 29.0Small、29.0ファイルでプレビュー画像を使用できる場合は true、それ以外の場合は false

BooleanhasImagePreview

23.0 ～ 31.0Small、29.0ファイルで PDF プレビューを使用できる場合は true、それ以外の場合は false

BooleanhasPdfPreview

23.0 ～ 31.0Small、29.0コンテンツの 18 文字の IDStringid

26.0 ～ 31.0Small、29.0ファイルが Salesforce Files Syncと同期されている場合は true、同期されていない場合はfalse。


23.0 ～ 31.0Small、29.0ファイルの MIME タイプのコンテンツStringmimeType

26.0 ～ 31.0Small、29.0ファイルの変換リソースへの URL。共有ファイルの場合、変換はアップロード後に非同期

StringrenditionUrl

で処理されます。非公開ファイルの場合、変換は最初にファイルプレビューが要求されたときに処理されるため、ファイルのアップロード直後は使用できません。

30.0 ～ 31.0Small、30.0ファイルの 240×180 の変換リソースへの URL。共有ファイルの場合、変換はアップロード後


642

Feed Item Attachment: ContentChatter REST API レスポンスボディ




に非同期で処理されます。非公開ファイルの場合、変換は最初にファイルプレビューが要求されたときに処理されるため、ファイルのアップロード直後は使用できません。

30.0 ～ 31.0Small、30.0ファイルの 720×480 の変換リソースへの URL。共有ファイルの場合、変換はアップロード後


に非同期で処理されます。非公開ファイルの場合、変換は最初にファイルプレビューが要求されたときに処理されるため、ファイルのアップロード直後は使用できません。

30.0 ～ 31.0Big、30.0可能な場合はファイルのテキストプレビュー、それ以外の場合は null です。

StringtextPreview

30.0 ～ 31.0Medium、30.0ファイルの 120×90 プレビュー画像の表示状況を示します。次のいずれかの値にします。


• Processing — 画像を表示しています。• Failed — 表示プロセスが失敗しました。• Success — 表示プロセスが成功しまし

た。• Na — この画像は表示できません。









23.0 ～ 31.0Small、29.0ファイルのタイトルStringtitle

643

Feed Item Attachment: ContentChatter REST API レスポンスボディ




27.0 ～ 31.0Small、29.0ContentStringtype

23.0 ～ 31.0Medium、29.0コンテンツのこのバージョンの 18 文字の IDStringversionId

Feed Item Attachment: Dashboard

重要: このレスポンスボディは、バージョン 32.0 以降では使用できません。バージョン 32.0 以降では、Dashboard Component Snapshot Capability が使用されます。




24.0 ～ 31.0Small、29.0コンポーネントの 18 文字の IDStringcomponentId

24.0 ～ 31.0Small、29.0コンポーネントの名前。コンポーネントと一緒に名前が保存されていない場合、ローカラ

StringcomponentName

イズされた文字列 "タイトル未定のコンポーネント" を返します。

24.0 ～ 31.0Small、29.0フィード項目の本文でアクターの横に表示するテキスト。これは、デフォルトの本文テキ

StringdashboardBodyText

ストの代わりに使用されます。テキストが指定されておらず、デフォルトの本文テキストもない場合、null を返します。

24.0 ～ 31.0Small、29.0ダッシュボードの 18 文字の IDStringdashboardId

24.0 ～ 31.0Small、29.0ダッシュボードの名前StringdashboardName

24.0 ～ 31.0Small、29.0実寸大のダッシュボード画像の URLStringfullSizeImageUrl

24.0 ～ 31.0Small、29.0このダッシュボードの最終更新日の ISO8601

の日付文字列 (例: 2011-02-25T18:24:31.000Z)

StringlastRefreshDate

24.0 ～ 31.0Small、29.0最終更新日の表示テキスト ("最終更新 2011 年10 月 31 日" など)。

StringlastRefreshDateDisplayText

24.0 ～ 31.0Small、29.0ダッシュボードを実行しているユーザUser SummaryrunningUser

24.0 ～ 31.0Small、29.0サムネイルサイズのダッシュボード画像のURL

StringthumbnailUrl

27.0 ～ 31.0Small、29.0DashboardComponentStringtype

644

Feed Item Attachment: DashboardChatter REST API レスポンスボディ

Feed Item Attachment: Email Message

ケースフィードのケースレコードから送信されるメールメッセージ。

重要: このレスポンスボディは、バージョン 32.0 以降では使用できません。バージョン 32.0 以降では、Email Message Capability が使用されます。




29.0 ～ 31.0Small、29.0メールメッセージの方向。次のいずれかの値にします。

Stringdirection

• Inbound — インバウンドメッセージ (顧客が送信)。

• Outbound — アウトバウンドメッセージ(サポートエージェントが顧客に送信)。

29.0 ～ 31.0Small、29.0メールメッセージの IDStringemailMessageId

29.0 ～ 31.0Small、29.0メールメッセージの件名Stringsubject

29.0 ～ 31.0Big、29.0メールメッセージの本文StringtextBody

29.0 ～ 31.0Small、29.0メールメッセージを受信するアドレスのコレクション

Email Address[]toAddresses

27.0 ～ 31.0Small、29.0EmailmessageStringtype

Feed Item Attachment: Link

重要: このレスポンスボディは、バージョン 32.0 以降では使用できません。バージョン 32.0 以降では、Link

Capability が使用されます。




23.0 ～ 31.0Small、29.0リンクの説明Stringtitle

27.0 ～ 31.0Small、29.0LinkStringtype

23.0 ～ 31.0Small、29.0フィード項目 (外部項目の可能性もある) に添付された URL

Stringurl

645

Feed Item Attachment: Email MessageChatter REST API レスポンスボディ

Feed Item Attachment: Poll

重要: このレスポンスボディは、バージョン 32.0 以降では使用できません。バージョン 32.0 以降では、Poll

Capability が使用されます。




26.0 ～ 31.0Small、29.0投票を構成するフィードのアンケート選択肢のコレクション

Feed Poll Choice[]choices

26.0 ～ 31.0Small、29.0このアンケートにおいて現在のユーザが投票したアンケート選択肢の 18 文字の ID。現在

StringmyChoiceId

のユーザが投票しなかった場合は、nullが返されます。

26.0 ～ 31.0Small、29.0フィードアンケート項目に投じられた投票の合計数

IntegertotalVoteCount

27.0 ～ 31.0Small、29.0PollStringtype

Feed Item Attachment: Record Snapshot

重要: このレスポンスボディは、バージョン 32.0 以降では使用できません。バージョン 32.0 以降では、Record Snapshot Capability が使用されます。




29.0 ～ 31.0Small、29.0レコードの表現。Record ViewrecordView

29.0 ～ 31.0Small、29.0RecordSnapshotStringtype

Feed Item Attachment: Tracked Change

重要: このレスポンスボディは、バージョン 32.0 以降では使用できません。バージョン 32.0 以降では、Tracked Changes Capability が使用されます。

646

Feed Item Attachment: PollChatter REST API レスポンスボディ




29.0 ～ 31.0Small、29.0フィード追跡変更のコレクション。Feed TrackedChange[]

changes

29.0 ～ 31.0Small、29.0TrackedChangeStringtype

Feed Item Body




23.0Medium、29.0種別に基づくメッセージセグメントのコレクション。セグメントは次のいずれかになる可能性があります。

Segment[]messageSegments

• Message Segment: Entity Link

• Message Segment: Field Change

• Message Segment: Field Change Name

• Message Segment: Field Change Value

• Message Segment: Hashtag

• Message Segment: Inline Image (バージョン 35.0

以降)

• Message Segment: Link

• Message Segment: Markup Begin (バージョン35.0 以降)

• Message Segment: Markup End (バージョン 35.0

以降)

• Message Segment: Mention

• Message Segment: More Changes

• Message Segment: Text

メッセージセグメントのコレクションには、以降の API バージョンで導入されるメッセージセグメント種別を含めることができます。すべてのメッセージセグメント種別には、バージョン 23.0 以降で使用できるテキストと種別のプロパティを確実に指定できます。クライアントで不明なメッセージセグメント種別が検出された場合、テキスト値を代わりに表示できます。

647

Feed Item BodyChatter REST API レスポンスボディ




23.0Small、29.0表示可能な状態のメッセージテキスト。メッセージセグメントを処理しない場合は、このテキストを使用します。

Stringtext

Feed Item Page

重要: このレスポンスボディは、バージョン 32.0 以降では使用できません。バージョン 32.0 以降では、Feed

Element Page が使用されます。




23.0 ～ 31.0Medium、29.0フィード項目の現在のページへの URLStringcurrentPageUrl

27.0 ～ 31.0Medium、29.0将来の使用のために予約されています。StringisModifiedToken

23.0 ～ 31.0Medium、29.0将来の使用のために予約されています。StringisModifiedUrl

23.0 ～ 31.0Small、29.01 つ以上のフィード項目のコレクションFeed Item[]items

23.0 ～ 31.0Small、29.0フィード項目の次のページへの URLStringnextPageUrl

30.0 ～ 31.0Big、30.0updatedSince パラメータで使用するトークン。使用できない場合は null です。

StringupdatesToken

30.0 ～ 31.0Big、30.0updatesToken プロパティの値を含むクエリ文字列を持つ Chatter REST API リソース。こ

StringupdatesUrl

のリソースは、最後の要求以降に更新されたフィード項目を返します。URL を変更せずにそのまま使用します。使用できない場合、プロパティは null です。

648

Feed Item PageChatter REST API レスポンスボディ

Feed Item Preamble Message Body








27.0Small、29.0preamble は投稿のタイトルです。このプロパティには、「App Builders - Pam Jones」など、

Stringtext

メッセージのすべてのセグメントに対する表示可能なプレーンテキストが含まれます。

Feed Items Topics

重要: このレスポンスボディは、バージョン 32.0 以降では使用できません。バージョン 32.0 以降では、Topics Capability が使用されます。




28.0 ～ 31.0Small、29.0トピックをフィード項目に割り当て可能な場合は true、それ以外の場合は false

BooleancanAssignTopics

28.0 ～ 31.0Small、29.0トピックのコレクションTopic[]topics

Feed Poll Choice




26.0Small、29.0アンケート選択肢の 18 文字の IDStringid

26.0Small、29.0このアンケート選択肢があるアンケート内の場所。最初のアンケート選択肢は 1 から開始します。

Integerposition

649

Feed Item Preamble Message BodyChatter REST API レスポンスボディ




26.0Small、29.0アンケート選択肢に関連付けられた表示ラベルテキスト。

Stringtext

26.0Small、29.0このアンケート選択肢の投票合計数。IntegervoteCount

26.0Small、29.0このアンケートに投じられたすべての投票数に対するこのアンケート選択肢への合計投票

DoublevoteCountRatio

数の割合。この割合を 100 で乗算して、このアンケート選択肢の投票数のパーセントを出します。

Feed Tracked Change




29.0Small、29.0更新された項目の名前。StringfieldName

29.0Small、29.0項目の新しい値または null (項目の長さが長い場合、または空の場合)。

StringnewValue

29.0Small、29.0項目の古い値または null (項目の長さが長い場合、または空の場合)。

StringoldValue

File Detail

File Summary レスポンスボディのすべてと次の追加項目が含まれます。




24.0Medium、29.0Flash 変換をサポートするドキュメントのページ数、またはプレゼンテーションのスライド

IntegerpageCount

数。Flash 変換が失敗した場合、またはファイルの種類でサポートされていない場合は 0

を返します。

関連トピック:

File Summary

650

Feed Tracked ChangeChatter REST API レスポンスボディ

File Preview

ファイルプレビュー。




35.0Small、35.0プレビューの形式。値は次のとおりです。

Stringformat

• Pdf — プレビュー形式は PDF です。

• Svg — プレビュー形式は圧縮SVG です。

• Thumbnail — プレビュー形式は 240×180 の PNG です。

• ThumbnailBig — プレビュー形式は 720×480 の PNG です。

• ThumbnailTiny — プレビュー形式は 120×90 の PNG です。

35.0Small、35.0このプレビュー形式のプレビューURL の総数。

IntegerpreviewUrlCount

35.0Small、35.0ファイルプレビュー URL のリスト。File Preview URL[]previewUrls

35.0Small、35.0プレビューの使用可能状況。値は次のとおりです。

Stringstatus

• Available — プレビューを使用できます。

• InProgress — プレビューは処理中です。

• NotAvailable — プレビューは使用できません。

• NotScheduled — プレビューの生成がまだスケジュールされていません。

35.0Small、35.0ファイルプレビューの URL。Stringurl

File Preview Collection

ファイルプレビューのコレクション。

651

File PreviewChatter REST API レスポンスボディ




35.0Small、35.0ファイルの ID。StringfileId

35.0Small、35.0ファイルでサポートされるプレビュー。

File Preview []previews

35.0Medium、35.0ファイルプレビューの現在のページの URL。

Stringurl

File Preview URL

ファイルプレビューの URL。




35.0Small、35.0PDF のゼロから開始するプレビューページ番号または null。

IntegerpageNumber

35.0Small、35.0ファイルプレビュー URL。StringpreviewUrl

File Share Link

リンクとして共有されるファイルの説明。




30.0Small、30.0ファイルの表示とダウンロードが可能なURL。この値は、ファイル共有リンクとも呼ばれます。

StringfileViewUrl

30.0Small、30.0共有の権限レベル。値は次のとおりです。StringsharingType

• C — コラボレータ• I — 共有権限は場所によって決まりま

す。これは一般に、共有権限がファイルではなくライブラリに設定されている場合に発生します。この値は、コンテキストユーザがファイルの所有者である場合にも使用されます。

• N — アクセス権限なし• V — 閲覧者

652

File Preview URLChatter REST API レスポンスボディ

File Shares Page




24.0Medium、29.0ファイル共有の現在のページの URLStringcurrentPageUrl

30.0Small、30.0ファイル共有リンクの URLFile Share LinklinkShare

24.0Small、29.01 つ以上のファイル共有のコレクションShares[]shares

24.0Small、29.0ファイル共有の次のページの URLStringnextPageUrl

24.0Medium、29.0ファイル共有の前のページの URLStringpreviousPageUrl

File Summary

ファイルの説明。すべての変換プロパティについて、次のことに注意してください。共有ファイルの場合、変換はアップロード後に非同期で処理されます。非公開ファイルの場合、変換は最初にファイルプレビューが要求されたときに処理されるため、ファイルのアップロード直後は使用できません。




26.0Big、29.0ファイルの MD5 チェックサムStringcheckSum

24.0Small、29.0ファイルのサイズ (バイト)IntegercontentSize

32.0Small、32.0このファイルに関連付けられた外部データソース、または、外部ファイルを指し示していない場合は null。


contentHubRepository


2011-02-25T18:24:31.000Z)。名前変更などの直接Datecontent

ModifiedDate

的なファイル操作でのみ更新されるファイル固有の変更日です。Salesforce以外からのファイルの変更により、この日付が更新される場合があります。

24.0Small、29.0ファイルがリンクの場合は URL を返し、それ以外の場合は文字列 "null" を返します。

StringcontentUrl

24.0Medium、29.0ファイルの説明Stringdescription

26.0Small、29.0ファイルへの URLStringdownloadUrl

653

File Shares PageChatter REST API レスポンスボディ




32.0Small、32.0このファイルが指し示す外部 URL。外部ファイルを指し示していない場合は null。


35.0Big、35.0外部ファイルの権限情報 (使用可能なグループ、使用可能な権限タイプ、現在の共有状況

External FilePermissionInformation

externalFilePermissionInformation など)。外部ファイル以外か、


が false の場合は null。24.0Big、29.0ファイルの Flash プレビューバージョンが表

示されたかどうかを示します。Stringflash

RenditionStatus

26.0Small、29.0ファイルの拡張子StringfileExtension

24.0Medium、29.0ファイルの種類 (PDF、PowerPoint など)StringfileType

24.0Small、29.0ファイルの 18 文字の IDStringid

26.0Medium、29.0ファイルが Salesforce Files Syncと同期されている場合は true、同期されていない場合はfalse。


31.0Medium、31.0ファイルがメジャーバージョンの場合はtrue、ファイルがマイナーバージョンの場


合は false。メジャーバージョンを置き換えることはできません。

26.0Medium、29.0ファイルの MIME タイプStringmimeType

30.0Big、30.0このファイルのフラグ。コミュニティモデレータは、フラグ付き項目を表示したり、フ


ラグ付き項目に対してアクションを実行したりできます。Features レスポンスボディのcommunityModeration プロパティがfalse の場合、このプロパティは null になります。


2011-02-25T18:24:31.000Z)。Salesforce 内からのDatemodifiedDate

ファイルの変更により、この日付が更新されます。

654

File SummaryChatter REST API レスポンスボディ




27.0Small、29.0オブジェクトがファイルであることを示す小、中、大のアイコン。motif にはオブジェクトのベース色を含めることもできます。このアイコンは、ファイルのプレビューではありません。

Motifmotif

23.0Medium、29.0コンテキストユーザがこのファイルをフォローしている場合は、登録に関する情報が含


まれます。それ以外の場合は、nullを返します。

24.0Small、29.0ファイルの名前Stringname

24.0Big、29.0ファイルソースを示します。有効な値は、次のとおりです。

Stringorigin

• Chatter — ファイルソースが Chatter の場合

• Content — ファイルソースがコンテンツの場合

• FileField — ファイルソースがレコードやその他の形式の場合

24.0Small、29.0ファイルの所有者User Summaryowner

28.0Small、29.0親フォルダへの参照。ReferenceparentFolder

24.0Big、29.0ファイルの PDF プレビューバージョンが表示されたかどうかを示します。

StringpdfRenditionStatus

29.0Small、29.0ファイルの公開状況。次のいずれかの値にします。

StringpublishStatus

• PendingAccess — ファイルは公開を待機中です。

• PrivateAccess — ファイルは非公開です。

• PublicAccess — ファイルは公開されています。

26.0Medium、29.0ファイルの変換リソースへの URL。共有ファイルの場合、変換はアップロード後に非同期

StringrenditionUrl

で処理されます。非公開ファイルの場合、変換は最初にファイルプレビューが要求された

655





ときに処理されるため、ファイルのアップロード直後は使用できません。

29.0Medium、29.0ファイルの 240×180 ピクセルサイズ変換へのURL (使用可能な場合)。共有ファイルの場合、


変換はアップロード後に非同期で処理されます。非公開ファイルの場合、変換は最初にファイルプレビューが要求されたときに処理されるため、ファイルのアップロード直後は使用できません。

29.0Medium、29.0ファイルの 720×480 ピクセルサイズ変換へのURL (使用可能な場合)。共有ファイルの場合、


変換はアップロード後に非同期で処理されます。非公開ファイルの場合、変換は最初にファイルプレビューが要求されたときに処理されるため、ファイルのアップロード直後は使用できません。

32.0Small、32.0外部リポジトリファイルのプロパティへのアクセスを提供する Chatter REST API リソースの

StringrepositoryFileUrl

URL。このファイルが外部ファイルを参照していない場合は null。

35.0Medium、35.0ファイルの共有オプション。値は次のとおりです。

StringsharingOption



29.0Medium、29.0ファイルの共有ロール。次のいずれかの値にします。

StringsharingRole

• Admin — 所有者権限ですが、ファイルは所有していません。

• Collaborator — 閲覧者権限に加えて、権限の編集および変更を行ったり、新しいバージョンのファイルをアップロードしたりできます。

• Owner — コラボレータ権限に加えて、ファイルを非公開にしたり、ファイルを削除したりできます。

656





• Viewer — ファイルを表示、ダウンロード、共有できます。

• WorkspaceManaged — ライブラリで制御される権限。

30.0Big、30.0可能な場合はファイルのテキストプレビュー、それ以外の場合は null です。

StringtextPreview

24.0Small、29.0ファイルの 120×90 プレビュー画像の表示状況を示します。次のいずれかの値にします。












24.0Small、29.0ファイルのタイトルStringtitle

24.0Small、29.0ContentDocumentStringtype

24.0Small、29.0ファイルの URLStringurl

24.0Medium、29.0ファイルのバージョン番号StringversionNumber

657


File Summary Page




24.0Medium、29.0ファイルの現在のページの URLStringcurrentPageUrl

24.0Small、29.01 つ以上のファイルのコレクションFile Summary[]files

24.0Small、29.0ファイルの次のページの URLStringnextPageUrl

24.0Medium、29.0ファイルの前のページの URLStringpreviousPageUrl

Files Connect Allowed Item Type Collection

リポジトリフォルダ内で作成が許可されている項目種別。




35.0Small、35.0リポジトリフォルダ内で作成できる項目種別のコレクション。

Files Connect ItemType Summary[]

allowedItemTypes

Files Connect Field Definition

項目種別の項目定義。




35.0Small、35.0項目の表示ラベルまたはキャプション。

StringdisplayName

35.0Small、35.0この項目がこの項目種別で必須かどうかを示します。

BooleanisMandatory

35.0Small、35.0項目の値の最大長。IntegermaxLength

35.0Small、35.0項目の名前。Stringname

35.0Small、35.0項目の値のデータ型を示します。値は次のとおりです。

Stringtype

• BooleanType

• DateTimeType

• DecimalType

658

File Summary PageChatter REST API レスポンスボディ




• HtmlType

• IdType

• IntegerType

• StringType

• UriType

• XmlType

Files Connect Item Type Detail

リポジトリフォルダに関連付けられた項目種別に関する詳細情報。Files Connect Item Type Detail レスポンスボディには、すべての Files Connect Item Type Summaryレスポンスボディとこのプロパティが含まれます。




35.0Small、35.0項目種別に設定可能な項目のリスト。

Files Connect FieldDefinition[]

fields

Files Connect Item Type Summary

リポジトリフォルダに関連付けられた項目種別に関する概要情報。




35.0Small、35.0コンテンツストリーミングのサポートを示します。値は次のとおりです。

StringcontentStreamSupport

• ContentStreamAllowed

• ContentStreamNotAllowed

• ContentStreamRequired

35.0Medium、35.0項目種別の説明。Stringdescription

35.0Small、35.0項目種別の表示名。StringdisplayName

35.0Small、35.0項目種別の ID。Stringid

35.0Small、35.0項目種別にバージョンを設定できるかどうかを示します。

BooleanisVersionable

659

Files Connect Item Type DetailChatter REST API レスポンスボディ




35.0Small、35.0項目種別の詳細情報の URL。Stringurl

Files Connect Permission

権限。




35.0Medium、35.0ディレクトリエントリの詳細情報。次のいずれか 1

つdirectoryEntry

• RepositoryGroup Summary

• Repository UserSummary

35.0Small、35.0この権限を更新できるかどうかを示します。

BooleanisUpdatable

35.0Medium、35.0権限タイプのコレクション。RepositoryPermission TypeCollection[]

rights

Files Connect Permission Collection

権限のコレクション。




35.0Small、35.0権限のコレクション。Files ConnectPermission[]

permissions

Files Connect Permission Type

権限タイプ。

660

Files Connect PermissionChatter REST API レスポンスボディ




35.0Medium、35.0リポジトリ内の権限タイプの内部ID。

Stringid

35.0Medium、35.0リポジトリから返された表示ラベル。

Stringlabel

Files Connect Provider Type

Files Connect プロバイダに関する情報。




32.0Small、32.0プロバイダタイプのローカライズされた表示ラベル。

Stringlabel

32.0Small、32.0プロバイダタイプ。次のいずれかの値にします。

Stringtype

• ContentHubCmis

• ContentHubGoogleDrive

• ContentHubSharepoint

• ContentHubSharepointOffice365

• SimpleUrl


Files Connect リポジトリに関する情報。




32.0Small、32.0リポジトリの機能。Files ConnectRepositoryFeatures

features

32.0Small、32.0外部データソースの 18 文字の ID。Stringid

32.0Small、32.0リポジトリの表示ラベル。Stringlabel

661

Files Connect Provider TypeChatter REST API レスポンスボディ




32.0Small、32.0motif プロパティには、Salesforce レコードタイプを示す小、中、大のアイコン

Motifmotif

への URL があります。一般的なレコードタイプは、ファイル、ユーザ、グループですが、すべてのレコードタイプに一連の motif アイコンがあります。カスタムオブジェクトレコードでは、タブスタイルアイコンが使用されます。認証されていないユーザでもすべてのアイコンを使用できるため、たとえば、motif アイコンをメールで表示することができます。motif にはレコードタイプのベース色を含めることもできます。

32.0Medium、32.0コンテキストユーザがこのレコードをフォローしている場合は、登録に関す


る情報が含まれます。それ以外の場合は、null を返します。

32.0Small、32.0リポジトリ名。Stringname

32.0Small、32.0リポジトリプロバイダタイプ。Files ConnectProvider Type

providerType

32.0Small、32.0リポジトリのルートフォルダ項目へのURL。リポジトリで参照がサポートされていない場合は null。

StringrootFolderItemsUrl

32.0Small、32.0レコード ContentHubRepository のタイプ。

Stringtype

32.0Small、32.0Files Connect リポジトリの Chatter REST API

リソース URL。Stringurl

Files Connect Repository Collection

Files Connect リポジトリのコレクション。






662

Files Connect Repository CollectionChatter REST API レスポンスボディ






null。別のページを取得する前に、この値が nullであるかどうかを確認します。ページが存在しない場合は、ConnectApi.NotFoundException




32.0Small、32.0リポジトリのコレクション。Files ConnectRepository[]

repositories

Files Connect Repository Features

Files Connect リポジトリの機能に関する情報。




32.0Small、32.0リポジトリのフォルダ階層を参照できるか (true)、否か (false) を示します。

BooleancanBrowse

32.0Small、32.0リポジトリを検索できるか (true)、否か (false) を示します。

BooleancanSearch

Flat Feed




25.0 ～ 26.0Medium、29.0項目の現在のページの URLStringcurrentPageUrl

25.0 ～ 26.0Small、29.01 つ以上のフラットフィード項目のコレクション

Flat Feed Item[]items

25.0 ～ 26.0Small、29.0項目の次のページの URLStringnextPageUrl

663

Files Connect Repository FeaturesChatter REST API レスポンスボディ

Flat Feed Item




25.0 ～ 26.0Small、29.0typeの値に応じたフラットフィード項目。有効な値は、次のとおりです。

typeによって異なる

item

• type が Comment の場合 — Comment

• type が FeedItem の場合 — Feed Item

25.0 ～ 26.0Small、29.0項目の種別。有効な値は、次のとおりです。Stringtype

• Comment

• FeedItem

Folder

フォルダの説明。




30.0Small、30.0フォルダの作成日を指定する ISO-8601 形式の日付文字列。

DatecreatedDate

30.0Small、30.0フォルダの 18 文字の ID。Stringid

33.0Small、33.0フォルダおよびこのフォルダ内のすべてのフォルダが Salesforce Files Syncと同期されてい


る場合は true、同期されていない場合はfalse。

30.0Small、30.0フォルダの最終変更日を指定する ISO-8601 形式の日付文字列。

DatemodifiedDate

30.0Small、30.0レコードタイプを示す小、中、大アイコン。motif にはレコードタイプのベース色を含めることもできます。

Motifmotif

30.0Medium、30.0コンテキストユーザがこのレコードをフォローしている場合、このプロパティには登録


に関する情報が含まれます。それ以外の場合は、このプロパティが null になります。

30.0Small、30.0フォルダ名。Stringname

664

Flat Feed ItemChatter REST API レスポンスボディ




30.0Small、30.0親フォルダへの参照。ReferenceparentFolder

30.0Small、30.0フォルダへのパス。Stringpath

30.0Small、30.0FolderStringtype

30.0Small、30.0このリソースへの Chatter REST API URL。Stringurl

Folder Item

フォルダ内の項目 (ファイルまたはフォルダ) の説明。




30.0Small、30.0ファイル表現File Summaryfile

30.0Small、30.0フォルダ表現Folderfolder

30.0Small、30.0項目の種別。有効な値は、次のとおりです。Stringtype

• File

• Folder

Folder Item Page

ページが設定された Folder Item レスポンスボディのコレクション。




30.0Medium、30.0現在のページを識別するChatter REST API URL。StringcurrentPageUrl

30.0Small、30.0フォルダ項目のコレクション。Folder Item[]items

30.0Small、30.0次のページを識別するChatter REST API URL。次のページがない場合は null。別のページを

StringnextPageUrl

取得する前に、この値が nullであるかどうかを確認します。ページが存在しない場合は、ConnectApi.NotFoundException エラーが返されます。

665

Folder ItemChatter REST API レスポンスボディ




30.0Medium、30.0前のページを識別するChatter REST API URL。前のページがない場合は null。


Follower Page




23.0Medium、29.0現在のページの URLStringcurrentPageUrl

23.0Small、29.0レコードをフォローしている人の 1 つ以上の登録のコレクション

Subscription[]followers

23.0 ～ 24.0ReferencemySubscriptionメモ: この項目は、バージョン 24.0 以降、使用できなくなります。

コンテキストユーザがこのユーザをフォローしている場合は、登録に関する情報が含まれます。それ以外の場合は、null を返します。


StringnextPageUrl




23.0Small、29.0フォローされている人の合計数Integertotal

Following Counts




23.0Small、29.0ユーザがフォローしている人の数Integerpeople

666

Follower PageChatter REST API レスポンスボディ




23.0Small、29.0ユーザがフォローしているレコードの数トピックは、バージョン 29.0 以降でフォロー可能なレコードタイプです。

Integerrecords

23.0Small、29.0ユーザがフォローしている項目の合計数Integertotal

Following Page




23.0Medium、29.0現在のページへの URLStringcurrentPageUrl

23.0Small、29.01 つ以上の登録のコレクションSubscription[]following

23.0Small、29.0次のページの URLStringnextPageUrl

23.0Medium、29.0前のページの URLStringpreviousPageUrl

23.0Small、29.0フォローされているレコードの合計数Integertotal

Generic Bundle Capability

フィード要素にこの機能がある場合、フィード要素は 1 つのフィード要素に集約された他のフィード要素のグループとなることができます。





31.0Small、31.0バンドルの種別を指定します。値は GenericBundle です。

StringbundleType

31.0Small、31.0フィード要素のコレクション。Feed Element Pagepage

31.0Small、31.0このバンドルで集約するフィード要素の合計数。

IntegertotalElements

667

Following PageChatter REST API レスポンスボディ

汎用フィード要素

汎用フィード要素。


検索条件とバージョン


22.0Small、22.0フィード要素に関する情報。Feed Item Bodybody

31.0Medium、31.0フィード要素に含めることができるすべての機能のコンテナ。

Feed ElementCapabilities

capabilities



31.0Small、31.0フィード要素は、フィードに含まれる最上位のオブジェクトです。


フィード要素の種類は、このフィード要素の特徴を記述します。次のいずれかの値にします。• Bundle — フィード要素のコン

テナ。バンドルには、メッセージセグメントを構成する本文も含まれます。メッセージセグメントは、テキストのみの値に常に適切に分解できます。

• FeedItem — フィード項目には1 つの親があり、その範囲は 1 つのコミュニティまたはすべてのコミュニティになります。フィード項目にはブックマーク、キャンバス、コンテンツ、コメント、リンク、アンケートなどの機能を設定できます。フィード項目には、メッセージセグメントを構成する本文が含まれます。メッセージセグメントは、テキストのみの値に常に適切に分解できます。

• Recommendation — おすすめは、おすすめ機能を備えたフィード要素です。おすすめは、コンテキストユーザに、フォローするレコード、参加す

668

汎用フィード要素Chatter REST API レスポンスボディ




るグループ、または役に立つアプリケーションを推奨します。

31.0Medium、31.0ヘッダーは投稿のタイトルです。このプロパティには、メッセージ

Feed Item Bodyheader

のすべてのセグメントに対する表示可能なプレーンテキストが含まれます。クライアント側でフィード要素の種類の表示方法が不明の場合、このテキストが表示されます。

22.0Small、22.0フィード要素の ID。Stringid


2011-02-25T18:24:31.000Z)。DatemodifiedDate

28.0Medium、29.0フィード要素の親。次のいずれかのレスポンスボ

parent

ディになります。• File Detail

• File Summary

• Group

• Group Detail

• RecordSummary

• Record View

• User Detail

• User Summary

31.0Small、29.0相対的なローカライズされた文字列として書式設定された作成日(「17 分前」、「昨日」など)

DaterelativeCreatedDate

22.0Small、29.0このフィード要素への Chatter REST

API URL。Stringurl

669

汎用フィード要素Chatter REST API レスポンスボディ

Group




30.0Small、30.0グループの追加表示ラベル。たとえば、「アーカイブ済み」、「非公開」、「非公


開、顧客を含む」などがあります。追加表示ラベルがない場合、値は null です。

31.0Big、31.0グループのお知らせ。Announcementannouncement

23.0Small、29.0このグループで Chatter 顧客を許可している場合は true、それ以外の場合は false


26.0Medium、29.0コミュニティに関する情報。デフォルトのコミュニティにグループが存在するか、コミュ

Referencecommunity

ニティが無効である場合は、nullが返されます。

23.0Big、29.0グループに関するテキストのみの説明Stringdescription

30.0Medium、30.0このグループにメールで投稿するためのグループのメールアドレス。Chatterメールと、メールによるChatterへの投稿がどちらも組織で有効ではない場合は、null を返します。

StringemailToChatterAddress

29.0Big、29.0グループがアーカイブされているか (true)、否か (false) を示します。

BooleanisArchived

29.0Big、29.0グループの自動アーカイブが無効になっているか (true)、否か (false) を示します。


24.0 ～ 27.0

fileCount

プロパティ

Big、29.0このグループに投稿されたファイルの数IntegerfileCount

は Group

Detail レスポンスボディに含まれます。

23.0Small、29.0グループの 18 文字の IDStringid

31.0Big、31.0グループに投稿された最新のフィード要素の日付

DatelastFeedElementPostDate

670

GroupChatter REST API レスポンスボディ




24.0 ～ 30.0Big、29.0グループに投稿された最新のフィード項目の日付。API バージョン 30.0 より後のバージョンでは、lastFeedElementPostDateを使用します。

DatelastFeedItemPostDate

23.0Small、29.0グループメンバーの合計数IntegermemberCount

27.0Small、29.0オブジェクトがグループであることを示す小、中、大のアイコン。motif にはレコードタイプのベース色を含めることもできます。このアイコンは、グループの写真ではありません。

Motifmotif

23.0Small、29.0値は次のとおりです。StringmyRole

• GroupOwner

• GroupManager

• NotAMember

• NotAMemberPrivateRequested

• StandardMember

23.0Medium、29.0コンテキストユーザがこのグループのメンバーである場合は、登録に関する情報が含ま


れます。それ以外の場合、null を返します。

23.0Small、29.0グループの名前Stringname

24.0Medium、29.0グループの所有者に関する情報User Summaryowner

23.0Small、29.0グループの写真に関する情報Photophoto

23.0Small、29.0CollaborationGroupStringtype

23.0Small、29.0グループへの相対 URL 文字列Stringurl

23.0Small、29.0値は次のとおりです。Stringvisibility



671

GroupChatter REST API レスポンスボディ





Group Chatter Settings

特定のグループのユーザの Chatter 設定です。




27.0Small、29.0グループメンバーがグループからメールを受信する頻度。次のいずれかの値になります。


• EachPost

• DailyDigest

• WeeklyDigest

• Never

• UseDefault

値が UseDefaultの場合、User Chatter Settings

に定義されたユーザのデフォルトのグローバル設定が使用されます。コミュニティでは、グループメンバーが 10,000 人を超えると [各投稿のメール] オプションが無効になります。このオプションを選択したすべてのメンバーは、自動的に [毎日のダイジェスト] に切り替わります。

Group Detail




30.0Small、30.0グループの追加表示ラベル。たとえば、「アーカイブ済み」、「非公開」、「非公


開、顧客を含む」などがあります。追加表示ラベルがない場合、値は null です。

672

Group Chatter SettingsChatter REST API レスポンスボディ




31.0Big、31.0このグループの現在のお知らせ。Announcementannouncement

23.0Small、29.0このグループで Chatter 顧客を許可している場合は true、それ以外の場合は false


26.0Medium、29.0コミュニティに関する情報。デフォルトのコミュニティにグループが存在するか、コミュ

Referencecommunity

ニティが無効である場合は、nullが返されます。

23.0Big、29.0グループに関するテキストのみの説明Stringdescription

30.0Medium、30.0このグループにメールで投稿するためのグループのメールアドレス。Chatterメールと、メールによるChatterへの投稿がどちらも組織で有効ではない場合は、null を返します。

StringemailToChatterAddress

28.0Big、29.0このグループに投稿されたファイルの数IntegerfileCount

23.0Small、29.0グループの 18 文字の IDStringid

28.0Big、29.0グループの [情報] セクション。Web UI では、このセクションは [説明] セクションの上にあ

Group Informationinformation

ります。グループが非公開の場合は、このセクションはメンバーにのみ表示されます。コンテキストユーザがグループのメンバーでない場合や、コンテキストユーザに「すべてのデータの編集」権限または「すべてのデータの参照」権限がない場合は、値が nullになります。

31.0Big、31.0グループに投稿された最新のフィード要素の日付

StringlastFeedElementPostDate

24.0 ～ 30.0Big、29.0グループに投稿された最新のフィード項目の日付。API バージョン 30.0 より後のバージョンでは、lastFeedElementPostDateを使用します。

StringlastFeedItemPostDate

23.0Small、29.0グループメンバーの合計数IntegermemberCount

673

Group DetailChatter REST API レスポンスボディ




27.0Small、29.0オブジェクトがグループであることを示す小、中、大のアイコン。motif にはレコードタイプのベース色を含めることもできます。このアイコンは、グループの写真ではありません。

Motifmotif

23.0Small、29.0値は次のとおりです。StringmyRole

• GroupOwner

• GroupManager

• NotAMember


• StandardMember

23.0Medium、29.0コンテキストユーザがこのグループのメンバーである場合は、登録に関する情報が含ま


れます。それ以外の場合、null を返します。

23.0Small、29.0グループの名前Stringname

24.0Medium、29.0グループの所有者に関する情報User Summaryowner

29.0Medium、29.0非公開グループへの待機中の参加要求数。公開グループの場合、値は null です。

IntegerpendingRequests

23.0Small、29.0グループの写真に関する情報Photophoto

23.0Small、29.0CollaborationGroupStringtype

23.0Small、29.0グループへの相対 URL 文字列Stringurl

23.0Small、29.0値は次のとおりです。Stringvisibility




674

Group DetailChatter REST API レスポンスボディ

Group Information

グループの [情報] セクションを説明します。グループのメンバー、写真、および組織内のグループなど、グループに関する情報。グループの作成および削除、グループへのメンバーの追加、グループの写真の変更を行います。




28.0Small、29.0グループの [情報] セクションのテキストStringtext

28.0Small、29.0グループの [情報] セクションのタイトルStringtitle

Group Member




23.0Small、29.0グループメンバーシップの 18 文字の IDStringid

31.0Small、31.0グループメンバーが最後にグループフィードにアクセスした日時。

DatelastFeedAccessDate

23.0Small、29.0値は次のとおりです。Stringrole

• GroupOwner

• GroupManager

• NotAMember


• StandardMember

23.0Small、29.0このメンバーシップへの URLStringurl

23.0Small、29.0このグループに登録しているユーザに関する情報

User Summaryuser

Group Member Page




23.0Medium、29.0メンバーのこのページへの URLStringcurrentPageUrl

675

Group InformationChatter REST API レスポンスボディ




23.0Small、29.0グループメンバーのコレクションGroup Member[]members

23.0Medium、29.0コンテキストユーザがこのグループのメンバーである場合はメンバーシップに関する情

ReferencemyMembership

報を返し、それ以外の場合は nullを返します。

23.0Small、29.0メンバーの次のページへの URLStringnextPageUrl

23.0Medium、29.0メンバーの前のページへの URLStringpreviousPageUrl

23.0Small、29.0グループメンバーの合計数IntegertotalMemberCount

Group Membership Request




27.0Big、29.0メンバーシップ要求の日付を指定する ISO 形式の日付文字列

StringcreatedDate

27.0Small、29.0グループメンバー要求オブジェクトの IDStringid

27.0Small、29.0要求の最終更新日を指定する ISO 形式の日付文字列

StringlastUpdateDate

27.0Big、29.0ユーザが参加を要求しているグループに関する情報

ReferencerequestedGroup

27.0Big、29.0メンバーシップ要求が却下された場合にユーザに表示するメッセージ。このプロパティの


値は、statusプロパティの値が Declined

の場合にのみ使用されます。最大文字数は 756 文字です。

27.0Small、29.0非公開グループへの参加要求の状況。値は次のとおりです。

Stringstatus

• Accepted

• Declined

• Pending

676

Group Membership RequestChatter REST API レスポンスボディ




27.0Small、29.0このグループメンバー要求オブジェクトのURL

Stringurl

27.0Small、29.0グループのメンバーシップを要求しているユーザに関する情報

User Summaryuser

Group Membership Request Collection




27.0Small、29.0非公開グループへのすべての参加要求に関する情報

Group MembershipRequest

requests

27.0Small、29.0非公開グループへの参加要求総数Integertotal

Group Page




23.0Medium、29.0グループのこのページへの URLStringcurrentPageUrl

23.0Small、29.0グループ詳細のコレクションGroup Detail[]groups

23.0Small、29.0グループの次のページへの URLStringnextPageUrl

23.0Medium、29.0グループの前のページへの URLStringpreviousPageUrl

Group Record

グループに関連付けられたレコード。




33.0Small、33.0グループに関連付けられたレコードの18 文字の ID。

Stringid

677

Group Membership Request CollectionChatter REST API レスポンスボディ




33.0Small、33.0グループに関連付けられたレコードに関する情報。

Record SummaryUser Summary

record

33.0Small、33.0グループに関連付けられたレコードへのURL。

Stringurl

Group Record Page

グループに関連付けられたレコードのページ設定されたリスト。





33.0Small、3.0次のページへの URL。次のページがない場合、null を返します。

StringnextPageUrl

33.0Medium、3.0前のページへの URL。前のページがない場合、null を返します。


33.0Small、33.0グループに関連付けられたレコードのコレクション。

Group Record[]records

33.0Small、33.0グループに関連付けられたレコードの総数。IntegertotalRecordCount

Icon




27.0Small、29.0アイコンの高さ (ピクセル単位)Integerheight

27.0Small、29.0アイコンの幅 (ピクセル単位)Integerwidth

27.0Small、29.0アイコンの URL。この URL は、認証されていないユーザが使用できます。URL の有効期限が切れることはありません。

Stringurl

678

Group Record PageChatter REST API レスポンスボディ

Influence Thresholds




24.0Small、29.0インフルエンサーカテゴリの説明。例:Active Influencer

Stringname

24.0Small、29.0このインフルエンサーカテゴリの下限しきい値を定義する、未加工のパーセントとして表

Doublethreshold

された数値。たとえば、0.25 は、Active

Influencer カテゴリの下限値です。つまり、影響度ランクが 25% 以上で次に高いカテゴリしきい値未満のユーザがこのカテゴリに含まれます。

Knowledgeable People

指定されたトピックに関する知識のあるユーザを表します。




30.0Small、30.0コンテキストユーザが、トピックについてこの知識のあるユーザを支持している場合は

BooleanisEndorsedByMe

true、それ以外の場合は falseを指定します。

30.0Small、30.0知識のあるレコードの IDStringknowledgeableId

30.0Medium、30.0トピックについて知識のあるユーザが受け取った支持の数

IntegernumEndorsements

30.0Medium、30.0ユーザがトピックに関する知識があるとみなされる理由を指定します。有効な値は、次のとおりです。

Stringreasons

• Influential — ユーザは、トピックを含む投稿か投稿へのコメントでメンションされたか、トピックを含む投稿へのコメントでいいね! を受信しました。

• Endorsed — ユーザは、トピックについて別のユーザから支持を受け取りました。

679

Influence ThresholdsChatter REST API レスポンスボディ




30.0Small、30.0トピックに関する知識のあるユーザUser Summaryuser

Knowledgeable People Collection

Knowledgeable People レスポンスボディのコレクション。





30.0Small、30.0Knowledgeable People レスポンスボディのコレクション。

KnowledgeablePeople[]

knowledgeableUsers


StringnextPageUrl




Like


検索条件グループまたはバージョン


23.0Small、29.0いいね! の 18 文字の IDStringid

27.0Medium、29.0いいね! と言われたコメントまたはフィード要素への参照

ReferencelikedItem

23.0Small、29.0このいいね! への URLStringurl

23.0Small、29.0このコメントまたはフィード要素にいいね!

と言ったユーザに関する情報User Summaryuser

680

Knowledgeable People CollectionChatter REST API レスポンスボディ

Like Message Body







• Message Segment: Resource Link


27.0Small、29.0フィード項目またはコメントにいいね! と言ったユーザのテキストサマリー。たとえば、

Stringtext

「あなたがいいね! と言っています。」または「Renee Moreau さん、Gordon Johnson さん、および Pam Jones さんがいいね! と言っています。」などがあります。

Like Page




23.0Medium、29.0いいね! の現在のページへの URLStringcurrentPageUrl

32.0Small、32.0いいね! のコレクションLike[]items

23.0 ～ 31.0Small、29.0いいね! のコレクションLike[]likes

重要: API バージョン 32.0 以降では、items プロパティを使用します。

23.0 ～ 24.0ReferencemyLikeメモ: この項目は、バージョン 24.0 以降、使用できなくなります。

特定のいいね! への参照を返すか、nullを返します。

23.0Small、29.0いいね! の次のページへの URLStringnextPageUrl

23.0Medium、29.0いいね! の前のページへの URLStringpreviousPageUrl

23.0Small、29.0この項目のいいね! の合計数Integertotal

681

Like Message BodyChatter REST API レスポンスボディ

Link Capability

フィード要素にこの機能がある場合、リンクがあります。




32.0Small、32.0リンク URL。URL は外部サイトへのURL にできます。

Stringurl

32.0Small、32.0リンクの説明。StringurlName

List View Column

レコードの関連リストの単一列を記述します。列のレイアウト方法を記述し、列のデータは含みません。




29.0Medium、29.0この列の項目のオブジェクト種別。これは、REST API と SOAP API で使用されるオブジェクト種別です。

StringdataType

29.0Big、29.0完全修飾された API 項目 ID (Contact.Name

など)。StringfieldId

29.0Small、29.0この列のローカライズされた表示ラベル。Stringlabel

29.0Medium、29.0API 項目の短縮名 (Name など)。Stringname

List View Definition

レコードビューの関連リスト構造または検索リスト構造を定義します。リストにデータはありません。




29.0Big、29.0このリストビューに表示される項目の列。List View Column[]columns

29.0Small、29.0このリストビューのローカライズされた表示ラベル。

Stringlabel

29.0Medium、29.0このリストビューに含まれるオブジェクトの種別の定義。

List View ObjectobjectType

682

Link CapabilityChatter REST API レスポンスボディ




29.0Medium、29.0このリストビューのページあたりの最大オブジェクト数。この関連リストのすべてのオブ

IntegerrowLimit

ジェクトを表示するには、このサイズ以下のページ単位でデータを表示します。このdescribe から SOQL ステートメントを作成するには、その SOQL ステートメントにこの値と等しい LIMIT 値を含める必要があります。含めないと実行時にエラーが発生します。

29.0Medium、29.0このリストビューの並び替え基準になる列。並び替え列を優先度順に示します (1 番目の並び替え、2 番目の並び替え、以下同様)。

List View Sort[]sortColumns

List View Object

関連リストの行に表示されるレコードのタイプを定義します。




29.0Big、29.0親レコードを参照する API 項目 ID。たとえば、Account レコードに Contact レコードの関

StringfieldId

連リストがある場合、Account の Contact 関連リスト定義ではこの値は "Account"になることがあります。

29.0Small、29.0このオブジェクトのオブジェクト種別名。これは、REST API と SOAP API で使用されるオブジェクト種別です。

Stringtype

List View Record

レコードのリストビュー。

683

List View ObjectChatter REST API レスポンスボディ




30.0Medium、30.0このリストに表示されるレコードの項目と値。次のいずれかを含むコレクション。

fields

• Record Field

• Record Field: Blank

• Record Field: Compound

• Record Field: Currency

• Record Field: Date

• Record Field: Percent

• Record Field: Picklist

• Record Field: Reference

• Record Field: Reference with Date

23.0Small、29.0オブジェクトの 18 文字の IDStringid

27.0Small、29.0オブジェクト種別を示す小、中、大アイコン。motif にはオブジェクトのベース色を含めることもできます。このアイコンは、ファイルのプレビューではありません。

Motifmotif

23.0Medium、29.0コンテキストユーザがこのファイルをフォローしている場合は、登録に関する情報が含



23.0Small、29.0このレコードのローカライズされた名前。Stringname

23.0Small、29.0このオブジェクトの固定の種別名。レスポンスボディの状態を判別するには、この値を調べます。

Stringtype

23.0Small、29.0このオブジェクトのChatter REST API URL リソース。

Stringurl

List View Sort

関連リストの並び替え順の序数を定義します。

684

List View SortChatter REST API レスポンスボディ




29.0Small、29.0並び替える関連リスト列の項目 ID。Stringcolumn

29.0Small、29.0列の並び替え順序。次のいずれかの値にします。

Stringorder

• Ascending — 昇順 (A から Z)。• Descending — 降順 (Z から A)。

Maintenance Information

組織の今後の定期メンテナンスに関する情報。




34.0Small、34.0メンテナンスの説明。Stringdescription

34.0Small、34.0メンテナンスのタイトル。StringmaintenanceTitle

34.0Small、34.0メンテナンスの種別を指定します。次のいずれかになります。

StringmaintenanceType

• Downtime — ダウンタイムメンテナンス。

• GenerallyAvailable — 正式リリースモードでのメンテナンス。

• MaintenanceWithDowntime —

ダウンタイムを伴う定期メンテナンス。

• ReadOnly — 参照のみモードでのメンテナンス。

34.0Small、34.0ユーザへのメンテナンスメッセージの表示開始日。

DatemessageEffectiveTime

34.0Small、34.0メンテナンスメッセージの有効期限。

DatemessageExpirationTime

34.0Small、34.0スケジュール設定されたダウンタイム終了日。

DatescheduledEndDowntime

GenerallyAvailable および

685

Maintenance InformationChatter REST API レスポンスボディ




ReadOnly メンテナンス種別の場合は null。

34.0Small、34.0定期メンテナンス終了日。Downtimeメンテナンス種別の場合は null。

DatescheduledEndMaintenanceTime

34.0Small、34.0スケジュール設定されたダウンタイム開始日。

DatescheduledStartDowntime

GenerallyAvailable およびReadOnly メンテナンス種別ではnull になります。

34.0Small、34.0定期メンテナンス開始日。Downtimeメンテナンス種別の場合は null。

DatescheduledStartMaintenanceTime

Managed Topic

コミュニティの管理トピックを表します。




35.0Medium、35.0管理トピックの子管理トピック。Managed Topic[]children

32.0Small、32.0管理トピックの ID。Stringid

32.0Small、32.0管理トピックの種別。StringmanagedTopicType • Featured — コミュニティホー



35.0Medium、35.0管理トピックの親管理トピック。Referenceparent

32.0Small、32.0トピックに関する情報。Topictopic

32.0Small、32.0管理トピックへの Chatter REST API

URL。Stringurl

686

Managed TopicChatter REST API レスポンスボディ

Managed Topic Collection

コミュニティの管理トピックのコレクション。






32.0Small、32.0管理トピックのコレクション。Managed Topic[]managedTopics

Mention Completion

ユーザまたはグループの @メンションに使用できるレコードに関する情報。




29.0Big、29.0この補完で表されるレコードの追加の表示ラベル (存在する場合) (「(Customer)」や「(Acme

Corporation)」など)。


29.0Medium、29.0この補完で表されるレコードの説明。Stringdescription

29.0Small、29.0この補完で表されるレコードの名前Stringname

29.0Medium、29.0この補完で表されるレコードの写真またはアイコンの URL

StringphotoUrl

29.0Small、29.0この補完で表されるレコードの 18 文字の IDStringrecordId

30.0Medium、30.0この完了によって表されるレコードがユーザの場合、この値はそのユーザに関連付けられ

StringuserType

たユーザ種別になります。それ以外の場合は、null です。次のいずれかの値にします。• ChatterGuest — 非公開グループの外部

ユーザ。• ChatterOnly — Chatter Free ユーザ。• Guest — 認証されていないユーザ。• Internal — 標準組織メンバー。• Portal — カスタマーポータル、パート


687

Managed Topic CollectionChatter REST API レスポンスボディ






Mention Completion Page

Mention Completion レスポンスボディのページ設定されたリスト。




29.0Medium、29.0現在のページの URLStringcurrentPageUrl

29.0Small、29.0メンションで使用する Mention Completion レスポンスボディのコレクション。

MentionCompletion[]

mentionCompletions


StringnextPageUrl




Mention Validation

提案メンションがコンテキストユーザに有効かどうかに関する情報。




29.0Small、29.0メンションされたレコードの ID。StringrecordId

688

Mention Completion PageChatter REST API レスポンスボディ




29.0Small、29.0提案メンションの検証エラーの種類を示します (存在する場合)。次のいずれかの値にします。

StringvalidationStatus

• Disallowed — 提案メンションは無効であり、コンテキストユーザが許可されていない対象にメンションしようとしているため却下されます。たとえば、非公開グループのメンバーでないユーザが非公開グループにメンションしようとしている場合などです。

• Inaccessible — 提案メンションは許可されていますが、メンションされるユーザまたはレコードには議論されている親レコードへのアクセス権がないため、通知されません。

• Ok — 提案メンションに検証エラーはありません。

Mention Validations

メンションのセットがコンテキストユーザに有効かどうかに関する情報。




29.0Small、29.0提案メンションのうち、少なくとも 1 つにエラーがあるか (true)、否か (false) を示しま

BooleanhasErrors

す。たとえば、コンテキストユーザは自分が属していない非公開グループにメンションできません。そのようなグループがメンションの検証のリストに含まれていると、hasErrors は true になり、そのメンションの検証で Disallowed のvalidationStatus がグループに設定されます。

29.0Medium、29.0メンションのセットがコンテキストユーザに有効かどうかに関する情報。

Mention Validation[]mentionValidations

689

Mention ValidationsChatter REST API レスポンスボディ

Message




23.0Small、29.0このメッセージのテキストFeed Item Bodybody

23.0Big、29.0このメッセージが含まれる会話の 18 文字のID

StringconversationId

23.0Small、29.0このメッセージが含まれる会話への URLStringconversationUrl

23.0Small、29.0メッセージの 18 文字の IDStringid

23.0Small、29.01 人以上のメッセージ受信者のコレクションUser Summary[]recipients

メモ: Conversation Detail と Conversation

Summaryの会話の membersプロパティで会話の参加者は特定されるため、次のリソースのメール受信者のコレクションは空になっています。• /chatter/users/me/

conversations

• /chatter/users/me/conversations/conversationId


StringsentDate

23.0Small、29.0このメッセージを送信したユーザに関する情報

User Summarysender

32.0Medium、32.0メッセージの送信元のコミュニティに関する情報デフォルトのコミュニティの場合またはコミュニティが無効の場合は nullが返されます。

ReferencesendingCommunity

23.0Small、29.0このメッセージへの URLStringurl

690

MessageChatter REST API レスポンスボディ

Message Collection





23.0Small、29.01 つ以上のメッセージのコレクションMessage[]messages


StringnextPageUrl


Message Segment: Entity Link

ユーザまたはグループなどのエンティティを表します。




27.0Small、29.0エンティティ種別に対応する小、中、大の一連のアイコン motif には、エンティティ種別のベース色を含めることもできます。

Motifmotif

25.0Small、29.0エンティティに関する情報Referencereference

25.0Small、29.0このセグメントのプレーンテキスト出力Stringtext

25.0Small、29.0EntityLinkStringtype

Message Segment: Field Change

インライン項目変更を表します。

例: インライン項目変更の例として、"First Name from Bob to Joe" などがあります。次のセグメント例は、複数のセグメントで構成されています。[

Text("Owner from "),FieldChangeValue("Bob Smith"),Text(" to "),

691

Message CollectionChatter REST API レスポンスボディ

FieldChangeValue("Dave Jones")]





Segments[]segments


• Message Segment: Field Change

• Message Segment: Field Change Name

• Message Segment: Field Change Value

• Message Segment: Hashtag

• Message Segment: Inline Image (バージョン 35.0

以降)

• Message Segment: Link

• Message Segment: Markup Begin (バージョン35.0 以降)

• Message Segment: Markup End (バージョン 35.0

以降)

• Message Segment: Mention

• Message Segment: More Changes


23.0Small、29.0変更の書式設定済みテキスト。次に例を示します。"City from San Francisco toNew Orleans"

Stringtext

23.0Small、29.0値は FieldChangeStringtype

Message Segment: Field Change Name

項目変更のインライン項目名を表します ("Name" や "Description" など)。これを別個のセグメントにすることで、名前項目を太字にするなど、項目名に対して特殊なユーザインターフェース処理を行うことができます。

692

Message Segment: Field Change NameChatter REST API レスポンスボディ




23.0Small、29.0変更の書式設定済みテキスト。値には、次のものがあります。

Stringtext

• 項目の以前の名前• 項目の新しい名前

23.0Small、29.0値は FieldChangeNameStringtype

Message Segment: Field Change Value

項目変更のインライン値を表します ("1" や "Bob Smith" など)。これを別個のセグメントにすることで、値をアンカータグで囲むなど、特殊なコーディングを追加できます。




29.0Big、29.0値の型。次のいずれかの値にします。StringvalueType

• NewValue — 項目変更の新しい値。• OldValue — 項目変更の以前の値。

23.0Small、29.0変更の書式設定済みテキスト。値には、次のものがあります。

Stringtext

• a blank value という語

メモ: このテキストはローカライズされます。

• 項目の以前の値• 項目の新しい値

23.0Small、29.0値は FieldChangeValueStringtype

23.0Small、29.0項目変更が URL 項目 (Web アドレスなど) に対するものである場合、URL 値

Stringurl

Message Segment: Hashtag

インラインハッシュタグを表します。

693

Message Segment: Field Change ValueChatter REST API レスポンスボディ




23.0Small、29.0ハッシュ記号 (#) を除いたハッシュタグのテキスト

Stringtag

23.0Small、29.0ハッシュ記号 (#) 付きのハッシュタグのテキスト

Stringtext

28.0Small、29.0次の形式のトピックの URL:

/services/data/.../topics?exactMatch=true&q=tag

StringtopicUrl

23.0Small、29.0値は HashtagStringtype

23.0Small、29.0次の形式のタグの URL 検索:

services/data/.../feed-elements?q=tag

Stringurl

Message Segment: Inline Image

フィード本文のインライン画像。




35.0Small、35.0インライン画像の代替テキスト。StringaltText

35.0Small、35.0ファイルのサイズ (バイト)。IntegercontentSize

35.0Small、35.0インライン画像の代替テキストまたはインライン画像の ID (代替テキストが使用できない場合)。

Stringtext

35.0Medium、35.0画像に使用可能なサムネイルに関する情報。

File PreviewCollection

thumbnails

35.0Small、35.0InlineImageStringtype

35.0Small、35.0最新バージョンのインライン画像の URL。

Stringurl

Message Segment: Link

URL へのインラインリンクを表します。

694

Message Segment: Inline ImageChatter REST API レスポンスボディ




23.0Small、29.0URL のプレーンテキスト。Stringtext

23.0Small、29.0値は Link です。Stringtype

23.0Small、29.0リンクの URL 値。Stringurl

Message Segment: Markup Begin

リッチテキストマークアップの開始。




35.0Small、35.0このマークアップの HTML タグ。StringhtmlTag

35.0Small、35.0リッチテキストマークアップの種別を示します。

StringmarkupType


トタグ。• Paragraph — パラグラフタグ。• StrikeThrough — 取り消し線


ストタグ。

35.0Small、35.0この種別のセグメントの空の文字列 ""。

Stringtext

35.0Small、35.0MarkupBeginStringtype

Message Segment: Markup End

リッチテキストマークアップの終了。

695

Message Segment: Markup BeginChatter REST API レスポンスボディ




35.0Small、35.0このマークアップの HTML タグ。StringhtmlTag

35.0Small、35.0リッチテキストマークアップの種別を示します。

StringmarkupType


トタグ。• Paragraph — パラグラフタグ。• StrikeThrough — 取り消し線


ストタグ。

35.0Small、35.0この種別のセグメントの空の文字列 ""。

Stringtext

35.0Small、35.0MarkupEndStringtype

Message Segment: Mention

インラインの @メンションを表します。




23.0Small、29.0メンションされたユーザまたはグループがメンションを表示できるか (true)、否か(false) を示します。

Booleanaccessible

23.0Small、29.0メンションされたユーザまたはグループの名前。

Stringname

23.0Small、29.0メンションのプレーンテキスト。Stringtext

23.0Small、29.0値は Mention です。Stringtype

696

Message Segment: MentionChatter REST API レスポンスボディ




29.0Small、29.0メンションされたユーザまたはグループに関する情報。次のいずれかのレスポンスボディになります。

record

• Group

• User Detail

• User Summary

23.0 ～ 28.0

29.0 より前のバージョ

なしメンションされたユーザに関する情報。コンテキストユーザにアクセス権がない場合はnull。

User Summaryuser

ンでは、メ重要: バージョン 29.0 以降では、record プロパティを使用します。ンションが

ユーザでない場合、メンションはMessageSegment: Text

レスポンスボディに含まれます。

Message Segment: More Changes




29.0Big、29.0フィード項目の追跡変更の完全なコレクション。

Message Segment:Field Change[]

moreChanges

23.0Small、29.0変更の数IntegermoreChangesCount

23.0Small、29.0変更数の書式設定済みテキスト。例: "2other changes"

Stringtext

メモ: この値はローカライズされます。

23.0Small、29.0値は MoreChangesStringtype

697

Message Segment: More ChangesChatter REST API レスポンスボディ

Message Segment: Resource Link




23.0Small、29.0このセグメントの書式設定済みテキストStringtext

23.0Small、29.0値は "ResourceLink"Stringtype

27.0Small、29.0リソースリンクの URL 値Stringurl

Message Segment: Text

プレーンインラインテキストを表します。




23.0Small、29.0項目に関連付けられた書式設定済みテキスト。値には、次のものがあります。

Stringtext

• フィード項目またはコメントの書式設定済みテキスト。

• from という語を使用して示される、変更された項目の名前。

23.0Small、29.0値は Text です。Stringtype

Moderation Capability

フィード要素にこの機能がある場合、コミュニティのユーザはフィード要素にモデレーションフラグを設定できます。このレスポンスボディには、フラグが設定されたコンテンツに関する情報も含まれます。




31.0Big、31.0このフィード要素のフラグ。コミュニティモデレータは、フラグ付き


項目を表示したり、フラグ付き項目に対してアクションを実行したりできます。

698

Message Segment: Resource LinkChatter REST API レスポンスボディ

Moderation Flags

Moderation flags は、組織で Salesforce Communities が有効になっていて、コミュニティ管理者がコミュニティ設定時に [メンバーにコンテンツのフラグの設定を許可] を選択した場合に使用できます。




29.0Small、29.0コンテキストユーザがコミュニティモデレータの場合、投稿、コメント、またはファイル

IntegerflagCount

のフラグの総数を示します。コンテキストユーザがコミュニティモデレータでない場合は、値が null になります。ファイルのフラグは、バージョン 30.0 以降で使用できます。

29.0Small、29.0投稿、コメント、またはファイルにコンテキストユーザがフラグを設定したか (true)、否か (false) を示します。ファイルのフラグは、バージョン 30.0 以降で使用できます。

BooleanflaggedByMe

Motif

motif プロパティには、Salesforceレコードタイプを示す小、中、大のアイコンへの URL があります。一般的なレコードタイプは、ファイル、ユーザ、グループですが、すべてのレコードタイプに一連の motif アイコンがあります。カスタムオブジェクトレコードでは、タブスタイルアイコンが使用されます。認証されていないユーザでもすべてのアイコンを使用できるため、たとえば、motif アイコンをメールで表示することができます。motif にはレコードタイプのベース色を含めることもできます。

例:

メモ: motif 画像はアイコンであり、ユーザがアップロードした画像または写真ではありません。たとえば、すべてのユーザは同じセットの motif アイコンを使用できます。

カスタムオブジェクトレコードでは、タブスタイルアイコンが使用されます。たとえば、次のカスタムオブジェクトでは、「boat」タブスタイルが使用されます。

"motif": {"color": "8C004C","largeIconUrl": "/img/icon/custom51_100/boat64.png","mediumIconUrl": "/img/icon/custom51_100/boat32.png","smallIconUrl": "/img/icon/custom51_100/boat16.png","svgIconUrl": null

},

699

Moderation FlagsChatter REST API レスポンスボディ

ユーザは、次のアイコンを使用します。"motif": {

"color": "1797C0","largeIconUrl": "/img/icon/profile64.png","mediumIconUrl": "/img/icon/profile32.png","smallIconUrl": "/img/icon/profile16.png","svgIconUrl": null

},

グループは、次のアイコンを使用します。"motif": {

"color": "1797C0","largeIconUrl": "/img/icon/groups64.png","mediumIconUrl": "/img/icon/groups32.png","smallIconUrl": "/img/icon/groups16.png"

},

ファイルは、次のアイコンを使用します。"motif": {

"color": "1797C0","largeIconUrl": "/img/content/content64.png","mediumIconUrl": "/img/content/content32.png","smallIconUrl": "/img/icon/files16.png","svgIconUrl": null

},

メモ: 前の例のアイコンを表示するには、URL を https://instance_name で置き換えます。たとえば、https://instance_name/img/icon/profile64.png に保存されます。




29.0Small、29.0レコードタイプのベース色を表す 16 進値または null。

Stringcolor

27.0Small、29.0レコードタイプを示す大アイコンStringlargeIconUrl

27.0Small、29.0レコードタイプを示す中アイコンStringmediumIconUrl

27.0Small、29.0レコードタイプを示す小アイコンStringsmallIconUrl

34.0Small、34.0レコードタイプを示す SVG 形式のアイコン、またはアイコンが存在しない場合は null。

StringsvgIconUrl

700

MotifChatter REST API レスポンスボディ

Mute Capability

フィード要素にこの機能がある場合、ユーザがフィード要素をミュートできます。ミュートされたフィード要素は、ミュートされたフィードに表示され、ミュートが考慮される他のすべてのフィードには表示されません。




35.0Small、35.0コンテキストユーザがフィード要素をミュートしたかどうかを示します。

BooleanisMutedByMe

Non-Entity Recommendation

Salesforce 以外のエンティティ (アプリケーションなど) のおすすめを表します。このレスポンスボディは、バージョン 34.0 以降では使用できません。バージョン 34.0 以降では、すべてのおすすめに Recommendation レスポンスボディが使用されます。




32.0Small、32.0非エンティティオブジェクトのローカライズされた表示ラベル。

StringdisplayLabel

23.0Big、29.0おすすめの説明。ExplanationSummary

explanation

32.0Small、32.0非エンティティオブジェクトのMotif。

Motifmotif

32.0Small、32.0おすすめされるレコードのタイプを示します。

StringrecommendationType

• apps

• files

• groups

• records

• users

701

Mute CapabilityChatter REST API レスポンスボディ

Organization




24.0Small、29.0この時間を過ぎると、何も操作を行っていないユーザに対し、ログアウトするか操作を続

IntegeraccessTimeout

行するかを選択させるポップアップウィンドウが表示されます。

24.0Small、29.0組織またはコミュニティで使用可能な機能に関する情報

Featuresfeatures

34.0Medium、34.0組織で今後予定されているメンテナンスのリストに関する情報。

MaintenanceInformation[]

maintenanceInfo

26.0Small、29.0組織名Stringname

24.0Small、29.0組織の 18 文字の IDStringorgId

24.0Small、29.0ユーザの組織権限に関する情報User SettingsuserSettings

Origin Capability

フィード要素にこの機能がある場合、そのフィード要素はフィードアクションによって作成されています。




33.0Small、33.0フィードアクションを実行したユーザ。

User Summaryactor

33.0Small、33.0フィードアクションが含まれるフィード要素への参照。

ReferenceoriginRecord

Phone Number

電話番号。




30.0Small、30.0電話の種別を示すローカライズされた文字列Stringlabel

702

OrganizationChatter REST API レスポンスボディ




23.0 ～ 26.0なしStringnumberメモ: このプロパティは、バージョン26.0 以降では使用できません。代わりに、phoneNumber プロパティを使用してください。

電話番号27.0Small、29.0電話番号StringphoneNumber

30.0Small、30.0電話の種別。次のいずれかの値にします。StringphoneType

• Fax

• Mobile

• Work

これらの値はローカライズされません。

23.0 ～ 29.0Small、29.0Stringtypeメモ: このプロパティは、バージョン29.0 以降では使用できません。代わりに、phoneTypeプロパティを使用してください。

値は次のとおりです。• Fax

• Mobile

• Work

Photo




27.0Medium、29.030 日後に有効期限が切れる大きなプロファイル写真への一時的な URL。この URL は、認証されていないユーザが使用できます。

StringfullEmailPhotoUrl

23.0Medium、29.0大きなプロファイル写真への URL。デフォルトの幅は 200 ピクセルです。長さは、元の画像の比率が維持されるように設定されます。

StringlargePhotoUrl

24.0Small、29.0そのバージョンの写真の 18 文字の IDStringphotoVersionId

703

PhotoChatter REST API レスポンスボディ




23.0Small、29.0小さいプロファイル写真への URL。デフォルトのサイズは 64x64 ピクセルです。

StringsmallPhotoUrl

27.0Small、29.030 日後に有効期限が切れる小さいプロファイル写真への一時的な URL。この URL は、認証されていないユーザが使用できます。

StringstandardEmailPhotoUrl

27.0Small、29.0Photo レスポンスボディを返すリソースの URL(/services/data/v35.0

Stringurl

/chatter/users/005D0000001LL8OIAW/photo

など)

Platform Action

コンテキストユーザの状態情報を含むプラットフォームアクションインスタンス。アクションリンクは、プラットフォームアクションの種別の 1 つなので、Platform Action レスポンスボディとして表されます。




33.0Medium、33.0subtype Ui または Download のアクションリンクの場合、このリ

StringactionUrl

ンクからユーザにダウンロードやUI アクセスを行わせます。Salesforce

は次の形式でリンクの Javascript リダイレクトを発行します:/action-link-redirect/communityId/actionLinkId?_bearer=bearerToken

Api および ApiAsync アクションリンク、およびすべてのプラットフォームアクションの場合、この値は null になります。Salesforce により、Api およびApiAsync アクションリンクへのコールアウトが処理されます。/connect/action-links/actionLinkId

リソースに対して PATCH 要求を実行し、statusを PendingStatusに設定して、Api または ApiAsync

704

Platform ActionChatter REST API レスポンスボディ




アクションリンクをコールすることもできます。

33.0Medium、33.0API 名。この値は null になることがあります。

StringapiName

33.0Medium、33.0このアクションに確認が必要で、状況が NewStatusの場合は、この

StringconfirmationMessage

プロパティがローカライズされたデフォルトのメッセージになり、このアクションを呼び出す前にエンドユーザに表示されます。それ以外の場合は、この値が nullになります。

33.0Medium、33.0このアクションがコンテキストユーザによって呼び出された後にその

Record Summary[]createdRecords

アクションによって作成されたレコードのコレクションです。コンテキストユーザがアクションを実行していない場合、またはアクションによってレコードが作成されていない場合、このコレクションは空になります。コンテキストユーザによって作成されたレコードのみが表示されます。

33.0Medium、33.0プラットフォームアクションの実行を開始したユーザ。

User SummaryexecutingUser

33.0Small、33.0このプラットフォームアクションがプラットフォームアクショング

BooleangroupDefault

ループのデフォルトまたはプライマリのプラットフォームアクションの場合は true、それ以外の場合は false。デフォルトプラットフォームアクションはプラットフォームアクショングループごとに 1 つのみです。

33.0Medium、33.0プラットフォームアクションのアイコンの URL。この値は、null になる場合があります。

StringiconUrl

705





33.0Small、33.0プラットフォームアクションの ID。type が QuickAction で、subtype が Create の場合、この値は null になります。

Stringid

33.0Small、33.0このプラットフォームアクションのローカライズされた表示ラベル。

Stringlabel


DatemodifiedDate

33.0Small、33.0このプラットフォームアクションを含むプラットフォームアクショングループへの参照。

ReferenceplatformActionGroup

33.0Small、33.0プラットフォームアクションの実行状況。値は次のとおりです。

Stringstatus


• NewStatus — アクションリンクの実行の準備が整っています。Download および Ui アクションリンクでのみ使用できます。

• PendingStatus — アクションリンクが実行されています。この値を選択すると、Api およびApiAsync アクションリンクのAPI コールがトリガされます。


アクションリンクに限り、/connect/action-links/actionLinksIdリソースに対して PATCH 要求を実行することによって、statusを更新できます。

706





33.0Small、33.0プラットフォームアクションのサブタイプまたは null。typeプロパティが ActionLinkの場合、使用できる値は次のとおりです。

Stringsubtype

• Api — アクションリンクは、アクション URL で同期 API をコールします。Salesforce は、サーバから返された HTTP 状況コードに基づいて状況をSuccessfulStatus またはFailedStatusに設定します。

• ApiAsync — アクションリンクは、アクション URL で非同期 API

をコールします。アクションは、非同期操作の完了時にサードパーティが/connect/action-links/actionLinkId

への要求を行って状況をSuccessfulStatus またはFailedStatus に設定するまで、PendingStatus 状態のままになります。



33.0Small、33.0プラットフォームアクションの種別。値は次のとおりです。

Stringtype

• ActionLink — API、Web ページ、またはファイルを指す、フィード要素上のインジケータで、Salesforce Chatter フィード UI

のボタンによって表されます。• CustomButton — クリックする

と、ウィンドウ内で URL または

707





Visualforce ページが開くか、JavaScript が実行されます。

• InvocableAction

• ProductivityAction — 生産性アクションは Salesforce によって事前定義され、限られたオブジェクトのセットに適用されます。生産性アクションを編集または削除することはできません。

• QuickAction — グローバルアクションまたはオブジェクト固有のアクション。

• StandardButton — 事前定義されたSalesforceボタン ([新規]、[編集]、[削除] など)。

33.0Small、33.0プラットフォームアクションのChatter REST API リソース URL。type が QuickAction で、subtype が Create の場合、この値は null になります。

Stringurl

Platform Action Group

コンテキストユーザに適した状態のプラットフォームアクショングループインスタンス。アクションリンクグループは、プラットフォームアクショングループの種別の 1 つなので、Platform Action Group

レスポンスボディとして表されます。




33.0Medium、33.0プラットフォームアクションの優先度および相対位置を示します。値は次のとおりです。

Stringcategory


708

Platform Action GroupChatter REST API レスポンスボディ





33.0Small、33.0プラットフォームアクショングループの 18 文字の ID か、不透明な文字列の ID。プラットフォームアクションのtype が QuickAction で、

Stringid

subtype が Create の場合、この値は null になります。


2011—02—25T18:24:31.000Z)。DatemodifiedDate

33.0Medium、33.0このグループのプラットフォームアクションインスタンス。アクションリンクグループ内では、アクションリンクは、Action Link

Platform Action[]platformActions

Group Definition Input リクエストボディの actionLinksプロパティにリストされる順序で表示されます。フィード項目内では、アクションリンクグループは、Associated Actions

Capability Input リクエストボディのactionLinkGroupIdsプロパティに指定された順序で表示されます。

33.0Small、33.0プラットフォームアクショングループの Chatter REST API リソース URL。プラットフォームアクションのtype が QuickAction で、

Stringurl

subtype が Create の場合、この値は null になります。

Poll Capability

フィード要素にこの機能がある場合、フィード要素に投票のアンケートを含めることができます。

709

Poll CapabilityChatter REST API レスポンスボディ




32.0Small、32.0アンケートを構成するアンケート選択肢のコレクション。

Feed Poll Choice[]choices

32.0Small、32.0このアンケートで現在のユーザが投票した選択肢の 18 文字の ID。現

StringmyChoiceId

在のユーザが投票していない場合は、null を返します。

32.0Small、32.0フィードアンケート要素に投じられた投票の合計数。

StringtotalVoteCount

Question and Answers Capability

フィード要素にこの機能がある場合、質問があり、フィード要素のコメントはその質問への回答です。




32.0Small、32.0質問の最良の回答として選択されたコメント。

CommentbestAnswer

32.0Small、32.0質問の最良の回答を選択したユーザ。

User SummarybestAnswerSelectedBy

32.0Small、32.0現在のユーザが最良の回答を選択または削除できるか (true)、否か(false) を示します。

BooleancanCurrentUserSelectOrRemoveBestAnswer

33.0Medium、33.0質問の投稿がエスカレーションされた場合、これがエスカレーション先ケースになります。

ReferenceescalatedCase

32.0Small、32.0質問のタイトル。StringquestionTitle

Question and Answers Suggestion Collection

質問および回答の提案の検索結果。




32.0Small、32.0記事のコレクション。Article Item[]articles

710

Question and Answers CapabilityChatter REST API レスポンスボディ




32.0Small、32.0質問のコレクション。質問は次のいずれかになります。

questions

• 汎用フィード要素• Feed Item

Recommendation

おすすめを表します。




23.0Small、29.0ユーザ、ファイル、グループ、およびレコード entity 種別の場合、この Chatter REST URL

StringactOnUrl

を POST 要求に使用して、おすすめのユーザ、ファイル、またはレコードをフォローするか、おすすめのグループに参加します。次に例を示します。/services/data/v35.0/chatter/users/005D0000001AzOAIA0/following?subjectId=005D0000001B4CvIAK

カスタムのおすすめなど、おすすめのオブジェクト entity種別の場合、Platform Action

レスポンスボディの actionUrlプロパティを使用しておすすめに対応します。

Small、29.0おすすめに対して実行するアクションを指定します。値は次のとおりです。

Stringaction

• follow (V23.0)

• join (V23.0)

• view (V25.0)

32.0Small、32.0受信者がアクションを実行することをすすめられたエンティティ。

File Summary

グループentity

Recommended

Object (バージョン 34.0 以降)

Record Summary

711

RecommendationChatter REST API レスポンスボディ




User Summary

23.0Big、29.0おすすめの説明。ExplanationSummary

explanation

23.0 ～ 31.0Small、29.0受信者がアクションを実行することをすすめられたオブジェクト。

File Summary

グループobject

重要: バージョン 32.0 以降では、entity プロパティを使用します。

Record Summary

User Summary

34.0Small、34.0コンテキストユーザに適した状態のプラットフォームアクショングループインスタンス。

Platform ActionGroup

platformActionGroup

32.0Small、32.0おすすめされるレコードのタイプを示します。

StringrecommendationType

• apps

• files

• groups

• records

• users

23.0 ～ 23.0バージョン 23.0 以降では使用できません。Stringtype

34.0Small、34.0おすすめへの URL。Stringurl

Recommendation Audience

おすすめ利用者。




35.0Small、35.0おすすめ利用者の 18 文字の ID。Stringid

35.0Small、35.0おすすめ利用者のメンバー数。IntegermemberCount

35.0Big、35.0おすすめ利用者のメンバー。User ReferenceCollection

members

35.0Small、35.0おすすめ利用者の名前。Stringname

35.0Small、35.0おすすめ利用者の URL。Stringurl

712

Recommendation AudienceChatter REST API レスポンスボディ

Recommendation Audience Collection

おすすめ利用者のコレクション。




35.0Small、35.0おすすめ利用者の総数。IntegeraudienceCount

35.0Small、35.0現在のページへの URL。StringcurrentPageUrl

35.0Small、35.0次のページへの URL。StringnextPageUrl

35.0Small、35.0前のページへの URL。StringpreviousPageUrl

35.0Small、35.0おすすめ利用者のコレクション。RecommendationAudience[]

recommendationAudiences

Recommendation Definition

カスタムおすすめ定義を表します。




33.0Small、33.0このおすすめに基づいて行動するための URL。

StringactionUrl

34.0Small、34.0ユーザインターフェースでのアクション URL のテキストラベル。

StringactionUrlName

33.0Medium、33.0おすすめ定義の説明。Stringexplanation

33.0Small、33.0おすすめ定義の 18 文字の ID。Stringid

33.0Medium、33.0おすすめ定義の名前。この名前が[設定] に表示されます。

Stringname

33.0Medium、33.0おすすめ定義の写真。Photophoto

33.0Small、33.0おすすめ定義のタイトル。Stringtitle

33.0Small、33.0おすすめ定義の Chatter REST API リソースへの URL。

Stringurl

Recommendation Definition Collection

おすすめ定義のリストを表します。

713

Recommendation Audience CollectionChatter REST API レスポンスボディ




33.0Small、33.0おすすめ定義のリスト。RecommendationDefinition[]

recommendationDefinitions

33.0Small、33.0おすすめ定義コレクションのChatter

REST API リソースへの URL。Stringurl

Recommendations

推奨事項のリスト。




23.0Small、29.0推奨事項のコレクション。Recommendation[]recommendations

Recommendations Capability

フィード要素にこの機能がある場合、おすすめがあります。




32.0Small、32.0おすすめのコレクション。次のレスポンスボディからなる

items

コレクションです。• Non-Entity

Recommendation

このレスポンスボディは、バージョン34.0 以降では使用できません。バージョン 34.0 以降では、すべてのおすすめにRecommendation

レスポンスボ

714

RecommendationsChatter REST API レスポンスボディ




ディが使用されます。

• Recommendation

Recommended Object

カスタムのおすすめや静的なおすすめなど、おすすめのオブジェクト。




34.0Small、34.0カスタムのおすすめのおすすめ定義 ID、または ID のない静的なおす

StringidOrEnum

すめの列挙値 Today (バージョン35.0 以降)。

34.0Small、34.0おすすめのオブジェクトの Motif。Motifmotif

22.0Small、29.0おすすめのオブジェクトの名前。Stringname

22.0Small、29.0RecommendedObjectStringtype

Record Field

表示ラベルおよびテキスト値を含む汎用レコード項目。




29.0Small、29.0レコード項目を説明するローカライズされた文字列。

Stringlabel

29.0Small、29.0レコード項目のテキスト値。すべてのレコード項目にテキスト値があります。すべてのク

Stringtext

ライアントが新しいコンテンツを使用できることを確認するために、レコード項目のtypeプロパティを調べます。認識されない場合は、デフォルトケースとしてテキスト値を表示します。

715

Recommended ObjectChatter REST API レスポンスボディ




29.0Small、29.0有効な値は、次のとおりです。Stringtype

• Boolean

• Email

• Number

• Phone

• Text

Record Field: Blank

項目のグリッドにプレースホルダとして表示されるレコード項目。




29.0Small、29.0BlankStringtype

Record Field: Compound

サブ項目で構成されるレコード項目。




29.0Big、29.0複合項目を構成するサブ項目のコレクション。次のレスポンスボディからなるコレクションです。

fields

• Record Field









716

Record Field: BlankChatter REST API レスポンスボディ





Stringlabel


Stringtext



• Address

• Compound

• Location

• Name

Record Field: Currency

通貨値を含むレコード項目。





Stringlabel


Stringtext

ライアントが新しいコンテンツを使用できることを確認するために、レコード項目のtypeプロパティを調べます。認識されない場合は、デフォルトケースとしてテキスト値を表示します。通貨は、組織のデフォルトの通貨の形式になります。

29.0Small、29.0CurrencyStringtype

717

Record Field: CurrencyChatter REST API レスポンスボディ

Record Field: Date

日付を含むレコード項目。




29.0Medium、29.0機械可読の日付。DatedateValue


Stringlabel


Stringtext



• Date

• DateTime

• Time

Record Field: Percent

パーセント値を含むレコード項目。




29.0Medium、29.0パーセントの値。Doublevalue


Stringlabel


Stringtext


718

Record Field: DateChatter REST API レスポンスボディ




29.0Small、29.0PercentStringtype

Record Field: Picklist

列挙値を含むレコード項目。





Stringlabel


Stringtext


29.0Small、29.0PicklistStringtype

Record Field: Reference

別のオブジェクトへの参照を含むレコード項目。





Stringlabel

29.0Medium、29.0レコード項目によって参照されるオブジェクト。

Referencereference


Stringtext

ライアントが新しいコンテンツを使用できることを確認するために、レコード項目のtypeプロパティを調べます。認識されない

719

Record Field: PicklistChatter REST API レスポンスボディ




場合は、デフォルトケースとしてテキスト値を表示します。

29.0Small、29.0ReferenceStringtype

Record Field: Reference with Date

特定の時刻に動作した参照されるオブジェクトを含むレコード項目 (「作成者」など)。




29.0Medium、29.0参照されるオブジェクトが動作した時刻。DatedateValue


Stringlabel

29.0Medium、29.0レコード項目によって参照されるオブジェクト。

Referencereference


Stringtext



• CreatedBy

• LastModifiedBy

Record Snapshot Capability

フィード要素にこの機能がある場合、1 つのレコード作成イベントについて、レコードのスナップショットとして取得された項目すべてが含まれます。

720

Record Field: Reference with DateChatter REST API レスポンスボディ




32.0Small、32.0メタデータとデータを含むレコード表現で、レコードを簡単に表示できるようになります。

Record ViewrecordView

Record Summary




23.0Small、29.0レコードの 18 文字の IDStringid

27.0Small、29.0レコードのタブスタイルを示す小、中、大のアイコン。motif にはレコードタイプのベース色を含めることもできます。

Motifmotif

24.0Medium、29.0コンテキストユーザがこのレコードをフォローしている場合は、登録に関する情報が含



23.0Small、29.0ローカライズされた名前Stringname

23.0Small、29.0レポートタイプ (CustomObject やContentDocument など)

Stringtype

23.0Small、29.0このレコードの相対 URLStringurl

Record Summary List

組織のレコード (カスタムオブジェクトを含む) のコレクションに関するサマリー情報。




30.0Small、30.0レコードのコレクション。コレクションには、次のレスポンスボディのいずれかが含まれる場合があります。

records

• File Summary

• Group

• Record Summary

721

Record SummaryChatter REST API レスポンスボディ




• User Summary

30.0Small、30.0このレコードのコレクションへの URL。Stringurl

Record View

組織のレコード (カスタムオブジェクトレコードを含む) のビュー。このオブジェクトは、レコードタイプで特殊なオブジェクト (User や ChatterGroup など) を使用できない場合に使用されます。データとメタデータが含まれるため、レコードを 1 つの応答で表示できます。




23.0Small、29.0オブジェクトの 18 文字の IDStringid

27.0Small、29.0オブジェクト種別を示す小、中、大アイコン。motif にはオブジェクトのベース色を含めることもできます。このアイコンは、ファイルのプレビューではありません。

Motifmotif

23.0Medium、29.0

コンテキストユーザがこのファイルをフォローしている場合は、登録に関する情報が含まれます。それ以外の場合は、null を返します。


29.0Small、29.0ローカライズされた名前Stringname

29.0Medium、29.0

このオブジェクトの関連リスト定義 (メタデータ)。これらのリスト定義には、関連リストデータは含まれません。

List View Definition[]relatedListDefinitions

29.0Small、29.0レコードビューセクションのリスト。Record View Section[]sections

23.0Small、29.0このオブジェクトの固定の種別名。レスポンスボディの状態を判別するには、この値を調べます。

Stringtype

23.0Small、29.0このオブジェクトのChatter REST API URL リソース。

Stringurl

722

Record ViewChatter REST API レスポンスボディ

Record View Section

レコード詳細のレコード項目と値のセクション。




29.0Small、29.0レコードセクションに項目をレイアウトするために使用する列の数。

StringcolumnCount

29.0Small、29.0レコードセクションに項目をレイアウトするために fields プロパティで使用する項目の順序。

StringcolumnOrder

• LeftRight — 項目は左から右に表示されます。

• TopDown — 項目は上から下に表示されます。

29.0Small、29.0このセクションに含まれるレコードの項目と値。次のレスポンスボディからなるコレクションです。

fields

• Record Field









29.0Small、29.0この項目のセクションを表示するときに使用するローカライズされた表示ラベル。

Stringheading

29.0Small、29.0このセクションを折りたたんですべての項目を非表示にできるか (true)、否か (false) を示します。

BooleanisCollapsible

Reference

レコードへの参照。

723

Record View SectionChatter REST API レスポンスボディ




23.0Small、29.0参照するレコードの ID。18 文字の ID または他の文字列 ID を指定できます。

Stringid

23.0Small、29.0リソースエンドポイントへの URL。Stringurl

Repository Directory Entry Collection

ディレクトリエントリのコレクション。




35.0Small、35.0ディレクトリエントリのコレクション。

Repository GroupSummary[]

Repository UserSummary[]

directoryEntries

Repository File Detail

リポジトリファイルの詳細な説明。Repository File Detail レスポンスボディには、Repository File Summary レスポンスボディのすべてが含まれます。

Repository File Summary

リポジトリファイルの説明。




32.0Small、32.0ファイルのチェックインコメント。StringcheckinComment

32.0Small、32.0ファイルのコンテンツの長さ (バイト単位)。

IntegercontentSize

32.0Small、32.0ファイルを作成したユーザの名前。StringcreatedBy

32.0Small、32.0ファイルの作成日。DatecreatedDate

32.0Small、32.0ファイルの説明。Stringdescription

32.0Small、32.0リポジトリファイルコンテンツへの URL。

StringdownloadUrl

724

Repository Directory Entry CollectionChatter REST API レスポンスボディ




32.0Small、32.0外部システムにおけるこのファイルのコンテンツの URL。

StringexternalContentUrl

32.0Small、32.0外部システムにおけるこのファイルの URL。


32.0Small、32.0ファイルの ID。Stringid

35.0Small、35.0項目種別情報の URL。StringitemTypeUrl

32.0Small、32.0ファイルの MIME タイプ。StringmimeType

32.0Small、32.0ファイルを最後に変更したユーザの名前。

StringmodifiedBy

32.0Small、32.0ファイルの変更日。DatemodifiedDate

32.0Small、32.0ファイルの Motif。Motifmotif

32.0Small、32.0ファイルの名前。Stringname

32.0Small、32.0ファイルの外部リポジトリ。Referencerepository

32.0Small、32.0ファイルのタイトル。Stringtitle

32.0Small、32.0レコードタイプ file。Stringtype

32.0Small、32.0このファイルのChatter REST API URL。Stringurl

32.0Small、32.0外部システムにおけるファイルバージョンの ID。

StringversionId

Repository Folder Item

フォルダ項目の説明。




32.0Small、32.0このフォルダ項目がファイルを表す場合は、ファイルのサマリー。

Repository FileSummary

file

このフォルダ項目がフォルダを表す場合は、null。

32.0Small、32.0このフォルダ項目がフォルダを表す場合は、フォルダのサマリー。

Repository FolderSummary

folder

このフォルダ項目がファイルを表す場合は、null。

725

Repository Folder ItemChatter REST API レスポンスボディ




32.0Small、32.0フォルダ項目の種別 (folder または file)。

Stringtype

Repository Folder Items Collection

リポジトリフォルダ項目のコレクション。






32.0Small、32.0リポジトリフォルダ内の項目のコレクション。

Repository FolderItem[]

items



null。別のページを取得する前に、この値が nullであるかどうかを確認します。ページが存在しない場合は、ConnectApi.NotFoundException




Repository Folder Summary

リポジトリフォルダの説明。




32.0Small、32.0フォルダを作成したユーザの名前。StringcreatedBy

32.0Small、32.0フォルダの作成日。DatecreatedDate

32.0Small、32.0フォルダの説明。Stringdescription

32.0Small、32.0外部システムにおけるこのフォルダの Chatter REST API URL。

StringexternalFolderUrl

726

Repository Folder Items CollectionChatter REST API レスポンスボディ




32.0Small、32.0このフォルダ内のファイルとフォルダをリストする Chatter REST API

URL。

StringfolderItemsUrl

32.0Small、32.0フォルダの ID。Stringid

35.0Small、35.0項目種別情報の URL。StringitemTypeUrl

32.0Small、32.0フォルダを最後に変更したユーザの名前。

StringmodifiedBy

32.0Small、32.0フォルダの変更日。DatemodifiedDate

32.0Small、32.0フォルダの Motif。Motifmotif

32.0Small、32.0フォルダの名前。Stringname

32.0Small、32.0外部システムにおけるフォルダの絶対パス。

Stringpath

32.0Small、32.0フォルダの外部リポジトリ。Referencerepository

32.0Small、32.0レコードタイプ folder。Stringtype

32.0Small、32.0このフォルダのChatter REST API URL。Stringurl

Repository Group Summary

グループエントリの詳細説明。




35.0Medium、35.0グループのドメイン。Stringdomain

35.0Small、35.0グループのメール。Stringemail

35.0Small、35.0グループの種別を示します。値は次のとおりです。

StringgroupType

• Everybody — グループは全員に公開されています。

• EverybodyInDomain — グループは同じドメインの全員に公開されています。

• Unknown — グループの種別が不明です。

727

Repository Group SummaryChatter REST API レスポンスボディ




35.0Small、35.0グループの ID。Stringid

35.0Medium、35.0グループの名前。Stringname

35.0Medium、35.0エントリの種別。値は GroupEntry

です。Stringtype

Repository Permission Type Collection

権限タイプのコレクション。




35.0Small、35.0権限タイプのコレクション。Files ConnectPermission Type[]

permissionTypes

Repository User Summary

ユーザエントリの詳細説明。




35.0Medium、35.0ユーザのドメイン。Stringdomain

35.0Small、35.0ユーザのメール。Stringemail

35.0Medium、35.0ユーザの名。StringfirstName

35.0Small、35.0ユーザの ID。Stringid

35.0Medium、35.0ユーザの姓。StringlastName

35.0Medium、35.0エントリの種別。値は UserEntry

です。Stringtype

評価

ユーザの評価。

728

Repository Permission Type CollectionChatter REST API レスポンスボディ




32.0Small、32.0ユーザの評価レベル。Reputation LevelreputationLevel

32.0Small、32.0ユーザの評価ポイント。評価ポイントは、コミュニティでさまざま

DoublereputationPoints

な活動を行うことによって獲得できます。

32.0Small、32.0評価への Chatter REST API URL。Stringurl

Reputation Level

ユーザの評価レベル。




32.0Small、32.0評価レベル画像への URL。StringlevelImageUrl

32.0Small、32.0評価レベルの名前。StringlevelName

32.0Small、32.0評価レベル番号。レベルの数値ランクで、最低レベルは 1 です。管理

IntegerlevelNumber

者が、評価レベルのポイント範囲を定義します。

Request Header

HTTP 要求ヘッダー名と値のペア。




33.0Small、33.0要求ヘッダーの名前。Stringname

33.0Small、33.0要求ヘッダーの値。Stringvalue

スケジュール済みおすすめ

スケジュール済みおすすめを表します。

729

Reputation LevelChatter REST API レスポンスボディ




34.0Small、34.0スケジュールが有効になっているかどうかを示します。true の場

Booleanenabled


33.0Small、33.0スケジュール済みおすすめの 18 文字の ID。

Stringid

33.0Small、33.0このスケジュール済みおすすめの順序を決めるランク。

Integerrank

35.0Small、35.0スケジュール済みおすすめの利用者の ID。


33.0Small、33.0このスケジュール済みおすすめによってスケジュールされるおすすめ定義。

RecommendationDefinition

recommendationDefinitionRepresentation

33.0Small、33.0スケジュール済みおすすめのChatter

REST API リソースへの URL。Stringurl

Scheduled Recommendation Collection

スケジュール済みおすすめのリストを表します。




33.0Small、33.0スケジュール済みおすすめのリスト。

ScheduledRecommendation[]

scheduledRecommendations

33.0Small、33.0スケジュール済みおすすめコレクションの Chatter REST API リソースへの URL。

Stringurl

730

Scheduled Recommendation CollectionChatter REST API レスポンスボディ

Shares




24.0Small、29.0ファイルが共有されているユーザ、レコード、またはグループに関する情報を返します。値は次のいずれかになります。

共有方法によって異なる

entity

• Group

• Record Summary

• User Summary

24.0Small、29.0共有の権限レベル。値は次のとおりです。StringsharingType

• C — コラボレータ• I — 共有権限は場所によって決まりま

す。これは一般に、共有権限がファイルではなくライブラリに設定されている場合に発生します。この値は、コンテキストユーザがファイルの所有者と同じ場合にも使用されます。

• N — アクセス権限なし• V — 閲覧者

Subscription




26.0Medium、29.0コミュニティに関する情報。デフォルトのコミュニティに登録が存在するか、コミュニ

Referencecommunity

ティが無効である場合は、nullが返されます。

23.0Small、29.0登録の 18 文字の IDStringid

Small、29.0親、つまりフォロー対象のものまたは人に関する情報。有効な値は、次のとおりです。

状況によるsubject

• Group (23.0)

• Record Summary (23.0)

• Topic (29.0)

731

SharesChatter REST API レスポンスボディ




• User Summary (23.0)

23.0Small、29.0登録者、つまりこの項目をフォローしている人に関する情報。有効な値は、次のとおりです。

状況によるsubscriber

• Group

• User Summary

23.0Small、29.0この特定の登録への相対 URLStringurl

Subscription Page




23.0Medium、29.0登録の現在のページを返します。StringcurrentPageUrl

23.0Small、29.0登録の次のページを返します。次のページがない場合、文字列 "null" を返します。

StringnextPageUrl

23.0Medium、29.0登録に関する情報を返します。コンテキストユーザが登録されていない場合は nullを返します。


23.0Medium、29.0登録の前のページを返します。前のページがない場合、文字列 "null" を返します。


23.0Small、29.0登録のコレクションSubscription[]subscriptions

23.0Small、29.0登録の合計数Integertotal

Time Zone

Salesforceのユーザの個人設定で選択されたユーザのタイムゾーン。この値には、デバイスの現在位置は反映されません。




30.0Small、30.0GMT との符号付き時差DoublegmtOffset

732

Subscription PageChatter REST API レスポンスボディ




30.0Small、30.0このタイムゾーンの表示名Stringname

Topic




28.0Big、29.0ISO8601 の日付文字列 (例:2011-02-25T18:24:31.000Z)

StringcreatedDate

28.0Big、29.0トピックの説明Stringdescription

28.0Small、29.0トピックの 18 文字の IDStringid

32.0Medium、32.0トピックに関連付けられた画像Topic Imagesimages

33.0Small、33.0トピックを現在削除中の場合は true、それ以外の場合は false。トピックが削除された後、トピックを取得しようとすると、応答は404: Not Foundになります。

BooleanisBeingDeleted

24.0Small、29.0トピックの名前Stringname

28.0Medium、29.0トピックの追加やトピックを含む投稿に対するコメントなどの要素に基づいた、過去 2 か月間にこのトピックに言及したユーザの数

IntegertalkingAbout

29.0Small、29.0トピックの詳細ページの URLStringurl

Topic Collection




29.0Medium、32.0

Small、29.0

～ 31.0

トピックの現在のページを返します。StringcurrentPageUrl

733

TopicChatter REST API レスポンスボディ




29.0Small、29.0トピックの次のページを返します。次のページがない場合、文字列 "null" を返します。

StringnextPageUrl

24.0Small、29.0トピックのコレクションTopic[]topics

Topic Endorsement

1 つのトピックについて他のユーザを支持する 1 人のユーザを表します。




30.0Small、30.0支持されているユーザUser Summaryendorsee

30.0Small、30.0支持レコードの IDStringendorsementId

30.0Small、30.0支持しているユーザUser Summaryendorser

30.0Small、30.0ユーザが支持されているトピックTopictopic

30.0Small、30.0支持レコードの Chatter REST API リソース URLStringurl

Topic Endorsement Collection

Topic Endorsement レスポンスボディのコレクション。





30.0Small、30.0Topic Endorsement レスポンスボディのコレクション

Topic Endorsement[]topicEndorsements


StringnextPageUrl


734

Topic EndorsementChatter REST API レスポンスボディ






Topic Images

トピックに関連付けられた画像。




32.0Small、32.0トピックページに表示される、トピックの表紙画像への URL。トピッ

StringcoverImageUrl

クと管理トピックの両方に、表紙画像を設定できます。

32.0Small、32.0管理トピックの主要画像への URL。主要画像は、指定した場所であれ

StringfeaturedImageUrl

ば、どこにでも表示されます (コミュニティホームページなど)。

Topic Opt Out

トピックからの「除外」。ユーザがトピックに関して知識があると識別されることを望まないことを示します。




30.0Small、30.0Topic Opt Out レコードの IDStringid

30.0Small、30.0トピックからユーザを除外する理由。有効な値は topicInfluenceHide のみです。

Stringreason

30.0Small、30.0ユーザが除外されるトピックTopictopic

30.0Small、30.0Topic Opt Out の Chatter REST API リソース URLStringurl

30.0Small、30.0トピックから除外するユーザUser Summaryuser

735

Topic ImagesChatter REST API レスポンスボディ

Topic Opt Out Collection

Topic Opt Out レスポンスボディのコレクション。





30.0Small、30.0Topic Opt Out レスポンスボディのコレクション。

Topic Opt Out[]topicOptOuts

Topic Suggestion




28.0Small、29.0すでに存在するトピック、または新規トピックの場合は null

TopicexistingTopic

28.0Small、29.0トピックの名前Stringname

Topic Suggestion Collection




28.0Small、29.0Topic Suggestion レスポンスボディのコレクション

Topic Suggestion[]topicSuggestions

Topics Capability

フィード要素にこの機能がある場合、コンテキストユーザはトピックを追加できます。トピックは、ユーザが会話を整理して検索するために役立ちます。

736

Topic Opt Out CollectionChatter REST API レスポンスボディ




32.0Small、32.0トピックをフィード要素に割り当て可能な場合は true、それ以外の場合は false。

BooleancanAssignTopics

32.0Small、32.0このフィード要素に関連付けられたトピックのコレクション。

Topic[]items

Topics People Are Knowledgeable About

指定されたユーザが知識のあるトピックを表します。




30.0Small、30.0コンテキストユーザが、トピックについてこの知識のあるユーザを支持している場合は

BooleanisEndorsedByMe

true、それ以外の場合は falseを指定します。

30.0Small、30.0知識のあるレコードの IDStringknowledgeableId

30.0Medium、30.0トピックについて知識のあるユーザが受け取った支持の数

IntegernumEndorsements

30.0Medium、30.0ユーザがトピックに関する知識があるとみなされる理由を指定します。有効な値は、次のとおりです。

Stringreasons

• Influential — ユーザは、トピックを含む投稿か投稿へのコメントでメンションされたか、トピックを含む投稿へのコメントでいいね! を受信しました。

• Endorsed — ユーザは、トピックについて別のユーザから支持を受け取りました。

30.0Small、30.0ユーザが知識のあるトピック。Topictopic

Topics People Are Knowledgeable About Collection

Topics People Are Knowledgeable About レスポンスボディのコレクション。

737

Topics People Are Knowledgeable AboutChatter REST API レスポンスボディ





30.0Small、30.0Topics People Are Knowledgeable About レスポンスボディのコレクション。

Topics People AreKnowledgeableAbout[]

knowledgeableAboutTopic


StringnextPageUrl




Tracked Change Bundle Capability

フィード要素にこの機能がある場合、バンドルと呼ばれる 1 つのフィード要素に集約された他のフィード要素のグループがあります。この種別のバンドルは、フィード追跡変更を集約します。





31.0Small、31.0フィード追跡変更のコレクション。

Feed TrackedChange[]

changes

31.0Small、31.0バンドルの種別を指定します。値は TrackedChanges です。

StringbundleType

31.0Small、31.0フィード要素のコレクション。Feed Element Pagepage

31.0Small、31.0このバンドルで集約するフィード要素の合計数。

IntegertotalElements

Tracked Changes Capability

フィード要素にこの機能がある場合、1 つの変更追跡イベントについて、レコードへのすべての変更が含まれます。

738

Tracked Change Bundle CapabilityChatter REST API レスポンスボディ




32.0Small、32.0フィード追跡変更のコレクション。Feed TrackedChange[]

changes

Unauthenticated User




24.0Small、29.0ソースメールの [差出人] 項目の名前か、ソースメールのメールアドレス

Stringname

24.0Small、29.0UnauthenticatedUserStringtype

User Capabilities




29.0Small、29.0コンテキストユーザが件名ユーザと共にChatter Messenger を使用できるか (true)、否か (false) を示します。

BooleancanChat

29.0Small、29.0コンテキストユーザが件名ユーザに直接メッセージを送信できるか (true)、否か (false)

を示します。

BooleancanDirectMessage

29.0Small、29.0コンテキストユーザが件名ユーザの取引先を編集できるか (true)、否か (false) を示します。

BooleancanEdit

29.0Small、29.0コンテキストユーザが件名ユーザのフィードをフォローできるか (true)、否か (false) を示します。

BooleancanFollow

29.0Small、29.0コンテキストユーザが件名ユーザのフィードを表示できるか (true)、否か (false) を示します。

BooleancanViewFeed

29.0Small、29.0コンテキストユーザが件名ユーザの完全なプロファイルを表示できるか (true)、または制

BooleancanViewFullProfile

739

Unauthenticated UserChatter REST API レスポンスボディ




限されたプロファイルのみを表示できるか(false) を示します。

29.0Small、29.0件名ユーザが Chatter モデレータまたは管理者か (true)、否か (false) を示します。

BooleanisModerator

User Chatter Settings

ユーザのグローバル Chatter 設定。




27.0Small、29.0ユーザが参加するグループからメールを受信するデフォルトの頻度。値は次のとおりです。


• EachPost

• DailyDigest

• WeeklyDigest

• Never

コミュニティでは、グループメンバーが10,000 人を超えると [各投稿のメール] オプションが無効になります。このオプションを選択したすべてのメンバーは、自動的に [毎日のダイジェスト] に切り替わります。

User Detail

コンテキストユーザにプロパティを表示する権限がない場合、プロパティは null に設定されます。




23.0Big、29.0ユーザのプロファイルから取得したテキストStringaboutMe



740

User Chatter SettingsChatter REST API レスポンスボディ





23.0Big、29.0住所Addressaddress

23.0Big、29.0Chatter 活動統計Chatter ActivitychatterActivity

23.0Big、29.0ユーザの影響度ランクChatter InfluencechatterInfluence


23.0Small、29.0会社名StringcompanyName

23.0 ～ 25.0User StatuscurrentStatusメモ: このプロパティは、バージョン25.0 以降、使用できなくなります。

ユーザの現在の状況32.0Small、32.0コミュニティで表示されるユーザの名前。

ニックネームが有効な場合は、ニックネームStringdisplayName


23.0Medium、29.0ユーザのメールアドレスStringemail


23.0Big、29.0このユーザをフォローしているユーザの数IntegerfollowersCount

23.0Big、29.0ユーザがフォローしている項目に関する情報Following CountsfollowingCounts

23.0Big、29.0ユーザがフォローしているグループの数IntegergroupCount

31.0Small、31.0ユーザに Chatter へのアクセス権がある場合は true、それ以外の場合は false

BooleanhasChatter

23.0Small、29.0ユーザの 18 文字の IDStringid

23.0Small、29.0ユーザが有効な場合は true、それ以外の場合は false

BooleanisActive

23.0 ～ 25.0BooleanisChatterGuestメモ: このプロパティは、バージョン26.0 以降、使用できなくなります。代わりに、userType プロパティを使用してください。


741

User DetailChatter REST API レスポンスボディ








23.0Big、29.0ユーザのマネージャの 18 文字の IDStringmanagerId

23.0Big、29.0ロケールに基づいて連結されたマネージャの姓と名

StringmanagerName


Motifmotif




23.0Small、29.0ロケールに基づいて連結されたユーザの姓と名

Stringname

23.0Big、29.0ユーザの電話番号のコレクションPhone Number[]phoneNumbers



評価reputation

29.0Big、29.0ユーザが受け取った感謝の数。IntegerthanksReceived




24.0Small、29.0ユーザのユーザ名 ([email protected]

など)

Stringusername

742

User DetailChatter REST API レスポンスボディ





StringuserType






関連トピック:

User Summary

User Group Page

ユーザがメンバーであるグループのページ設定されたコレクション。





23.0Small、29.0ユーザのグループのコレクションGroup[]groups

23.0Small、29.0次のページへの URL。次のページがない場合は文字列 "null" を返します。

StringnextPageUrl

23.0Medium、29.0前のページへの URL。前のページがない場合は文字列 "null" を返します。


23.0Small、29.0ユーザがメンバーであるグループの総数。この数値は、要求が検索で応答に総数のサブセットが含まれる場合でも、常にユーザがメンバーであるグループの総数です。

Integertotal

743

User Group PageChatter REST API レスポンスボディ

User Page





23.0Small、29.0次のページへの URL。次のページがない場合は null を返します。

StringnextPageUrl

23.0Medium、29.0前のページへの URL。前のページがない場合は null を返します。


24.0Small、29.0ユーザ詳細情報のコレクション。User Detail[]users

User Profile




29.0Medium、29.0件名ユーザのプロファイルに固有のコンテキストユーザの機能

User Capabilitiescapabilities

29.0Small、29.0プロファイルに添付されるユーザの IDStringid

29.0Big、29.0そのユーザ種別でコンテキストユーザに表示されるタブ

User Profile Tab[]tabs

29.0Small、29.0ユーザのプロファイルの URLStringurl

29.0Small、29.0プロファイルに添付されるユーザに関する詳細情報

User DetailuserDetail

User Profile Tab




29.0Small、29.0タブの一意の識別子 (18 文字の ID)Stringid

29.0Small、29.0ユーザプロファイルをクリックしたときにタブが最初に表示されるか (true)、否か(false) を示します。

BooleanisDefault

744

User PageChatter REST API レスポンスボディ




29.0Small、29.0ユーザプロファイルタブの種別を示します。StringtabType

• CustomVisualForce — Visualforceページからのデータを表示するタブ。

• CustomWeb — 外部の Web ベースのアプリケーションまたは Web ページからのデータを表示するタブ。

• Element — 汎用コンテンツをインラインで表示するタブ。

• Feed — Chatterフィードを表示するタブ。• Overview — ユーザの詳細を表示するタ

ブ。

29.0Small、29.0現在のタブのコンテンツ URL (組み込み以外のタブの種類の場合)

StringtabUrl

User Reference Collection

ユーザ参照のコレクション。




35.0Small、35.0現在のページへの URL。StringcurrentPageUrl

35.0Small、35.0次のページへの URL。StringnextPageUrl

35.0Small、35.0前のページへの URL。StringpreviousPageUrl

35.0Small、35.0コレクション内のユーザ数。IntegeruserCount

35.0Small、35.0ユーザ参照のコレクション。Reference[]users

User Settings

ユーザ固有の設定。

745

User Reference CollectionChatter REST API レスポンスボディ




27.0Small、29.0ユーザは、Chatter投稿からワークフローを承認できるかどうか。

BooleanapprovalPosts

24.0Small、29.0コンテキストユーザにフォローが許可されているかどうか。

BooleancanFollow

24.0Small、29.0ユーザに「すべてのデータの編集」権限があるかどうか。

BooleancanModifyAllData

24.0Small、29.0ユーザはグループを所有できるかどうか。BooleancanOwnGroups

24.0Small、29.0ユーザに「すべてのデータの参照」権限があるかどうか。

BooleancanViewAllData

24.0Small、29.0ユーザに「すべてのグループの参照」権限があるかどうか。

BooleancanViewAllGroups

24.0Small、29.0ユーザに「すべてのユーザの参照」権限があるかどうか。

BooleancanViewAllUsers

34.0Small、34.0ユーザにコミュニティ切り替えメニューが表示されるかどうか。

BooleancanViewCommunitySwitcher

24.0Small、29.0ユーザが他のユーザの Chatter プロファイルを表示できるかどうか。

BooleancanViewFullUserProfile

24.0Small、29.0ユーザが公開とマークされたすべてのファイルを表示できるかどうか。

BooleancanViewPublicFiles

28.0Small、29.0通貨の値を表示するために使用する通貨記号。Features レスポンスボディの

StringcurrencySymbol

multiCurrency プロパティが false の場合のみ該当します。

24.0Small、29.0ユーザが Chatter 顧客であるかどうか。BooleanexternalUser

32.0Small、32.0ユーザが同期できるファイルの最大数。IntegerfileSyncLimit

29.0Small、29.0同期済みファイルのための最大ストレージ(MB)

IntegerfileSyncStorageLimit

32.0Small、32.0ユーザが同期できるフォルダの最大数。IntegerfolderSyncLimit

26.0Small、29.0ユーザが、社内組織のメンバーであるかどうか。

BooleanhasAccessToInternalOrg

31.0Small、31.0ユーザには Chatter へのアクセス権があります。

BooleanhasChatter

746

User SettingsChatter REST API レスポンスボディ




26.0Small、29.0ユーザに「ファイルを同期」権限があるかどうか。

BooleanhasFileSync

34.0Small、34.0ユーザの組織のシステム管理者が File Sync クライアントの自動更新を許可するかどうか。

BooleanhasFileSyncManagedClientAutoUpdate

29.0Small、29.0ユーザに REST API へのアクセス権があるかどうか。

BooleanhasRestDataApiAccess

30.0Small、30.0Salesforce のユーザの個人設定で選択されたユーザのタイムゾーン。この値には、デバイスの現在位置は反映されません。

Time ZonetimeZone

28.0Small、29.0デフォルト通貨の ISO コード。Features レスポンスボディの multiCurrency プロパティが true の場合のみ該当します。

StringuserDefaultCurrencyIsoCode

24.0Small、29.0ユーザの 18 文字の IDStringuserId

24.0Small、29.0ユーザのロケールStringuserLocale

User Status




23.0 ～ 25.0Small、29.0投稿の本文Feed Item Body[]body

23.0 ～ 25.0Small、29.018 文字の IDStringparentId

23.0 ～ 25.0Small、29.0このユーザ状況の投稿の URLStringurl

User Summary

User Summary レスポンスボディは、User Detail レスポンスボディのサブセットです。






747

User StatusChatter REST API レスポンスボディ






23.0Small、29.0会社の名前StringcompanyName

32.0Small、32.0コミュニティで表示されるユーザの名前。ニックネームが有効な場合は、ニックネーム

StringdisplayName



23.0Small、29.018 文字の IDStringid

25.0Small、29.0ユーザが有効な場合は true、それ以外の場合は false。

BooleanisActive

23.0 ～ 26.0BooleanisChatterGuest メモ: このプロパティは、バージョン

26.0 以降、使用できなくなります。代わりに、userType プロパティを使用してください。







Motifmotif




748

User SummaryChatter REST API レスポンスボディ




23.0Small、29.0ロケールに基づいて連結された姓と名Stringname



評価reputation





StringuserType






例:

メモ: ユーザの名前が Chatter Expert で、戻り値のほとんどが null 値の場合、Chatter Expert ユーザが管理者によって無効化または引き継ぎされたか、あるいは、Salesforceに Chatter Expert ユーザが導入される前に組織が作成されたことを示します。Chatter Expert は、Chatterの使用を開始するユーザに、ヒント、使用方法、およびサンプル投稿を提供する特殊なユーザです。

関連トピック:

User Detail

749

User SummaryChatter REST API レスポンスボディ

Zone

Chatter アンサーのゾーン。




29.0Big、29.0ゾーンの説明Stringdescription

29.0Small、29.0ゾーン IDStringid

29.0Small、29.0ゾーンが有効であることを示します。BooleanisActive

29.0Small、29.0ゾーンが Chatter アンサーで使用できることを示します。

BooleanisChatterAnswers

29.0Small、29.0ゾーンの名前Stringname

30.0Small、30.0ゾーンの Chatter REST API リソース URLStringurl

29.0Small、29.0ゾーンの表示種別。次のいずれかの値にします。

Stringvisibility

• Community — コミュニティで使用できます。

• Internal — 内部でのみ使用できます。• Portal — ポータルで使用できます。

29.0Small、29.0ゾーンがポータルまたはコミュニティで使用できる場合、このプロパティにはそのポータ

StringvisibilityId

ルまたはコミュニティの ID が含まれます。ゾーンがすべてのポータルで使用できる場合、このプロパティには All の値が含まれます。

Zone Page

Chatter アンサーのゾーンのページ。




29.0Small、29.01 つ以上のゾーンのコレクションZone[]zones


750

ZoneChatter REST API レスポンスボディ





StringnextPageUrl


Zone Search Page

Chatter アンサーのゾーン内の検索結果のページ。




29.0Medium、29.0現在のページを識別するトークン。StringcurrentPageToken


29.0Small、29.0検索結果のコレクションZone Search Result[]items

29.0Small、29.0次のページを識別するトークン。次のページがない場合は null。

StringcurrentPageToken


StringnextPageUrl


Zone Search Result

Chatter アンサーのゾーン内の検索結果。




29.0Small、29.0検索結果に最良の回答が含まれているかどうかを示します。

BooleanhasBestAnswer

751

Zone Search PageChatter REST API レスポンスボディ




29.0Small、29.0検索結果の ID。検索結果は、質問または記事になります。

Stringid

29.0Small、29.0検索結果のタイトルStringtitle

29.0Small、29.0検索結果の種別。次のいずれかの値にします。

Stringtype

• Article — 検索結果には記事のみが含まれます。

• Question — 検索結果には質問のみが含まれます。

29.0Small、29.0検索結果への投票数StringvoteCount

752

Zone Search ResultChatter REST API レスポンスボディ

第 8 章 Chatter REST API の付録この章には、付録資料があります。


アクションリンクの表示ラベルアクションリンクボタンには次の表示ラベルを使用します。

アクションリンクの表示ラベル

アクションリンクボタンには次の表示ラベルを使用します。アクションリンクは、フィード要素上のボタンです。アクションリンクをクリックすると、ユーザを特定のWeb ページに移動したり、ファイルダウンロードを開始したり、Salesforce または外部サーバへの API コールを呼び出したりできます。アクションリンクには、URL と HTTP メソッドが含まれ、リクエストボディとヘッダー情報 (認証用の OAuth トークンなど) を含めることができます。アクションリンクを使用して Salesforce およびサードパーティサービスをフィードに統合することで、ユーザはアクションを実行して生産性を高め、イノベーションを促進できます。Action Link Definition Input リクエストボディの labelKey プロパティでキーを指定します。アクションリンクが表示されるときに UI には、[新規]、[待機中]、[成功]、[失敗] 状態の表示ラベルが必要に応じて使用されます。

ヒント: アクションリンクに適した定義済み表示ラベルがない場合は、カスタム表示ラベルを使用します。カスタム表示ラベルを使用するには、アクションリンクテンプレートを作成し、テンプレートで表示ラベルを定義します。「アクションリンクテンプレート」を参照してください。

失敗成功待機中新規キー

Acceptance FailedAcceptedAcceptance PendingAcceptAccept

Activation FailedActivatedActivation PendingActivateActivate

Add FailedAddedAdd PendingAddAdd

Add to Calendar FailedAdded to CalendarAdd to Calendar PendingAdd to CalendarAdd to Calendar

Add FailedAddedAdd PendingAdd to CartAdd to Cart

Agree FailedAgreeAgree PendingAgreeAgree

Alert FailedAlertedAlert PendingAlertAlert

Answer FailedAnsweredAnswer PendingAnswerAnswer

753


Approval FailedApprovedApproval PendingApproveApprove

Assign FailedAssignedAssign PendingAssignAssign

Assistance FailedAssistedAssistance PendingAssistAssist

Attach FailedAttachedAttach PendingAttachAttach

Authorization FailedAuthorizedAuthorization PendingAuthorizeAuthorize

Begin FailedStartedBegin PendingBeginBegin

Book FailedBookedBook PendingBookBook

Buy FailedBoughtBuy PendingBuyBuy

Call FailedCalledCall PendingCallCall

Call FailedCall SucceededCall PendingCall MeCall Me

Certification FailedCertifiedCertifcation PendingCertifyCertify

Change FailedChangedChange PendingChangeChange

Chat FailedChat CompletedChat PendingChatChat

Check FailedCheckedCheck PendingCheckCheck

Clear FailedClearClear PendingClearClear

Clone FailedClonedClone PendingCloneClone

Close FailedClosedClose PendingCloseClose

Confirmation FailedConfirmedConfirmation PendingConfirmConfirm

Convert FailedConvertedConvert PendingConvertConvert

Lead Conversion FailedLead ConvertedLead Conversion PendingConvert a LeadConvert a Lead

Create FailedCreatedCreate PendingCreateCreate

Deactivation FailedDeactivatedDeactivation PendingDeactivateDeactivate

Decline FailedDeclinedDecline PendingDeclineDecline

Delete FailedDeletedDelete PendingDeleteDelete

Denial FailedDeniedDenial PendingDenyDeny

Detach FailedDetachedDetach PendingDetachDetach

Disagree FailedDisagreeDisagree PendingDisagreeDisagree

Dislike FailedDislikedDislike PendingDislikeDislike

Dismissal FailedDismissedDismissal PendingDismissDismiss

Do Response FailedDoDo Response PendingDoDo

754

アクションリンクの表示ラベルChatter REST API の付録


Donation FailedDonatedDonation PendingDonateDonate

Down Response FailedDownDown Response PendingDownDown

Download FailedDownloadedDownload PendingDownloadDownload

Edit FailedEditedEdit PendingEditEdit

End FailedEndedEnd PendingEndEnd

Endorsement FailedEndorsedEndorsement PendingEndorseEndorse

Enter FailedEnteredEnter PendingEnterEnter

Escalation FailedEscalatedEscalation PendingEscalateEscalate

Estimate FailedEstimateEstimate PendingEstimateEstimate

Exclude FailedExcludedExclude PendingExcludeExclude

Exit FailedExitedExit PendingExitExit

Export FailedExportedExport PendingExportExport

File FailedFiledFile PendingFileFile

Fill FailedFilledFill PendingFillFill

Finish FailedFinishedFinish PendingFinishFinish

Flag FailedFlaggedFlag PendingFlagFlag

Flip FailedFlippedFlip PendingFlipFlip

Follow FailedFollowedFollow PendingFollowFollow

Generate FailedGeneratedGenerate PendingGenerateGenerate

Give FailedGivenGive PendingGiveGive

Help FailedHelpedHelp PendingHelpHelp

Hide FailedHiddenHide PendingHideHide

High Response FailedHighHigh Response PendingHighHigh

Hold FailedHold SucceededHold PendingHoldHold

Import FailedImportedImport PendingImportImport

Include FailedIncludedInclude PendingIncludeInclude

Join FailedJoinedJoin PendingJoinJoin

Launch FailedLaunchedLaunch PendingLaunchLaunch

Leave FailedLeftLeave PendingLeaveLeave

Like FailedLikedLike PendingLikeLike

755



List FailedListedList PendingListList

Log FailedLoggedLog PendingLogLog

Log a Call FailedLogged a CallLog a Call PendingLog a CallLog a Call

Low Response FailedLowLow Response PendingLowLow

Mark FailedMarkedMark PendingMarkMark

Maybe Response FailedMaybeMaybe Response PendingMaybeMaybe

Medium Response FailedMediumMedium ResponsePending

MediumMedium

Meet FailedMeetMeet PendingMeetMeet

Message FailedMessageMessage PendingMessageMessage

Move FailedMovedMove PendingMoveMove

Negative Response FailedNegativeNegative ResponsePending

NegativeNegative

New FailedNewNew PendingNewNew

No Response FailedNoNo Response PendingNoNo

OK Response FailedOKOK Response PendingOKOK

Open FailedOpenedOpen PendingOpenOpen

Order FailedOrderedOrder PendingOrderOrder

Positive Response FailedPositivePositive ResponsePending

PositivePositive

Post FailedPostedPost PendingPostPost

Post FailedPostedPost PendingPost ReviewPost Review

Process FailedProcessedProcess PendingProcessProcess

Provide FailedProvidedProvide PendingProvideProvide

Purchase FailedPurchasedPurchase PendingPurchasePurchase

Quote FailedQuotedQuote PendingQuoteQuote

Receive FailedReceivedReceive PendingReceiveReceive

Recommend FailedRecommendedRecommend PendingRecommendRecommend

Redo Response FailedRedoRedo Response PendingRedoRedo

Refresh FailedRefreshedRefresh PendingRefreshRefresh

Rejection FailedRejectedRejection PendingRejectReject

756



Release FailedReleasedRelease PendingReleaseRelease

Reminder FailedRemindedReminder PendingRemindRemind

Removal FailedRemovedRemoval PendingRemoveRemove

Repeat FailedRepeatedRepeat PendingRepeatRepeat

Report FailedReportedReport PendingReportReport

Request FailedRequestedRequest PendingRequestRequest

Reservation FailedReservedReservation PendingReserveReserve

Resolve FailedResolvedResolve PendingResolveResolve

Response FailedRespondedResponse PendingRespondRespond

Restore FailedRestoredRestore PendingRestoreRestore

Review FailedReviewedReview PendingReviewReview

Revision FailedRevisedRevision PendingReviseRevise

Save FailedSavedSave PendingSaveSave

Schedule FailedScheduledSchedule PendingScheduleSchedule

Sell FailedSoldSell PendingSellSell

Send FailedSentSend PendingSendSend

Send Email FailedEmail SentSend Email PendingSend EmailSend Email

Share FailedSharedShare PendingShareShare

Shipment FailedShippedShipment PendingShipShip

Show FailedShownShow PendingShowShow

Start FailedStartedStart PendingStartStart

Stop FailedStoppedStop PendingStopStop

Submit FailedSubmittedSubmit PendingSubmitSubmit

Subscribe FailedSubscribedSubscribe PendingSubscribeSubscribe

Test FailedTestedTest PendingTestTest

Thanks FailedThankedThanks PendingThankThank

Unauthorization FailedUnauthorizedUnauthorization PendingUnauthorizeUnauthorize

Uncheck FailedUncheckedUncheck PendingUncheckUncheck

Undo Response FailedUndoUndo Response PendingUndoUndo

Unflag FailedUnflaggedUnflag PendingUnflagUnflag

757



Unfollow FailedUnfollowedUnfollow PendingUnfollowUnfollow

Unlike FailedUnlikedUnlike PendingUnlikeUnlike

Unmark FailedUnmarkedUnmark PendingUnmarkUnmark

Unsubscribe FailedUnsubscribedUnsubscribe PendingUnsubscribeUnsubscribe

Up Response FailedUpUp Response PendingUpUp

Update FailedUpdatedUpdate PendingUpdateUpdate

Validate FailedValidatedValidate PendingValidateValidate

Verify FailedVerifiedVerify PendingVerifyVerify

View FailedViewedView PendingViewView

Visit FailedVisit SuccessfulVisit PendingVisitVisit

Yes Response FailedYesYes Response PendingYesYes

758


chatter rest api...

Documents