寝太郎の江戸風呂。ね！

Kauli の広告で収益が・・・

広告配信ネットワークのKauliで収益が出ていました。驚きだったので、久しぶりにブログを更新です。

数年前に、あるサイトでadsense の広告配信が停止されてしまいました。その代替えとして　Kauli　を埋め込んだのです。稼げるとは思わなかったので、サイトごと放置していました。

今日、急に思い立ち、２年ぶりぐらいに管理画面を見たら、予想外の金額が表示されていました。5000円に達した段階で振込んでもらえるのですが、口座情報を登録していなかったので溜まっていたのです。

期待していなかっただけに、ウレシイ。

放置していても、サイトを訪問してくれる人っているんですね。
それも予想外。

ブログを書いたり、サイトを作ったり、そのメンテナンスをしたりすることに興味がなくなっていたのですが、再開するのも悪くないかもと。

日本製BaaS：appiaries を使ってみる。その７

今回は、日本製のBaaS：appiaries（アピアリーズ）のユーザー情報の取得について述べます。ユーザー機能の使い方の第４弾です。

appiaries（アピアリーズ）の Profile API

appiaries（アピアリーズ）の Profile API では、次のURLにアクセスして、ユーザー情報を取得します。

https://api-profiles.appiaries.com/v1/[データストアID]/[アプリケーションid]

そして、パラメータに access_token やユーザーデータの取得範囲(scope)を含めてリクエストすると、JSON データが返ってきますので、これを用いてユーザーデータを処理します。

「appiary_1_O_1.js」でのユーザー情報取得

「appiary_1_O_1.js」では、ユーザー情報取得用のURLは、Appiary オブジェクトの「profile_url」プロパティに格納しています。ユーザー情報を取得する際には、getUser()メソッドを実行します。

Appiary.prototype.getUser = function(settings){
 if(this.user_token&&settings){
    settings.data              = settings.data||{};
    settings.data.access_token = this.user_token;
    Appiary.x(this.profile_url,settings);
 }
}

上記のコード中「Appiary.x()」とあるのは、XMLHttpRequest です。引数の「settings」の１つとして「onload」にコールバック関数を指定して、取得したユーザーデータを処理します。

「appiary_1_O_1.js」を用いたユーザーデータの処理

「お試しアピアリーズ・ユーザー投稿掲示板」では、Appiary オブジェクト生成時に、まずスコープとして"nickname"を指定しています。そして、コールバック関数で取得したニックネームをページに表示します。

appiary = new Appiary(
 '_sandbox',
 '[アプリID]',
 '[アプリトークン]',
 '[クライアントID]',
 'nickname'
);

login = document.querySelector('#login');

appiary.show_nickname=function(e){
  if(typeof e.target.responseText=='string'){
     var res = JSON.parse(e.target.responseText);
     login.innerHTML  = res.nickname;
  }
}

appiary.getUser({'onload':appiary.show_nickname});

取得したデータを「JSON.parse()」でJavaScriptオブジェクトに変換しているところがポイントですね。また、その引数が「e.target.responseText」となっているところは注意。「e.target」が元となる「XMLHttpRequest」オブジェクトです。

次回は、JSONデータの作成がappiaries（アピアリーズ）ユーザーに限定されている場合の処理について述べます。

日本製BaaS：appiaries を使ってみる。その７

今回は、日本製のBaaS：appiaries（アピアリーズ）のユーザー情報の取得について述べます。ユーザー機能の使い方の第４弾です。

appiaries（アピアリーズ）の Profile API

appiaries（アピアリーズ）の Profile API では、次のURLにアクセスして、ユーザー情報を取得します。

https://api-profiles.appiaries.com/v1/[データストアID]/[アプリケーションid]

「appiary_1_O_1.js」でのユーザー情報取得

