REST サービスを使用して SharePoint アイテムを同期させるSynchronize SharePoint items using the REST service

SharePoint とアドインまたはサービス間でアイテムを同期させる場合、GetListItemChangesSinceToken リソースを使用して行うことができます。If you want to synchronize items between SharePoint and your add-ins or services, you can use the GetListItemChangesSinceToken resource to do so. SharePoint REST サービスの一部である GetListItemChangesSinceToken は、Lists.GetListItemChangesSinceToken Web サービス呼び出しに対応します。The GetListItemChangesSinceToken, part of the SharePoint REST service, corresponds to the Lists.GetListItemChangesSinceToken web service call.

要求本文に SP.ChangeLogItemQuery オブジェクトのプロパティ オブジェクトを含む POST 要求を実行します。Perform a POST request that includes an SP.ChangeLogItemQuery object properties object in the request body.

要求は、指定されたクエリに一致するリスト アイテムの変更に対応する行を含む ADO rowset XML を返します。The request returns ADO rowset XML, which includes rows corresponding to any list item change matching the specified query. プロパティのデータ構造、CAML 要素の説明、戻り値など、これらのプロパティの詳細については、「Lists.GetListItemChangesSinceToken」を参照してください。For more information about these properties, including property data structures, CAML element descriptions, and return values, see Lists.GetListItemChangesSinceToken.


要求の例Example request

POST http://server/site/_api/web/Lists/GetByTitle('Announcements')/GetListItemChangesSinceToken

POST 本文の例Example POST body

{ 'd' : { 
  'query': { 
    '__metadata': { 'type': 'SP.ChangeLogItemQuery'}, 
    'ViewName': '', 
    'Query': '
         <FieldRef Name="Title" />
         <Value Type='Text'>Te</Value>
    'QueryOptions': '<QueryOptions>
      <Folder>Shared Documents/Test1</Folder></QueryOptions>', 
      <FieldRef Name="Title"/>
      <Value Type="Text">Testing</Value></Contains>' } 

SP.ChangeLogItemQuery オブジェクトのプロパティSP.ChangeLogItemQuery object properties

プロパティProperty 説明Description
ListNameListName リストのタイトルまたは GUID のいずれかを含む文字列。UserInfo テーブルをクエリする場合、文字列には UserInfo が含まれる。GUID を使用するほうが処理速度が速い。A string that contains either the title or the GUID for the list. When querying the UserInfo table, the string contains UserInfo. Using the GUID results in better performance.
ViewNameViewName ビューの GUID を含む文字列。これは、queryviewFields、および rowLimit パラメータによって表される既定のビュー属性で使用するビューを決定します。この引数を指定しなければ、既定のビューと仮定されます。A string that contains the GUID for the view, which determines the view to use for the default view attributes represented by the query, viewFields, and rowLimit parameters. If this argument is not supplied, the default view is assumed.

指定した場合は、queryviewFields、または rowLimit パラメーターの値で、ビュー内の対応する設定が上書きされます。If it is supplied, the value of the query, viewFields, or rowLimit parameter overrides the equivalent setting within the view.

たとえば、viewFields パラメーターで指定されたビューに 100 行の行数制限があり、rowLimit パラメーターの値が 1000 に指定されている場合、応答には 1,000 行が返されます。For example, if the view specified by the viewFields parameter has a row limit of 100 rows, but the rowLimit parameter contains a value of 1000, then 1,000 rows are returned in the response.
クエリQuery Query 要素。どのレコードをどの順序に並べて返すかを指定するクエリを含みます。A Query element containing the query that determines which records are returned and in what order.
QueryOptionsQueryOptions SPQuery オブジェクトのさまざまなプロパティの個別のノードを含む、次の形式の XML 断片。An XML fragment in the following form that contains separate nodes for the various properties of the SPQuery object.
ChangeTokenChangeToken 要求の変更トークンを含む文字列。A string that contains the change token for the request.

この文字列に使用される形式の詳細については、「変更ログの概要」を参照してください。For a description of the format that is used in this string, see Overview of the Change Log. Null を渡すと、リスト内のすべてのアイテムが返されます。If null is passed, all items in the list are returned.
ContainsContains Contains 要素。クエリのカスタム フィルタリングを指定します。A Contains element that defines custom filtering for the query.

関連項目See also