APIリファレンス 開発ガイドライン クイックスタート ガイド - メッセージを送信する
- テキストの文字数のカウント
- ユーザーIDを取得する
- スタンプ
- LINE絵文字
- オーディエンスを使う
- クイックリプライを使う
- 送信したメッセージの統計情報を取得する
- LINE URLスキームでLINEの機能を使う
- LINEでビーコンを使う
- LINE公式アカウントの友だちを増やす
- ユーザーアカウントの連携
- アイコンと表示名をカスタマイズする
- ローディングのアニメーションを表示する
- メンバーシップ機能を使う
- 引用トークンを取得する
- 失敗したAPIリクエストを再試行する
- LINE公式アカウントの利用を停止する
- Messaging APIの利用を停止する
- チュートリアル - 応答ボットを作る
Webhook リッチメニュー LINE Bot Designer Flex Message 概念 リファレンス リソース
APIリファレンス 開発ガイドライン クイックスタート ガイド - メッセージを送信する
- テキストの文字数のカウント
- ユーザーIDを取得する
- スタンプ
- LINE絵文字
- オーディエンスを使う
- クイックリプライを使う
- 送信したメッセージの統計情報を取得する
- LINE URLスキームでLINEの機能を使う
- LINEでビーコンを使う
- LINE公式アカウントの友だちを増やす
- ユーザーアカウントの連携
- アイコンと表示名をカスタマイズする
- ローディングのアニメーションを表示する
- メンバーシップ機能を使う
- 引用トークンを取得する
- 失敗したAPIリクエストを再試行する
- LINE公式アカウントの利用を停止する
- Messaging APIの利用を停止する
- チュートリアル - 応答ボットを作る
Webhook リッチメニュー LINE Bot Designer Flex Message 概念 リファレンス リソース
# LINE URLスキームでLINEの機能を使う
LINE URLスキームを使うと、スタンプショップやLIFFアプリを開いたり、カメラを起動したりできます。LINE URLスキームは、LINE公式アカウントでも利用できます。たとえば、リッチメニューにLINE URLスキームを開くアクションを設定しておくことで、メニューをタップしたユーザーに対してLINE内のコンテンツを表示できます。
利用できるLINE URLスキームは、以下のとおりです。
https://line.me/R/
https://liff.line.me/
line://
(非推奨)
ユーザーがline://
で始まるURLにアクセスした際に、ユーザーおよびLINEヤフー株式会社の意図に反して、LINE以外のアプリを起動させる「乗っ取り攻撃」を防ぐため、line://
は非推奨です。「乗っ取り攻撃」は、特定の条件を満たした場合にのみ成立します。
なお、line://
を廃止する時期は未定です。
LINE以外のネイティブアプリを起動するURLスキームは、LINEヤフー株式会社では提供していません。ただし他社が提供するネイティブアプリにおいて、そのアプリを起動するURLスキームが用意されている場合は、そのURLスキームをLINEのリッチメニューやFlex MessageなどのURIアクションで利用することはできます。
# LINE URLスキームをクリックしたときの動作
ユーザーがLINE URLスキームを使ったURLにアクセスすると、LINEが自動的に起動してURLで指定されたコンテンツが表示されます。ユーザーがLINEをインストールしていない場合の動作は、LINE URLスキームごとに異なります。
LINE URLスキーム | LINEをインストールしていない場合の動作 |
---|---|
https://line.me/R/ | ウェブブラウザが開き、LINEのダウンロードを求めるページが開く。 |
line:// (非推奨) | 何も起きないか、エラーページが開く。 |
# 動作環境
LINE URLスキームは、iOS版LINEまたはAndroid版LINEをインストールしたスマートフォンで利用できます。
LINE URLスキームは、デスクトップ版(macOS、Windows)のLINEではサポートされません。
# LINEで利用できるURLスキーム
LINEで利用できるURLスキームは以下のとおりです。なお、指定の動作環境でのみサポートされているLINE URLスキームについては、それぞれの項目内に記載しています。
- カメラとカメラロールを開く
- 位置情報を送る
- LINE公式アカウントをシェアする
- LINE公式アカウントのLINE VOOMやプロフィールを開く
- LINE公式アカウントとのトーク画面を開く
- テキストメッセージを送る
- プロフィール情報を開く
- その他の画面を開く
- 設定画面を開く
- スタンプショップを開く
- 着せかえショップを開く
- LIFFアプリを開く
- URLを外部ブラウザで開く
# カメラとカメラロールを開く
このLINE URLスキームを使うと、カメラまたはカメラロールを開くことができます。カメラロールは、ユーザーがトークに送信する画像を選択する画面です。
このURLスキームは、LINEのトーク(オープンチャットを含む)でのみサポートされます。トーク以外の機能や、LINE以外のアプリ、LIFFアプリではサポートされません。
LINE URLスキーム | 説明 |
---|---|
https://line.me/R/nv/camera/ | カメラを開きます。前面カメラ(インカメラ)と背面カメラ(アウトカメラ)など複数のカメラが搭載されているスマートフォンの場合、使用するカメラを指定することはできません。 |
https://line.me/R/nv/cameraRoll/single | カメラロールを開きます。トーク内で共有する画像を1つ選択できます。 |
https://line.me/R/nv/cameraRoll/multi | カメラロールを開きます。トーク内で共有する画像を複数選択できます。 |
# 位置情報を送る
このLINE URLスキームを使うと、「位置情報」画面を開き、位置情報をLINE公式アカウントに送信できます。
このURLスキームはLINE公式アカウントとの1対1のトークでのみサポートされます。他の種類のトークや、LINE以外のアプリ、LIFFアプリではサポートされません。
LINE URLスキーム | 説明 |
---|---|
https://line.me/R/nv/location/ | 「位置情報」画面を開きます。ユーザーは、地図にピンを刺してシェアする位置情報を選択できます。 |
# LINE公式アカウントをシェアする
このLINE URLスキームを使うと、指定したLINE公式アカウントをユーザーやユーザーの友だちにおすすめして、LINE公式アカウントを友だち追加するように促すことができます。
LINE URLスキーム | 説明 |
---|---|
https://line.me/R/ti/p/{Percent-encoded LINE ID} | 指定したLINE公式アカウントのプロフィールを開きます。LINE公式アカウントとすでに友だちだった場合は、1対1のトーク画面を開きます。 |
https://line.me/R/nv/recommendOA/{Percent-encoded LINE ID} | 「送信先を選択」画面を開きます。友だち、グループトーク、または複数人トークを選択してLINE公式アカウントのリンクをシェアできます。 |
{Percent-encoded LINE ID}
はUTF-8を用いてパーセントエンコード (opens new window)してください。たとえば、LINE IDが@linedevelopers
の場合は、https://line.me/R/ti/p/%40linedevelopers
やhttps://line.me/R/nv/recommendOA/%40linedevelopers
のようにします。LINE IDをパーセントエンコードせずにそのまま置き換えた場合も動作しますが、非推奨です。
ただし「送信先を選択」画面を開くURLスキーム(https://line.me/R/nv/recommendOA/%40linedevelopers
)でLINE IDをパーセントエンコードした場合、Android版のLINEバージョン13.8.0未満では動作しません。
LINE公式アカウントのLINE IDは、ベーシックIDとプレミアムID (opens new window)のどちらも利用できます。
LINE公式アカウントのLINE IDはLINE Official Account Manager (opens new window)で確認できます。詳しくは、「LINE公式アカウントのLINE IDをシェアする」を参照してください。
ユーザーがhttps://line.me/R/ti/p/{Percent-encoded LINE ID}
をパソコンで開いた場合、LINE公式アカウントのWeb版プロフィール(例:LINE FRIENDSのプロフィール (opens new window))や、QRコードが表示されます。どちらが表示されるかは、以下の条件を満たしているかどうかで異なります。
- LINE公式アカウントが認証済アカウントである
- Web版プロフィールを「利用する」設定にしている
どちらの条件も満たしている場合、LINE公式アカウントのWeb版プロフィールがQRコード付きで表示されます。条件を満たしていない場合は、LINE公式アカウントのQRコードのみが表示されます。利用中の未認証アカウントを認証済アカウントに変更したり、Web版プロフィールを利用したりするための設定は、LINE Official Account Manager (opens new window)から行うことができます。
# LINE公式アカウントのLINE VOOMやプロフィールを開く
このLINE URLスキームを使うと、LINE公式アカウントのLINE VOOMやプロフィールを開くことができます。
LINE URLスキーム | 説明 |
---|---|
https://line.me/R/home/public/main?id={LINE ID without @} | 指定したLINE公式アカウントのLINE VOOMを開きます。 |
https://line.me/R/home/public/profile?id={LINE ID without @} | 指定したLINE公式アカウントのプロフィールを開きます。 |
https://line.me/R/home/public/post?id={LINE ID without @} &postId={postId} | 指定したLINE公式アカウントの特定のLINE VOOMの投稿を開きます。各投稿のIDは、LINE VOOM Studio (opens new window)で確認できます。 |
{LINE ID without @}
は、LINE公式アカウントのLINE IDに置き換えてください。ベーシックIDとプレミアムIDのどちらも指定できます。なお、LINE IDの先頭の@
を含めないでください。たとえば、LINE IDが@linedevelopers
の場合は、https://line.me/R/home/public/main?id=linedevelopers
のようにします。
LINE公式アカウントのLINE IDはLINE Official Account Manager (opens new window)で確認できます。詳しくは、「LINE公式アカウントのLINE IDをシェアする」を参照してください。
あなたが管理しているLINE公式アカウントのLINE VOOMに投稿したり、プロフィールをカスタマイズしたりするには、LINE VOOM Studio (opens new window)やLINE Official Account Manager (opens new window)を使います。
# LINE公式アカウントとのトーク画面を開く
このLINE URLスキームを使うと、LINE公式アカウントとのトーク画面を開くことができます。
LINE URLスキーム | 説明 |
---|---|
https://line.me/R/oaMessage/{Percent-encoded LINE ID} | LINE公式アカウントとのトーク画面を開きます。 |
https://line.me/R/oaMessage/{Percent-encoded LINE ID} /?{text_message} | {text_message} に設定したテキストメッセージがメッセージ入力欄に入力された状態で、LINE公式アカウントとのトーク画面を開きます。 |
{Percent-encoded LINE ID}
と{text_message}
はUTF-8を用いてパーセントエンコード (opens new window)してください。たとえば、LINE IDが@linedevelopers
のLINE公式アカウントに対して、こんにちは
というテキストメッセージを送信する場合は、https://line.me/R/oaMessage/%40linedevelopers/?%E3%81%93%E3%82%93%E3%81%AB%E3%81%A1%E3%81%AF
のようにします。LINE IDをパーセントエンコードせずにそのまま置き換えた場合も動作しますが、非推奨です。
LINE公式アカウントのLINE IDは、ベーシックIDとプレミアムID (opens new window)のどちらも利用できます。
LINE公式アカウントのLINE IDはLINE Official Account Manager (opens new window)で確認できます。詳しくは、「LINE公式アカウントのLINE IDをシェアする」を参照してください。
# テキストメッセージを送る
このLINE URLスキームを使うと、ユーザーの友だちまたはLINE公式アカウントに送信するテキストメッセージを設定できます。
LINE URLスキーム | 説明 |
---|---|
https://line.me/R/share?text={text_message} | 「送信先を選択」画面を開きます。ユーザーは、友だち、グループトーク、または複数人トークを選択して、{text_message} に設定されたテキストメッセージを送信できます。テキストはKeepメモやLINE VOOM、他のアプリにも送信できます。 |
{text_message}
はUTF-8を用いてパーセントエンコード (opens new window)してください。たとえば、こんにちは
というテキストメッセージを指定する場合は、https://line.me/R/share?text=%E3%81%93%E3%82%93%E3%81%AB%E3%81%A1%E3%81%AF
のようにします。
# プロフィール情報を開く
このLINE URLスキームを使うと、ユーザーの「プロフィール」画面を開きます。この画面では、表示名、ステータスメッセージ、およびLINE IDを設定できます。また、さまざまなLINEプロフィール情報を確認できます。
LINE URLスキーム | 説明 |
---|---|
https://line.me/R/nv/profile | ユーザーの「プロフィール」画面を開きます。 |
https://line.me/R/nv/profileSetId | ユーザーの「ID」画面を開きます。LINE IDが未設定の場合は、LINE IDを設定できます。 |
# その他の画面を開く
このLINE URLスキームを使うと、トークタブを含むLINEのさまざまな画面を開きます。
LINE URLスキーム | 説明 |
---|---|
https://line.me/R/nv/chat | トークタブを開きます。 |
https://line.me/R/nv/timeline | VOOMタブを開きます。 |
https://line.me/R/nv/wallet | ウォレットタブを開きます。 |
https://line.me/R/nv/addFriends | 「友だち追加」画面を開きます。 |
https://line.me/R/nv/officialAccounts | 「LINE公式アカウント」画面を開きます。 |
# 「設定」画面を開く
このLINE URLスキームを使うと、LINEのさまざまな設定画面を開きます。
LINE URLスキーム | 説明 |
---|---|
https://line.me/R/nv/settings | 「設定」画面を開きます。 |
https://line.me/R/nv/settings/account | 「アカウント」設定画面を開きます。ユーザーのLINEアカウント情報が表示されます。 |
https://line.me/R/nv/connectedApps | 「アカウント」 > 「連動アプリ」設定画面を開きます。この画面では、認証済みアプリに付与されている権限を確認したり、アプリの連動を解除したりできます。 |
https://line.me/R/nv/connectedDevices | 「アカウント」 >「ログイン中の端末」設定画面を開きます。 |
https://line.me/R/nv/settings/privacy | 「プライバシー管理」の設定画面を開きます。 |
https://line.me/R/nv/things/deviceLink | 「LINE Things」設定画面を開きます。LINEとデバイスを連携したり、連携済みのデバイスを確認したりする画面です。 |
https://line.me/R/nv/settings/sticker | 「スタンプ」設定画面を開きます。 |
https://line.me/R/nv/stickerShop/mySticker | 「スタンプ」 > 「マイスタンプ」設定画面を開きます。 |
https://line.me/R/nv/settings/themeSettingsMenu (iOS)、https://line.me/R/nv/settings/theme (Android) | 「着せかえ」設定画面を開きます。 iOSとAndroidでスキームが異なります。 |
https://line.me/R/nv/themeSettings | 「着せかえ」 > 「マイ着せかえ」設定画面を開きます。 |
https://line.me/R/nv/notificationServiceDetail | 「通知」 > 「連動アプリ」設定画面を開きます。この画面では、連動アプリの通知設定を設定できます。 |
https://line.me/R/nv/settings/chatSettings | 「トーク」設定画面を開きます。 |
https://line.me/R/nv/suggestSettings | 「トーク」 > 「サジェスト表示」設定画面を開きます。 |
https://line.me/R/nv/settings/callSettings | 「通話」設定画面を開きます。 |
https://line.me/R/nv/settings/addressBookSync | 「友だち」設定画面を開きます。 |
https://line.me/R/nv/settings/timelineSettings | 「LINE VOOM」設定画面を開きます。 |
# スタンプショップを開く
このLINE URLスキームを使うと、公式スタンプやクリエイターズスタンプの購入を促すために、LINE内でスタンプショップを開くことができます。
LINE URLスキーム | 説明 |
---|---|
https://line.me/R/shop/sticker/detail/{package_id} | 指定されたスタンプの「スタンプ情報」画面を開きます。{package_id} には、LINE STORE (opens new window)のスタンプページのURLに含まれる数字を指定します。 |
https://line.me/R/shop/category/{category_id} | 「公式スタンプ」セクション内の指定されたカテゴリの人気ランキングが表示されます。{category_id} には、LINE STORE (opens new window)の「公式スタンプ」セクション内のカテゴリページのURLに含まれる数字を指定します。 |
https://line.me/R/shop/sticker/author/{author_id} | 指定された作成者のスタンプリストを開きます。{author_id} には、LINE STORE (opens new window)のスタンプの作成者ページのURLに含まれる数字を指定します。 |
https://line.me/R/nv/stickerShop | スタンプショップのホームタブを開きます。 |
https://line.me/R/shop/sticker/hot | スタンプショップの人気タブを開きます。 |
https://line.me/R/shop/sticker/new | スタンプショップの新着タブを開きます。 |
https://line.me/R/shop/sticker/event | スタンプショップの無料タブを開きます。 |
https://line.me/R/shop/sticker/category | スタンプショップのカテゴリータブを開きます。 |
ユーザー向けに独自のスタンプセットを作成するには、LINE Creators Market (opens new window)サイトでLINEスタンプメーカー (opens new window)アプリを使用してください。
# 着せかえショップを開く
このLINE URLスキームを使うと、公式着せかえやクリエイターズ着せかえの購入を促すために、LINE内で着せかえショップを開くことができます。
LINE URLスキーム | 説明 |
---|---|
https://line.me/R/shop/theme/detail?id={product_id} | 指定された公式着せかえ、またはクリエイターズ着せかえの「着せかえ情報」画面を開きます。{product_id} には、LINE STORE (opens new window)の、着せかえページのURLに含まれるIDを指定します。たとえば、「マットホワイト (opens new window)https://store.line.me/themeshop/product/0bac8fed-4c75-40c5-9982-e9ecc3b9d191/ja 」を開く場合、0bac8fed-4c75-40c5-9982-e9ecc3b9d191 を指定します。 |
# LIFFアプリを開く
このLINE URLスキームを使うと、指定したLIFFアプリを開くことができます。LIFFアプリは、LINE Front-end Framework(LIFF)を利用して動作するウェブアプリです。
LINE URLスキーム | 説明 |
---|---|
https://liff.line.me/{liffId} | 指定したLIFF IDのLIFFアプリを開きます。このURLスキームを、LIFF URLと呼びます。 |
https://liff.line.me/{liffId} /path_A/path_B/?key1=value1&key2=value2 | 指定したLIFF IDでLIFFアプリを開きます。/path_A/path_B/?key1=value1&key2=value2 を追加情報として渡します。 |
LIFFアプリが開くまでの処理について詳しくは、『LIFFドキュメント』の「LIFFアプリを開く」を参照してください。
# URLを外部ブラウザで開く
クエリパラメータを使うと、LINE内ブラウザの代わりに外部ブラウザでURLを開くことができます。
これらのクエリパラメータは、LINEアプリからアクセスするすべてのURLで機能します。ただし、LIFFアプリのみ例外的にサポートされないため、LIFF URLにクエリパラメータを付与しても機能しません。
クエリパラメータ付きのURL | 説明 |
---|---|
https://example.com/?openExternalBrowser=1 | 対象のURLを外部ブラウザで開きます。 |
https://example.com/?openInAppBrowser=0 | 対象のURLをChromeカスタムタブで開きます。(Android版LINEのみ対応)[1] |
QRコードリーダーを起動してURLを読み込んだ場合、当該クエリパラメータが付与されていなくても対象のURLをChromeカスタムタブで開きます。 ↩︎