リモートコールイン

• アクセス性 — Salesforce が提供する SOAP API を使用してリモートシステムは以下の操作を実行できます。
  • イベントを公開して Salesforce 組織に通知
  • 組織内のデータのクエリ
  • データの追加、更新、削除
  • 組織のメタデータの取得
  • 管理タスク実行のためのユーティリティの実行
• 同期 API — API コールが行われた後、リモートクライアントアプリケーションはサービスから応答を受信するまで待機します。Salesforce への非同期コールはサポートされていません。
• 生成された WSDL — Salesforce では、リモートシステムに 2 つの WSDL を使用できます。
  • Enterprise WSDL — Salesforce 組織に固有の強く型付けされた WSDL を使用できます。
  • Partner WSDL — Salesforce 組織に固有ではない、緩やかに型付けされた WSDL を使用できます。
• セキュリティ — SOAP API を実行するクライアントは、有効なログイン情報を持ち、API コールを実行するためのセッションを取得する必要があります。API は、ログインユーザのプロファイルに基づいて Salesforce に設定されたオブジェクトレベルおよび項目レベルのセキュリティを反映します。
• トランザクション/コミット動作 — デフォルトでは、各 API コールは、一部のレコードがエラーとマークされた場合に部分的な成功を許容します。これを「オールオアナッシング」動作に変更して、エラーが発生したらすべての結果をロールバックすることができます。複数の API コールにまたがってトランザクションを実行することはできません。この制限を打開するために、1 つの API で複数のオブジェクトに影響を与えることができます。
• 大量データ — 大量データ (5,000 件を超えるレコード) 操作の場合、REST ベースの Bulk API を使用します。
• イベント駆動型アーキテクチャ — プラットフォームイベントは、Salesforce オブジェクトの定義と同じ方法で定義されます。SOAP API を介したイベントの公開は、Salesforce レコードの作成と同じです。作成と挿入操作のみがサポートされています。

• アクセス性 — Salesforce が提供する REST API を使用してリモートシステムは以下の操作を実行できます。
  • イベントを公開して Salesforce 組織に通知
  • 組織内のデータのクエリ
  • データの追加、更新、削除
  • 組織のメタデータの取得
  • 管理タスク実行のためのユーティリティの実行
• 同期 API — API コールが行われた後、リモートクライアントアプリケーションはサービスから応答を受信するまで待機します。Salesforce への非同期コールはサポートされていません。
• REST API と SOAP API の比較 — REST はリソース (エンティティ/オブジェクト) を URI として公開し、HTTP 動詞を使用してこれらのリソースに対する CRUD 操作を定義します。SOAP とは異なり、REST API では、事前定義した契約は不要で、応答には XML と JSON を利用し、緩やかな型付けを使用します。REST API は軽量であり、Salesforce との相互作用のための単純な方法を提供します。インテグレーションおよび開発が容易という利点があり、モバイルアプリケーションおよび Web アプリケーションで使用するためには最適な選択です。
• セキュリティ — REST API を実行するクライアントは、有効なログイン情報を持ち、API コールを実行するためのセッションを取得する必要があります。API は、ログインユーザのプロファイルに基づいて Salesforce に設定されたオブジェクトレベルおよび項目レベルのセキュリティを反映します。
• トランザクション/コミット動作 — デフォルトでは、各レコードは、個別のトランザクションとして扱われ、個別にコミットされます。1 つのレコード変更が失敗しても、他のレコード変更はロールバックされません。この動作を「オールオアナッシング」動作に変更できます。1 回の API コールで一連の更新を実行するには、REST API 複合リソースを使用します。
• REST 複合リソース — 1 回の API コールで複数の操作を実行するには、これらの REST API リソースを使用します。1 回のコールの出力を、次のコールの入力として使用することもできます。要求のすべてのレスポンスボディと HTTP 状況は、1 つのレスポンスボディで返されます。要求全体が API の制限への単一のコールとしてカウントされます。
• 大量データ — 大量データ (500,000 件を超えるレコード) 操作の場合、REST ベースの Bulk API を使用します。
• イベント駆動型アーキテクチャ — プラットフォームイベントは、Salesforce オブジェクトの定義と同じ方法で定義されます。REST API を介したイベントの公開は、Salesforce レコードの作成と同じです。作成と挿入操作のみがサポートされています。

• 完全なトランザクションサポートが必要である (たとえば、取引先、取引先責任者、および商談をすべて 1 つのトランザクションで作成する場合��ど)。
• コミットする前に、カスタムロジックを Salesforce 側で適用する必要がある。

Apex Web サービスを使用する利点と、Salesforce でメンテナンスが必要な追加コードを比較して評価する必要があります。

コンシューマでのトランザクション事前挿入ロジックはイベント駆動型アーキテクチャには適用されないため、プラットフォームイベントには適用されません。イベントが発生したことを Salesforce 組織に通知するには、SOAP API、REST API、または Bulk API を使用します。

REST API 複合リソースを使用して、1 回のトランザクションで複数の更新を実行できます。

SOAP とは異なり、クライアントがサービス定義/契約 (WSDL) を使用してクライアントスタブを生成する必要はありません。リモートシステムには、HTTP 要求を作成して、返された結果 (XML または JSON) を処理する機能のみが必要です。

コンシューマでのトランザクション事前挿入ロジックはイベント駆動型アーキテクチャには適用されないため、プラットフォームイベントには適用されません。イベントが発生したことを Salesforce 組織に通知するには、SOAP API、REST API、または Bulk API を使用します。

Bulk API では、クライアントアプリケーションは、複数のバッチを送信し、そのバッチが Salesforce によりバックグラウンドで処理されることで、大量のレコードをクエリ、挿入、更新、更新/挿入、削除できます。対照的に、SOAP API は、一度に少数のレコードを更新するリアルタイムのクライアントアプリケーション用に最適化されています。

