mixiアプリ » 各種申請・登録 » アプリの変更・削除に関する申請・登録 » アプリ設定変更 » ユーザーID新方式移行手順
ユーザーID新方式移行手順
【注意】 2011年11月末をもちまして、ユーザーIDの新方式への移行期間は終了致しました。 本ドキュメントは古い情報となっており、現在は下記の移行手順を実施することはできません。 また、今後新しく作成したアプリに関しましても、移行作業を実施して頂く必要はございません。
現在、ユーザーのIDの指定方法が現状の数字のみから、ハッシュ化（以後「プラットフォーム共通化」と呼ぶ）された英数字（13桁）のIDに変更されるため、随時準備していただいていることかと思いますが、2011年6月29日よりAPIの使用においてプラットフォーム共通化されたユーザーIDを利用する方式（以後「新方式」と呼ぶ）に移行可能となりました。 本移行後、数字のみの方式（以後「旧方式」と呼ぶ）ではAPIが動作しなくなります。
また、一度移行してしまうと旧方式に戻すことができませんので、検証を十分に行って頂いた上で移行していただくようよろしくお願いします。
2011年6月29日以降にアプリを新規登録された場合は、最初からこの新方式のみ利用することになりますので、 本移行作業は不要です。（この場合、Partner Dashboardに以下説明するボタン等の表示は出現しませんのでご注意ください）
移行が必要なアプリ
2011年6月29日以前に登録したアプリ
下画像のように Partner Dashboard のアプリ設定ページ（https://sap.mixi.jp/edit_appli.pl?id=【アプリID】）にある「各種申請」の中に「ID変換API」の項目がある場合が該当します。
新方式への移行手順
新方式への移行については二つのステップが存在します。
- 旧方式で利用していたユーザーIDを新方式に置き換える準備をする。
- mixiアプリAPIを新方式に切り替える。
以下、この二つのステップについて説明していきます。
1. 旧方式のユーザーIDを新方式に置き換える準備をする。
ID変換APIを利用しして、旧方式から新方式のユーザーIDへと置き換える準備を行ってください。
まず、新方式のユーザーIDに置き換える対象のmixiアプリの設定内容を編集するため、アプリ設定変更ページを開きます。
※アプリ設定変更ページへのアクセス方法については こちら をご覧ください。
アプリ設定変更ページの中に「ID変換API」という項目がありますので、表示された「ID変換APIを利用する」ボタンを押下します。
ID変換APIを利用するためには利用規約に同意する必要がありますので、「同意して登録する」ボタンを押下します。
結果、完了画面が表示されます。
上記登録後、Person & Friends APIに新方式のユーザーIDが格納された"platformUserId"フィールドが追加されます。
これを利用し、新方式のユーザーIDに置き換えることが可能となります。
Person & Friends APIの詳細については以下のドキュメントをご覧ください。
新方式のユーザーIDを取得できる条件については以下のドキュメントを参考にしてください。
2. mixiアプリAPIを新方式に切り替える。
ID変換APIを利用して、新方式のユーザーIDに置き換える準備が終わりましたら、次のステップとしてmixiアプリAPIを新方式に切り替えてください。
ただし、ユーザーIDの変換API（Person & Friends API）に関しましては、11月末まで新方式に切り替え後もプラットフォーム共通化されていないユーザーIDからプラットフォーム共通化されたユーザーIDへの変換手段として利用できます。ライフサイクルイベントでは完了ボタン押した後にプラットフォーム共通化されていないユーザーIDが送信されてくる場合がありますので、必要に応じて 変換APIを引き続きご活用下さい。
「アプリ設定変更」ページの中に 「ID変換API」という項目がありますので、そこで「プラットフォーム共通化対応完了」ボタンを押下します。
（「ID変換APIを利用する」ボタンが表示されている場合はユーザーIDが新方式に切り替わっていないため、1 の手順から始めてください。）
ID変換完了による注意点に同意する必要がありますので、チェックボックスにチェックをして、 「同意して登録する」ボタンを押下します。
ここで「同意して完了する」ボタンを押下してしまうと、旧方式に戻せませんので慎重に操作をお願いします。
結果、完了画面が表示されます。 
以後mixiアプリAPIが新方式に移行され、API利用において新方式のユーザーIDのみが利用可能となります。
これでユーザーIDの新方式への対応は完了です。
ご協力ありがとうございました。