ニュース：#Messaging APIの記事

Messaging APIに、新しいエンドポイントが追加されました。これらのエンドポイントを使って、チャネルから送信されたメッセージの数を取得できます。

詳しくは、『Messaging APIリファレンス』の以下のセクションを参照してください。

• 送信済みの応答メッセージの数を取得する
• 送信済みのプッシュメッセージの数を取得する
• 送信済みのマルチキャストメッセージの数を取得する

Messaging APIにおいて以下の障害が発生しておりましたが、すべて回復いたしました。お客様には多大なご迷惑をお掛けし、誠に申し訳ございませんでした。

発生日時

2019/01/12 16:59 ~ 18:30（GMT+9）

原因

サーバー障害

状況

2019/01/12 17:00前後の1分程度、Messaging APIにステータスコード500番台のエラーが発生していました。また、2019/01/12 18:30まで、Webhookイベントを正常に送信できていませんでした。

LINEは今後もお客様への一層のサービス向上に取組んでまいります。何卒ご理解を賜りますよう、よろしくお願い申し上げます。

画像コンポーネントおよびアイコンコンポーネント

画像とアイコンのアスペクト比を、一定の範囲内で自由に指定できるようになりました。

詳しくは、以下のリファレンスを参照してください。

• 画像コンポーネント
• アイコンコンポーネント

URIアクション

iOS版とAndroid版のLINE用のアクションURLと、macOS版とWindows版のLINE用のアクションURLを、個別に指定できるようになりました。

詳しくは、「URIアクション」を参照してください。

2018年11月14日にお知らせしたイメージマップメッセージの仕様変更は、互換性維持のために中止させていただくことになりました。ご利用中のユーザー様にはご迷惑をおかけしたことを深くお詫び申し上げますとともに、何卒ご理解いただきますようお願い申し上げます。

今後も、baseSizeプロパティで指定した画像の幅および高さからはみ出した領域にアクションを設定しても、イメージマップメッセージを送信できます。

ただし、そのようなイメージマップメッセージのレイアウトはユーザーの端末では表示が崩れる場合があります。baseSizeプロパティで指定した画像の幅および高さの範囲内に、アクションを設定することをお勧めします。

Messaging APIに、メンバー参加イベントとメンバー退出イベントという新しいWebhookイベントが追加されました。

詳しくは、以下のセクションを参照してください。

• メンバー参加イベント
• メンバー退出イベント

イメージマップメッセージの仕様変更が予定されています。

イメージマップメッセージのアクションの設定方法に問題がある場合は、仕様変更後はエラーが発生し、イメージマップメッセージを送信できません。

現在の仕様：

baseSizeプロパティで指定した画像の幅および高さからはみ出した領域にアクションを設定しても、イメージマップメッセージを送信できます。

※ユーザーの端末に表示されるレイアウトは崩れる場合があります。

変更後の仕様：

baseSizeプロパティで指定した画像の幅および高さからはみ出した領域にアクションを設定すると、APIリクエストがエラーになり、イメージマップメッセージを送信できません。

仕様変更は、11月27日を予定しています。

昨日公開された、Webhookイベントに追加された新しいdestinationプロパティの記載に誤記がありました。お詫びして訂正いたします。

【誤】destinationプロパティには、Webhookイベントを受信すべきボットのMID（destination）が含まれます。この値は、「u[0-9a-f]{32}」の正規表現にマッチする文字列です。

【正】destinationプロパティには、Webhookイベントを受信すべきボットのユーザーID（destination）が含まれます。この値は、「U[0-9a-f]{32}」の正規表現にマッチする文字列です。

詳しくは、「リクエストボディ」を参照してください。

イメージマップメッセージで動画を再生できます

イメージマップメッセージで動画を再生できるようになりました。

詳しくは、「イメージマップメッセージ」を参照してください。

10月24日にお知らせしたイメージマップメッセージのアクション領域に対する検証は、今回の変更には含まれません。リリース予定が定まり次第、改めてお知らせします。

Webhookイベントに新しいプロパティが追加されました

• Webhookイベントのボディに、Webhookイベントを受信すべきボットのユーザーID（destination）が含まれるようになりました。詳しくは、「リクエストボディ」を参照してください。
• 画像メッセージ、動画メッセージ、音声メッセージの各メッセージオブジェクトに、新しい情報が追加されました。詳しくは、「画像」、「動画」、「音声」を参照してください。

2018/11/09訂正：MID -> userId

Flex Messageをマルチキャストで送信できるようになりました

Flex Messageを/v2/bot/message/multicastエンドポイントを使って送信できるようになりました。

/v2/bot/message/multicastエンドポイントについては、『Messaging APIリファレンス』の「複数のユーザーにメッセージを送る」を参照してください。

