CalPush for SNS 機能仕様書
CalPush 機能説明書

株式会社 AnchorZ
2021 年 9 ⽉ 10 ⽇
Copyright © 2018 AnchorZ Inc. All rights reserved.

株式会社 AnchorZ

⽬次
1

機能概要 ..........................................................................................................................................................................................................32

動作環境 ..........................................................................................................................................................................................................332.1

推奨する動作環境..................................................................................................................................................................................32.2

制限事項 .................................................................................................................................................................................................3

機能詳細 ..........................................................................................................................................................................................................43.1

連携形式 .................................................................................................................................................................................................4

3.1.1

機能連携時の遷移先....................................................................................................................................................................43.1.2

情報引き渡しメソッド ......................................................................................................................................................................4

3.1.3

パラメータ .........................................................................................................................................................................................4

3.1.4

パラメータの⻑さ...............................................................................................................................................................................4

3.1.5

パラメータエラー時の画⾯表⽰ .......................................................................................................................................................4

3.2

URL とパラメータ設定 ...............................................................................................................................................................................54

背景画像の設定 ..............................................................................................................................................................................................65

メンテナンスについて ...........................................................................................................................................................................................71

株式会社 AnchorZ

はじめに【本書について】
本書は、CalPush for SNS の機能について⽰した仕様書です。

【対象読者】
本機能を導⼊する関係者になります。

【仕様書内語句説明】「CalPush for SNS」（略称カルプッシュ）︓CalPush for SNS とは、予め設定されたイベント情報をカルプッシュにより簡単にユーザーのカレンダーに登録することができるアプリケーションを必要としない Web サービスのことです。
カレンダーへ登録︓イベント情報をユーザーのカレンダーに追加することです。

2株式会社 AnchorZ

1 機能概要CalPush for SNS とは、予め設定されたイベント情報をカルプッシュにより簡単にユーザーのカレンダーに登録することができるアプリケーションを必要としない Web サービスのことです。

2 動作環境2.1 推奨する動作環境
CalPush for SNS は通常のブラウザ、並びにアプリケーションの WebView 上で動作する、イベント情報をカレンダーへ登録する WEB サービスです。動作する OS と推奨ブラウザなどは下記になります。
表 2.1 カルプッシュの動作環境動作する OSスマートフォン
PC

推奨ブラウザ

iOS8 以降

SafariAndroid4.4 以降

ChromeWindows7 以降

Microsoft Edge, Chrome, Firefox

MacOS X10.8 以降

Safari, Chrome, Firefox
表 2.2 登録するカレンダー

ブラウザ
SNS（LINE、Facebook、Twitter）

カレンダー
デフォルトでは Google カレンダーに登録します。
※SNS のメニュー「Safari で開く」からカレンダー登録サイトを開く場合、iOS の標準カレンダーに登録します。

MacOS の Safari

MacOS の標準カレンダーに登録します。

iOS の Safari

iOS の標準カレンダーに登録します。

Edge 、Chrome

Google カレンダーに登録します。

その他のブラウザ

Google カレンダーに登録します。

※注１︓Google アカウントへのログイン
カレンダー登録を⾏う時に、Google アカウントへログインしていない場合、Google アカウントのログイン画⾯が表⽰され、Google アカウントへログインしてからイベントをカレンダーに登録する必要があります。⼀度ログインが完了すれば、以後（ログイン状態のままの場合）は不要となります。
※注２︓Google アカウントはないユーザーの場合
Google アカウントを持っていないユーザーが LINE の WebView で表⽰された CalPush for SNS のカレンダー登録確認画⾯を LINE の「Safari で開く」を選択して、Safari で開いた CalPush for SNS のカレンダー登録画⾯にてカレンダー登録を⾏い、イベントを iOS の標準カレンダーに登録します。

2.2 制限事項① ブラウザの「プライベートモード」などの制限によって、カルプッシュが動作しません。

3株式会社 AnchorZ

3 機能詳細3.1 連携形式
HTTPS でカレンダー登録情報を受け渡します。

機能連携時の遷移先

3.1.1