Appiary.prototype.getUser = function(settings){
 if(this.user_token&&settings){
    settings.data              = settings.data||{};
    settings.data.access_token = this.user_token;
    Appiary.x(this.profile_url,settings);
 }
}

「appiary_1_O_1.js」を用いたユーザーデータの処理

appiary = new Appiary(
 '_sandbox',
 '[アプリID]',
 '[アプリトークン]',
 '[クライアントID]',
 'nickname'
);

login = document.querySelector('#login');

appiary.show_nickname=function(e){
  if(typeof e.target.responseText=='string'){
     var res = JSON.parse(e.target.responseText);
     login.innerHTML  = res.nickname;
  }
}

appiary.getUser({'onload':appiary.show_nickname});

次回は、JSONデータの作成がappiaries（アピアリーズ）ユーザーに限定されている場合の処理について述べます。

日本製BaaS：appiaries を使ってみる。その７

今回は、日本製のBaaS：appiaries（アピアリーズ）のユーザー情報の取得について述べます。ユーザー機能の使い方の第４弾です。

appiaries（アピアリーズ）の Profile API

appiaries（アピアリーズ）の Profile API では、次のURLにアクセスして、ユーザー情報を取得します。

https://api-profiles.appiaries.com/v1/[データストアID]/[アプリケーションid]

「appiary_1_O_1.js」でのユーザー情報取得

Appiary.prototype.getUser = function(settings){
 if(this.user_token&&settings){
    settings.data              = settings.data||{};
    settings.data.access_token = this.user_token;
    Appiary.x(this.profile_url,settings);
 }
}

「appiary_1_O_1.js」を用いたユーザーデータの処理

appiary = new Appiary(
 '_sandbox',
 '[アプリID]',
 '[アプリトークン]',
 '[クライアントID]',
 'nickname'
);

login = document.querySelector('#login');

appiary.show_nickname=function(e){
  if(typeof e.target.responseText=='string'){
     var res = JSON.parse(e.target.responseText);
     login.innerHTML  = res.nickname;
  }
}

appiary.getUser({'onload':appiary.show_nickname});

次回は、JSONデータの作成がappiaries（アピアリーズ）ユーザーに限定されている場合の処理について述べます。

日本製BaaS：appiaries を使ってみる。その６

今回は、日本製のBaaS：appiaries（アピアリーズ）のユーザー機能の使い方の第３弾です。

「日本製BaaS：appiaries を使ってみる。その４」では、次の５点をappiaries（アピアリーズ）のユーザー機能の要点としました。

コールバックURLを設定する。
JSONオブジェクトの作成権限を"SIGN IN"とする。
ページに認証ページへのリンクを設定する。
認証後の処理を記述する。
投稿ボタンを押したときの処理を記述する。

今回は、４番目「認証後の処理を記述する。」の項目についてです。

コールバックURLに付加されるパラメータ

appiaries（アピアリーズ）では、ユーザー認証後に指定したコールバックURLにリダイレクトする際、認証ユーザーの権限に関する情報をクエリストリングとして付加します。アプリケーション側は、これらのパラメータを用いて appiaries（アピアリーズ）内に作成したコレクション（ファイル・JSONデータ）にアクセスさせます。

Authorization Grantで認可コードを取得する場合は「code」がクエリストリングに含まれ、Implicit Grantでアクセストークンを取得する場合は次のパラメータが得られます。

access_token
store_token

access_token は、ユーザーに関する情報を取得するときに使用し、store_token は、JSONデータやファイルのコレクションにアクセスするときに使用します。

「appiary_1_O_1.js」でのトークンの処理

「appiary_1_O_1.js」では、クエリストリングを見て、次のように「access_token」と「store_token」を取得します。

