Download OpenAPI specification:
N-INE クライアント向け公開API
カレンダーイベントを作成します。
終日イベントの場合の注意点:
isAllDay: trueの場合、startAtの時刻部分は自動的に00:00:00 UTCに正規化されますendAtは無視され、常にnullとして保存されます| miniappId required | string ミニアプリID |
| genreId required | string ジャンルID |
| title required | string イベントタイトル |
| url | string or null イベントURL |
| visibleFrom required | string <date-time> 表示開始日時(ISO 8601形式) |
| isAllDay required | boolean 終日イベントかどうか |
| startAt required | string <date-time> イベント開始日時(ISO 8601形式) 終日イベントの場合、時刻部分は自動的に00:00:00 UTCに正規化されます |
| endAt | string or null <date-time> イベント終了日時(ISO 8601形式) 終日イベントの場合、この値は無視され、常にnullとして保存されます |
{- "miniappId": "01HQZX1234567890ABCDEFGHIJ",
- "genreId": "01HQZY1234567890ABCDEFGHIJ",
- "title": "重要なイベント",
- "visibleFrom": "2025-12-01T00:00:00Z",
- "isAllDay": false,
- "startAt": "2025-12-25T10:00:00Z",
- "endAt": "2025-12-25T12:00:00Z"
}{- "success": true,
- "calendarEvent": {
- "id": "01HQZZ1234567890ABCDEFGHIJ",
- "miniappId": "01HQZX1234567890ABCDEFGHIJ",
- "genreId": "01HQZY1234567890ABCDEFGHIJ",
- "title": "重要なイベント",
- "visibleFrom": "2025-12-01T00:00:00.000Z",
- "isAllDay": false,
- "startAt": "2025-12-25T10:00:00.000Z",
- "endAt": "2025-12-25T12:00:00.000Z",
- "createdAt": "2025-11-30T05:30:00.000Z",
- "updatedAt": "2025-11-30T05:30:00.000Z"
}
}LINEマルチキャスト配信を作成します。
重要な制限事項:
targetingSettingsは必須ですtargetingSettings.includeTargetTypeがTAGSの場合、includeTagIdsは必須ですLINE account configuration not found)| crmAccountId required | string CRMアカウントID |
| isBroadcast required | boolean ブロードキャスト配信かどうか |
| scheduledAt | string or null <date-time> 配信予約日時(ISO 8601形式) |
| customAggregationUnit | string or null カスタム集計単位 |
object or null ブロードキャスト配信でない場合は必須 | |
| includeTagIds | Array of strings 配信対象タグID(includeTargetType='TAGS'の場合は必須) |
| excludeTagIds | Array of strings 除外対象タグID |
required | Array of objects [ 1 .. 5 ] items 配信するメッセージ(最低1件、最大5件) |
{- "crmAccountId": "01HQZW1234567890ABCDEFGHIJ",
- "isBroadcast": true,
- "messages": [
- {
- "messageType": "TEXT",
- "messageJson": {
- "type": "text",
- "text": "こんにちは!これはブロードキャストメッセージです。"
}
}
]
}{- "success": true,
- "multicast": {
- "id": "01HR001234567890ABCDEFGHIJ",
- "crmAccountId": "01HQZW1234567890ABCDEFGHIJ",
- "status": "PENDING",
- "isBroadcast": false,
- "scheduledAt": "2025-12-26T12:00:00.000Z",
- "customAggregationUnit": "campaign-2025-12",
- "createdAt": "2025-12-26T05:30:00.000Z",
- "updatedAt": "2025-12-26T05:30:00.000Z"
}
}全てのタグ情報を取得します。
| limit | integer >= 1 Default: 100 1ページあたりの取得件数。デフォルトは100件。 |
| offset | integer >= 0 Default: 0 取得開始位置。デフォルトは0(最初のアイテムから取得)。 |
{- "success": true,
- "tags": [
- {
- "id": "string",
- "crmAccountId": "string",
- "name": "string"
}
], - "totalCount": 100,
- "limit": 100,
- "offset": 0
}指定したLINEユーザーIDに紐づくタグ情報を取得します。
| lineUserId required | string タグ情報を取得する対象のLINEユーザーID。 |
| limit | integer >= 1 Default: 100 1ページあたりの取得件数。デフォルトは100件。 |
| offset | integer >= 0 Default: 0 取得開始位置。デフォルトは0(最初のアイテムから取得)。 |
{- "success": true,
- "lineUserId": "string",
- "tags": [
- {
- "id": "string",
- "crmAccountId": "string",
- "name": "string"
}
], - "totalCount": 100,
- "limit": 100,
- "offset": 0
}指定したミニアプリIDに紐づくジャンルグループとジャンルの階層構造を取得します。
リマインダーの通知がONの利用者に配信する場合:
利用タグ(usageTagId)でミニアプリの利用者に絞り込み、対象ジャンルの通知OFFタグ(tagId)で除外します。
初期値のまま通知がONの利用者も対象です。初期設定が必要なミニアプリでは、初期設定を完了した利用者、
または既存の通知設定により初期設定が不要な利用者が対象となり、初期設定が必要なまま未完了の利用者は対象外です。
初期設定が不要なミニアプリでは、起動した利用者が対象です。
利用開始前に、利用タグの設定と既存利用者の移行が完了していることをサービス担当者へ確認してください。
usageTagId が返されるだけでは移行完了を判断できません。
usageTagId または対象ジャンルの tagId が null の場合、この方法での配信は行わず、サービス担当者へ確認してください。
対象ジャンルを1件指定する場合、POST /multicasts に次の配信条件を設定します。
CRMアカウントID、メッセージ、配信予約日時などは、同APIの仕様に従って指定してください。
isBroadcast: falseincludeTagIds: usageTagId のみを含む配列excludeTagIds: 対象ジャンルの tagId のみを含む配列targetingSettings.includeTargetType: TAGStargetingSettings.includeTagConditionType: ANDtargetingSettings.excludeTagConditionType: OR利用タグはサービスが自動的に付与します。管理画面・一括操作・APIで利用者に付け外ししたり、タグ自体を削除したりしないでください。 配信対象の絞り込み専用のため、タグ付与をきっかけにするステップ配信やリッチメニューの切り替え条件には使用しないでください。
| miniappId required | string Example: 01HQZX1234567890ABCDEFGHIJ ジャンル情報を取得する対象のミニアプリID |
{- "success": true,
- "usageTagId": "01HQZUSER1234567890ABCDEFGH",
- "genreGroups": [
- {
- "id": "01HQZY1234567890ABCDEFGHIJ",
- "miniappId": "01HQZX1234567890ABCDEFGHIJ",
- "settingName": "カテゴリー",
- "description": "メインカテゴリーの設定",
- "order": 1,
- "genres": [
- {
- "id": "01HQZZ1234567890ABCDEFGHIJ",
- "genreGroupId": "01HQZY1234567890ABCDEFGHIJ",
- "tagId": "01HR001234567890ABCDEFGHIJ",
- "name": "アクション",
- "order": 1,
- "colorTheme": "BLUE"
}
]
}
]
}LINEユーザーにタグを付与します。
| lineUserId | string タグを削除するLINEユーザーのID。 ※lineUserIdまたはlineUserIdsのいずれか必須 |
| lineUserIds | Array of strings [ 1 .. 100 ] items タグを付与するLINEユーザーのIDのリスト。最大100件まで指定可能。 |
| tagIds required | Array of strings [ 1 .. 100 ] items LINEユーザーに付与するタグIDのリスト。最大100件まで指定可能。 |
{- "lineUserId": "U1234567890abcdef1234567890abcdef",
- "tagIds": [
- "01J7MMT6VRNWSP1F9VTARXW4GF",
- "01J7MMWJZXEA0HTZDN9DAZY4BZ"
]
}{- "success": true
}LINEユーザーに付与されているタグを削除します。
| lineUserId | string タグを削除するLINEユーザーのID。 ※lineUserIdまたはlineUserIdsのいずれか必須 |
| lineUserIds | Array of strings [ 1 .. 100 ] items タグを削除するLINEユーザーのIDのリスト。最大100件まで指定可能。 |
| tagIds required | Array of strings [ 1 .. 100 ] items LINEユーザーから削除するタグIDのリスト。最大100件まで指定可能。 |
{- "lineUserId": "U1234567890abcdef1234567890abcdef",
- "tagIds": [
- "01J7MMT6VRNWSP1F9VTARXW4GF",
- "01J7MMWJZXEA0HTZDN9DAZY4BZ"
]
}{- "success": true
}指定したtrackingアカウントの計測リンクを作成日時の降順(新しい順)で一括取得します。
削除済みの計測リンクは含まれません。 アナリティクスタグ・クリックタグ・リダイレクト条件などの付随設定は含まれません(リンク本体の項目のみ)。
全件取得するには、totalCountに達するまでoffsetを進めてください。
| trackingAccountId required | string non-empty Example: trackingAccountId=01HQZX1234567890ABCDEFGHIJ 取得対象のtrackingアカウントID |
| offset | integer [ 0 .. 999999999 ] Default: 0 取得開始位置。デフォルトは0(最初のアイテムから取得)。受理されるのは9桁までの非負整数で、範囲外は400になります。 |
| limit | integer [ 1 .. 100 ] Default: 100 1ページあたりの取得件数。デフォルトは100件、上限は100件。 |
{- "success": true,
- "data": {
- "totalCount": 120,
- "limit": 50,
- "offset": 0,
- "items": [
- {
- "id": "01HR0A1234567890ABCDEFGHIJ",
- "trackingAccountId": "01HQZX1234567890ABCDEFGHIJ",
- "categoryId": "01HQZY1234567890ABCDEFGHIJ",
- "description": "キャンペーンA",
- "isConversionEnabled": true,
- "openInLineApp": false,
- "expirationTime": null,
- "conversionLimit": null,
- "lineUserConversionLimit": null,
- "isLineUidEnabled": false,
- "lineUidParameterName": null,
- "isA8Enabled": false,
- "createdAt": "2026-07-30T10:00:00.000Z",
- "updatedAt": "2026-07-30T10:00:00.000Z"
}
]
}
}計測リンク(tracking links)を一括作成します(1リクエストあたり最大100件)。
各リンクはトランザクションで作成され、デフォルトのリダイレクト条件(priority=0)も自動生成されます。
リンクごとに独立して作成されるため、1件の失敗は他の件に影響しません(レスポンスに件別の成否が返ります)。
一意ルール(違反時は400で、messageに重複箇所が返ります):
analyticsTags: eventNameとtagIdの組み合わせはanalyticsTags配列内で一意clickTags: tagIdはclickTags配列内で一意defaultParameters: sourceParameterはdefaultParameters配列内で一意redirectConditions: priorityはredirectConditions配列内で一意(1以上・昇順に評価)redirectConditions[].tags: tagIdは同一redirectConditions要素のtags配列内で一意(要素をまたぐ重複は可)redirectConditions[].parameters: sourceParameterは同一redirectConditions要素のparameters配列内で一意(要素をまたぐ重複は可)| trackingAccountId required | string non-empty 作成先のtrackingアカウントID(全リンク共通) |
required | Array of objects [ 1 .. 100 ] items 作成するリンクの配列(1〜100件) |
{- "trackingAccountId": "01HQZX1234567890ABCDEFGHIJ",
- "links": [
- {
- "description": "キャンペーンB",
- "isConversionEnabled": false,
- "categoryId": "01HQZY1234567890ABCDEFGHIJ"
}
]
}{- "success": true,
- "data": {
- "total": 2,
- "succeeded": 2,
- "failed": 0,
- "results": [
- {
- "index": 0,
- "ok": true,
- "trackingLinkId": "01HR0A1234567890ABCDEFGHIJ",
- "error": "string"
}
]
}
}