Box開発者向けドキュメントポータル
ログイン

共有リンクの作成

ガイド共有リンク共有リンクの作成

共有リンクの作成

ファイルリソースまたはフォルダリソースの共有リンクを直接作成して、適切なアクセスレベルを持つユーザーにコンテンツの表示を許可するための読み取り専用URLを生成できます。

ファイルまたはフォルダのアクティブな共有リンクは、常に1つのみ保持できます。

共有リンクの作成には少なくとも以下の情報が必要です。

  • リソースのタイプ(ファイルまたはフォルダ)。
  • リソースのID。

共有リンクの作成時には、以下の情報もオプションとして指定できます。

  • 以下のいずれかのアクセスレベル。

    • open: パブリックな共有リンク。そのリンクを知っているすべてのユーザーがアクセスできます。
    • company: 会社内のすべてのユーザーがアクセスできます。
    • collaborators: コンテンツのコラボレーションに参加しているすべてのユーザーがアクセスできます。
  • 有効期限。その日時から、共有リンクが自動的に無効になります。
  • リソースへのアクセスに必要なパスワード。

共有リンクの作成時にアクセスレベルを指定しなかった場合、会社の管理者が指定したデフォルトのアクセスレベルが使用されます。

ファイルの共有リンクの作成

ファイルの共有リンクを作成するには、ファイルのIDとオプションの共有リンクパラメータを指定します。

.NET
string fileId = "11111";
var sharedLinkParams = new BoxSharedLinkRequest()
{
    Access = BoxSharedLinkAccessType.open
};
BoxFile file = client.FilesManager.CreateSharedLinkAsync(fileId, sharedLinkParams);
string sharedLinkUrl = file.SharedLink.Url;
Python
file_id = '11111'

url = client.file(file_id).get_shared_link()
print('The file shared link URL is: {0}'.format(url))

フォルダの共有リンクの作成

フォルダの共有リンクを作成するには、フォルダのIDとオプションの共有リンクパラメータを指定します。

.NET
var sharedLinkParams = new BoxSharedLinkRequest()
{
    Access = BoxSharedLinkAccessType.open
};
BoxFolder folder = await client.FoldersManager.CreateSharedLinkAsync("11111", sharedLinkParams);
string sharedLinkUrl = folder.SharedLink.Url;
Python
url = client.folder(folder_id='22222').get_shared_link()
print('The folder shared link URL is: {0}'.format(url))