こんにちは!
Yuki (@yukibnb) です。
前回はBeds24のAPI Key (APIキー) を発行する方法を紹介しました。
www.yukibnb.com
今回はBeds24のProp Key (Propキー)と呼ばれるキーを発行する方法を紹介します。
Propキーとは?
APIキーとPropキーの違い
Propキーの"Prop"はPropertyの"Prop"です。
前回紹介したAPIキーはひとつのBeds24のアカウントに対してひとつ発行しますが、PropキーはひとつのPropertyに対してひとつ発行します。
そのためBeds24で複数のPropertyを管理されている方はPropertyの数だけPropキーを発行できます。
Propキーを使用する機会
Beds24が提供しているAPIを通じて、Beds24の様々な情報を取得したりBeds24の情報を編集したりできます。
上記URLにてBeds24で使用できるAPIが公開されています。(英語ページです)
"getBookingsCSV"は予約情報のCSVを取得する操作、"getRatesCSV"はRatesのCSVを取得する操作、というように"getXXXX"・"setXXXX"・"putXXXX"という様々な操作をAPIを通じて行うことができます。
それぞれの操作を行うには異なるプログラムを書く必要があります。
あるプログラムではAPIキーだけ必要だったり、別のプログラムではAPIキーとPropキーの両方が必要だったりします。
そのためPropキーが不要な場面もありますが、予め発行しておくと後々必要になった時にスムーズにプログラムを記述できて便利です。
Beds24のPropキーを発行する方法
ではBeds24のPropキーを発行する方法を見ていきましょう。
APIキーと同じく簡単に発行できます。
1. [Settings]を開く
Beds24にログインし、画面上部の[Settings]をクリックしてください。
2. [Access]を開く
画面左の[Properties] → [Access]をクリックしてください。
3. Propertyを選択する
PropキーはPropertyごとに発行する必要があります。
そのためPropキーを発行したいPropertyを選択してください。
※Propertyがもともと一つしかない場合、上記画像のようなPropertyを選択するボックスは表示されません。
4. Propキーを入力する
[propKey]の入力ボックスに16~64桁のランダムな英数字をご自身で決めて入力してください。
ここに入力したものがPropキーとなります。
決めにくい場合は以下のようなパスワードジェネレーターを使用すると便利です。
1password.com
PropキーはみなさんのBeds24アカウントのPropertyにアクセスするためのパスワードのようなものです。他人やウェブ上に公開しないようにご注意ください。
なお、設定後にこのページに来ればいつでもPropキーを確認できます。
5. [Save]をクリックして発行完了
[Save]をクリックすると入力したPropキーが保存され、無事発行完了です!
Propertyの数だけ(3)~(5)を繰り返す
Beds24で複数のPropertyを管理されている方は(3)~(5)を繰り返し、すべてのPropertyのPropキーを作成してください。
同じPropキーを複数のPropertyに使用しないでください。
例えばPropertyを5つ管理している場合、発行する5つのPropキーは全て異なる文字列にしてください。
まとめ
今回はBeds24のPropキーを発行する方法を紹介しました。
前回記事で紹介したAPIキーと同じくPropキーはAPI連携をする上でとても重要です。
これでBeds24側での準備が整いましたので、次回からはAPI連携をするためのプログラムのお話に入りたいと思います。
細かいことはわからなくてもコピペで実現できるように紹介しますのでご安心ください!
【2020/2/25更新】
API連携シリーズ、次回記事を公開しました。