イメージマップメッセージの仕様変更が予定されています。

イメージマップメッセージのアクションの設定方法に問題がある場合は、仕様変更後はエラーが発生し、イメージマップメッセージを送信できません。

現在の仕様：

baseSizeプロパティで指定した画像の幅および高さからはみ出した領域にアクションを設定しても、イメージマップメッセージを送信できます。

※ユーザーの端末に表示されるレイアウトは崩れる場合があります。

変更後の仕様：

baseSizeプロパティで指定した画像の幅および高さからはみ出した領域にアクションを設定すると、APIリクエストがエラーになり、イメージマップメッセージを送信できません。

仕様変更は、11月5日で始まる週を予定しています。

GET https://api.line.me/v2/bot/profile/{userId}リクエストのレスポンスに含まれるpictureUrlプロパティのスキームとして、httpsがサポートされるようになりました。

8月にお知らせした長期間有効なチャネルアクセストークンの廃止について、変更することをお知らせします。

長期間有効なチャネルアクセストークンを2018年11月に廃止すると、開発者の方が多くの影響を受けると判断し、引き続きサポートすることを決定しました。より影響の少ない代替方法を策定次第、改めて詳細をお知らせします。

Messaging APIでデフォルトのリッチメニューを設定できるようになりました。

LINE@マネージャーで作成するデフォルトのリッチメニューも引き続きサポートされ、Messaging APIで作成するリッチメニューと並行して利用できます。

リッチメニュー機能の使い方について詳しくは、以下のページを参照してください。

• リッチメニューを使う
• 『Messagig APIリファレンス』の「リッチメニュー」

ボットから送信できるスタンプが、342種類から462種類に増えました。多彩な新しいスタンプを活用して、さらに表現力豊かで気配りのきいたボットを開発できます。

詳しくは、「スタンプメッセージ」およびスタンプリストを参照してください。

Messaging APIで使用されてきた、長期間有効なチャネルアクセストークンを廃止することになりました。

これはMessaging API v1のエンドポイントの廃止に伴う措置で、2018年11月に行われる予定です。

長期間有効なチャネルアクセストークンは、コンソールからのみ発行されます。短期間有効なチャネルアクセストークンを発行する以下のエンドポイントは、今回の措置に影響を受けません。

https://api.line.me/v2/oauth/accessToken

代替方法について詳しくは、近日中にお知らせします。

Flex Messageをデスクトップで表示できるようになりました。

対応するmacOS版とWindows版LINEのバージョンは5.9.0以降です。

また、Flex Messageに以下の新しいプロパティが追加され、メッセージをさらに自由に作成できるようになりました。

• ボックスコンポーネントのactionプロパティ
• テキストコンポーネントのmaxLinesプロパティ

詳しくは、以下のトピックを参照してください。

• Flex Messageを使う
• Flex Message

Messaging APIのメッセージで使用できるクイックリプライがリリースされました。クイックリプライボタンを設定したメッセージをボットから受信すると、トーク画面の下部にそれらのボタンが表示されます。ボタンをタップするだけで、ボットからのメッセージに簡単に返信できます。

クイックリプライはiOS版とAndroid版のLINE 8.11.0以降で対応しています。

詳しくは、「クイックリプライを使う」を参照してください。

Messaging APIにおいて以下の障害が発生しておりましたが、すべて回復いたしました。お客様には多大なご迷惑をお掛けし、誠に申し訳ございませんでした。

回復日付

2018/06/27 JST（GMT+9）

原因

サーバー障害

状況

ユーザーとリッチメニューのリンクを解除するためにMessaging APIを呼び出したときに、そのユーザーがボットとのトーク画面を閉じていると、リッチメニューのリンクを解除できないという問題がありました。この問題は、ユーザーがiOS版LINE 8.7.0以降を使用し、リッチメニューがadmin-official.line.meで設定されていた場合にのみ発生しました。

LINEは今後もお客様への一層のサービス向上に取組んでまいります。何卒ご理解を賜りますよう、よろしくお願い申し上げます。

Messaging APIの新しいメッセージタイプであるFlex Messageがリリースされました。Flex Messageは、複数の要素を組み合わせてレイアウトを自由にカスタマイズできるメッセージです。

Flex MessageはiOS版とAndroid版のLINE 6.7.0以降で対応しています。

詳しくは、「Flex Messageを使う」を参照してください。

Messaging APIのリッチメニューを、1つのボットに対して1000件まで設定できるようになりました。以前の上限は10件でした。

リッチメニューについて詳しくは、「リッチメニューを使う」を参照してください。

ご自身が提供されているサービスの既存のユーザーアカウントを、ボットと友だちになっているLINEユーザーのアカウントとセキュアに連携できるようになりました。これにより、すでにお持ちのユーザー情報を活用し、LINEのボットを使ってより良いサービスを提供できます。

