Web link (Mini)

ウェブリンクとは、URLを指すオブジェクトです。これらのオブジェクトはBoxウェブアプリケーション内ではブックマークとも呼ばれます。

ウェブリンクオブジェクトはファイルオブジェクトと同様に扱われ、通常のファイルに適用されるアクションの大部分もサポートしています。

このリソースにはAPIの使用時に発生する可能性があるいくつかのバリエーションがあります。

通常、簡易バリアントに含まれるフィールドは、このリソースが別のリソースの応答内にネストされている場合に返されます。

string
11446498

このウェブリンクの一意の識別子

string
web_link

次の値に固定: web_link

string
1

このウェブリンクのエンティティタグ。If-Matchヘッダーで 使用します。

string
My Bookmark

ウェブリンクの名前

3

この項目に適用された最新のユーザーイベントを表す数値の識別子。

これをGET /eventsエンドポイントと組み合わせて使用すると、この識別子が読み取られる前に発生した可能性があるユーザーイベントを除外できます。

たとえば、Box DriveなどのアプリケーションがAPIを介して項目を取得し、その項目の変更に関連するユーザーイベントの発生を監視する場合などがこれに該当します。ユーザーイベントのsequence_idが最初に取得されたリソースのsequence_idよりも小さいか同じである場合、アプリケーションはそのようなユーザーイベントをすべて無視します。

string
https://www.example.com/example/1234

このウェブリンクが指すURL

レスポンスの例

{
  "id": 11446498,
  "type": "web_link",
  "etag": 1,
  "name": "My Bookmark",
  "sequence_id": 3,
  "url": "https://www.example.com/example/1234"
}