ファイルアップロード¶
Slack にファイルをアップロードするタスクです。
このタスクを実行するには、以下のスコープをもつトークンが必要です。
トークンタイプ | 必要なスコープ |
---|---|
bot | bot |
user | files:write:user |
入力値¶
im_slackFileUpload <object>
├─ token <string> *
├─ channels <string[]>
├─ file <binary> *
├─ filename <string> *
├─ filetype <string>
├─ initialComment <string>
├─ threadTs <string>
└─ title <string>
項目名 | 必須/任意 | 型 | 配列/リスト | 説明 |
---|---|---|---|---|
im_slackFileUpload | 任意 | object | なし | |
token | 必須 | string | なし | 必要なスコープを持つ認証トークン |
channels | 任意 | string | 配列 | アップロード先のチャンネル |
file | 必須 | binary | なし | アップロードするファイル |
filename | 必須 | string | なし | ファイル名 |
filetype | 任意 | string | なし | ファイルタイプ |
initialComment | 任意 | string | なし | コメント |
threadTs | 任意 | string | なし | 返信先スレッドのタイムスタンプ
任意のスレッドへ返信を行う場合に利用します。
|
title | 任意 | string | なし | タイトル |
コラム
指定可能なファイルタイプについては「Slack File types」を参照してください。
出力値¶
im_slackFileUpload <object>
├─ ok <boolean>
├─ file <object>
│ ├─ id <string>
│ ├─ created <long>
│ ├─ timestamp <long>
│ ├─ name <string>
│ ├─ title <string>
│ ├─ mimetype <string>
│ ├─ filetype <string>
│ ├─ prettyType <string>
│ ├─ user <string>
│ ├─ editable <boolean>
│ ├─ size <long>
│ ├─ mode <string>
│ ├─ external <boolean>
│ ├─ externalType <string>
│ ├─ public <boolean>
│ ├─ publicUrlShared <boolean>
│ ├─ displayAsBot <boolean>
│ ├─ username <string>
│ ├─ urlPrivate <string>
│ ├─ urlPrivateDownload <string>
│ ├─ permalink <string>
│ ├─ permalinkPublic <string>
│ ├─ commentsCount <string>
│ ├─ starred <boolean>
│ ├─ numStars <integer>
│ ├─ pinnedTo <string[]>
│ ├─ shares <map>
│ ├─ channels <string[]>
│ ├─ groups <string[]>
│ ├─ ims <string[]>
│ ├─ hasRichPreview <boolean>
│ ├─ editLink <string>
│ ├─ preview <string>
│ ├─ previewHighlight <string>
│ ├─ lines <integer>
│ ├─ linesMore <integer>
│ ├─ previewIsTruncated <boolean>
│ ├─ thumb64 <string>
│ ├─ thumb80 <string>
│ ├─ thumb160 <string>
│ ├─ thumb360 <string>
│ ├─ thumb360w <integer>
│ ├─ thumb360h <integer>
│ ├─ thumb480 <string>
│ ├─ thumb480w <integer>
│ ├─ thumb480h <integer>
│ ├─ thumb720 <string>
│ ├─ thumb720w <integer>
│ ├─ thumb720h <integer>
│ ├─ thumb960 <string>
│ ├─ thumb960w <integer>
│ ├─ thumb960h <integer>
│ ├─ thumb1024 <string>
│ ├─ thumb1024w <integer>
│ ├─ thumb1024h <integer>
│ ├─ imageExifRotation <integer>
│ ├─ originalW <integer>
│ └─ originalH <integer>
├─ error <string>
└─ warning <string>
項目名 | 型 | 配列/リスト | 説明 |
---|---|---|---|
im_slackFileUpload | object | なし | |
ok | boolean | なし | 処理結果 |
file | object | なし | ファイル情報 |
id | string | なし | ファイルID |
created | long | なし | 作成日 |
timestamp | long | なし | タイムスタンプ |
name | string | なし | ファイル名 |
title | string | なし | タイトル |
mimetype | string | なし | MIMEタイプ |
filetype | string | なし | ファイルタイプ |
prettyType | string | なし | 人が判読できるファイルの型 |
user | string | なし | ユーザID |
editable | boolean | なし | 編集可能なモードで保存されている場合、true |
size | long | なし | ファイルサイズ(byte) |
mode | string | なし | モード
hosted, external, snippet, postのいずれかが含まれます。
|
external | boolean | なし | 外部にホストされるマスタファイルの場合、true |
externalType | string | なし | 外部ファイルの種類 |
public | boolean | なし | ファイルが公開されている場合、true |
publicUrlShared | boolean | なし | 公開URLが共有されている場合、true |
displayAsBot | boolean | なし | |
username | string | なし | |
urlPrivate | string | なし | ファイル内容のURL |
urlPrivateDownload | string | なし | ファイルのダウンロードURL (編集可能モードの場合のみ)
|
permalink | string | なし | 詳細、コメント、ダウンロードリンクを含むファイルの単一ページ |
permalinkPublic | string | なし | 公開ファイルのpermalink |
initialComment | string | なし | アップロード時のコメント |
commentsCount | integer | なし | コメント数 |
starred | boolean | なし | 呼び出し元ユーザがファイルにスターをつけた場合、true |
numStars | integer | なし | ファイルにスターを付けたユーザ数 |
pinnedTo | string | 配列 | ファイルが現在固定されているすべてのチャンネルID |
shares | map | なし | 共有先情報 |
channels | string | 配列 | ファイルが共有されているすべてのチャンネルID |
groups | string | 配列 | ファイルが共有されているすべてのプライベートグループID |
ims | string | 配列 | ファイルが共有されているすべてのIMチャンネルID |
hasRichPreview | boolean | なし | |
editLink | string | なし | ファイルを編集できるページ(モードが post か snippet の場合のみ)
|
preview | string | なし | プレーンテキストプレビュー(モードが post の場合のみ) |
previewHighlight | string | なし | 構文の強調表示されたプレビュー |
lines | integer | なし | ラインで返された場合のスニペットの行数 |
linesMore | integer | なし | プレビューに表示されない行数 |
previewIsTruncated | boolean | なし | |
thumb64 | string | なし | 64×64のサムネイルURL |
thumb80 | string | なし | 80×80のサムネイルURL |
thumb160 | string | なし | 160×160のサムネイルURL |
thumb360 | string | なし | 可変サイズのサムネイルURL |
thumb360w | integer | なし | 可変サイズのサムネイルの幅 |
thumb360h | integer | なし | 可変サイズのサムネイルの高さ |
thumb480 | string | なし | 可変サイズのサムネイルURL |
thumb480w | integer | なし | 可変サイズのサムネイルの幅 |
thumb480h | integer | なし | 可変サイズのサムネイルの高さ |
thumb720 | string | なし | 可変サイズのサムネイルURL |
thumb720w | integer | なし | 可変サイズのサムネイルの幅 |
thumb720h | integer | なし | 可変サイズのサムネイルの高さ |
thumb960 | string | なし | 可変サイズのサムネイルURL |
thumb960w | integer | なし | 可変サイズのサムネイルの幅 |
thumb960h | integer | なし | 可変サイズのサムネイルの高さ |
thumb1024 | string | なし | 可変サイズのサムネイルURL |
thumb1024w | integer | なし | 可変サイズのサムネイルの幅 |
thumb1024h | integer | なし | 可変サイズのサムネイルの高さ |
imageExifRotation | integer | なし | |
originalW | integer | なし | ファイルの幅 |
originalH | integer | なし | ファイルの高さ |
error | string | なし | エラー |
warning | string | なし | 警告 |
コラム
各項目の詳しい説明は「Slack Web API files.upload」を参照してください。