詳しくは、「ユーザーアカウントを連携する」を参照してください。

LINE Bot Designerを使えば、プログラミングの知識がなくても簡単かつ短時間でLINE Botのプロトタイプを作成できます。ご希望のシナリオに沿って、自由にチャットボットを設計できます。

LINE Bot Designerは無料です。LINEアカウントをお持ちであれば、どなたでもダウンロードしてご利用いただけます。

詳しくは、「LINE Bot Designer」ページを参照してください。

イメージマップメッセージとリッチメニューで、labelプロパティを使って、ユーザーデバイスのアクセシビリティ機能が有効な場合に読み上げられるテキストを設定できるようになりました。この機能は、iOS版LINE 8.2.0以降でサポートされます。

詳しくは、以下のリファレンスを参照してください。

• イメージマップアクションオブジェクト
• アクションオブジェクト

テンプレートメッセージにデフォルトアクションを設定できるようになりました

ボタンテンプレートメッセージとカルーセルテンプレートメッセージのカラムオブジェクトに、defaultActionプロパティが追加されました。これにより、画像、タイトル、テキストの領域全体に対して、ユーザーがタップすると実行されるアクションを1つ指定できるようになりました。

詳しくは、以下のリファレンスを参照してください。

• ボタン
• カルーセル

ポストバックアクションにdisplayTextプロパティが追加されました

ポストバックアクションにdisplayTextプロパティを追加しました。textプロパティは廃止される予定です。textプロパティの代わりにdisplayTextプロパティを使用することをお勧めします。displayTextプロパティとtextプロパティは同時に使用できないことにご注意ください。詳しくは、以下のリファレンスを参照してください。

• ポストバックアクション

「Messaging API SDK」ページにコミュニティSDKのセクションが追加されました。このセクションには、LINEの開発者コミュニティによって開発されるMessaging API SDKを記載していきます。現在はC#（.NET）SDKのみですが、さらに多くのリソースを追加していく予定です。

Messaging API向けのSDKやライブラリを開発し、コミュニティで共有したい方は、プロジェクトを提出してLINEによるレビューを受ける方法について「コミュニティ貢献ガイドライン」を参照してください。

ボットの友だちを増やし、リーチを広げる方法についての記事を追加しました。たとえば、QRコードや［友だち追加］ボタンを使ったり、LINEログインのチャネルにボットをリンクしたりできます。

詳しくは、「ボットをユーザーとシェアする」を参照してください。

ボタンとカルーセルのテンプレートメッセージに、imageAspectRatio、imageSize、およびimageBackgroundColorプロパティが追加されました。これらのプロパティを使って、テンプレートメッセージで使用する画像のアスペクト比、表示形式、および背景色を設定できます。詳しくは、以下のリファレンスを参照してください。

• ボタンテンプレートメッセージ
• カルーセルテンプレートメッセージ

LINEログインとMessaging APIのドキュメントに、LINE URLスキームの記事が追加されました。URLスキームを使うと、LINE内でカメラ、位置情報、設定画面などの特定のコンテンツを表示することができます。LINE URLスキームは、LINE内ではボット（Messaging API）で利用できます。ネイティブアプリまたはWebアプリでURLスキームを利用する場合は、LINEが自動的に開きます。

以下の新しい記事を参照してください。

• Messaging API：LINE URLスキームを使う
• LINEログイン：LINE URLスキームを使う

ユーザーがLINEログインを使ってあなたのアプリにログインするときに、ボットを友だち追加するオプションを表示できるようになりました。この機能を有効にするには、LINE Developersコンソールの［このチャネルにリンクされたボット］オプションを使ってLINEログインアカウントにボットをリンクしてから、LINEログインの認可URLにbot_promptクエリパラメータを含めます。

この機能について詳しくは、「ボットをLINEログインのチャネルにリンクする」を参照してください。

また、ボットとユーザーの友だち関係を取得するための、Social APIの新しいリソースをリリースしました。https://api.line.me/friendship/v1/statusにGETリクエストを送信すると、ユーザーがボットを友だち追加しているかどうかを確認できます。

このリソースについて詳しくは、APIリファレンスの「ボットとの友だち関係を取得する」を参照してください。

注：現在この機能は企業ユーザー様にはご利用いただけません。この機能のご利用をご希望の企業ユーザー様は、LINEの貴社担当者までお問い合わせください。

LINE Developersサイトのドキュメントで使われている用語や概念を簡単に調べられるように、LINEログインとMessaging APIの用語集を追加しました。

以下のリンクから各サービスの用語集をチェックしてみてください。

• LINEログイン用語集
• Messaging API用語集

