ステップ 3: サンプルコードを説明する
これらの例は、コピー/貼り付けして cURL で送信できます。ただし、先にベース URI の MyDomainName を Salesforce ドメインに置き換えてください。REST 要求の仕組みの詳細は、「REST リソースと要求」を参照してください。
Salesforce バージョンを取得する
使用可能な Salesforce バージョンのそれぞれに関する情報を取得するには、Versions 要求を送信します。この場合、要求に認証は必要ありません。
この要求の出力は、応答ヘッダーを含めて、すべての有効なバージョンを指定します。結果には複数の値が含まれる場合があります。
リソースのリストを取得する
Salesforce (この例ではバージョン 59.0) で使用可能なリソースのリストを取得するには、Resources by Version 要求を送信します。
この要求の出力は、sobjects が、Salesforce バージョン 59.0 で使用可能なリソースの 1 つであることを示します。
使用可能なオブジェクトのリストを取得する
使用可能なオブジェクトのリストを要求するには、Describe Global 要求を送信します。
この要求の出力は、Account オブジェクトが使用可能であることを示します。
オブジェクトの基本情報を取得する
使用可能な Account オブジェクトのメタデータの基本情報を取得するには、sObject Basic Information 要求を送信します。
この要求の出力は、名前や表示ラベルなどの Account オブジェクトの基本属性と、最近使用された取引先のリストを示します。
項目のリストを取得する
詳細情報を取得するには、sObject Describe 要求を送信します。
この要求の出力は、その項目の属性や子リレーションなど、Account オブジェクトのさらに詳細な情報を示します。
SOQL クエリを実行する
Account の name のすべての値を取得する SOQL クエリを実行するには、Query 要求を送信します。
出力で、使用可能な取引先名がリストされます。それぞれの名前の前にある属性には取引先の ID が含まれます。
レコードの項目を更新する
取引先の 1 つを取得し、市区郡 (請求先) を更新するには、sObject Rows 要求を送信します。オブジェクトを更新するには、新しい市区郡 (請求先) の情報を含む patchaccount.json というテキスト���ァイルを作成します。
REST 要求に、この JSON ファイルを指定します。cURL 表記には、データを指定する場合、—d オプションが必要です。詳細は、http://curl.haxx.se/docs/manpage.html を参照してください。
また、REST リソースを更新するために使用する PATCH メソッドを指定します。次の cURL コマンドは、ID 項目を使用して指定された Account オブジェクトを取得し、その市区郡 (請求先) を更新します。
レスポンスボディはなく、ヘッダーのみが返されます。
請求先が Fremont に変更されたことを確認するには、取引先のページを更新します。