SOAP API を使用しても多数のレコードを処理することはできますが、数百から、数千、数百万のレコードがデータセットに含まれている場合には実用性に欠けます。これは、比較的オーバーヘッドが高く、パフォーマンスが低いという特性のためです。

• イベント駆動型アーキテクチャ — プラットフォームイベントは、Salesforce オブジェクトの定義と同じ方法で定義されます。Bulk API を介したイベントの公開は、Salesforce レコードの作成と同じです。作成と挿入操作のみがサポートされています。バッチ内のイベントは、一括処理ジョブが処理されるときに非同期で Salesforce イベントバスに公開されます。

次に、リモートシステムは、適切な動詞で REST 呼び出し (HTTP 要求) を生成し、返された結果 (JSON および XML データ形式がサポート対象) を処理します。

リモートシステムがセッション ID を取得するには、有効なログイン情報を使用してログインする必要があります。リモートシステムにすでに有効なセッション ID がある場合は、明示的なログインなしで API をコールできます。これは、このドキュメントですでに説明したコールバックパターンで使用されます。このパターンでは、先行する Salesforce アウトバウンドメッセージに含まれているセッション ID とレコード ID が後続の作業で使用されます。

クライアントは、コールごとに新しいセッション ID を取得するのではなく、SOAP API キャッシュをコールし、セッション ID を再利用してパフォーマンスを最大化することをお勧めします。

クライアントは、コールごとに新しいセッション ID を取得するのではなく、REST API キャッシュをコールし、セッション ID を再利用してパフォーマンスを最大化することをお勧めします。

• SOAP ログイン — SOAP ログイン要求のサイズは、10 KB 未満に制限されています。login() 関数に対して 1 時間につき 1 ユーザあたり最大 3,600 コールを行うことができます。この制限を超えると、API はエラーを返します。
• 作成、更新、削除 — リモートシステムが一度に作成、更新、または削除できるレコード数は最大 200 件です。複数回のコールを行えば合計 200 件を超えるレコードを処理できますが、要求ごとのサイズは 200 レコードに制限されています。
• BLOB データ — sObject Basic Information、sObject Rows、または sObject Collections REST リソースを使用して、Salesforce 標準オブジェクトの BLOB データを挿入または更新できます。sObject Basic Information または sObject Rows リソースの場合、アップロードの最大ファイルサイズは、ContentVersion オブジェクトの場合は 2 GB、使用可能な他の標準オブジェクトの場合は 500 MB です。sObject Collections リソースを使用する場合、1 回の要求の全ファイルの最大合計サイズは 500 MB です。
• クエリ結果サイズ — デフォルトでは、query() または queryMore() コールで返される、クエリ結果オブジェクト内に返される行数 (バッチサイズ) は 500 に設定されています。返される最大行数は 2,000 です。バッチサイズを明示的に設定できますが、要求したバッチサイズが実際のバッチサイズになるとは限りません。パフォーマンスを最大化するために変更が行われます。返される行数がバッチサイズを上回る場合、queryMore() API コールを使用して複数のバッチを反復処理します。追加のルールが適用される場合もあるため、詳細は、『Salesforce Developer の制限および割り当てクイックリファレンス』を参照してください。
• イベントメッセージ — イベントメッセージの最大サイズは 1 MB です。Salesforce API を使用したイベントの公開は、標準の API 制限にカウントされます。

Bulk API は、大規模なデータセットの非同期のインポートまたはエクスポート用に最適化されています。

Bulk API は、バッチ要求と関連データを送信するときは同期します。データの実際の処理は、非同期に行われます。API とバッチ処理制限の詳細は、「Bulk API の制限」を参照してください。

• 24 時間あたりに送信可能なバッチ数は最大で 10,000 件に制限されています。

• 1 つのバッチには、最大で 10,000 件のレコードを含めることができます。

• イベントメッセージ — イベントメッセージの最大サイズは 1 MB です。Salesforce API を使用したイベントの公開は、標準の API 制限にカウントされます。

• API 要求制限 – Salesforce は、24 時間あたりの API コール数に制限を適用します。制限は、Salesforce のエディションの種類とライセンス数に基づきます。たとえば、Unlimited Edition では、24 時間あたり、Salesforce または Lightning Platform ライセンスにつき、5,000 API 要求を使用できます。詳細は、『Salesforce Developer の制限および割り当てクイックリファレンス』を参照してください。
• API クエリカーソル制限 — ユーザは一度に最大 10 個のクエリカーソルを開くことができます。10 個を超えると、10 個のカーソルのうち最も古いものが解放されます。リモートアプリケーションが解放されたクエリカーソルを開こうとすると、エラーになります。たとえば、インテグレーションユーザログイン情報を共有する場合、最大クエリカーソル数を考慮する必要があります。可能な場合は、ミドルウェアで別のクエリを (順次に) 実行する前に完全なクエリを完了するか、各アプリケーションで指定されたインテグレーションユーザを使用する必要があります。または、ミドルウェアは、「ラウンドロビン」式に複数のユーザの要求を実行することが必要になる場合があります。
• コール制限 — 作成、更新、およびクエリの制限については、補足の「データ量」を参照してください。

• イベント通知の制限 — 標準プラットフォームイベントの場合、1 時間あたり最大 100,000 イベントを公開できます。大規模の使用量ベースのプラットフォームイベントの場合、1 時間あたり最大 250,000 イベントを公開できます。大規模のイベント使用状況を監視するには、REST API の limits リソースを使用します。
• イベントメッセージサイズの制限 — イベントメッセージの最大サイズは 1 MB です。Salesforce API を使用したイベントの公開は、標準の API 制限にカウントされます。