Force.com REST API 開発者ガイド
jリファレンス
次の表に、API でサポートされている REST リソースをリストし、それぞれのリソースについて簡単に説明します。それぞれの場合で、リソースの URI は、認証サービスから取得するベース URI (http://domain/services/data) に続きます。domain は、使用している Salesforce インスタンス、またはカスタムドメインです。たとえば、バージョン 20.0 の Account オブジェクトに関する基本情報を取得する場合、http://na1.salesforce.com/services/data/v20.0/sobjects/Account/ となります。
コール名をクリックすると、構文、使用方法、各コールの詳細情報を確認できます。
| リソース名 | URI | 説明 |
|---|---|---|
| Versions | / | バージョン、表示ラベル、および各バージョンのルートへのリンクなど、現在使用可能な各 Salesforce バージョンの概要情報をリストします。 |
| Resources by Version | /vXX.X/ | リソース名および URI を含む、指定された API バージョンで使用可能なリソースをリストします。 |
| Describe Global | /vXX.X/sobjects/ | 組織のデータで使用可能なオブジェクトとそのメタデータをリストします。 |
| sObject Basic Information | /vXX.X/sobjects/sObject/ | 指定されたオブジェクトの個別のメタデータを説明します。特定のオブジェクトの新規レコードの作成にも使用できます。 |
| sObject Describe | /vXX.X/sobjects/sObject/describe/ | 指定されたオブジェクトのすべてのレベルで、個別のメタデータを完全に説明します。 |
| sObject Get Deleted | /vXX.X/sobjects/sObject/deleted/?start=startDateAndTime&end=endDateAndTime | 指定されたオブジェクトについて、特定の期間内に削除された個々のレコードのリストを取得します。 |
| sObject Get Updated | /vXX.X/sobjects/sObject/updated/?start=startDateAndTime&end=endDateAndTime | 指定されたオブジェクトに対して指定された期間内に更新された (追加または変更された) 個別のレコードのリストを取得します。 |
| SObject Named Layouts | /vXX.X/sobjects/Object/describe/namedLayouts/layoutName | 特定のオブジェクトの代替名前付きレイアウトに関する情報を取得します。 |
| sObject Rows | /vXX.X/sobjects/SObject/id/ | 指定されたオブジェクト ID に基づいてレコードにアクセスします。レコードを取得、更新、または削除します。このリソースは、項目値の取得にも使用できます。 |
| sObject Rows by External ID | /vXX.X/sobjects/sObject/fieldName/fieldValue | 指定された外部 ID 項目の値に基づいて、新しいレコードを作成するか、既存のレコードを更新 (レコードを Upsert) します。 |
| sObject ApprovalLayouts | /vXX.X/sobjects/sObjectName/describe/approvalLayouts/ | 指定されたオブジェクトの承認レイアウトのリストを返します。 |
| sObject CompactLayouts | /vXX.X/sobjects/Object/describe/compactLayouts/ | 特定のオブジェクトのコンパクトレイアウトのリストを返します。 |
| Describe Layouts |
/vXX.X/sobjects/global/describe/layouts/ /vXX.X/sobjects/object/describe/layouts/ |
レイアウトおよび説明のリストを返します。 |
| SObject PlatformAction | /services/data/vXX.X/sobjects/PlatformAction | PlatformAction は、参照のみの仮想オブジェクトです。ユーザ、コンテキスト、デバイス形式、レコード ID に応じて、UI に表示するアクション (標準およびカスタムボタン、クイックアクション、生産性アクションなど) をクエリできるようにします。 |
| sObject Blob Retrieve | /vXX.X/sobjects/sObject/id/blobField | 個別のレコードから指定された blob 項目を取得します。 |
| sObject Quick Actions |
/vXX.X/sobjects/object/quickActions/ /vXX.X/sobjects/object/quickActions/{アクション名} /vXX.X/sobjects/object/quickActions/{アクション名}/describe/ services/data/vXX.X/sobjects/object/quickActions/{アクション名}/defaultValues/ vXX.X/sobjects/object/quickActions/{アクション名}/defaultValues/{親 ID} |
アクションとその詳細のリストを返します。 |
| sObject Suggested Articles for Case |
vXX.X/sobjects/Case/suggestedArticles?language=記事の言語&subject=ケースの件名&description=ケースの説明 vXX.X/sobjects/Case/ID/suggestedArticles?language=記事の言語 |
ケースについて提案する Salesforce ナレッジの記事のリストを返します。 |
| sObject User Password |
/vXX.X/sobjects/User/ユーザ ID/password /vXX.X/sobjects/SelfServiceUser/セルフサービスユーザ ID/password |
ユーザパスワードを設定またはリセットしたり、ユーザパスワードに関する情報を取得したりします。 |
| AppMenu |
/vXX.X/appMenu/AppSwitcher/ /vXX.X/appMenu/Salesforce1/ |
Salesforce アプリケーションドロップダウンメニューまたは Salesforce1 ナビゲーションメニューの項目のリストを返します。 |
| FlexiPage | /vXX.X/flexiPage/Lightning ページの ID | Lightning ページとその詳細のリストを返します。返される情報には、Lightning ページの範囲、各範囲内のコンポーネント、各コンポーネントのプロパティ、および関連付けられた QuickActions が含まれます。 |
| Process Approvals | /vXX.X/process/approvals/ | すべての承認プロセスのリストを返します。特定のレコードが承認プロセスをサポートしていて、承認プロセスがすでに定義されている場合、そのレコードを送信するためにも使用できます。現在のユーザが割り当てられた承認者である場合、レコードを承認および却下できます。 |
| Process Rules | /vXX.X/process/rules/ | すべての有効なワークフロールールのリストを返します。ルールにアクションがある場合、アクションがルールの下にリストされます。指定したレコードに関連付けられたワークフロールールすべてをトリガするためにも使用できます。ルールのアクションは、ルール条件に一致した場合にのみ起動されます。 |
| Query | /vXX.X/query/?q=soql | 指定された SOQL クエリを実行します。 |
| QueryAll | /vXX.X/queryAll/?q=soql | 指定された SOQL クエリを実行します。結果には削除されたレコード、マージされたレコード、およびアーカイブ済みレコードが含まれる場合があります。 |
| Quick Actions | /vXX.X/quickActions/ | グローバルクイックアクションとその種別のリスト、および Chatter フィードに表示されるカスタム項目とオブジェクトを返します。 |
| Recently Viewed Items | /vXX.X/recent | 現在のユーザが表示または参照した、最近参照された項目を取得します。 |
| Relevant Items | /vXX.X/sobjects/relevantItems | 現在のユーザの最も関連性の���い項目を取得します。関連性の高い項目には、ユーザのグローバル検索範囲のオブジェクトや、最後に使用した (MRU) オブジェクトのレコードなどがあります。 |
| Search | /vXX.X/search/?q=sosl | 検索を実行します。 |
| Search Scope and Order | /vXX.X/search/scopeOrder | ログインユーザのデフォルトのグローバル検索範囲内にあるオブジェクトの順序付きリストを返します。グローバル検索は、操作するオブジェクトとそれらを操作する頻度を追跡し、それに基づいて検索結果を編成します。最もよく使用されるオブジェクトは、リストの最上部に表示されます。 |
| Search Result Layouts | /vXX.X/searchlayout/?q=カンマで区切られたオブジェクトのリスト | クエリ文字列に含まれるオブジェクトの検索結果レイアウトに関する情報を返します。このコールでは、検索結果ページに列として表示される項目のリスト、最初のページに表示される行数、および検索結果ページで使用されるラベルがオブジェクトごとに返されます。 |
| Search Suggested Article Title Matches | /vXX.X/search/suggestTitleMatches?q=search string&language=article language&publishStatus=article publication status | タイトルがユーザの検索クエリ文字列に一致した Salesforce ナレッジ記事のリストを返します。ユーザが検索を実行する前に、関連する可能性のある記事に直接移動するためのショートカットを提供します。 |
| Search Suggested Queries | vXX.X/search/suggestSearchQueries?q=検索文字列&language=クエリの言語 | 他のユーザが Salesforce ナレッジで実行した検索に一致するユーザのクエリ文字列テキストに基づいて、提案する検索のリストを返します。ユーザが検索を実行する前に、検索の有効性を高める手段を提供します。 |
| Tabs | /vXX.X/tabs | ユーザが [すべてのタブ] ([+]) タブカスタマイズ機能を使用してタブを非表示にしているかどうかに関係なく、ログインユーザが使用できるすべてのタブ (Lightning ページタブを含む) のリストを返します。 |
| Themes | /vXX.X/theme | Salesforce アプリケーションのテーマで使用するアイコンと色のリストを取得します。 |
複合リソース
| リソース名 | URI | 説明 |
|---|---|---|
| Batch | /vXX.X/composite/batch | 1 回の要求で最大 25 個のサブ要求を実行します。 |
| SObject Tree | /vXX.X/composite/tree | 指定されたタイプのルートレコードを持つ 1 つ以上の sObject ツリーを作成します。sObject ツリーは、同じルートレコードを持つネストされた親-子レコードのコレクションです。 |