指定する URL は下記になります。
https://XXX.sns.calpush.addirect.promise-mail.com/rec.php※「XXX」は、AnchorZ が発⾏したアカウント ID を指定してください※rec.php を rec_t.php、rec_m.php を変更することによって、カレンダー登録画⾯のデザインを変更できます。

情報引き渡しメソッド

3.1.2

GET メソッドを利⽤して、カレンダー登録情報を受け渡します。

パラメータ

3.1.3

カレンダーに登録するイベント情報を GET メソッドのパラメータによって受け渡します。
パラメータ名
customer（※必須）説明

フォーマットCalPush for SNS のアカウント ID

AnchorZ から発⾏する ID 情報

title（※必須）

イベントのタイトルテキスト

start（※必須）

イベントの開始時間yyyymmddThhmm（半⾓英数字）
例︓20170718T0800

end

イベントの終了時間開始⽇時より過去の⽇時を設定することはできません。

yyyymmddThhmm（半⾓英数字）例︓
20170718T1200

location

再配達先の場所

テキスト

details

再配達の詳細情報

テキスト

注※① 上記パラメータの customer、title、start は必須設定項⽬になります。設定しない、また start と end は上記フォーマットと異なるフォーマットで設定される場合、カレンダーへの登録はできません。
② 例えば、2017 年 7 ⽉ 18 ⽇の 08:00〜12:00 に定義される場合、start と end のパラメータは下記のように指定して頂くことになります。
&start=20170718T0800&end=20170718T1200

3.1.4

パラメータの⻑さ

パラメータの⻑さは HTTP の GET メソッドで転送できるデータ量に準拠します。CalPush for SNS 側では制限しません。

3.1.5

パラメータエラー時の画⾯表⽰

必須情報が正しく設定されない場合、CalPush for SNS のカレンダー登録の確認画⾯にエラーメッセージが表⽰され、カレンダー登録情報が表⽰されません。各パラメータのエラーメッセージは下表になります。

4株式会社 AnchorZ
再配達⽇程情報の設定

画⾯に表⽰されるエラーメッセージ

顧客アカウント ID が設定されないカレンダーへ登録する情報はありません。

予定のタイトルが設定されない予定のタイトルが設定されていません。

予定の開始時間が設定されない予定開始時間が設定されていません。

予定の開始時間フォーマットは異なる

予定開始時間フォーマットは正しくありません。

予定の終了時間が設定されない予定終了時間が設定されていません。

予定の終了時間フォーマットは異なる

予定終了時間フォーマットは正しくありません。

備考

3.2 URL とパラメータ設定
URL に関するパラメータ設定は下記になります。
http://XXX.sns.calpush.addirect.promise-maill.com/rec.php?customer=XXX&title=タイトル&location=場所&start=開始時間&end=終了時間&details=内容
例︓<a href="https://XXX.sns.calpush.addirect.promise-mail.com/rec_t.php?customer=XXX&title=IoT セミナー&details=IoT の概念から実際のデバイスを使⽤して IoT 的な体験まで、IoT を⽀える基本的な技術及びその全体像を理解でき、⾝近な環境の中での IoT の可能性を深めることが出来るセミナーです。
&location=幕張メッセ&start=20180527T1800&end=20180527T1830" class="calpush_btn" target="_blank" style="text-decoration: none; color: white">カレンダー登録</a>パラメータ customer の値は弊社から発⾏したアカウント ID（別途でお渡します）を記載して頂きます。

5

株式会社 AnchorZ

4 背景画像の設定
CalPush for SNS のカレンダー登録確認画⾯の背景画像をお客様から頂く画像に設定することができます。

メニュー[for SNS]- [編集]ボタンを押下します。

確認⽤背景画像を設定します。

6

株式会社 AnchorZ

5 メンテナンスについてカルプッシュサーバーのメンテナンスは不定期になります。カルプッシュのサービスに影響しない場合、メンテナンスの内容によって、事前にお客様に通知しない場合があります。
また、緊急メンテナンスの場合、メンテナス後のご報告になる場合があります。

7