ストリーム位置

ストリーム位置の要素には、時系列データの 1 つ以上の論理ストリームの位置参照が含まれます。位置参照は、タイムスタンプなどのおおよその外部仕様や、以前の API 呼び出しによって返された位置の不透明な内部仕様である場合があります。ストリーム位置は、複雑な複数要素タイプとして定義することも、文字列として指定することもできます。

ストリーム位置は、データをバッチで取得するのに使用され、呼び出し元が結果をページ分割できます。API リクエスト内で渡されるストリーム位置は、以前の応答で返されたストリーム位置の値です。以前の API 呼び出しから返されたストリーム位置を変更することはお勧めしません。変更すると、予期しない API の動作が発生する場合があります。

ストリーム位置をサポートする API

シンプルなストリーム位置

<streamPosition>8UJZetaMb1V6uUZl+L7DcPP2jG+PMmtpF</streamPosition>

複雑なストリーム位置

<startPosition>
  <latestCreatedAt  />
  <oldestCreatedAt>2013-08-01T00:13:13+00:00</oldestCreatedAt>
  <activityCreatedAt  />
  <offset>ID:1086173</offset>
</startPosition>