Bulk API 2.0 および Bulk API 開発者ガイド
jステップ 2: 認証
Bulk API 2.0 は、REST ベースの API で、Salesforce の他の REST API でサポートされるすべての OAuth 2.0 フローがサポートされます。Bulk API 2.0 では、認証にアクセストークン (「ベアラートークン」とも呼ばれる) が必要です。このクイックスタートの本トピック以降では、アクセストークンを取得し、それを使用して cURL で Bulk API 2.0 要求を行う手順について説明します。
独自の接続アプリケーションを作成し、それに対して認証を行うこともできますが、このクイックスタートの例では、便宜上、Salesforce CLI を使用しています。事実上、Salesforce CLI は、認証時に使用できる接続アプリケーションで、設定の作業は不要です。
このクイックスタートの例では、cURL ツールを使用して HTTP 要求を送信し、Salesforce のリソースへのアクセスや、リソースの作成および操作を行います。要求の送信に別のツールを使用している場合は、cURL の例と同じ要素を使用して要求を送信できます。これらの手順は、開発者組織を使用したシナリオを説明していますが、どの種別の Salesforce 組織でも同様に適用できます。cURL ツールは、多くの Linux システムや macOS システムにあらかじめインストールされています。Windows バージョンは、curl.se からダウンロードできます。Windows で HTTPS を使用する場合、システムが SSL の cURL 要件を満たしていることを確認してください。
Salesforce CLI でのアクセストークンの取得
Salesforce CLI から取得したアクセストークン (「ベアラートークン」とも呼ばれる) を使用して、cURL 要求を認証します。
- Salesforce CLI をインストールまたは更新します。
- Salesforce CLI がすでにインストールされている場合は、「Salesforce CLI の更新」の手順に従って更新します。
- Salesforce CLI のインストールが必要な場合は、ご使用のオペレーティングシステムに対応した最新バージョンをインストールしてください。
- インストールを確認します。
- Salesforce CLI を使用して開発者組織にログインします。ブラウザーが開き、https://login.salesforce.com のページが表示されます。
- ブラウザーで、ユーザーのログイン情報を使用して開発者組織にログインします。
- ブラウザーで [許可] をクリックして、アクセスを許可します。 コマンドラインに次のような確認メッセージが表示されます。
- コマンドラインで組織に関する認証情報を表示して、アクセストークンを取得します。次に例を示します。コマンド出力の例を次に示します。コマンド出力内にある長いアクセストークン文字列とインスタンス URL 文字列をメモします。cURL 要求を行うには、これらの両方の文字列が必要です。
Salesforce CLI のショートカット (省略可能)
認証が成功したら、今後 Salesforce CLI での認証を簡素化するために、cURL ワークフローで次のショートカット (省略可能) を試します。
私のユーザー名の別名を設定する
スクリプトでこれらのコマンドを使用する
--json フラグを呼び出して CLI の JSON 出力を使用します。JSON 出力を要求すると、出力形式の一貫性が保たれるため、スクリプトの実行に最適です。--json フラグを使用しない場合は、CLI の出力形式が変化する場合があります。
関連トピック