> ## Documentation Index
> Fetch the complete documentation index at: https://domoinc-bradley-turek-pfilter-operators-reference.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Domo Japan Connector for LINE(Messaging API)

## **概要**

Domo Japan Connector for LINE (Messaging API)を使用すると\
LINE Messaging APIを使用して、LINE公式アカウントの分析情報を抽出することができます。

Domo Japan Connector for LINE(Messaging API)では、メッセージ送信数、友だち数、友だち属性などの統計情報にアクセスできます。

LINE公式アカウントにログインしているユーザー（アクセストークン）に応じたデータが返されます。

Reportを以下の3種類から選択します。

1. Delivery：メッセージの送信数
2. Followers：友だち数
3. Demographic：友だちの属性情報に基づく統計情報

DeliveryとFollowersのReportは日付の指定を行うことができます。

設定できる日付の指定は以下の通り。表記は日本語のみです。

<Note>**Note:** 特定の日の1日分のデータを取得するのが1リクエストとなることを注意してください。30日分取得すると30リクエストとなります。</Note>

### 日付の選択

DeliveryとFollowersは以下の3通りの日付選択が可能です。

* 「単一の日付」
* 「日付範囲」
* 「期間」

<Frame>
  <img src="https://mintcdn.com/domoinc-bradley-turek-pfilter-operators-reference/w8qX7lFzkotgN4pO/images/kb/ja/0EM5w000005wLlD.png?fit=max&auto=format&n=w8qX7lFzkotgN4pO&q=85&s=e6d4a14da2abeb63bc6ef99768a993d8" alt="Date.png" width="663" height="253" data-path="images/kb/ja/0EM5w000005wLlD.png" />
</Frame>

#### **「単一の日付」**

特定の日付のデータを取得します。

<Frame>
  <img src="https://mintcdn.com/domoinc-bradley-turek-pfilter-operators-reference/w8qX7lFzkotgN4pO/images/kb/ja/0EM5w000005wLl7.png?fit=max&auto=format&n=w8qX7lFzkotgN4pO&q=85&s=a9a26e18a766ecfd545eb21c3e2336b5" alt="Unique_date-Specific.png" width="455" height="167" data-path="images/kb/ja/0EM5w000005wLl7.png" />
</Frame>

<Frame>
  <img src="https://mintcdn.com/domoinc-bradley-turek-pfilter-operators-reference/w8qX7lFzkotgN4pO/images/kb/ja/0EM5w000005wLl5.png?fit=max&auto=format&n=w8qX7lFzkotgN4pO&q=85&s=f77642051f1147dcc4a6e0e22e70b884" alt="Unique_date-Relative.png" width="461" height="167" data-path="images/kb/ja/0EM5w000005wLl5.png" />
</Frame>

「日付」

「日付タイプ」            「相対」          「遡る日数」　本日から何日前の日付を入力

「特定」          「日付」　カレンダーから特定日を指定

#### **「日付範囲」**

指定した何日から何日までのデータを取得します。

<Frame>
  <img src="https://mintcdn.com/domoinc-bradley-turek-pfilter-operators-reference/w8qX7lFzkotgN4pO/images/kb/ja/0EM5w000005wLlA.png?fit=max&auto=format&n=w8qX7lFzkotgN4pO&q=85&s=8a4e939eaf910781801791a55a66ebde" alt="Any_date_range-Specific.png" width="439" height="235" data-path="images/kb/ja/0EM5w000005wLlA.png" />
</Frame>

<Frame>
  <img src="https://mintcdn.com/domoinc-bradley-turek-pfilter-operators-reference/w8qX7lFzkotgN4pO/images/kb/ja/0EM5w000005wLlG.png?fit=max&auto=format&n=w8qX7lFzkotgN4pO&q=85&s=2a571a3afbea33de2e6be8a6daee751b" alt="Any_date_range-Relative.png" width="441" height="235" data-path="images/kb/ja/0EM5w000005wLlG.png" />
</Frame>

「開始日」

「日付タイプ」            「特定」          「日付」

「相対」          「遡る日数」

「終了日」

「日付タイプ」            「特定」          「日付」

「相対」          「遡る日数」

#### **「期間」**

設定済みの期間でデータを取得します。

<Frame>
  <img src="https://mintcdn.com/domoinc-bradley-turek-pfilter-operators-reference/w8qX7lFzkotgN4pO/images/kb/ja/0EM5w000005wLlE.png?fit=max&auto=format&n=w8qX7lFzkotgN4pO&q=85&s=e26aa15e12e0c9d1ddf79c9baaf15662" alt="Predefined-specific.png" width="266" height="343" data-path="images/kb/ja/0EM5w000005wLlE.png" />
</Frame>