Messaging APIの以下のリッチメニューリソースのレスポンスが変更されました。リッチメニューの削除、リッチメニューの画像のアップロード、リッチメニューとユーザーのリンク、またはリッチメニューとユーザーのリンク解除のリクエストが成功すると、LINEプラットフォームからステータスコード200と空のJSONオブジェクトが返されるようになりました。以前はステータスコード200のみが返されていました。

更新されたAPIリファレンスドキュメントは、以下のとおりです。

• リッチメニューを削除する
• リッチメニューとユーザーをリンクする
• リッチメニューとユーザーのリンクを解除する
• リッチメニューの画像をアップロードする

カルーセルタイプと画像カルーセルタイプのテンプレートメッセージに含められるカラムオブジェクトの数が、5から10に増えました。

詳しくは、以下のリファレンスを参照してください。

• カルーセル
• 画像カルーセル

Messaging APIのリッチメニュー機能がリリースされました。この機能では、ユーザーごとに異なるリッチメニューを表示することができます。新しくリリースされたリッチメニューのエンドポイントを使えば、LINE@マネージャーの代わりにAPIを介して、リッチメニューの作成、リンク、および管理を実行することができます。また、より柔軟にリッチメニューを設計し、特定のメニュー領域にポストバックアクションを設定できます。

LINE@マネージャーで現在設定できるリッチメニューのサイズは2500×1686ですが、Messaging APIならそれに加えて、2500×843の小さなリッチメニューも作成できます。小さなリッチメニューでは、大きなリッチメニューと同様のインタラクティブなメニューをユーザーに提供しながら、トーク画面をより広く表示することができます。

LINE@マネージャーで作成するリッチメニューは引き続きサポートされ、Messaging APIで作成するリッチメニューと並行して利用できます。

注：新しいリッチメニュー機能は、Android版とiOS版のLINE 7.14.0以降でサポートされます。

新しいリッチメニュー機能の使い方について詳しくは、以下のページを参照してください。

• リッチメニューを使う
• リッチメニューリファレンス

The user consent process and the data included in certain webhooks will change from LINE version 7.5.0 (iOS and Android). The details of the changes are shown below.

1. Changes to the user consent process

   The way that users give consent to bots (LINE@ accounts and official accounts) will change with the release of LINE version 7.5.0. Instead of requiring users to agree to a consent screen for every bot they want to add as a friend or start a chat with, from version 7.5.0, users will provide consent to all bots at once through a new consent screen (called the “Official Accounts Terms of Use”). After users have agreed to this screen once, they will be able to add other bots as friends and add them to chats in a single action.

   For more information on the user consent process, see User consent

2. Changes to the Messaging API specifications

   Webhooks will include the user ID of users who send messages in a group or a room if the user has agreed to the “Official Accounts Terms of Use”. Note that the user ID will not be included in the webhook if the user is using a version of LINE below 7.5.0.

We have released the Messaging API SDK for Node.js. This makes it easier for you to to build a bot on LINE with Node.js using the Messaging API.

See the Messaging API SDK repository below.

• https://github.com/line/line-bot-sdk-nodejs
  

For more information on how to use the Messaging API SDK for Node.js, see the documentation.

We've released the multicast feature which lets you send messages to multiple users at any time.

See the updated documentation in the API reference below.

• Multicast reference

We will continue to provide improvements so that developers can code more easily.

We've made some updates to the LINE Developers website. We've added new documentation together with the release of the Messaging API. Our API reference documentation has also been updated and redesigned. And we've made a couple of branding changes as well.

For more detailed information about the changes, see below:

• Added "Overview", "Getting started", and API reference documentation for the Messaging API. For more information, see Messaging API.
• Changed the look of the API reference documentation. See the new documentation here: API reference.
• Made the following branding changes:
• Web API includes the APIs used for integrating Web Login with your websites.
• Social REST API includes REST APIs that you can call from your applications.
• LINE Login, LINE SDK for Android, LINE SDK for iOS, Web API, and Social REST API are included in Social API
• Added information on LINE official accounts and LINE@ accounts in "Account types".

The "Sending rich messages" section of the LINE Developers site has been updated to include information about the "sendMessage" feature of rich messages. For more information, go to https://developers.line.me/bot-api/api-reference.

We have added useful links to accelerate your development on BOT API Trial. See all the links added from below.

Messaging API links

Sticker images have been added to the sticker list which will allow developers to easily recognize the sticker ID.

You are no longer required to register the IP address of your server to call APIs for BOT API Trial. If you register an IP address on the whitelist, API calls will be limited to that IP address. You can use the whitelist for security purposes.

SSL CA root certificates for Let's Encrypt and StartSSL have been added for BOT API callback URL.

See the "Note" in the Registering a callback URL section to find a link to the full list of authorized CAs.