パブリック・リンクを使用したファイルおよびフォルダへのアクセスの提供

機械翻訳について

パブリック・リンクを使用したファイルおよびフォルダへのアクセスの提供

ユーザーがファイルやフォルダにアクセスできるようにするには、パブリック・リンクを使用して、割り当てられたユーザーとファイルやフォルダを共有できます。

ノート:

パブリック・リンクは「プライベート・インスタンス」ではサポートされていません。

異なるアクセス・ロール、有効期限などを使用して、同じファイルまたはフォルダ・リソースに対して複数の名前付きリンクを作成できます。既存のパブリック・リンクの一部の情報を編集することもできます。

パブリック・リンクを使用してファイルやフォルダにアクセスするには:

Create File Public LinkおよびCreate Folder Public link REST APIを使用して、必要なパブリック・リンクを作成します。
使用可能なパブリック・リンク・パラメータを編集する場合は、Edit Public Link REST APIを使用します。

Get File Public LinkまたはGet Folder Public Link REST APIを使用して、ファイルまたはフォルダで使用可能な繋がりリンクに関する情報を取得します。

たとえば、Get Folder Public Linkリクエストには、フォルダID F4E111D0D0645CD368453C2BT0000000000100000001を指定します:

GET . . ./publiclinks/folder/F4E111D0D0645CD368453C2BT0000000000100000001

HTTPステータス・コードが200で、指定されたフォルダに対して1つ以上のパブリック・リンクが利用可能な場合、レスポンスはフォルダに対して定義されたパブリック・リンクに関する情報を返します:

{
    "count": "2",
    "errorCode": "0",
    "id": "F4E111D0D0645CD368453C2BT0000000000100000001",
    "type": "folder",
    "items": [
        {
            "type": "publiclink",
            "linkID": "LF31C09DE51854DBBDA37A90T0000000000100000001",
            "linkName": "hasSecondLink",
            "ownedBy": {
		            "displayName": "User AA",
		            "loginName": "userAALoginName",
		            "id": "U0EAA20910FAF3052ACB79E4T00000000001",
		            "type": "user"
            },
            "role": "viewer",
            "assignedUsers": "@everybody",
            "createdTime": "2015-06-02T19:30:37Z",
            "lastModifiedTime": "2015-06-02T19:30:37Z"
        },
        {
            "type": "publiclink",
            "linkID": "LF5E5F73A444FFB8924EF8ACT0000000000100000001",
            "linkName": "hasFirstLink",
            "ownedBy": {
		            "displayName": "User AA",
		            "loginName": "userAALoginName",
		            "id": "U0EAA20910FAF3052ACB79E4T00000000001",
		            "type": "user"
            },
            "role": "contributor",
            "assignedUsers": "@serviceinstance",
            "createdTime": "2015-06-10T16:15:37Z",
            "lastModifiedTime": "2015-06-10T16:15:37Z"
        }
    ]
}

このレスポンスは、2つのパブリック・リンクが利用可能であることを示しています.1つはフォルダのビューア・ロールが割り当てられているユーザー用で、もう1つはコントリビュータ・ロールが割り当てられているユーザー用です。 APIヘッダーのレスポンスからの情報を使用して、パブリック・リンクで指定された割り当てられたユーザー(assignedUsersの値)とフォルダを共有します。

この例では、2つ目のリンクによって、指定されたフォルダをホストするContent Managementインスタンスのすべてのアカウント所有者にコントリビュータ・レベルのアクセス権が付与されます。

たとえば:

@serviceinstance/documents/link/LF5E5F73A444FFB8924EF8ACT0000000000100000001/folder/F4E111D0D0645CD368453C2BT0000000000100000001

ファイルやフォルダを共有するには、共有フォルダやコレクションなどの他のAPIのヘッダーでレスポンスの情報を使用します。

Webクライアントは、次のいずれかの形式のURLを使用して、パブリック・リンクを介してファイルまたはフォルダを視覚化できます:

domain URL/documents/link/linkID/fileview/file ID

domain URL/documents/link/linkID/folder/folder ID

パブリック・リンクの詳細は、Publiclinks Resourceまたは「ドキュメント用REST API」のPubliclinksを参照してください。