if(location.hash) {
 if(location.hash.match(/[#&\?]access_token=([a-zA-Z0-9]+)/)){
  access_token = RegExp.$1;
 }
 if(location.hash.match(/[#&\?]store_token=([a-zA-Z0-9]+)/)){
  store_token = RegExp.$1;
 }
}

そして、それぞれ Appiary オブジェクトの「user_token」、「store_token」プロパティに値を格納します。

 this.user_token  = access_token;
 this.store_token = store_token;

Appiary オブジェクトに格納した値は、ユーザー情報やJSONデータの取得や作成の際に使用します。

次回はユーザー情報の取得について、その次はJSONデータの取得について述べます。

日本製BaaS：appiaries を使ってみる。その５

今回は、日本製のBaaS：appiaries（アピアリーズ）のユーザー機能の使い方の第２弾です。

前回の記事「日本製BaaS：appiaries を使ってみる。その４」では、次の４点をappiaries（アピアリーズ）のユーザー機能のポイントとし、基本設定部分について説明しました。

コールバックURLを設定する。
JSONオブジェクトの作成権限を"SIGN IN"とする。
ページに認証ページへのリンクを設定する。
認証後の処理を記述する。
投稿ボタンを押したときの処理を記述する。

今回は、このうち３番目の「ページに認証ページへのリンクを設定する。」の部分についての話です。

ページに認証ページへのリンクを設定する。

appiaries（アピアリーズ）の登録ユーザーに限って、投稿できるというような設定にした場合、ユーザーが登録ユーザーなのかを判断しなければなりません。このためには、一度、ユーザーにappiaries（アピアリーズ）の認証を受けてもら必要があります。このためには、WEBページにappiaries（アピアリーズ）の認証ページへのリンクを設定します。

認証ページのURL

appiaries（アピアリーズ）の認証ページのURLは、次のようなものです。

https://api-oauth.appiaries.com/v1/auth
?response_type=token
&scope=nickname
&client_id=[client_id]
&redirect_uri=[redirect_uri]

appiaries（アピアリーズ）の OAuth API を用います。クエリーパラメータの概要は次のとおり。

respnpse_type

Implicit Grantでアクセストークンを取得する場合は「token」。 Authorization Grantで認可コードを取得する場合は「code」。

scope

取得するユーザー属性の範囲。指定がない場合は「userid」とみなされます。「gender」、「picture」、「country」などの個別の属性や、やや範囲の広い「profile」などを指定できます。

参照：「appiariesユーザー属性と認可スコープ」

client_id

「アプリ詳細」＞「OAuth情報」の欄に表示されているアプリ固有の「クライアントID」です。

redirect_uri

「アプリ詳細」＞「OAuth情報」の欄に追加した「リダイレクトURL」です。認証後、このパラメータで指定したURLにリダイレクトされます。

その他のパラメータ

コールバックURIに引き継ぐデータは「state」パラメータを使います。

「OAuthによるサインイン処理」
「Implicit Grantでアクセストークンを取得する」

「appiary_1_O_1.js」を用いた認証ページへのリンク設定

「お試しアピアリーズ・ユーザー投稿掲示板」では、「お試しアピアリーズ appiary_1_0_1_js」を使って、appiaries（アピアリーズ）の認証ページへのリンクを設定しています。その手順の概略を示します。

HTMLでのリンク箇所

HTMLで、認証ページへのリンクを作成したい箇所にアンカーを設定しておきます。

<a id="login">Login</a>

Appiary オブジェクトの生成

「appiary.1.0.1.js」では、Appiary オブジェクトを作成して、そのプロパティ、メソッドを利用します。

  var appiary = new Appiary(
       '_sandbox',
       '[アプリID]',
       '[アプリトークン]',
       '[クライアントID]',
       '[スコープ]'
      );

ログイン有無の判定

Appiary オブジェクトでは、ユーザーがログインしている場合には、「store_token」に値が入るようにしています。したがって、この真偽によってユーザーがログインしているか判断できます。

var login = document.querySelector('#login');
if(appiary.store_token){
   //ログインしている場合の処理
   //略
}else{
   //ログインしてない場合の処理
    login.setAttribute(
　　　'href',
     appiary.oauth_url
     +'&redirect_uri='+location.href
    );
   //略
}

認証用ページへのリンクの生成

上記のスニペットのとおり、リンク用のアンカー要素の href属性に認証用ページのURIを設定すれば、認証用ページへのリンクができあがります。

Appiary オブジェクトでは、「oauth_url」プロパティに認証用ページへの基本的なURIが埋め込まれますので、通常、リクエストパラメータに「redirect_uri」を付加すれば充分です。

上記の例では、処理を簡単にするため、自分自身(location.href)に認証後リダイレクトするようにしています。なお、このページのURLは、基本設定「アプリ詳細」＞「OAuth情報」で「リダイレクトURL」として登録しておく必要があります。

全体の記述

認証用リンクの作り方は以上のとおりです。ただ、全体的な記述はわかりにくいかもしれません。そこで、「お試しアピアリーズ・ユーザー投稿掲示板」で使用しているコードを Gist に掲載しました。

Gist : appiary_sign_1_0_1.js

また、「appiary.1.0.1.js」の Gist は、「appiary.1.0.1.js」です。

日本製BaaS：appiaries を使ってみる。その４

今回は、日本製のBaaS：appiaries（アピアリーズ）のユーザー機能の使い方について簡単に説明します。

前回の記事「日本製BaaS：appiaries を使ってみる。その３」で紹介した「お試しアピアリーズ・ユーザー投稿掲示板」のページを作成したときのポイントを示しましょう。

要点は次の４点。

コールバックURLを設定する。
JSONオブジェクトの作成権限を"SIGN IN"とする。
ページに認証ページへのリンクを設定する。
認証後の処理を記述する。
投稿ボタンを押したときの処理を記述する。

コールバックURLを設定する。

「コールバックURL」は appiaries(アピアリーズ)がユーザー認証を行った後に戻ってくるページです。

appiaries(アピアリーズ)での「コールバックURL」の設定は、「アプリ詳細」の「OAuth編集」で行います。

「お試しアピアリーズ・ユーザー投稿掲示板」では、そのページのURL「https://api-datastore.appiaries.com/v1/bin/_sandbox/message/board/sign_1_0_1/_bin」自体を「コールバックURL」に設定しています。簡便だからです。

「コールバックURL」のページで、いったんアクセストークンなどのパラメータを保存する方法もありますが、少し複雑になります。

appiaries(アピアリーズ)での「コールバックURL」の設定は、３つまで設定できますが、複数設定した場合は、リクエスト時にどの「コールバックURL」を使用するのか指定する必要があります。

appiaries(アピアリーズ)のチュートリアル「OAuthによるサインイン処理」も参考にして下さい。

JSONオブジェクトの作成権限を"SIGN IN"とする。

appiaries(アピアリーズ)での権限レベルは、"ALL"、"SIGN IN"、”OWNER”、”ADMIN”の４種類です。「作成」、「参照」、「更新」、「削除」ごとにこれらのアクセス権限を設定します。

「お試しアピアリーズ・ユーザー投稿掲示板」では、投稿を appiaries(アピアリーズ)のユーザーに限定しますので、「作成」権限は"SIGN IN"です。また、投稿内容は公開しますので、「参照」権限は"ALL"です。なお、「更新」権限は”OWNER”、「削除」権限は”ADMIN”としています。

appiaries(アピアリーズ)でのアクセス権限の設定は、コレクション作成時には「datastore manager」＞「データベース」＞「コレクションの作成」で行います。

appiaries(アピアリーズ)のチュートリアル「ユーザーインターフェースの用意」も参考にして下さい。

appiaries(アピアリーズ)でユーザー機能を用いる場合の基本的な設定は、上記の「コールバックURLの設定」と「コレクションのアクセス権限」です。

これらの基本設定後の処理部分の記述については、次回説明します。

日本製BaaS：appiaries を使ってみる。その３

今回は、日本製のBaaS：appiaries（アピアリーズ）のユーザー機能を使ったページを紹介します。

サンプルとして作成したのが、「お試しアピアリーズ・ユーザー投稿掲示板」

前回の「日本製BaaS：appiaries を使ってみる。その２」では、投稿権限を制限していない「お試しアピアリーズ・誰かの落書き」を示しましたが、「お試しアピアリーズ・ユーザー投稿掲示板」は、投稿は appiaries（アピアリーズ）のユーザーに限定しています。

限定とはいっても、appiaries（アピアリーズ）への登録は簡単ですので、是非ユーザー登録して利用してみて下さい。また、閲覧は無制限ですので「お試しアピアリーズ・ユーザー投稿掲示板」を覗いて、雰囲気を掴んでもらうだけでもいいでしょう

今回はサンプルページの紹介のみ。次回、設定やコードについて、説明します。

日本製BaaS：appiaries を使ってみる。その２

前回の記事「日本製BaaS：appiaries を使ってみる。」では、 appiaries（アピアリーズ）をファイル置き場として利用する例のひとつに、「お試しアピアリーズ」を紹介しました。

広告なしの無料ホームページ代わりになりそうですが、それだけでは appiaries（アピアリーズ）がどういうものかを理解するには不十分です。やはりAPIを利用したいところです。

そこで作ってみたのが、「お試しアピアリーズ・誰かの落書き」。 appiaries の JSONデータAPI を利用しています。以下、そこで使用している JSONデータAPI とは、どんなものか眺めてみましょう。

JSONデータの取得

単独オブジェクトの取得

appiaries の JSONデータAPI では、オブジェクトのID("_id")を指定して、そのオブジェクトのデータを取得できます。

体験版のデータストア("_sandbox")で、"message"というアプリの"all"というコレクションでIDが"1be51bd3774b562422"のものを取得するURLは次のとおりです。

https://api-datastore.appiaries.com/v1/dat/_sandbox/message/all/1be51bd3774b562422

次のようなJSONデータが返ってきます。

{
 "_id":"1be51bd3774b562422",
 "text":"何、食べた？",
 "_cby":"_anonymous_",
 "_uby":"_anonymous_",
 "_cts":1375702358174,
 "_uts":1375702358174
}

プロパティ名がアンダーバー付のものは、appiaries で自動的に付加されるものです。ただし,"_id"は、データ登録時に指定することができます。コレクション内でユニークなものにすればよいので、連番にすることも可能です。 "_cby"、"_uby"は、それぞれデータ登録時、変更時のユーザー。 "_cts"、"_uts"は、データ登録時、変更時のタイムスタンプ（UTC通算秒）です。

複数オブジェクトの取得（検索）

appiaries の JSONデータAPI では、検索条件を付加して複数のオブジェクトのデータを取得できます。

https://api-datastore.appiaries.com/v1/dat/_sandbox/message/all/-;_uts.lt.1375702358174n;

検索条件の最初のハイフン"-"は、オブジェクトIDを指定するのではなく、検索することを示しているようです。

次のようなJSONデータが返ってきます。

{ "_total":3, "_objs":[ {"_id":"f668f6604628647042",(略)}, {"_id":"95cfe19116d83c79b2",(略)}, {"_id":"10433c901af7f83a15",(略)} ], "_start":1, "_end":3, "_prev":false, "_next":false }

アクセス権限

"all"というコレクションは参照権限は"ALL"に設定していますので、すべてのデータを誰でも取得できます。アクセス権限は、"ALL"のほかに、"SIGN IN"というものがあり、この場合にはサインインしているユーザーに限定されます。また、"OWNER"という設定すると、そのオブジェクトのオーナーに限られます。 APIからアクセスできないもの、すなわちダッシュボード画面でのみ操作できるものは"ADMIN"という設定をします。

日本製BaaS：appiaries を使ってみる。

日本製のBaaS：appiaries（アピアリーズ）を使って、「お試しアピアリーズ」というページを作ってみた。

とりあえず、HTMLやCSS、JavaScriptなどのファイルを置けることがわかりました。体験版では20MBという容量の制限があるものの、無料ホームページ代わりにも使えることがわかったのは収穫。このあとは、JSONデータやユーザー関係のAPIを利用して、もうちょっと高度な利用方法を考えたいと思いました。

アプリを開発する際には、サーバーやデータベースの構築などのバックエンド作業が面倒。その煩雑さを解消してくれるのが、「Backend as a Service」こと「BaaS」ということのようです。モバイル・アプリで利用する共通の基本的な機能もあらかじめ用意しているので、アプリ本体の開発に集中できるようになることがメリット。

海外の BaaS(Backend as a Service)には、Parse, StackMob, Kinvey, Buddy, CloudMine, QuickBlox, Appcelerator Cloud Services（旧、Cocoafish）,Buddy, Pankia, などがあるとのこと。ただし、語学が堪能ではない自分には、ちょっと敷居が高い。そんな中、日本語のドキュメントがある appiaries はありがたい。機能はまだ多くなくシンプル。それがかえってわかりやすさにつながりそう。 appiaries で雰囲気に慣れてから、海外の BaaS にトライするほうがベターと考えました。

詳しいことは、appiaries のドキュメントを読めば、だいたいわかると思います。このブログでは、「お試しアピアリーズ」を作成した際に気付いたことなどを記していきましょう。アプリの種類は、JavaScript アプリです。これで基本をつかめば、PHPなどを用いたWEBアプリやandroidアプリなどにも応用できるでしょう。

寝太郎の江戸風呂。ね！

Kauli の広告で収益が・・・

日本製BaaS：appiaries を使ってみる。その７

appiaries（アピアリーズ）の Profile API

「appiary_1_O_1.js」でのユーザー情報取得

「appiary_1_O_1.js」を用いたユーザーデータの処理

関連ページ

関連リンク

日本製BaaS：appiaries を使ってみる。その７

appiaries（アピアリーズ）の Profile API

「appiary_1_O_1.js」でのユーザー情報取得

「appiary_1_O_1.js」を用いたユーザーデータの処理

関連ページ

関連リンク

日本製BaaS：appiaries を使ってみる。その７

appiaries（アピアリーズ）の Profile API

「appiary_1_O_1.js」でのユーザー情報取得

「appiary_1_O_1.js」を用いたユーザーデータの処理

関連ページ

関連リンク

日本製BaaS：appiaries を使ってみる。その６

コールバックURLに付加されるパラメータ

「appiary_1_O_1.js」でのトークンの処理

関連ページ

関連リンク

日本製BaaS：appiaries を使ってみる。その５

ページに認証ページへのリンクを設定する。

認証ページのURL

respnpse_type

scope

client_id

redirect_uri

その他のパラメータ

「OAuthによるサインイン処理」 「Implicit Grantでアクセストークンを取得する」

「appiary_1_O_1.js」を用いた認証ページへのリンク設定

HTMLでのリンク箇所

Appiary オブジェクトの生成

ログイン有無の判定

認証用ページへのリンクの生成

全体の記述

関連ページ

関連リンク

日本製BaaS：appiaries を使ってみる。その４

コールバックURLを設定する。

JSONオブジェクトの作成権限を"SIGN IN"とする。

関連ページ

関連リンク

日本製BaaS：appiaries を使ってみる。その３

関連ページ

関連リンク

日本製BaaS：appiaries を使ってみる。その２

JSONデータの取得

単独オブジェクトの取得

複数オブジェクトの取得（検索）

アクセス権限

日本製BaaS：appiaries を使ってみる。

「OAuthによるサインイン処理」
「Implicit Grantでアクセストークンを取得する」