SharedItems
Query the available shared items in Box.
テーブル固有の情報
Shared Items は、URL を使って外部からビューが公開されているFile です。これらのFile はパスワードで保護することが可能です。このURL へのアクセスとパスワードを保有する人は誰でも、このFile を読み/書きできます。
Select
SharedItems のSelect には、アイテムを指し示すSharedLink を指定します。
SELECT * FROM SharedItems WHERE SharedLink = 'www.url.com'
SharedItem にパスワードがある場合には、パスワードも指定する必要があります。
SELECT * FROM SharedItems WHERE SharedLink = 'www.url.com' AND SharedLinkPassword = 'password'
If you're authenticated as an administrator with user impersonation permissions, you can query shared items from multiple user accounts:
SELECT * FROM SharedItems WHERE AsUserId IN (SELECT Id FROM Users)
Note: User impersonation has the following limitations:
- The authenticated user cannot be impersonated unless that user is a service account.
- If the authenticated user is a standard user account, they can only query shared items associated with their account.
- Shared items shared with multiple users are only returned for one of the users.
Columns
Name | Type | Description |
Name | String | The name of the shared item. |
ItemId [KEY] | String | The Id of the shared item. |
ItemType | String | The item type that the shared item points to. |
CreatedAt | String | The date the shared item was created at. |
Description | String | The description of the of the shared item. |
ModifiedAt | String | The date the shared item was modified at. |
OwnedById | String | The id of owner of the shared item. |
OwnedByName | String | The name of owner of the shared item. |
OwnedByLogin | String | The login of owner of the shared item. |
ParentId | String | The id of the parent of the shared item. |
ParentName | String | The Name of the parent of the shared item. |
Access | String | The availability of the shared item. |
DownloadCount | Integer | The number of times the item was downloaded |
DownloadUrl | String | The url to download the item from. |
IsPasswordEnabled | String | If you need to specify a password to download the file or not. |
CanDownload | Boolean | If the item is available to download or not. |
CanPreview | Boolean | If the item is available to preview or not. |
PreviewCount | Integer | The number of times the item was previewed. |
Url | String | The preview url of the item. |
Size | Long | The size of the item. |
AsUserId | String | The Id of the user you want to impersonate. Only works with Admin, Co-Admin and Service Accounts. |
Pseudo-Columns
SELECT ステートメントのWHERE 句では、疑似カラムフィールドを使用して、データソースから返されるタプルを詳細に制御することができます。
Name | Type | Description |
SharedLink | String | The shared link to query. |
SharedLinkPassword | String | The password of shared link. |