詳細情報:
API の制限とガイドライン
Marketing Cloud Engagement API を使用して、アプリケーションやその他のテクノロジーシステムを Marketing Cloud Engagement と統合します。Salesforce では、サービスを保護し、すべてのお客様が Marketing Cloud Engagement を使用できるように、API の使用に制限を設けています。
制限種別
API の制限には 2 つの種別があります。ハード制限は超えることができない制限です。多くの場合、ハード制限を超える API 要求を発行すると、API により要求は拒否され、エラーが返されます。
ソフト制限は、超えるとパフォーマンスが低下する可能性がある制限です。Salesforce は、API 要求がシステムのパフォーマンスやセキュリティの問題の原因となる場合、API 要求のレートを制限する権利を留保します。ソフト制限を超える場合、追加のライセンスまたは割り当ての購入が必要になることがあります。
一般的な API 制限
このセクションの制限は、Marketing Cloud Engagement SOAP API と REST API の両方に適用されます。
| リソース | 制限 | 制限種別 | 詳細 |
|---|---|---|---|
| 最大 API 要求数 | 制限はエディションによって異なります
|
ソフト制限 | 連絡先または API 要求の追加の割り当てを購入できます。詳細は、アカウントエグゼクティブにお問い合わせください。 |
| 1 日あたりの非同期要求の最大数 | 5,000 万要求/日 | ソフト制限 | この制限は非同期 REST API 要求および SOAP API 要求に適用されます。 |
| アクセストークン要求の最大数 | クライアントマシンあたり 20 分ごとに 1 要求 | ソフト制限 | API 要求ごとに新しいトークンを要求しないでください。代わりに、トークン要求への応答で expires_in パラメータを使用して、既存のアクセストークンが有効である期間を決定します。既存のトークンの期限が切れた場合のみ新しいトークンを要求します。 |
| 同期 API 要求の最大バッチサイズ | 50 オブジェクト | ソフト制限 | — |
| 非同期 API 要求の最大バッチサイズ | 32,000 オブジェクト | ハード制限 | — |
| 同期 API 要求の最小要求タイムアウト期間 | タイムアウト期間は API 操作の種別によって異なります。
|
ソフト制限 | API クライアントのタイムアウト値をこれらの値と一致させます。 |
| 非同期 API 要求の最小要求タイムアウト期間 | 30 秒 | ソフト制限 | API クライアントのタイムアウト値をこれらの値と一致させます。 |
Marketing Cloud Engagement REST API の制限
Marketing Cloud Engagement REST API を使用すると、コンテンツビルダーや Journey Builder など、複数のアプリケーションの機能に幅広くアクセスできます。
| リソース | 制限 | 制限種別 | 詳細 |
|---|---|---|---|
| Transactional メッセージング API 要求の最大要求率 | 静的メッセージおよびシンプルメッセージでは、1,000 要求/秒 | ソフト制限 | 静的メッセージにはコンテンツブロックやパーソナライズ要素は含まれません。 シンプルメッセージには 1 個の HTML コンテンツブロックと 1 ～ 2 個のパーソナライズ要素 (受信者の名前や注文番号など) が含まれます。 複数のコンテンツブロックと、名前と注文番号以外のパーソナライズ要素が含まれる Transactional メッセージでは、スループット率が低下します。 |
| バッチ Transactional メッセージング API 要求の最大要求率 | 250 要求/秒 | ソフト制限 | この制限では、1 要求あたり 50 受信者のバッチサイズと、静的メッセージまたはシンプルメッセージの本文を想定しています。 |
| 同期デバイス API 要求の最大要求率 | 4,000 要求/分 | ソフト制限 | — |
| 同期 API 要求の最大要求率 | 2,500 要求/分 | ソフト制限 | この制限は、デバイス API 要求を除くすべての API 要求およびアクセストークン要求に適用されます。 |
| 同時接続の最大数 | 100 接続 | ソフト制限 | — |
| 認証 API の最大要求ペイロードサイズ | 8 KB | ハード制限 | — |
| データ API の最大要求ペイロードサイズ | 5.9 MB | ハード制限 | — |
| アセット API の最大要求ペイロードサイズ | 25 MB | ハード制限 | — |
| メッセージング API の最大要求ペイロードサイズ | 16 MB | ハード制限 | — |
| オートメーション API の最大要求ペイロードサイズ | 27.9 MB | ハード制限 | — |
| 他のすべての Marketing Cloud Engagement API の最大要求ペイロードサイズ | 4 MB | ハード制限 | — |
| MobilePush 送信 API の最大バッチサイズ | 5,000 オブジェクト | ハード制限 | — |
| ENS コールバック API のバッチサイズ | 最小: 100 オブジェクト 最大: 1,000 オブジェクト |
ハード制限 | — |
Marketing Cloud Engagement SOAP API の制限
Marketing Cloud Engagement SOAP API は、Email Studio との詳細なインテグレーションを提供します。SOAP API を使用して、メールメッセージの作成と送信、メールメッセージの応答データの表示ができます。
| リソース | 制限 | 制限種別 | 詳細 |
|---|---|---|---|
| 同期 API 要求の最大要求率 | 2,500 API 要求/分 | ソフト制限 | — |
| 同時接続の最大数 | 100 接続 | ソフト制限 | — |
| 最大要求ペイロードサイズ | 28.6 MB | ハード制限 | — |
| 応答ごとに返されるレコードの最大数 | 2,500 レコード/応答 | ハード制限 | 結果に 2,500 件を超えるレコードが含まれる場合、API によりトークンが提供されます。そのトークンを後続の要求で使用して、次の 2,500 件のレコードのバッチを取得できます。 |
