ウェブリンクを復元
post
https://api.box.com/2.0
/web_links/:web_link_id
ごみ箱に移動されたウェブリンクを復元します。
元のフォルダが削除されている場合にウェブリンクの復元先となる新しい親ID(省略可)を指定することができます。
リクエスト
application/json
パスパラメータ
stringパス内必須
12345ウェブリンクのID。
クエリパラメータ
string arrayクエリ内省略可能
id,type,name応答に含める属性のカンマ区切りリスト。このパラメータを使用すると、標準の応答には通常含まれないフィールドをリクエストできます。
このパラメータを指定すると、明示的に指定しない限り標準フィールドは応答に含まれず、リクエストしたフィールドのほかには、簡易版レプリゼンテーションのフィールドしか返されないことに注意してください。
リクエスト本文
string本文内省略可能
Restored.docxウェブリンクの新しい名前(省略可)。
object本文内
元のフォルダがすでに存在しない場合にウェブリンクの復元先となるフォルダのID(省略可)を指定します。
このIDは、元のフォルダがすでに存在しない場合にのみ使用されることに注意してください。このIDは、元の場所が削除されている場合にウェブリンクの復元先となるフォールバックの場所を指定します。
stringnull省略可能
123親項目のID
レスポンス
application/jsonウェブリンク
ウェブリンクオブジェクトが復元された場合は、そのオブジェクトを返します。
application/jsonクライアントエラー
ウェブリンクの復元先フォルダに対してユーザーがアクセス権限を持っていない場合、またはごみ箱からウェブリンクを復元する権限を持っていない場合は、エラーを返します。
application/jsonクライアントエラー
ウェブリンクがごみ箱内にない場合は、エラーを返します。
application/jsonクライアントエラー
ウェブリンクの復元先フォルダに同じ名前のウェブリンクが存在する場合は、エラーを返します。
application/jsonクライアントエラー
予期しないクライアントエラー。
リクエストの例
cURL
curl -X POST https://api.box.com/2.0/web_links/12345 \
-H 'Authorization: Bearer <ACCESS_TOKEN>" '
-H 'Content-Type: application/json'Python
web_link_to_restore = client.web_link(web_link_id='33333')
restored_web_link = client.trash().restore_item(web_link_to_restore)
print('Web link ID is {0} and name is {1}'.format(restored_web_link.id, restored_web_link.name))