SDKリファレンスマニュアルAndroid版Ver2.2.0第３版PESPLE S O F T  W  A  R  E
BaaS@kuraza SDK for Android の利用方法このページでは、BaaS@rakuza SDK for Androidをお客様の環境で利用するための設定を行います。
手順書作成環境
当手順書は以下の環境で作成しています。お客様の環境のバージョンによっては設定方法が異なる可能性があります。 ◆ JDK1.7 ◆  Android Studio 2.1 ◆  OS X Yosemite
Android Studio
ダウンロードページからダウンロードし、任意のディレクトリに展開します。 Android Developer Tool (ADT) Android  Studio起動後、Android  Studioのウィザードに従い、必要なADTをインストールします。
最新のSDKはGitHubにて配布しています。クリック後に表示されるポップアップウィンドウの「Download ZIP」をクリックします。お使いのPCにZIP形式でSDKがダウンロードされますダウンロードしたSDKのzipファイルを、お使いのPC上の任意のディレクトリに展開します。 & Baas@rakuza SDKリファレンスマニュアル for Android Ver2.2.0提供ファイルの構成は以下になります。 baasatrakuza-sdk-android Hdocs Hjavadoc.zip l l └BaaSAtRakuzaSDKリファレンスマニュアル_Android_x.pdf └libs └BaaSAtRakuzaSDK_for_Android.jar
プロジェクトへの設定
BaaS@rakuza SDKをプロジェクトに追加する画面左にあるパッケージ・エクスプローラー内のBaaSAtRakuzaを使用したいプロジェクトのlibsフォルダ内にダウンロードしたjarファイルをコピーします。 & BaaS@rakuza SDKリファレンスマニュアル for Android Ver2.2.0
AndroidManifest.xmlに権限の追加をする
作成したプロジェクト内にあるAndroidManifest.xmlに以下のパーミッションを追加します。 (追加場所は<application>タグの直前に記述してください。) <uses-permission android name="android.permission.INTERNET"/> <uses permission android name="android.permission.BLUETOOTH_ADMIN" /> <uses permission android name="android.permission.BLUETOOTH" /> <uses-permission android-name="android.permission.INTERNET" />以上でBaaS@rakuza を利用する環境が整いました。 APIを利用するための初期化処理BaaS@rakuza SDK for Androidを利用する際には、 RKZClientクラスのシングルトンインスタンスを利用します。以下の処理をアプリ起動時におこなうことで、BaaS@rakuzaのAPIを利用することが出来るようになります。 & Baas@rakuza SDKリファレンスマニュアル for Android Ver2.2.0
RKZClientクラスの初期化
ここでは、BaaS@rakuza SDK for Androidを使用するうえ重要なRKZClientクラスの初期化を説明します。 BaaS@rakuza  SDK for AndroidではRKZClientクラスの初期化は最初に呼び出されるActivityで初期化する事を推奨していますが、どの場所で初期化を行っても構いません。作成したプロジェクト内にある以下のソースを変更していきます。 src /自分で定義したパッケージ/ MainActivity.java ● MainActivityを開き、onCreateメソッド内のsetContentView(R.layout.activity_main);の下に以下のコードを追加します。 ] SDKリファレンスマニュアル for Android Ver2.2.0また、ソースコード上部にimport文として下記の記述を追加してください。(すでに同じ記述がある場合は追加しないでください。)上記プログラムを実行後、端末画面下に"RKZClientクラスの初期化に成功しました。"と数秒間だけ表示されればOKです。もし、表示されない場合は再度配布したテナントキーの確認を行ってください。またAndroid Studio上でエラーが出ている場合は以下の確認を行ってください。 ● libsフォルダ内に指定のjarファイルを追加する。 import文の記述が間違っている（記述されていない） . ● onCreateメソッド内に初期化用の記述が間違っている（記述されていない）みBaaS@rakuza SDKリファレンスマニュアル for Android Ver2.2.0データ管理機能を利用するデータ管理機能は、BaaS@rakuza標準オブジェクト以外の情報を管理する基本的な仕組みを提供します。このページでは、データ管理機能を利用する実装例を紹介します。
複数レコード取得する（キー未指定）
複数レコード取得の場合、検索条件とソート条件を指定することができます。指定可能な条件についてはデータ管理>複数レコード取得する（キー未指定）>検索条件についてデータ管理>複数レコード取得する（キー未指定）>ソート条件についてを参照してください。複数レコード取得（キー未指定）はRKZClientのgetDataListで行います。お気に入り情報登録（addFavoriteToObjectData）したデータを取得する場合は、拡張属性を指定します。取得に成功した場合は、取得したレコードのコードをソート順にアラートで表示します。取得に失敗した場合はエラー内容をアラートで表示します。 // 検索条件データを作成する//オプジェクト内のcodeの値が“9999”か“0005”か“0032”か“9493”のデータを取得する。 List<RKZApiSearchCondition> searchCondition = new ArrayList<RKZApiSearchCondition>( ); List<String> targetBeacon = new ArrayList<String> ( ): //取得したい位を追加していくtargetBeacon. add ( "9999" ) : targetBeacon. add ( "0005" ) : targetBeacon. add ( "0032" ) : targetBeacon. add ( "9493" ) : //複数指定の物を探し出す命令を指すRKZApiSearchCondition. INを指定し、 // 検索を掛ける項目名を第２引数で指定する。 // 最後に数値を指定する。 searchCondition.add( new RKZApiSearchCondition( RKZApiSearchCondition.IN, "code", targets ): & BaaS@rakuza SDKリファレンスマニュアル for Android Ver2.2.0 // ソート条件データを作成する//オプジェクト内の名前を降順でソートする場合List<RKZApiSortCondition> sortCondition = new ArrayList<RKZApiSortCondition>( ); // RKZApiSortConditionクラスのコンストラクタで//第1引数に降順を示すRKZAp i SortCondition. DESCを指定し、 // 第２引数にソートを掛ける項目名のnameを指定する。 sortCondition.add ( new RKZApiSortCondition ( RKZApiSortCondition.DESC, "name" )); // 検索条件、ソート条件を指定しないで取得する//取得したいオプジェクトIDは必須項目ですString objectId = "object1": //検索条件、ソート条件を使用する場合は、 // 換索条件を第２引数に、   ソート条件を第３引数に指定してください。 RKZCIient.getInstance().getDataList( objectId, searchCondition, sortCondition, new OnGetRKZObjectDataListLiten er() { @Override public void onGetRKZObjectDataList(List<RKZObjectData> dataList, RKZResponseStatus rkzStatus ) { if ( rkzStatus.isSuccess( ) ) { for ( RKZObjectData rKZObjectData : dataList ) { Log.d( "OnGetRKZObjectDataListener", rKZObjectData.getCode( ) ); Log.d( "OnGetRKZObjectDataListener", rKZObjectData.getName( ) ); Log.d( "OnGetRKZObjectDataListener", rKZObjectData.getShortName( ) ); Log.d( "OnGetRKZObjectDataListener", Integer.toString(rKZObjectData.getSortNo( ) ); Log.d( "OnGetRKZObjectDataListener", rKZObjectData.getAttributesValue("code"); } } else { Log.d( "OnGetRKZObjectDataListListener", rkzStatus.getStatusCode( ) ); Log.d( "OnGetRKZObjectDataListListener", rkzStatus.getMessage( ) ); l } } & BaaS@rakuza SDKリファレンスマニュアル for Android Ver2.2.0
検索条件について
BaaS@rakuza SDKでは複数レコード取得時に検索条件を指定する事ができます。 ※一部指定できないものもあります。検索条件に指定可能なタイプは以下になります。
SDKリファレンスマニュアル for Android Ver2.2.0
ソート条件について
BaaS@rakuza SDKでは複数レコード取得時にソート条件を指定することもできます。 ※一部指定できないものもあります。ソート条件に設定可能なタイプは以下になります。
お気に入りの並び替え条件が指定できるメソッドは、 ● getDataList ● getPaginateDataListの２メソッドになります。
1レコード取得する（キー指定）
レコード取得（キー指定）はRKZClientの getData で行います。データはRKZObjectDataとして返却されます。取得に成功した場合はコールバックメソッドの第１引数に検索結果のデータが渡されます。取得失敗の場合は第２引数のisSuccessメソッドがfalseを返します。キ一を指定してレコードを取得するには// //　オプジェクトIDとデータのコード[code]が必要になります。 String  objectId = "object1": = ″0001″: String code RKZCIient.getData( objectId, code, new OnGetRKZObjectDataListener( ) { @Override public void onGetRKZObjectData( RKZObjectData objectData, RKZResponseStatus rkzSatus ) { if ( rkzStatus.isSuccess( ) ) { //成功時Log.d( "OnGetRKZObjectDataListener", objectData.getCode( ) ); & BaaS@rakuza SDKリファレンスマニュアル for Android Ver2.2.0 Log.d( "OnGetRKZObjectDataListener", objectData.getName( ) ); Log.d( "OnGetRKZObjectDataListener", objectData.getShortName( ) ); Log.d( "OnGetRKZObjectDataListener", Integer.toString( objectData.getSortNo( ) ) ); Log.d( "OnGetRKZObjectDataListener", objectData,getAttributesValue("code"); } else { Log.d( "OnGetRKZObjectDataListener", rkzStatus.getStatusCode( ) ); Log.d( "OnGetRKZObjectDataListener", rkzStatus, getMessage( ) ); } }
オブジェクトデータを登録する
データオブジェクトへのデータ登録はRKZClientの addData で行います。登録に成功したか失敗したかを取得することができます。登録に成功した場合はコールバックメソッドの第１引数に"1001"が渡されます。登録に失敗した場合はコールバックメソッドの第２引数のisSuccessメソッドがfalseを返します。 // RKZObjectDataを作成し、豊順に最低限必要なデータを設定しますRKZObjectData rKZData = new RKZObjectData( ): rKZData. setName( “名称” ); rKZData.setObjectId( “objectOO1” ); RKZCIient.addData( rKZData, new OnAddRKZObjectDataListener( ) { @Override public void onAddRKZObjectData( String status, RKZResponseStatus rkzStatus ) { if ( rkzStatus.isSuccess( ) ) { //  豊像に成功した際の処理を配述Log.d( "OnAddRKZObjectDataListener", "登録成功" ); } else { Log.d( "OnAddRKZObjectDataListener", rkzStatus.getStatusCode( ) ); Log.d( "OnAddRKZObjectDataListener", rkzStatus, getMessage( ) ); } } & BaaS@rakuza SDKリファレンスマニュアル for Android Ver2.2.0
データオブジェクトのデータ編集はRKZClientの editData で行います。編集に成功したか失敗したかを取得することができます。編集に成功した場合はコールバックメソッドの第１引数に文字列"1001"が渡されます。編集に失敗した場合はコールバックメソッドの第２引数のisSuccessメソッドがfalseを返します。 // RKZObjectDataを作成し、編集に必要なデータを設定しますRKZObjectData rKZData = new RKZObjectData( ): rKZData. setName("名称"); rKZData.setObjectId("object1" ); rKZData. setCode ("0001" ) : RKZCIient.editData( rKZData, new OnEditRKZObjectDataListaner( ) { public void onEditRKZObjectData( String status,  RKZResponseStatus rkzStatus ) { if ( rkzStatus.isSuccess( ) ) { // データ編集に成功した際の処理を配述Log.d( "OnEditRKZObjectDataListener", "編集成功" ); } else { Log.d( "OnEditRKZObjectDataListener", rkzStatus, getStatusCode( ) ); Log.d( "OnEditRKZObjectDataListener", rkzStatus.getMessage( ) ); l J SDKリファレンスマニュアル for Android Ver2.2.0
オブジェクトのデータ削除はRKZClientのdeleteDataで行います。編集に成功したか失敗したかを取得することができます。削除に成功した場合はコールバックメソッドの第１引数に文字列"1001"が渡されます。削除に失敗した場合はコールバックメソッドの第２引数のisSuccessメソッドがfalseを返します。複数レコード削除の場合、検索条件を指定することができます。指定可能な条件についてはデータ管理>複数レコード取得する（キー未指定）>検索条件についてを参照してください。 String objectId = "objectO1":    //オプジェクトIDを指定します//第２引数にはRKZApiSearchConditionを指定する。 RKZCIient.getInstance().deleteData(objectId, null, new OnDeleteDataListener() { public void onDeleteData(final Integer deleteCount, final RKZResponseStatus rkzResponseStatus) { //復帰位を設定するif ( rkzStatus.isSuccess( ) ) { //データ編集に成功した際の処理を配述Log.d( "OnDeleteDataDataListener", "縄集成功" ); } else { Log.d( "OnDeleteDataListener", rkzStatus.getStatusCode( ) ); Log.d( "OnDeleteDataListener", rkzStatus, getMessage( ) ); } l });
階層付きレコードを複数取得する（キー未指定）
階層付きレコード取得（キー未指定）はRKClientのgetDataListWithRelationObjectsで行います。データはRKZObjectDataとして返却されます。引数の検索条件とソート条件はnullを指定しています。検索条件、ソート条件の設定方法についてはデータ管理>複数レコード取得する（キー未指定）>検索条件についてデータ管理>複数レコード取得する（キー未指定）>ソート条件について& BaaS@rakuza SDKリファレンスマニュアル for Android Ver2.2.0を参照してください。取得に成功した場合はコールバックメソッドの第１引数に検索結果のデータが渡されます。取得失敗の場合は第２引数のisSuccessメソッドがfalseを返します。 String objectId = "objectO1": Integer treeCount = 2: // 検索対象のオブジェクトIDを指定します// ２簡易分取得しますRKZCIient.getDataListWithRelationObjects( objectId, treeCount, null, null, new OnGetRKZObjectDataListListener ( ) { @Override public void onGetRKZObjectDataList(List<RKZObjectData> dataList, RKZResponseStatus rkzStatus ) { if ( rkzStatus.isSuccess( ) ) { for ( RKZObjectData rKZObjectData : dataList ) { Log.d( "OnGetRKZObjectDataListener", rKZObjectData.getCode( ) ); Log.d( "OnGetRKZObjectDataListener", rKZObjectData.getName( ) ); Log.d( "OnGetRKZObjectDataListener", rKZObjectData.getShortName( ) ); Log.d( "OnGetRKZObjectDataListener", Integer.toString(rKZObjectData.getSortNo( ) ); Log.d( "OnGetRKZObjectDataListener", rKZObjectData.getAttributesValue("code"); ] } else { Log.d( "OnGetRKZObjectDataListListener", rkzStatus.getStatusCode( ) ); Log.d( "OnGetRKZObjectDataListListener", rkzStatus.getMessage( ) ); J } l
ページング機能を利用してレコードを取得する
データオブジェクトからレコードを取得するときに、ページング機能を利用すると◆取得するレコードの開始位置◆取得するレコードの件数といったレコードを分割して取得するための条件を指定することができます。取得結果には条件に該当したレコードのほかに、 •指定された条件に該当したデータの総件数も取得することができます。ページングを利用してレコードを取得する場合は、 RKZClientのgetPaginateDataListで行います。取得結果はRKZPagingDataとして復帰されます。 & BaaS@rakuza SDKリファレンスマニュアル for Android Ver2.2.0引数の検索条件とソート条件はnullを指定しています。検索条件、ソート条件の設定方法についてはデータ管理>複数レコード取得する（キー未指定）>検索条件についてデータ管理>複数レコード取得する（キー未指定）>ソート条件についてを参照してください。お気に入り情報登録（addFavoriteToObjectData）したデータを取得する場合は、拡張属性を指定します。拡張属性はnullを指定しています。取得に成功した場合はコールバックメソッドの第１引数に検索結果のデータが渡されます。取得失敗の場合は第２引数のisSuccessメソッドがfalseを返します。 String objectId = "objectO1": Integer limit = 10; Integer offset = 10:
//データの取得位置を指定しますRKZClient.getInstance().getPaginateDataList( objectId, limit, offset, null, null, null, new OnGetPagingDataLis tener ( ) { @Override public void onGetPagingData(final PagingData pagingData, final RKZResponseStatus rkzResponseStatus) { if ( rkzStatus.isSuccess( ) ) { for ( RKZObjectData rKZObjectData : dataList ) { Log.d( " OnGetPagingDataListener ", pagingData.getLimit() ); Log.d( " OnGetPagingDataListener ", pagingData.getOffset() ): Log.d( " OnGetPagingDataListener ", pagingData.getResultCnt() ); Log.d( " OnGetPagingDataListener ", pagingData.getData() ); l } else { Log.d( "OnGetRKZObjectDataListListener", rkzStatus.getStatusCode( ) ); Log.d( "OnGetRKZObjectDataListListener", rkzStatus.getMessage( ) ); l } J
位置情報を利用してレコードを取得する
位置情報を利用してデータオブジェクトを取得することができます。 ※注意点位置情報を利用してデータを抽出する場合、取得対象となるデータオブジェクトにspotオブジェクトが関連付けされている必要があります。 spotオブジェクトが関連付けされているフィールドに対して検索を実行します。 & BaaS@rakuza SDKリファレンスマニュアル for Android Ver2.2.0位置情報を利用して取得するには、 RKZClientのgetDataWithLocation（1レコード取得）か、 getDataListWithLocation（複数レコード取得)で行います。 spotFieldNameは未指定でも取得可能です。データオブジェクトに複数のspotオ※注意点ブジェクトを関連付けている場合、検索する対象のフィールドを特定する場合にspotFieldNameを指定します。取得に成功した場合はコールバックメソッドの第１引数に検索結果のデータが渡されます。取得失敗の場合は第２引数のisSuccessメソッドがfalseを返します。
RKZCIient.getDataWithLocation( objectId, code, location, null, new OnGetRKZObjectDataListener( ) { @Override public void onGetRKZObjectData(RKZObjectData objectData, RKZResponseStatus rkzResponseStatus) { if ( rkzStatus.isSuccess( ) ) { //成功時Log.d( "OnGetRKZObjectDataListener", objectData.getCode( ) ); Log.d( "OnGetRKZObjectDataListener", objectData.getName( ) ); Log.d( "OnGetRKZObjectDataListener", objectData.getShortName( ) ); Log.d( "OnGetRKZObjectDataListener", Integer.toString( objectData.getSortNo( ) ) ); Log.d( "OnGetRKZObjectDataListener", objectData.getAttributesValue("code"); } else { Log.d( "OnGetRKZObjectDataListListener", rkzStatus.getStatusCode( ) ); Log.d( "OnGetRKZObjectDataListListener", rkzStatus.getMessage( ) ); l J J
データオブジェクトのフィールド定義を取得する
フィールド定義情報を取得するには、 RKZClientのgetFieldDataListで行います。取得に成功した場合はコールバックメソッドの第１引数に検索結果のデータが渡されます。取得失敗の場合は第２引数のisSuccessメソッドがfalseを返します。 String objectId = "objectO1": Boolean visibleOnly = true:
RKZCIient.getFieldDataList( objectId, visibleOnly, new OnGetRKZFieldDataListListener() { @Override public void onGetRKZFieldDataList(List<RKZFieldData> datas, RKZResponseStatus rkzResponseStatus) { if ( rkzStatus.isSuccess( ) ) { //成功時Log.d( " OnGetRKZFieldDataListListener ", datas.getFieldName( ) ); Log.d( " OnGetRKZFieldDataListListener ", datas.getLabelStr( ) ); } else { Log.d( "OnGetRKZObjectDataListListener", rkzStatus.getStatusCode( ) ); Log.d( "OnGetRKZObjectDataListListener", rkzStatus.getMessage( ) ); l } l
お気に入り登録されたオブジェクトを取得する
登録されたオブジェクトデータに対してお気に入り登録を行った場合、登録されたお気に入り情報を条件に指定して抽出することができます。お気に入りの登録についてはお気に入り管理>お気に入り情報を登録するを参照してください。お気に入り登録されたオブジェクトを検索する場合は、 ● getDataList ● getPaginateDataListのメソッドを利用します。お気に入り登録情報を含めてデータを取得する場合は、 extensionAttributes引数を指定します。お気に入り情報を抽出する際に指定できる
取得に成功した場合はコールバックメソッドの第１引数に検索結果のデータが渡されます。 & BaaS@rakuza SDKリファレンスマニュアル for Android Ver2.2.0取得失敗の場合は第２引数のisSuccessメソッドがfalseを返します。 String objectId = "object1": List<RKZSearchCondition> searchConditions = new ArrayList<>() ; List<RKZSortCondition> sortConditions = new ArrayList<> () : // extensionAttribute引数を設定ObjectDataExtensionAttribute extensionAttribute = new ObjectDataExtensionAttribute(); extensionAttribute . setUserAccessToken (USER_ACCESS_TOKEN) . setShowFavorite(true) //お気に入り情報を復帰する. setShowFavoriteSummary (true):  //お気に入り件数を復帰するRKZCIient.getInstance().getDataList(objectId, searchConditions, sortConditions, extensionAttribute, new OnGetRKZObjectDataListListener() { @SuppressLint ("LongLogTag") @Override public void onGetRKZObjectDataList(List<RKZObjectData> rKZObjectDataList, RKZResponseStatus rKZResponseSta tus） { if (rKZResponseStatus.isSuccess()) { for (RKZObjectData rKZObjectData : rKZObjectDataList) { Log.d( "OnGetRKZObjectDataListener", (String) ((Map) rKZObjectData.getAttributesValue("sys_fav orite")).get("is_favorite")); Log.d( "OnGetRKZObjectDataListener", (String) ((Map) rKZObjectData.getAttributesValue("sys_fav orite")).get("favorite_date") ) : l } else { Log.d( "OnGetRKZObjectDataListener", rKZResponseStatus, getStatusCode() ); Log.d( "OnGetRKZObjectDataListener", rKZResponseStatus, getMessage() ); } } }); SDKリファレンスマニュアル for Android Ver2.2.0ユーザー管理機能を利用するユーザー管理機能は、アプリケーションでユーザーの情報を管理する基本的な仕組みを提供します。このページでは、ユーザー管理機能を利用する実装例を紹介します。
ユーザー情報を登録する
ユーザー情報登録はRKZClientの registUser で行います。登録に成功した場合はコールバックリスナの第１引数に"1001"が渡されます。登録に失敗した場合はコールバックリスナの第２引数のisSuccessメソッドがfalseを返します。ユーザー登録に成功した場合、userData に"user_access_token"が格納されて返却されます。 "user_access_token"はユーザーに関連する情報を取得・変更する際にユーザーを特定するキーとして必ず必要となりますので、ユーザーを扱うアプリケーションを開発する場合は、 "user_access_token"をアプリケーションの永続データ領域に保存しておくように実装して下さい。 //   豊像するユーザー情報を作成しますUser  user  = new User ( ) : //  豊像したい情報を設定していきます//名前の設定user.setFirstName( "ピープル" ); user. setLastName( "太郎" ); //  ユーザー登録APIの実行(RKZCI ient変数は初期化済みとする) RKZCIient.registUser ( user, new OnGetUserListener ( ) { @Override public void onGetUser( User user,  RKZResponseStatus rkzStatus ) { if ( rkzStatus.isSuccess( ) ) { // ユーザー豊像成功//  成功時には引数のuser内に登録内容が格前されて返却されますLog.d( "OnGetUserListener", user.getFirstName( ) ); Log.d( "OnGetUserListener", user.getLastName( ) ); Log.d( "OnGetUserListener", user.getUserAccessToken( ) ): } else { // ユーザー豊像失敗// 失敗時にはrkzStatusにエラ一情報が格納されて還却されます& BaaS@rakuza SDKリファレンスマニュアル for Android Ver2.2.0 Log.d( "OnGetUserListener", rkzStatus.getStatusCode( ) ); Log.d( "OnGetUserListener", rkzStatus.getMessage( ) ); ] }
ユーザー情報を取得する
ユーザー情報取得はRKZClientの getUser で行います。ユーザー情報取得に成功した場合はコールバックリスナの第１引数にユーザーデータが渡されます。取得に失敗した場合はコールバックリスナの第２引数のisSuccessメソッドがfalseを返します。 //ユーザアクセストークンが必要String  userAccessToken  = "userAccessTokenXXXX": RKZCIient.getUser ( userAccessToken, new OnGetUserListener( ) { public void onGetUser( User user, RKZResponseStaus rkzStatus ) { Log.d( "OnGetUserListener", user.getUserFirstName( ) ); Log.d( "OnGetUserListener", user.getUserLastName( ) ); Log.d( "OnGetUserListener", user.getMailAddress1( ) ); Log.d( "OnGetUserListener", user.getTelNo1( ) ); } else { //ユーザー情報取得失敗時Log.d( "OnGetUserListener", rkzStatus.getStatusCode( ) ); Log.d( "OnGetUserListener", rkzStatus.getMessage( ) ); J } SDKリファレンスマニュアル for Android Ver2.2.0
ユーザー編集をメソッドから行う場合は、RKZClientのeditUserで行います。ユーザー編集に成功した場合はコールバックリスナの第１引数にユーザー情報を渡します。失敗した場合はコールバックリスナの第２引数のisSuccessメソッドがfalseを返します。 Log.d("OnEditUserListener",rKZResponseStatus.getMessage()); });機種変更認証コードを発行する（必須項目のみ指定）機種変更認証コード発行(必須項目のみ指定)はRKZClientのregistModelChangeCodeで行います。機種変更認証コード発行に成功した場合は取得した認証コードと有効期限が復帰されます。失敗した場合はコールバックリスナの第２引数のisSuccessメソッドがfalseを返します。 // 機種変更を行うための觀藍コードを生成します。 //ユーザーアクセストークンが必須です。 String userAccessToken = “userAccessTokenXXXX” : RKZCIient. registModelChangeCode(userAccessToken, new OnRegistModelChangeCodeListener () { public void onRegistModelChangeCode(final String modelChangeCode, final Calendar limitDate, final RKZResponseStatus rkzResponseStatus) { if (rkzResponseStatus.isSuccess() { Log.d( “OnRegistModelChangeCodeListener”,modelChangeCode); //生成された腰藍コード& BaaS@rakuza SDKリファレンスマニュアル for Android Ver2.2.0 Log.d( “OnRegistModelChangeCodeListener”,limitDate); //生成された最藍コードの有効期限} else { //生成失敗Log.d("OnEditUserListener",rKZResponseStatus.getStatusCode()); Log.d("OnEditUserListener",rKZResponseStatus.getMessage()); l } });
機種変更コードを発行する（必須項目＋任意項目指定）
機種変更認証コード発行(必須項目+任意項目指定)はRKZClientのregistModelChangeCodeで行います。機種変更認証コード発行に成功した場合は取得した認証コードと有効期限が復帰されます。失敗した場合はコールバックリスナの第２引数のisSuccessメソッドがfalseを返します。 // 機種変更を行うための壓藍コードを生成します。 //ユーザーアクセストークンが必須です。 String userAccessToken = “userAccessTokenXXXX” : //任意項目(パスワード、桁数、有効期限)の設定を行います。 String password = “ユーザーが指定したパスワード” :  //醍醐コード＋αのセキュリティ対策にパスワードを酸定// 発行される霊藍コードの桁象Integer limitCount = 8: Integer limit = 60 * 24: // 隠藍コードの有効期限(単位：分) RKZCIient.registModelChangeCode(userAccessToken, password, limitCount, limit. new  OnRegistModelChangeCodeListener () { êOverride public void onRegistModelChangeCode(final String modelChangeCode, final Calendar limitDate, final RKZResponseStatus rkzResponseStatus) { if (rkzResponseStatus.isSuccess() { Log.d( “OnRegistModelChangeCodeListener”,modelChangeCode):  //生成された罷藍コードLog.d( “OnRegistModelChangeCodeListener”, I imitDate) : //生成された最低コードの有効期限} else { //生成失敗Log.d("OnEditUserListener",rKZResponseStatus.getStatusCode()); Log.d("OnEditUserListener",rKZResponseStatus.getMessage()); %BaaS@rakuza SDKリファレンスマニュアル for Android Ver2.2.0 } l });
機種変更認証(必須項目のみ指定)はRKZClientのauthModelChangeCodeで行います。機種変更認証に成功した場合は取得したユーザー情報のユーザーNoとuserAccessTokenをアラートで表示します。失敗した場合はコールバックリスナの第２引数のisSuccessメソッドがfalseを返します。 // 機種変更服藍コード発行で発行された服藍コードを指定final String modelChangeCode = “認証コード” : RKZCIient. authModelChange(modelChangeCode, new OnAuthModelChangeListener() { public void onAuthModelChange(final User user, final RKZResponseStatus rkzResponseStatus) { Log.d("OnAuthModelChangeListener", user.getUserAccessToken()); } else { //最紅失敗Log. d ("OnAuthModelChangeListener", rKZResponseStatus. getStatusCode()) ; Log. d ("OnAuthModelChangeListener", rKZResponseStatus, getMessage()) ; } l });
機種変更認証をする（必須項目＋任意項目指定）
機種変更認証(必須項目+任意項目指定)はRKZClientのauthModelChangeCodeで行います。機種変更認証に成功した場合は取得したユーザー情報のユーザーNoとuserAccessTokenをアラートで表示します。失敗した場合はコールバックリスナの第２引数のisSuccessメソッドがfalseを返します。 // 機種変更服藍コード発行で発行された服藍コードを指定final String modelChangeCode = “認証コード” : & BaaS@rakuza SDKリファレンスマニュアル for Android Ver2.2.0 final String password = “ユーザーが発行した認証パスワード” : RKZCIient. authModelChange(modelChangeCode, password, new OnAuthModelChangeListener() { @Override public void onAuthModelChange(final User user, final RKZResponseStatus rkzResponseStatus) { if (rkzResponseStatus.isSuccess()) { //最低成功Log.d("OnAuthModelChangeListener", user.getUserAccessToken()); } else { //最重失敗Log. d ("OnAuthModelChangeListener", rKZResponseStatus. getStatusCode()) : Log. d ("OnAuthModelChangeListener", rKZResponseStatus. getMessage()) ; } J });
ユーザーアクセストークンを更新する(1フェーズコミット)
ユーザーアクセストークン更新(1フェーズコミット)はRKZClientのupdateUserAccessTokenで行います。 1フェーズコミットを利用した場合、Success時に復帰されるuserAccessTokenがすぐに利用可能な状態となり、旧userAccessTokenは利用不可になります。取得に成功した場合はコールバックメソッドの第１引数に検索結果のデータが渡されます。取得失敗の場合は第２引数のisSuccessメソッドがfalseを返します。 // 使用中のユーザーアクセストークンを指定String userAccessTokene = "ユーザーアクセストークン": RKZCIient.updateUserAccessToken(userAccessToken, new OnUpdateUserAccessTokenListener() { public void onUpdateUserAccessToken(String newUserAccessToken, RKZResponseStatus rkzResponseStatus) { if (rkzResponseStatus.isSuccess()) { Log.d("OnUpdateUserAccessTokenListener",newUserAccessToken); } else { //更新失敗Log.d("OnUpdateUserAccessTokenListener",rKZResponseStatus.getStatusCode()); Log.d("OnUpdateUserAccessTokenListener",rKZResponseStatus.getMessage()); } J });
ユーザーアクセストークン更新(2フェーズコミット)はRKZClientのbeginUpdateUserAccessTokenで新しいユーザーアクセストークンを仮発行して、 commitUpdateUserAccessTokenで確定します。 2フェーズコミットを利用した場合、beginUpdateUserAccessTokenにて発行した新しいユーザーアクセストークンはcommitUpdateUserAccessTokenを呼び出すまで利用できません。取得に成功した場合はコールバックメソッドの第１引数に検索結果のデータが渡されます。取得失敗の場合は第２引数のisSuccessメソッドがfalseを返します。 // 使用中のユーザーアクセストークンを指定String userAccessTokene = "ユーザーアクセストークン"; RKZCIient.beginUpdateUserAccessToken(userAccessToken, new OnUpdateUserAccessTokenListener() { @Override public void onUpdateUserAccessToken(String newUserAccessToken, RKZResponseStatus rkzResponseStatus) { if (rkzResponseStatus.isSuccess()) { //仮発行成功RKZCIient.commitUpdateUserAccessToken(userAccessToken, new OnUpdateUserAccessTokenListener() { @Override public void onUpdateUserAccessToken(String newUserAccessToken, RKZResponseStatus rkzResponseStatus) { if (rkzResponseStatus.isSuccess()) { //更新成功Log.d("OnUpdateUserAccessTokenListener",newUserAccessToken); } else { //更新失敗Log.d("OnUpdateUserAccessTokenListener",rKZResponseStatus.getStatusCode()); Log.d("OnUpdateUserAccessTokenListener",rKZResponseStatus.getMessage()); J J }); } else { //仮筆録失敗Log.d("OnUpdateUserAccessTokenListener",rKZResponseStatus.getStatusCode()); Log.d("OnUpdateUserAccessTokenListener",rKZResponseStatus.getMessage()); } J });みBaaS@rakuza SDKリファレンスマニュアル for Android Ver2.2.0 SDKリファレンスマニュアル for Android Ver2.2.0
コンタクト管理機能は、アプリケーションでコンタクト情報を管理する基本的な仕組みを提供します。このページでは、コンタクト管理機能を利用する実装例を紹介します。
コンタクト情報の一覧を取得する
コンタクトを取得する場合はRKZClientのgetContactListで行います。コンタクトの取得に成功した場合はコールバックリスナの第１引数にコンタクトデータが渡されます。失敗した場合はコールバックリスナの第２引数のisSuccessメソッドがfalseを返します。引数の検索条件とソート条件はnullを指定しています。検索条件、ソート条件の設定方法についてはデータ管理>複数レコード取得する（キー未指定）>検索条件についてデータ管理>複数レコード取得する（キー未指定）>ソート条件についてを参照してください。 //コンタクト種別取得では、必須項目はユーザーアクセストークンです。 //第２引数に鎮東条件、第３引数にソート条件を設定できます。 RKZCIient.getContactList("APP0001", null, null, new OnGetContactListListener() { @Override public void onGetContactHistoryList(List<Contact> contactList, RKZResponseStatus rKZResponseStatus) { if (rKZResponseStatus. isSuccess ()) { for (Contact contact : contactList) { Log.d("OnGetContactListListener", contact.getContactNo()); Log.d("OnGetContactListListener",CalendarUtil,getDateText(contact,getContactDate())); Log. d("OnGetContactListListener", contact. getContactClassCd()) : Log.d("OnGetContactListListener", contact. getContactMethodClassCd()); Log.d("OnGetContactListListener", contact. getContactItemNo()); Log. d("OnGetContactListListener", contact. getEntryNo()) : Log. d("OnGetContactListListener", contact. getStatusCd()) : Log. d ("OnGetContactListListener", contact. getPlaceCd ()) : Log.d("OnGetContactListListener", StringUtil.parseString(contact.getPoint())); Log. d("OnGetContactListListener", contact. getRemarks()) : Log.d("OnGetContactListListener", contact.getDepositNo());みBaaS@rakuza SDKリファレンスマニュアル for Android Ver2.2.0 Log. d("OnGetContactListListener", contact. getBeaconId()) : Log.d("OnGetContactListListener", contact. getBeaconSpotCd()) : Log.d("OnGetContactListListener", StringUtil.parseString(contact.getRssi())); Log.d("OnGetContactListListener", contact. getStampRallyCd()) : Log. d("OnGetContactListListener", contact. getCouponCd()) : Log.d("OnGetContactListListener", StringUtil.parseString(contact.getQuantity())); Log.d("OnGetContactListListener", contact. getStampRallyCd()) : Log.d("OnGetContactListListener", contact.getStampRallySpotCd()); l } J });
コンタクト情報を登録する
コンタクト情報を登録する場合はRKZClientのaddContactで行います。コンタクト情報の登録に成功した場合はコールバックリスナの第１引数にコンタクトデータが渡されます。登録に失敗した場合はコールバックリスナの第２引数のisSuccessメソッドがfalseを返します。 //コンタクトデータサンプルを作成Contact contactHistory = new Contact (): contact. setContactClassCd("0005") : contact. setContactMethodClassCd("") : contact. setBeaconId("1"); Map<String, Object> attributes = new HashMap<String, Object>(); attributes.put("testfield", "test"); contactHistory. setAttributes (attributes) : //コンタクト最嚴豊順において必須項目はユーザーアクセストークンです。 RKZCIient.addContact ("APP0001", contact, new OnAddContactListener() { @Override public void onAddContact(RKZResponseStatus rKZResponseStatus) { if (rKZResponseStatus. isSuccess ()) { Log.d("OnAddContactListener","登録完了"); } else { Log.d("OnAddContactListener",rKZResponseStatus, getStatusCode()) : Log.d("OnAddContactListener",rKZResponseStatus, getMessage()); J } }); SDKリファレンスマニュアル for Android Ver2.2.0お知らせ管理機能を利用するお知らせ管理機能は、アプリケーションでお知らせ情報を管理する基本的な仕組みを提供します。このページでは、お知らせ管理機能を利用する実装例を紹介します。すべてのお知らせ情報を取得する（キー未指定）すべてのお知らせ情報を取得する場合は、RKZClientのgetNewsListで行います。お知らせ取得に成功した場合はコールバックリスナの第１引数にお知らせ情報が渡されます。取得に失敗した場合は第２引数のisSuccessメソッドがfalseを返します。引数の検索条件とソート条件はnullを指定しています。検索条件、ソート条件の設定方法についてはデータ管理>複数レコード取得する（キー未指定）>検索条件についてデータ管理>複数レコード取得する（キー未指定）>ソート条件についてを参照してください。お気に入り情報（お知らせ）を取得する場合は、拡張属性を指定します。引数の拡張属性はnullを指定しています。 //お知らせ取得（公開中のみ）（お知らせ未指定）には最大取得件数が必要になります//最大１０件の取得Integer limit = Integer.valueOf( "10" ); //第２、３引数にはRKZApiSearchConditionとRKZApiSortConditionを指定する。 // 第４引数には NewsExtensionAttributeを指定する（お気に入り情報取得時）。 RKZCIient.getInstance().getNewsList( limit, null, null, null, new OnGetReleasedNewsListListener( ) { @Override public void onGetReleasedNewsListListener (List<News> newsList, RKZResponseStatus rkzStatus ) { if( rkzStatus.isSuccess( ) ) { for ( News news : newsList ) { //お知らせ情報を出力Log.d( "OnGetReleasedNewsListListener" , news.getTitle( ) ); Log.d( "OnGetReleasedNewsListListener" , news.getDescription( ) ); } } else { Log.d( "OnGetReleasedNewsListListener" , rkzStatus.getStatusCode( ) ); Copyright© people software. All Rights Reserved & BaaS@rakuza SDKリファレンスマニュアル for Android Ver2.2.0 Log.d( "OnGetReleasedNewsListListener" , rkzStatus.getMessage( ) ); l ] }
公開中のお知らせ情報を取得する（キー未指定）
公開中のお知らせ情報を取得する場合は、RKZClientのgetReleasedNewsListで行います。お知らせ取得に成功した場合はコールバックリスナの第１引数にお知らせ情報が渡されます。お知らせ取得に失敗した場合は第２引数のisSuccessメソッドがfalseを返します。引数の検索条件とソート条件はnullを指定しています。検索条件、ソート条件の設定方法についてはデータ管理>複数レコード取得する（キー未指定）>検索条件についてデータ管理>複数レコード取得する（キー未指定）>ソート条件についてを参照してください。お気に入り情報を取得する場合は、拡張属性を指定します。引数の拡張属性はnullを指定しています。 //お知らせ取得（公開中のみ）（お知らせ未指定）には最大取得件数が必要になります//最大１０件の取得Integer limit = Integer.valueOf( "10" ); //第２、３引敷にはRKZApiSearchConditionとRKZApiSortConditionを指定する。 //第４引数にはNewsExtensionAttributeを指定する。 RKZCIient.getInstance().getReleasedNewsList( limit, null, null, null, new OnGetNewsListener( ) { @Override public void onGetNewsList( List<News> newsList, RKZResponseStatus rkzStatus ) { if( rkzStatus.isSuccess( ) ) { for ( News news : newsList ) { //お知らせ情報を出力Log.d( "OnGetNewsListListener" , news.getTitle( ) ); Log.d( "OnGetNewsListListener" , news.getDescription( ) ); } } else { Log.d( "OnGetNewsListListener" , rkzStatus.getStatusCode( ) ); Log.d( "OnGetNewsListListener" , rkzStatus.getMessage( ) ); l l & BaaS@rakuza SDKリファレンスマニュアル for Android Ver2.2.0
お知らせ情報を１レコード取得する場合は、RKZClientのgetNewsで行います。 readNewsで登録したお知らせ既読情報は、取得不可です。 ※注意点お知らせ取得に成功した場合はコールバックリスナの第１引数にお知らせ情報が渡されます。失敗した場合は第２引数のisSuccessメソッドがfalseを返します。 //お知らせIDを指定しますString  newsId = "1"; RKZCIient.getInstance().getNews( newsId, new OnGetNewsListener( ) { public void onGetNews( News news, RKZResponseStatus rkzStatus ) { if( rkzStatus.isSuccess( ) ) { //お知らせ情報を出力Log.d( "OnGetNewsListener" , news.getTitle( ) ); Log.d( "OnGetNewsListener" , news.getDescription( ) ); } else { Log.d( "OnGetNewsListener" , rkzStatus.getStatusCode( ) ); Log.d( "OnGetNewsListener" , rkzStatus.getMessage( ) ); J } Jお知らせ既読情報を１レコード取得する（キー指定）お知らせ既読情報を１レコード取得する場合では、RKZClientのgetNewsReadHistoryで行います。 ※注意点readNewsで登録したお知らせ既読情報は、取得不可です。お知らせ既読情報取得に成功した場合はコールバックリスナの第１引数にお知らせ既読情報が渡されます。失敗した場合はコールバックリスナの第２引数のisSuccessメソッドがfalseを返します。 //お知らせ既読情報取得（お知らせ指定）には//お知らせIDとユーザアクセストークンが必要になります。 String  newsld = "1": String  userAccessToken  = "userAccessTokenXXXX": & BaaS@rakuza SDKリファレンスマニュアル for Android Ver2.2.0 RKZCIient.getInstance().getNewsReadHistory ( newsId, userAccessToken, new OnGetNewsReadHistoryListener( ) { @Override public void onGetNewsReadHistory( NewsReadHistory newsReadHistory , RKZResponseStatus rkzStatus ) { if ( rkzStatus.isSuccess( ) ) { //お知らせ既読情報を出力Log.d( "OnGetNewsReadHistoryListener ", newsReadHistory.getNewsId( ) ); Log.d( "OnGetNewsReadHistoryListener" , newsReadHistory.getReadDate( ) ); } else { Log.d( "OnGetNewsReadHistoryListener" , rkzStatus.getStatusCode( ) ); Log.d( "OnGetNewsReadHistoryListener" , rkzStatus.getMessage( ) ); l } J
お知らせ既読情報を複数レコード取得する（キー未指定）
お知らせ既読情報を複数レコード取得する場合は、RKZClientのgetNewsReadHistoryListで行います。 ※注意点readNewsで登録したお知らせ既読情報は、取得不可です。お知らせ既読情報取得（お知らせ未指定）の取得に成功した場合は、コールバックリスナの第１引数にお知らせ既読情報データが渡されます。取得に失敗した場合はコールバックリスナの第２引数のisSuccessメソッドがfalseを返します。 //お知らせ既読情報取得（お知らせ未指定）にはユーザアクセストークンが必要になりますString  userAccessToken  = "userAccessTokenXXXX": RKZCIient.getInstance().getNewsReadHistoryList ( userAccessToken, new OnGetNewsReadHistoryListListener( ) { @Override public void onGetNewsReadHistoryList( List<NewsReadHistory> newsReadHistoryList, RKZResponseStatus rkzStatus ) { if ( rkzStatus.isSuccess( ) ) { for ( NewsReadHistory newsReadHistory : newsReadHistoryList ) { //お知らせ既能情報を出力Log.d( "OnGetNewsReadHistoryListLitener ",newsReadHistory.getNewsId( ) ); Log.d( "OnGetNewsReadHistoryListListener", newsReadHistory.getReadDate( ) ); } else { Log.d( "OnGetNewsReadHistoryListLitener" , rkzStatus.getStatusCode( ) ); Log.d( "OnGetNewsReadHistoryListLitener" , rkzStatus.getMessage( ) ); l } SDKリファレンスマニュアル for Android Ver2.2.0
BaaS@rakuzaの管理者機能にて特定のユーザーに向けたお知らせ配信を行ったとき、引数に渡したユーザーアクセストークンに該当するユーザーに該当するお知らせのみを取得することができます。セグメント配信されたお知らせ情報を取得する場合は、RKZClientのgetSegmentNewsListで行います。コールバックリスナの第１引数にお知らせ既読情報データが渡されます。取得に失敗した場合はコールバックリスナの第２引数のisSuccessメソッドがfalseを返します。お気に入り情報を取得する場合は、拡張属性を指定します。 //ユーザーアクセストークンを指定しますString userAccessToken = "userAccessTokenXXXX": //取得するお知らせの件数を指定しますInteger limit = 10; Boolean onlyMatch = true; //自分に関係するお知らせのみを取得するように指定しますRKZCIient.getInstance().getSegmentNewsList( limit, userAccessToken, onlyMatch, null, null, null, new OnGetNews ListListener () { @Override public void onGetNewsList(List<News> list, RKZResponseStatus rkzResponseStatus) { if ( rkzStatus.isSuccess( ) ) { for ( NewsData data : list ) { //お知らせ既読情報を出力Log.d( " OnGetNewsListListener ", data.getNewsId( ) ); } else { Log.d( "OnGetNewsReadHistoryListLitener" , rkzStatus.getStatusCode( ) ); Log.d( "OnGetNewsReadHistoryListLitener" , rkzStatus.getMessage( ) ); l J
お知らせ既読情報を登録する
お知らせ既読情報を登録する場合は、RKZClientのregistNewsReadHistoryで行います。 registNewsReadHistoryで登録したお知らせ既読情報は、getNewsReadHistory、 ※注意点または、getNewsReadHistoryListのみで取得可能です。 & BaaS@rakuza SDKリファレンスマニュアル for Android Ver2.2.0お知らせ既読情報登録に成功した場合はコールバックリスナの第１引数に"1001"が渡されます。失敗した場合はコールバックリスナの第２引数のisSuccessメソッドがfalseを返します。 //お知らせ既読情報登録にはユーザアクセスト一クンとお知らせIDと読んだ既読日時が必要です。 String  userAccessToken  = "userAccessTokenXXXX": String  newsId = "1"; //既読日時Calendar today = Calendar.getInstance() : RKZCIient.getInstance().registNewsReadHistory( newsId, userAccessToken, today, new OnRegistNewsReadHistoryList ener ( ) { @Override public void onRegistNewsReadHistory ( String statusCode, RKZResponseStatus rkzStatus ) { if ( rkzStatus.isSuccess( ) ) { Log.d( "OnRegistNewsReadHistoryListener" , "登録成功" ); } else { Log.d( "OnRegistNewsReadHistoryListener" , rkzStatus.getStatusCode( ) ); Log.d( "OnRegistNewsReadHistoryListener" , rkzStatus.getMessage( ) ); J }
お知らせ既読情報を登録する
お知らせ既読情報を登録する場合は、RKZClientのreadNewsで行います。 readNewsで登録したお知らせ既読情報は、 getNewsReadHistory 、または、 getNewsReadHistoryListでは取得不可です。 getNewslist 、 getSegmentNewsList 、 getReleasedNewsList、getReleasedSegmentNewsListで取得します。 getNewsList、getReleasedNewsList、getSegmentNewsList、getReleasedSegmentNewsListに、 extensionAttributeパラメータを指定することで、未読既読が取得できます。 extensionAttributeにはユーザーアクセストークンを設定します。 NewsExtensionAttribute extensionAttribute = new NewsExtensionAttribute(); extetnsionAttribute.setUserAccessToken("userAccessTokenXXXX");お知らせ既読情報登録に成功した場合はコールバックリスナの第１引数に"1001"が渡されます。失敗した場合はコールバックリスナの第２引数のisSuccessメソッドがfalseを返します。 //お知らせ既読情報登録にはユーザアクセストークンとお知らせIDが必要です。 userAccessToken  = "userAccessTokenXXXX": String newsId = "1": String & BaaS@rakuza SDKリファレンスマニュアル for Android Ver2.2.0 RKZCIient.getInstance().readNews( newsId, userAccessToken, new OnReadNewsListener ( ) { @Override public void onReadNews ( String statusCode, RKZResponseStatus rkzStatus ) { if ( rkzStatus.isSuccess( ) ) { Log.d( "OnReadNewsListener" , "登録成功" ); } else { Log.d( "OnReadNewsListener" , rkzStatus.getStatusCode( ) ); Log.d( "OnReadNewsListener" , rkzStatus.getMessage( ) ); ] } } SDKリファレンスマニュアル for Android Ver2.2.0プッシュ通知管理機能を利用するプッシュ通知管理機能は、アプリケーションを利用するユーザーへプッシュ通知する基本的な仕組みを提供します。このページでは、プッシュ通知管理機能を利用する実装例を紹介します。
ユーザーのプッシュデバイストークンを登録する
プッシュデバイストークンの設定はRKZClientのregistPushDeviceTokenで行います。登録に成功した場合はアラートで「登録に成功しました。」と表示します。登録に失敗した場合はエラー内容をアラートで表示します。 //ユーザーアクセストークンは必須です。 final String userAccessToken = "userAccessTokenXXXX": // デパイストークンは0Sから取得します。 final String deviceToken = "OSから通知されたデバイストークン": RKZCIient.getInstance().registPushDeviceToken(userAccessToken, deviceToken. new OnRegistPushDeviceTokenListener () { @Override public void onRegistPushDeviceToken(final String statusCode, RKZResponseStatus rkzResponseStatus) { if ( rkzStatus.isSuccess( ) ) { Log.d( "OnRegistPushDeviceTokenListener" , "登録成功" ); } else { Log.d( "OnRegistPushDeviceTokenListener" , rkzStatus.getStatusCode( ) ); Log.d( "OnRegistPushDeviceTokenListener" , rkzStatus.getMessage( ) ); J l });ゲーヘプッシュ通知するユーザーへのプッシュ通知は、管理機能[プッシュ通知管理]カテゴリの各機能から行うことができCopyright© people software. All Rights Reserved & BaaS@rakuza SDKリファレンスマニュアル for Android Ver2.2.0ます。管理機能[プッシュ通知管理]->[プッシュ通知環境設定]機能より、AndroidのAPIキーを設定して利用してください。アプリケーションでプッシュ通知を受信する端末でのプッシュ通知の受け取り方法については、Androidの受信の仕方を参照してください。ユーザーのプッシュデバイストークンを削除するプッシュデバイストークンの削除はRKZClientのclearPushDeviceTokenで行います。登録に成功した場合はアラートで「登録に成功しました。」と表示します。登録に失敗した場合はエラー内容をアラートで表示します。 //ユーザーアクセストークンは必須です。 final String userAccessToken = "userAccessTokenXXXX": RKZCIient.getInstance().clearPushDeviceToken(userAccessToken, new OnClearPushDeviceTokenListener() { public void onClearPushDeviceToken(final String statusCode, RKZResponseStatus rkzResponseStatus) { if ( rkzStatus.isSuccess( ) ) { Log.d( "OnClearPushDeviceTokenListener" , "登録成功" ); Log.d( "OnClearPushDeviceTokenListener" , rkzStatus.getStatusCode( ) ); Log.d( "OnClearPushDeviceTokenListener" , rkzStatus.getMessage( ) ); J J }); SDKリファレンスマニュアル for Android Ver2.2.0
ビーコン管理機能は、アプリケーションでビーコン情報を管理する基本的な仕組みを提供します。このページでは、ビーコン管理機能を利用する実装例を紹介します。
ビーコンを複数レコード取得する
ビーコンを複数取得する場合は、RKZClientのgetBeaconListで行います。ビーコン取得に成功した場合はコールバックリスナの第１引数にビーコンデータが渡されます。取得に失敗した場合はコールバックリスナの第２引数のisSuccessメソッドがfalseを返します。引数の検索条件とソート条件はnullを指定しています。検索条件、ソート条件の設定方法についてはデータ管理>複数レコード取得する（キー未指定）>検索条件についてデータ管理>複数レコード取得する（キー未指定）>ソート条件についてを参照してください。 //ピーコン取得では必須項目はありません//第１引数に検索条件、第２引数にソート条件を指定できますRKZCIient.getBeaconList( null, null, new OnGetBeaconListListener( ) { @Override public void onGetBeaconList( List<Beacon> beaconList , RKZResponseStatus rkzStatus ) { if( rkzStatus.isSuccess( ) ) { for ( Beacon beacon : beaconList ) {ピーコン情報を出力// Log.d( "OnGetBeaconListListener" , beacon.getCode( ) ); Log.d( "OnGetBeaconListListener" , beacon.getName( ) ); Log.d( "OnGetBeaconListListener" , beacon.getShortName( ) ); Log.d( "OnGetBeaconListListener" , beacon.getBeaconId( ) ); Log.d( "OnGetBeaconListListener" , beacon.getBeaconTypeCd( ) ); Log.d( "OnGetBeaconListListener" , StringUtil.parseString(beacon.getMajor( ) ) ) ) ; Log.d( "OnGetBeaconListListener" , StringUtil.parseString(beacon.getMinor( ) ) ); l } else { Log.d( "OnGetBeaconListListener" , rkzStatus.getStatusCode( ) ); Log.d( "OnGetBeaconListListener" , rkzStatus.getMessage( ) ); & BaaS@rakuza SDKリファレンスマニュアル for Android Ver2.2.0 l } J
スポットを複数取得する場合は、RKZClientのgetSpotListで行います。スポット取得に成功した場合はコールバックリスナの第１引数にスポットデータが渡されます。取得に失敗した場合はコールバックリスナの第２引数のisSuccessメソッドがfalseを返します。引数の検索条件とソート条件はnullを指定しています。検索条件、ソート条件の設定方法についてはデータ管理>複数レコード取得する（キー未指定）>検索条件についてデータ管理>複数レコード取得する（キー未指定）>ソート条件についてを参照してください。 //ピーコン取得では必須項目はありません//第１引数に換策条件、第２引数にソート条件を指定できますRKZCIient.getSpotList( null, null, new OnGetSpotListListener() { �Override public void onGetSpotList(final List<Spot> list, final RKZResponseStatus rkzResponseStatus) { if( rkzStatus.isSuccess( ) ) { for ( Spot spot : l i s ) { //　スポット情報を出力Log.d( " OnGetSpotListListener " , spot.getCode( ) ); Log.d( " OnGetSpotListListener " , spot.getName( ) ); Log.d( " OnGetSpotListListener " , spot.getShortName( ) ); } } else { Log.d( "OnGetBeaconListListener" , rkzStatus.getStatusCode( ) ); Log.d( "OnGetBeaconListListener" , rkzStatus.getMessage( ) ); l } } ) : SDKリファレンスマニュアル for Android Ver2.2.0クーポン管理機能を利用するクーポン管理機能は、アプリケーションでクーポン情報を管理する基本的な仕組みを提供します。このページでは、クーポン管理機能を利用する実装例を紹介します。クーポンを複数レコード取得するクーポンを複数取得する場合は、RKZClientのgetCouponListで行います。クーポン取得に成功した場合はコールバックリスナの第１引数にクーポンデータが渡されます。取得に失敗した場合はコールバックリスナの第２引数のisSuccessメソッドがfalseを返します。引数の検索条件とソート条件はnullを指定しています。検索条件、ソート条件の設定方法についてはデータ管理>複数レコード取得する（キー未指定）>検索条件についてデータ管理>複数レコード取得する（キー未指定）>ソート条件についてを参照してください。 // クーポン取得（coupon未指定）では必須項目はありません//第１引数に検索条件、第２引数にソート条件を指定できますRKZCIient.getCouponList( null, null, new OnGetCouponListListener( ) { @Override public void onGetCouponList( List<Coupon> couopnList , RKZResponseStatus rkzStatus ) { if( rkzStatus.isSuccess( ) ) { for ( Coupon coupon : couponList ) { //クーポン情報を出力Log.d( "OnGetCouponListListener", coupon.getCode() ); Log.d( "OnGetCouponListListener", coupon.getName() ); Log.d( "OnGetCouponListListener", CalendarUtil.getDateText( coupon.getPossibleFromDte() ) ); ] } else { Log.d( "OnGetCouponListListener" , rkzStatus.getStatusCode( ) ); Log.d( "OnGetCouponListListener" , rkzStatus.getMessage( ) ); l l & BaaS@rakuza SDKリファレンスマニュアル for Android Ver2.2.0
クーポンを１レコード取得する場合は、RKZClientのgetCouponで行います。クーポン取得に成功した場合はコールバックリスナの第１引数クーポンデータが渡されます。取得に失敗した場合は第２引数のisSuccessメソッドがfalseを返します。 //クーポンコード指定しますString  couponCode = "0001": RKZCIient. getCoupon( couponCode, new OnGetCouponListener( ) { public void onGetCoupon( Coupon coupon , RKZResponseStatus rkzStatus ) { if( rkzStatus.isSuccess( ) ) { //クーポン情報を出力Log.d( "OnGetCouponListener" , coupon.getCode( ) ); Log.d( "OnGetCouponListener" , coupon.getName( ) ); Log.d( "OnGetCouponListener" , CalendarUtil.getDateText ( coupon.getPossibleFromDte( ) ) : } else { Log.d( "OnGetCouponListener" , rkzStatus.getStatusCode( ) ); Log.d( "OnGetCouponListener" , rkzStatus.getMessage( ) ): l }
クーポンを交換する
クーポンを交換する場合は、RKZClientのexchangeCouponで行います。クーポン交換に成功した場合はコールバックリスナの第１引数に"1001"が渡されます。クーポン交換に失敗した場合はコールバックリスナの第２引数のisSuccessメソッドがfalseを返します。 //クーポン交換では、ユーザアクセストークンとクーポンコードと交換枚数が必要ですString  userAccessToken  = "userAccessTokenXXXX": String coupontCode = "0005": Integer quantity = Integer.valueOf( "1" ); & BaaS@rakuza SDKリファレンスマニュアル for Android Ver2.2.0 RKZCIient.exchangeCoupon( userAccessToken, couponCode, quantity, new OnExchangeCouponListener( ) { êOverride public void onExchangeCouponListener( String statusCode, RKZResponseStatus rkzStatus ) { if( rkzStatus.isSuccess( ) ) { Log. d( "OnExchangeCouponListener" , "クーポン交換に成功しました。" ); } else { Log.d( "OnExchangeCouponListener" , rkzStatus.getStatusCode( ) ); Log.d( "OnExchangeCouponListener" , rkzStatus.getMessage( ) ); J l
マイクーポンを複数レコード取得する
マイクーポンを複数取得する場合は、RKZClientのgetMyCouponListで行います。マイクーポン取得に成功した場合はコールバックリスナの第１引数にマイクーポンデータが渡されます。取得に失敗した場合はコールバックリスナの第２引数のisSuccessメソッドがfalseを返します。引数の検索条件とソート条件はnullを指定しています。検索条件、ソート条件の設定方法についてはデータ管理>複数レコード取得する（キー未指定）>検索条件についてデータ管理>複数レコード取得する（キー未指定）>ソート条件についてを参照してください。 //マイクーポン取得（myCoupon未指定）ではユーザアクセストークンが必要ですString userAccessToken = "userAccessTokenXXXX": //第２引数に検索条件、第３引数にソート条件を指定できますRKZCIient.getMyCouponList( userAccessToken, null, null, new OnGetMyCouponListListener( ) { @Override public void onGetMyCouponList( List<MyCoupon> myCouponList, RKZResponseStatus rkzStatus ) { if( rkzStatus.isSuccess( ) ) { for ( MyCoupon myCoupon : myCouponList ) { Log.d( "OnGetMyCouponListListener" , myCoupon.getCode( ) ); Log.d( "OnGetMyCouponListListener" , myCoupon.getCouponName( ) ); Log.d( "OnGetMyCouponListListener" , myCoupon.getCouponCd( ); l } else { Log.d( "OnGetMyCouponListListener" , rkzStatus.getStatusCode( ) ); Log.d( "OnGetMyCouponListListener" , rkzStatus.getMessage( ) ); %BaaS@rakuza SDKリファレンスマニュアル for Android Ver2.2.0 l } J
マイクーポンを1レコード取得する場合は、RKZClientのgetMyCouponで行います。マイクーポン取得に成功した場合はコールバックリスナの第１引数にマイクーポンデータが渡されます。取得に失敗した場合は第２引数のisSuccessメソッドがfalseを返します。 //マイクーポン取得（myCoupon指定）ではユーザアクセストークン及びマイクーポンコードが必要ですString  userAccessToken  = "userAccessTokenXXXX": String myCouponCode = "10"; RKZClient.getMyCoupon( userAccessToken, myCouponCode, new OnGetMyCouponListener( ) { public void onGetMyCoupon( MyCoupon myCoupon , RKZResponseStatus rkzStatus ) { if( rkzStatus.isSuccess( ) ) { Log.d( "OnGetMyCouponListener" , myCoupon.getCode( ) ); Log. d ( "OnGetMyCouponListener" myCoupon.getCouponName( ) ) ; Log.d( "OnGetMyCouponListener" , myCoupon.getCouponCd( ); } else { Log.d( "OnGetMyCouponListener" , rkzStatus.getStatusCode( ) ); Log.d( "OnGetMyCouponListener" , rkzStatus.getMessage( ) ); l }
クーポンを利用する
クーポンを利用する場合は、RKZClientのuseMyCouponで行います。クーポン利用に成功した場合はコールバックリスナの第１引数に"1001"が渡されます。クーポン利用に失敗した場合はコールバックリスナの第２引数のisSuccessメソッドがfalseを返します。 //クーポン利用では、ユーザアクセストークンとマイクーポンデータが必要です& Baas@rakuza SDKリファレンスマニュアル for Android Ver2.2.0 String  userAccessToken  = "userAccessTokenXXXX": MyCoupon myCoupon = new MyCoupon( ) : //マイクーポンデータにはマイクーポンコードとクーポンコードが酸定されている必要があるmyCoupon. setCode ("31") : myCoupon. setCouponcd ("0005") : RKZCIient.useMyCoupon( userAccessToken, myCoupon, new OnUseMyCouponListener( ) { @Override public void onUseMyCoupon( String statusCode , RKZResponseStatus rkzStatus ) { if( rkzStatus.isSuccess( ) ) { Log.d( "OnUseMyCouponListener" , "クーポン利用に成功しました。" ); } else { Log.d( "OnExchangeCouponListener" , rkzStatus.getStatusCode( ) ); Log.d( "OnExchangeCouponListener" , rkzStatus.getMessage( ) ); } } J SDKリファレンスマニュアル for Android Ver2.2.0ポイント管理機能を利用するポイント管理機能は、アプリケーションでユーザーが保持するポイント情報を管理する基本的な仕組みを提供します。このページでは、ポイント管理機能を利用する実装例を紹介します。
ユーザーのポイント情報を取得する
ユーザーが保持しているポイント情報を取得する場合はRKZClientのgetPointで行います。取得に成功した場合はコールバックメソッドの第１引数にポイント情報として渡されます。取得に失敗した場合は第２引数のisSuccessメソッドがfalseを返します。ポイント取得にはポイントを知りたいアプリ利用者のユーザアクセストークンが必要です// String  userAccessToken  = "userAccessTokenXXXX": RKZCIient.getPoint( userAccessToken, new OnGetPointListener( ) { public void onGetPoint( Point point, RKZResponseStatus rkzStatus ) { if( rkzStatus.isSuccess( ) ) { Log.d( "OnGetPointListener" , point.getPoint() ): } else { Log.d( "OnGetPointListener" , rkzStatus.getStatusCode( ) ); Log.d( "OnGetPointListener" , rkzStatus.getMessage( ) ); l J
ユーザーのポイント数を加算・減算する
ユーザーの保持しているポイント情報を加算・減算する場合はRKZClientのaddPointで行います。ポイントの加算・減算処理に成功した場合はコールバックメソッドの第１引数に処理後のポイント情報が渡されます。 & BaaS@rakuza SDKリファレンスマニュアル for Android Ver2.2.0失敗した場合は第２引数のisSuccessメソッドがfalseを返します。 //ポイント加算試算にはアプリ利用者のユーザアクセストークンと加算試算するポイント散と日付が必要ですString  userAccessToken  = "userAccessTokenXXXX": // １００ポイント追加させるInteger pointNum  = Integer.valueOf("100"); //ポイント計算を行った日付Calendar today = Calendar.getInstance() : RKZCIient.addPoint( userAccessToken,  pointNum,  today,  new OnGetPointListener( ) { public void onGetPoint( Point point, RKZResponseStatus rkzStatus ) { if( rkzStatus.isSuccess( ) ) { Log.d( "OnGetPointListener" , Integer.toString(point.getPoint() ) ); } else { Log.d( "OnGetPointListener" , rkzStatus.getStatusCode( ) ); Log.d( "OnGetPointListener" , rkzStatus.getMessage( ) ); } ] J SDKリファレンスマニュアル for Android Ver2.2.0
アプリ管理機能は、アプリケーションの設定を管理する基本的な仕組みを提供します。このページでは、アプリ管理機能を利用する実装例を紹介します。
アプリケーション設定情報を取得する
アプリケーション基本設定情報の取得はRKZClientのgetApplicationSettingDataで行います。取得に成功した場合は、コールバックリスナの第１引数に取得データが渡されます。取得に失敗した場合は、第２引数のisSuccessメソッドがfalseを返します。 RKZCIient.getApplicationSettingData( OnGetApplicationSettingDataListener() { @Override public void onGetApplicationSettingData( ApplicationConfig appConfig, RKZResponseStatus rkzSatus ) { if ( rkzStatus.isSuccess( ) ) { //成功時Log.d( "OnGetApplicationSettingData", appConfig.getName( ) ); Log.d( "OnGetApplicationSettingData", appConfig.getVersionAndroid( ) ); } else { Log.d( "OnGetApplicationSettingData", rkzStatus.getStatusCode( ) ); Log.d( "OnGetApplicationSettingData", rkzStatus, getMessage( ) ); l } J SDKリファレンスマニュアル for Android Ver2.2.0スタンプラリー管理機能を利用するスタンプラリー管理機能は、アプリケーションでスタンプラリー情報を管理する基本的な仕組みを提供します。このページでは、スタンプラリー管理機能を利用する実装例を紹介します。
スタンプラリー情報（開催中）を一覧取得する
スタンプラリー一覧を取得する場合は、RKZClientのgetStampRallyListで行います。スタンプラリー一覧取得に成功した場合はコールバックリスナの第１引数にスタンプラリーデータリストが渡されます。取得に失敗した場合はコールバックリスナの第2引数のisSuccessメソッドがfalseを返します。引数の検索条件とソート条件はnullを指定しています。検索条件、ソート条件の設定方法についてはデータ管理>複数レコード取得する（キー未指定）>検索条件についてデータ管理>複数レコード取得する（キー未指定）>ソート条件についてを参照してください。 //スタンプラリー一覧取得では必須項目は有りません。 //第1引数に検索条件、第２引数に、ソート条件を指定できます。 RKZCIient.getStampRallyList(null, null, new OnGetStampRallyListListener() { @Override public void onGetStampRallyList(List<StampRally> stamprallyDataList, RKZResponseStatus rKZResponseStatus) { if (rKZResponseStatus. isSuccess ()) { for (StampRally stampRally : stamprallyDataList) { //スタンプラリー情報を出力Log.d("OnGetStampRallyListListener",stampRally.getCode()); Log.d("OnGetStampRallyListListener", stampRally.getName()); Log.d("OnGetStampRallyListListener", stampRally.getShortName()); Log.d("OnGetStampRallyListListener", stampRally.getStampRallyDetail()); Log.d("OnGetStampRallyListListener",stampRally.getStampRallyImage()); Log.d("OnGetStampRallyListListener", stampRally.getStampRallyImageUrl()); Log. d("OnGetStampRallyListListener",CalendarUtil.getDateText(stampRally.getStampRallyStartDate())); Log. d ("OnGetStampRallyListListener", CalendarUtil.getDateText(stampRally.getStampRallyEndDate())); & BaaS@rakuza } 1 });
スタンプラリーを全件取得する場合は、RKZClientのgetAllStampRallyListで行います。スタンプラリー取得に成功した場合はコールバックリスナの第１引数にスタンプラリーデータリストが渡されます。取得に失敗した場合はlp-るバックリスナの第２引数のisSuccessメソッドがfalseを返します。引数の検索条件とソート条件はnullを指定しています。検索条件、ソート条件の設定方法についてはデータ管理>複数レコード取得する（キー未指定）>検索条件についてデータ管理>複数レコード取得する（キー未指定）>ソート条件についてを参照してください。 //スタンプラリー一覧取得では必須項目は有りません。 //第１引数に検業条件、第２引数に、ソート条件を指定できます。 RKZCIient.getStampRallyList(null, null, new OnGetStampRallyListListener() { @Override public void onGetStampRallyList(List<StampRally> stamprallyDataList, RKZResponseStatus rKZResponseStatus) { if (rKZResponseStatus. isSuccess ()) { for (StampRally stampRally : stamprallyDataList) { //スタンプラリー情報を出力Log.d("OnGetStampRallyListListener", stampRally.getCode()) : Log.d("OnGetStampRallyListListener", stampRally.getName()); Log.d("OnGetStampRallyListListener", stampRally.getShortName()); Log.d("OnGetStampRallyListListener", stampRally.getStampRallyDetail()); Log.d("OnGetStampRallyListListener", stampRally.getStampRallyImage()); Log.d("OnGetStampRallyListListener",stampRally.getStampRallyImageUrl()); Log. d("OnGetStampRallyListListener",CalendarUtil. getDateText(stampRally. getStampRallyStartDate())); Log. d ("OnGetStampRallyListListener", CalendarUtil, getDateText(stampRally, getStampRallyEndDate())); } } J });みBaaS@rakuza SDKリファレンスマニュアル for Android Ver2.2.0
なスタンプラリースポット情報一覧取得（必須条件なし）はRKZClientのgetStampRallySpotListで行います。取得に成功した場合は、取得したレコードのコードと名称をアラートで表示します。取得に失敗した場合はエラー内容をアラートで表示します。引数の検索条件とソート条件は未指定です。検索条件、ソート条件の設定方法についてはデータ管理>複数レコード取得する（キー未指定）>検索条件についてデータ管理>複数レコード取得する（キー未指定）>ソート条件についてを参照してください。 //スタンプラリー一覧取得では必須項目は有りません。 //第1引数に換索条件、第2引数に、ソート条件を指定できます。 RKZCIient.getAIIStampRallyList(null, null, new OnGetStampRallyListListener() { public void onGetStampRallyList(List<StampRally> stamprallyDataList, RKZResponseStatus rKZResponseStatus) { if (rKZResponseStatus. isSuccess ()) { for (StampRally stampRally : stamprallyDataList) { //スタンプラリー情報を出力Log.d("OnGetStampRallyListListener", stampRally.getCode()) : Log.d("OnGetStampRallyListListener", stampRally.getName()); Log.d("OnGetStampRallyListListener", stampRally.getShortName()); Log.d("OnGetStampRallyListListener", stampRally.getStampRallyDetail()); Log.d("OnGetStampRallyListListener",stampRally.getStampRallyImage()); Log.d("OnGetStampRallyListListener", stampRally.getStampRallyImageUrl()); Log. d ("OnGetStampRallyListListener", CalendarUtil. getDateText(stampRally. getStampRallyStartDate())); Log. d ("OnGetStampRallyListListener", CalendarUtil, getDateText(stampRally, getStampRallyEndDate())); } J }); & BaaS@rakuza SDKリファレンスマニュアル for Android Ver2.2.0
取得するスタンプラリースポット一覧をスタンプラリーIDで指定して取得する場合は、RKZClientのgetStampRallySpotListByStampRallyIdで行います。スタンプラリースポット一覧取得に成功した場合はコールバックリスナの第１引数にスタンプラリースポット一覧データリストが渡されます。取得に失敗した場合はコールバックリスナの第２引数のisSuccessメソッドがfalseを返します。引数の検索条件とソート条件はnullを指定しています。検索条件、ソート条件の設定方法についてはデータ管理>複数レコード取得する（キー未指定）>検索条件についてデータ管理>複数レコード取得する（キー未指定）>ソート条件についてを参照してください。 //スタンプラリースポット一覧取得では必須項目はスタンプラリーIDです//第１引敷に換索条件、第２引敷にソート条件を設定できます。 RKZCIient.getStampRallySpotListByStampRallyId("0001",null, null, new OnGetStampRallySpotListListener () { public void onGetStampRallySpotList(List<StampRallySpot> stamprallyspotDataList, RKZResponseStatus rKZResponseStatus) { for (StampRallySpot stampRallySpot : stamprallyspotDataList) { Log.d("OnGetStampRallySpotListListener", stampRallySpot.getCode()); Log.d("OnGetStampRallySpotListListener",stampRallySpot.getStampRallyCd()); Log.d("OnGetStampRallySpotListListener",stampRallySpot.getStampRallyName()); Log.d("OnGetStampRallySpotListListener", stampRallySpot.getName()); Log.d("OnGetStampRallySpotListListener", StringUtil, parseString(stampRallySpot, getSortNo())); } l }); & BaaS@rakuza SDKリファレンスマニュアル for Android Ver2.2.0
るスタンプラリースポットー覧をスポットで指定する場合、RKZClientのgetStampRallySpotListBySpotIdで行います。スタンプラリースポット一覧取得に成功した場合はコールバックリスナの第１引数にスタンプラリースポット一覧データリストが渡されます。取得に失敗した場合はコールバックリスナの第２引数のisSuccessメソッドがfalseを返します。引数の検索条件とソート条件はnullを指定しています。検索条件、ソート条件の設定方法についてはデータ管理>複数レコード取得する（キー未指定）>検索条件についてデータ管理>複数レコード取得する（キー未指定）>ソート条件についてを参照してください。 //スタンプラリースポット一覧取得では必須項目はスポットIDです。 //第１引数に換索条件、第２引数にソート条件を設定できます。 RKZCIient.getStampRallySpotListBySpotId("0001",null, null, new  OnGetStampRallySpotListListener ()   { @Override public void onGetStampRallySpotList(List<StampRallySpot> stamprallyspotDataList, RKZResponseStatus rKZResponseStatus) { if (rKZResponseStatus. isSuccess ()) { for (StampRallySpot stampRallySpot : stamprallyspotDataList) { //スタンプラリースポット情報を出力Log.d("OnGetStampRallySpotListListener", stampRallySpot.getCode()); Log.d("OnGetStampRallySpotListListener",stampRallySpot.getStampRallyCd()); Log.d("OnGetStampRallySpotListListener",stampRallySpot.getStampRallyName()); Log.d("OnGetStampRallySpotListListener", stampRallySpot.getName()); Log.d("OnGetStampRallySpotListListener", StringUtil, parseString(stampRallySpot, getSortNo())); l } l });
スタンプコンプリートを登録する
スタンプラリー情報のスタンプコンプリート登録はRKZClientのstampCompleteで行います。 p. 56 Copyright© people software. All Rights Reserved & BaaS@rakuza SDKリファレンスマニュアル for Android Ver2.2.0登録に成功したか失敗したかを取得することができます。登録に成功した場合はアラートで「スタンプをコンプリートしました。」と表示します。登録に失敗した場合はエラー内容をアラートで表示します。 Log.d("OnStampCompleteListener",rKZResponseStatus.getStatusCode()); Log.d("OnStampCompleteListener", rKZResponseStatus.getMessage()) : l
取得したスタンプを登録する
取得したスタンプを登録する場合は、RKZClientのaddMyStampで行います。取得したスタンプの登録に成功した場合はコールバックリスナの第１引数に取得したスタンプデータが渡されます。登録に失敗した場合はコールバックリスナの第２引数のisSuccessメソッドが falseを返します。 // 取得スタンプ登録では必須項目はユーザーアクセストークン、スタンプラリー ID,スタンプラリースポット IDです。 RKZCIient.addMyStamp("APP0001", "0001", new OnAddMyStampListener() { public void onAddMyStamp(RKZResponseStatus rKZResponseStatus) { Log.d("OnAddMyStampListener","登録成功"); Log. d("OnAddMyStampListener", rKZResponseStatus, getStatusCode()) : Log.d("OnAddMyStampListener",rKZResponseStatus, getMessage()); } J }); %BaaS@rakuza SDKリファレンスマニュアル for Android Ver2.2.0
スタンプ取得履歴の取得はRKZClientのgetMyStampHistoryListで行います。取得に成功した場合は取得したレコードのコンタクト種別コードとポイントをアラートで表示します。取得失敗の場合はエラー内容をアラートで表示します。引数の検索条件とソート条件は未指定です。検索条件、ソート条件の設定方法についてはデータ管理>複数レコード取得する（キー未指定）>検索条件についてデータ管理>複数レコード取得する（キー未指定）>ソート条件についてを参照してください。 //取得スタンプ履履専では、必須項目はユーザーアクセストークンです。 RKZCIient.getMyStampHistoryList("APP0001", null, null, new OnGetAcquisitionStateOfStampListener() { @Override public void onGetAcquisitionStateOfStamp(List<MyStampHistory> myStampHistoryList, RKZResponseStatus rKZResponseStatus) { if (rKZResponseStatus. isSuccess ()) { for (MyStampHistory myStampHistory : myStampHistoryList) { Log.d("OnGetAcquisitionStateOfStampListener", myStampHistory.getContactClassCd()); Log.d("OnGetAcquisitionStateOfStampListener", myStampHistory.getStampRallyCd()); Log.d("OnGetAcquisitionStateOfStampListener", myStampHistory.getStampRallyName()); Log.d("OnGetAcquisitionStateOfStampListener",myStampHistory,getStampRallySpotCd()); Log.d("OnGetAcquisitionStateOfStampListener", myStampHistory.getStampRallySpotName()); Log.d("OnGetAcquisitionStateOfStampListener",CalendarUtil,getDateText((myStampHistory,getContactDate ())): l J J }); SDKリファレンスマニュアル for Android Ver2.2.0お気に入り管理機能を利用するお気に入り管理機能は、アプリケーションでお気に入り情報を管理する基本的な仕組みを提供します。このページでは、お気に入り管理機能を利用する実装例を紹介します。
オブジェクトデータをお気に入りに登録する
オブジェクトデータをお気に入りに登録する場合は、RKZClientのaddFavoriteToObjecttDataで行います。お気に入り情報登録に成功した場合はコールバックリスナの第１引数に"1001"が渡されます。お気に入り情報登録に失敗した場合はコールバックリスナの第２引数の isSuccess メソッドがfalseを返します。 //お気に入り豊農では、必須項目は、オブジェクトデータとユーザーアクセスト一クンです。 // RKZObjectDataを作成し、豊像に最低限必要なデータを設定しますRKZObjectData rKZData = new RKZObjectData( ): rKZData.setObjectId("object1" ); rKZData. setCode ("0001" ) : //ユーザーアクセストークンを指定String userAccessTokene = "ユーザーアクセストークン": RKZCIient.getInstance().addFavoriteToObjectData ( rKZData, userAccessTokene, new OnAddFavoriteListener() { @Override public void onAddFavorite(RKZResponseStatus rKZResponseStatus) { if ( rkzStatus.isSuccess( ) ) { Log.d( "OnAddFavoriteListener" , "登録成功" ); } else { Log.d( "OnAddFavoriteListener" , rkzStatus.getStatusCode( ) ); Log.d( "OnAddFavoriteListener" , rkzStatus.getMessage( ) ); } J }); & BaaS@rakuza SDKリファレンスマニュアル for Android Ver2.2.0
オブジェクトデータのお気に入りを削除する場合は、RKZClientのdeleteFavoriteToObjectDataで行います。お気に入り情報削除に成功した場合はコールバックリスナの第１引数に"1001"が渡されます。お気に入り情報削除に失敗した場合はコールバックリスナの第２引数の isSuccess メソッドがfalseを返します。 //お気に入り削除では、必須項目は、オブジェクトデータとユーザーアクセスト一クンです。 // RKZObjectDataを作成し、削除に最低限必要なデータを設定しますRKZObjectData rKZData = new RKZObjectData( ): rKZData.setObjectId("object1" ); rKZData. setCode ("0001" ) : //ユーザーアクセストークンを指定String userAccessTokene = "ユーザーアクセストークン": RKZCIient.getInstance().deleteFavoriteToObjectData( rKZData, userAccessTokene, new OnDeleteFavoriteListener() public void onAddFavorite(RKZResponseStatus rKZResponseStatus) { Log.d( "OnDeleteFavoriteListener" , "削除成功" ); } else { Log.d( "OnDeleteFavoriteListener" , rkzStatus.getStatusCode( ) ); Log.d( "OnDeleteFavoriteListener" , rkzStatus.getMessage( ) ); } l }); APIのタイムアウトを制御する全てのAPI呼び出し時に、タイムアウトを指定することでAPIのレスポンスが未応答の場合の処理を制御する機能を提供します。このページでは、スタンプラリー管理機能を利用する実装例を紹介します。
全てのAPIで共通のタイムアウト時間を設定する
全てのAPIで共通のタイムアウト時間を設定するにはRKZClientのsetDefaultTimeoutoで行います。 Blocks により処理結果を返却します。処理時間が指定した時間以内で完了した場合は" rKZResponseStatus.isSuccess"がTrue,処理時間が指定した時間以上経過した場合は False となります。 public void onGetSpotList(List<Spot> spotList, RKZResponseStatus rKZResponseStatus) { } else { Log.e("baasatrakuza", "ERROR! "); J } }); & BaaS@rakuza SDKリファレンスマニュアル for Android Ver2.2.0
特定のAPIにのみ有効なタイムアウト時間を設定するにはRKZClientのsetTimeoutoで行います。 setTimeoutメソッドを呼び出すと、指定したタイムアウト時間でタイムアウトするRKZClientインスタンスが新しく生成されます。生成されたインスタンスから呼び出されるAPIは全てsetTimeoutで指定した時間がタイムアウトとして有効になります。 Blocks により処理結果を返却します。処理時間が指定した時間以内で完了した場合は"responseStatus.isSuccess"がYES ,処理時間が指定した時間以上経過した場合はNOとなります。 ※注意点setDefaultTimeoutとsetTimeoutどちらも指定した場合はsetTimeoutにて指定した時間がタイムアウト値として有効になります。みBaaS@rakuza SDKリファレンスマニュアル for Android Ver2.2.0みBaaS@rakuza SDKリファレンスマニュアル for Android Ver2.2.0