この文章は Salesforce 機械翻訳システムを使用して翻訳されました。詳細はこちらをご参照ください。

sObject Get Updated

指定されたオブジェクトに対して指定された期間内に更新された (追加または変更された) 個別のレコードのリストを取得します。sObject Get Updated は、API バージョン 29.0 以降で使用できます。

このリソースは、データ複製アプリケーションで一般的に使用されます。次の考慮事項に注意してください。

コールが実行された日から 30 日以内の結果が返されます。
クライアントアプリケーションは、適切な権限が付与されている場合、任意のオブジェクトを複製できます。たとえば、組織のすべてのデータを複製するには、クライアントアプリケーションは指定されたオブジェクトの「すべてのデータの参照」アクセス権限を持ってログインしなければなりません。同様に、オブジェクトはそのユーザの共有ルールに含まれていなければなりません。
このリソースから返される ID は、600,000 件までに制限されています。600,000 件以上の ID が返された場合、EXCEEDED_ID_LIMIT が返されます。開始日と終了日の期間を短くすることでこのエラーを回避できます。

データ複製およびデータ複製の制限についての詳細は、『SOAP API 開発者ガイド』の「データ複製」を参照してください。

URI

/vXX.X/sobjects/sObjectName/updated/?start=startDateAndTime&end=endDateAndTime

形式

JSON、XML

HTTP メソッド

GET

認証

Authorization: Bearer token

パラメータ

パラメータ	説明
start	データを取得する期間の開始日時 (ローカル時間ではなく協定世界時 (UTC))。API は、指定された dateTime 値の秒の値を切り捨てます (たとえば、12:30:15 は 12:30:00 UTC となります)。日時は、ISO 8601 形式 (`YYYY-MM-DD`T`hh:mm:ss`+`hh:mm`) で指定する必要があります。start の日付/時間値は、end の値より過去の日時でなければなりません。このパラメータは URL 符号化されている必要があります。
end	データを取得する期間の終了日時 (ローカル時間ではなく協定世界時 (UTC))。API は、指定された dateTime 値の秒の値を切り捨てます (たとえば、12:35:15 は 12:35:00 UTC となります)。日時は、ISO 8601 形式 (`YYYY-MM-DD`T`hh:mm:ss`+`hh:mm`) で指定する必要があります。このパラメータは URL 符号化されている必要があります。

パラメータ

説明

start

データを取得する期間の開始日時 (ローカル時間ではなく協定世界時 (UTC))。API は、指定された dateTime 値の秒の値を切り捨てます (たとえば、12:30:15 は 12:30:00 UTC となります)。日時は、ISO 8601 形式 (YYYY-MM-DDThh:mm:ss+hh:mm) で指定する必要があります。start の日付/時間値は、end の値より過去の日時でなければなりません。このパラメータは URL 符号化されている必要があります。

end

データを取得する期間の終了日時 (ローカル時間ではなく協定世界時 (UTC))。API は、指定された dateTime 値の秒の値を切り捨てます (たとえば、12:35:15 は 12:35:00 UTC となります)。日時は、ISO 8601 形式 (YYYY-MM-DDThh:mm:ss+hh:mm) で指定する必要があります。このパラメータは URL 符号化されている必要があります。

応答形式

プロパティ	型	説明
ids	array	要求で指定された開始日と終了日を満たす更新されたレコードの配列。各エントリにはレコード ID が含まれます。
latestDateCovered	String	要求の対象となる最終日の ISO 8601 形式のタイムスタンプ (ローカル時間ではなく協定世界時 (UTC) タイムゾーン)。

例

更新された項目のリストを取得する例は、「特定の期間に更新されたレコードのリストの取得」を参照してください。

Force.com REST API 開発者ガイド

sObject Get Updated