取得できる期間は以下の通りです。

「今日」

「今週」

「今月」

「昨日」

「前の週」

「前の月」

## **前提条件**

Domo Japan Connector for LINE(Messaging API)を利用するためには、LINEの公式アカウントを作成し、LINE Messaging Apiを利用できる状態にしておく必要があります。詳細は以下をご参照ください。

[https://developers.line.biz/ja/docs/messaging-api/getting-started/](https://developers.line.biz/ja/docs/messaging-api/getting-started/)

[https://www.linebiz.com/jp/manual/OfficialAccountManager/account-settings\_messaging\_api/](https://www.linebiz.com/jp/manual/OfficialAccountManager/account-settings_messaging_api/)

## **LINE Official Accountへの接続**

ここでは、「Domo Japan Connector for LINE(Messaging API)」ページの「Credentials(接続)」と「Details(取得できる情報)」のオプションについて説明します。このページの他のコンポーネントである\*\*「データセットのスケジューリング\*\* と**名前と説明」は**、ほとんどのコネクタタイプで共通であり、「[データコネクターを使用してDataSetを追加する](/s/article/360042926274)」で詳しく説明されています 。

### **クレデンシャル（接続）**

[https://developers.line.biz/ja/docs/messaging-api/getting-started/](https://developers.line.biz/ja/docs/messaging-api/getting-started/)

[https://www.linebiz.com/jp/manual/OfficialAccountManager/account-settings\_messaging\_api/](https://www.linebiz.com/jp/manual/OfficialAccountManager/account-settings_messaging_api/)

上記のサイトの手順に従って、Messaging APIのChannel access token

Channel access token (long-lived)を取得してください。

<Frame>
  <img src="https://mintcdn.com/domoinc-bradley-turek-pfilter-operators-reference/w8qX7lFzkotgN4pO/images/kb/ja/0EM5w000005wLl2.png?fit=max&auto=format&n=w8qX7lFzkotgN4pO&q=85&s=0a0db3ff5b4397d3ce2030451a9a1175" alt="Credentials-new.png" width="734" height="232" data-path="images/kb/ja/0EM5w000005wLl2.png" />
</Frame>

一度LINE Messaging APIの認証情報を入力すれば、Domo Japan Connector for LINE(Messaging API)のデータセットを新規に作成する際に、同じアカウントを使用することができます。。コネクタアカウントは、データセンターの\[**アカウント**]タブで管理できます。このタブの詳細については、「[Connector のユーザーアカウントを管理する](/s/article/360042926054)」を参照してください。

### **詳細（取得できる情報）**

**ここでは、選択したReportごとに取得する列やデータタイプについて説明します。**

#### **1. Delivery**

**status String**

集計処理の状態。以下のいずれかの値です。

* ready：メッセージ数を取得できます。
* unready：dateに指定した日付のメッセージ数の集計がまだ完了していません。しばらくしてからリクエストを再実行してください。通常、集計処理は翌日中に完了します。
* out\_of\_service：dateに指定した日付が、集計システムの稼働開始日（2017年03月01日）より前です。

**Broadcast Number**

LINE公式アカウントと友だちになっているすべてのユーザーに送信されたプッシュメッセージ（ブロードキャストメッセージ）の数。

**Targeting Number**

LINE公式アカウントと友だちになっているユーザーの中から属性で絞り込んで送信されたプッシュメッセージ（ターゲティングメッセージ、セグメントメッセージ）の数。

**autoResponse Number**

送信された応答メッセージの数。

**welcomeResponse Number**

送信されたあいさつメッセージの数。

**chat Number**

LINE Official Account Managerの「[チャット基本画面 (opens new window)](https://www.linebiz.com/jp/manual/OfficialAccountManager/chats/)」から送信されたメッセージの数。

**apiBroadcast Number**

「[ブロードキャストメッセージを送る](https://developers.line.biz/ja/reference/messaging-api/#send-broadcast-message)」で送信されたメッセージの数。

**apiPush Number**

「[プッシュメッセージを送る](https://developers.line.biz/ja/reference/messaging-api/#send-push-message)」で送信されたメッセージの数。

**apiMulticast Number**

「[マルチキャストメッセージを送る](https://developers.line.biz/ja/reference/messaging-api/#send-multicast-message)」で送信されたメッセージの数。

**apiNarrowcast Number**

「[ナローキャストメッセージを送る](https://developers.line.biz/ja/reference/messaging-api/#send-narrowcast-message)」で送信されたメッセージの数。

**apiReply Number**

「[応答メッセージを送る](https://developers.line.biz/ja/reference/messaging-api/#send-reply-message)」で送信されたメッセージの数。

broadcast以降のプロパティは、dateに指定した日付に送信されたメッセージの数です。なお、statusの値がreadyの場合にのみレスポンスに含まれます。

[https://developers.line.biz/ja/reference/messaging-api/#get-number-of-delivery-messages](https://developers.line.biz/ja/reference/messaging-api/#get-number-of-delivery-messages)

#### **2. Followers**

**status String**

集計処理の状態。以下のいずれかの値です。

* ready：数値を取得できます。
* unready：dateに指定した日付の友だち数の集計がまだ完了していません。しばらくしてからリクエストを再実行してください。通常、集計処理は翌日中に完了します。
* out\_of\_service：dateに指定した日付が、集計システムの稼働開始日（2016年11月01日）より前です。

**followers Number**

dateに指定した日付までに、アカウントが友だち追加された回数。アカウントがブロックされたり、あなたを友だち追加したユーザーがLINEアカウントを削除したりしても、この値は減少しません。

**targetedReaches Number**

dateに指定した日付時点の、性別や年齢、地域で絞り込んだターゲティングメッセージの配信先となりうる友だちの総数。LINEおよびその他のLINEサービスの利用頻度が高く、属性の高精度な推定が可能な友だちが含まれます。

**blocks Number**

dateに指定した日付時点で、アカウントをブロックしているユーザーの数。ブロックが解除されると、この値は減少します。

followers以降のプロパティは、statusの値がreadyの場合にのみレスポンスに含まれます。

[https://developers.line.biz/ja/reference/messaging-api/#get-number-of-followers](https://developers.line.biz/ja/reference/messaging-api/#get-number-of-followers)

#### **3. Demographic**

**available Boolean**

友だちの属性情報に基づく統計情報が利用できる場合は、true

**genders Array**

性別ごとの割合

**genders\[].gender\*\*\*\*String**

ユーザーの性別に基づいて、以下の値が返されます。

* male
* female
* unknown

**genders\[].percentage Number**

割合

**ages Array**

年齢ごとの割合

**ages\[].age String**

ユーザーの年齢に基づいて、以下の値が返されます。

* from0to14
* from15to19
* from20to24
* from25to29
* from30to34
* from35to39
* from40to44
* from45to49
* from50
* unknown

**ages\[].percentage Number**

割合

**areas Array**

地域ごとの割合

**areas\[].area String**

ユーザーの国や地域に基づいて、以下の値が返されます。\
**JP**

* 北海道
* 青森
* 岩手
* 宮城
* 秋田
* 山形
* 福島
* 茨城
* 栃木
* 群馬
* 埼玉
* 千葉
* 東京
* 神奈川
* 新潟
* 富山
* 石川
* 福井
* 山梨
* 長野
* 岐阜
* 静岡
* 愛知
* 三重
* 滋賀
* 京都
* 大阪
* 兵庫
* 奈良
* 和歌山
* 鳥取
* 島根
* 岡山
* 広島
* 山口
* 徳島
* 香川
* 愛媛
* 高知
* 福岡
* 佐賀
* 長崎
* 熊本
* 大分
* 宮崎
* 鹿児島
* 沖縄
* unknown

**TW**

* 台北市
* 新北市
* 桃園市
* 台中市
* 台南市
* 高雄市
* 基隆市
* 新竹市
* 嘉義市
* 新竹縣
* 苗栗縣
* 彰化縣
* 南投縣
* 雲林縣
* 嘉義縣
* 屏東縣
* 宜蘭縣
* 花蓮縣
* 台東縣
* 澎湖縣
* 金門縣
* 連江縣
* unknown

**TH**

* Bangkok
* Pattaya
* Northern
* Central
* Southern
* Eastern
* NorthEastern
* Western
* unknown

**ID**

* Bali
* Bandung
* Banjarmasin
* Jabodetabek
* Makassar
* Medan
* Palembang
* Samarinda
* Semarang
* Surabaya
* Yogyakarta
* Lainnya
* unknown

**areas\[].percentage Number**

割合

**appTypes Array**

OSごとの割合

**appTypes\[].appType String**

ユーザーが使用するOSに基づいて、以下の値が返されます。

* ios
* android
* others

**appTypes\[].percentage Number**

割合

**subscriptionPeriods Array**

友だち期間ごとの割合

**subscriptionPeriods\[].subscriptionPeriod String**

ユーザーとの友だち期間に基づいて、以下の値が返されます。

* within7days
* within30days
* within90days
* within180days
* within365days
* over365days
* unknown

**subscriptionPeriods\[].percentage Number**

割合

各Arrayの要素は、availableの値がtrueの場合にのみレスポンスに含まれます。

[https://developers.line.biz/ja/reference/messaging-api/#get-demographic](https://developers.line.biz/ja/reference/messaging-api/#get-demographic)