ユーザープロフィール

Facebook や Twitter のような外部のサービスの認証を利用する場合の多くはユーザーのプロフォール情報が利用できます。これらのサービスでは、プロフィール 情報のエンコーディングが異なっていることが多いため、対応が面倒になっています。 そのため、Passport はこれらのプロフィール情報を正規化する機能を持っています。

When authenticating using a third-party service such as Facebook or Twitter, user profile information will often be available. Each service tends to have a different way of encoding this information. To make integration easier, Passport normalizes profile information to the extent possible.

プロフィール情報は Portable Contacts によって策定された コンタクトスキーマ の形式で正規化されます。 共通するフィールドについては下の表をご覧ください。

Normalized profile information conforms to the contact schema established by Portable Contacts. The common fields available are outlined in the following table.

provider {String}

サービスの提供者 (facebook や twitter など)。

id {String}

サービスの提供者によって生成されたユーザーのユニークな識別子。

displayName {String}

表示されるユーザID

name {Object}

familyName {String}

ユーザーの姓（欧米圏ではラストネーム）。

givenName {String}

ユーザーの名（欧米圏ではファーストネーム）。

middleName {String}

ユーザーのミドルネーム。

emails {Array} [n]

value {String}

メールアドレス。

type {String}

メールアドレスの種類（自宅や職場など）。

photos {Array} [n]

value {String}

写真の URL。

provider {String}

The provider with which the user authenticated (facebook, twitter, etc.).

id {String}

A unique identifier for the user, as generated by the service provider.

displayName {String}

The name of this user, suitable for display.

name {Object}

familyName {String}

The family name of this user, or "last name" in most Western languages.

givenName {String}

The given name of this user, or "first name" in most Western languages.

middleName {String}

The middle name of this user.

emails {Array} [n]

value {String}

The actual email address.

type {String}

The type of email address (home, work, etc.).

photos {Array} [n]

value {String}

The URL of the image.

注意：全てのサービスで、これら全てのフィールドが利用できるとは限りません。 また、サービスの提供者によっては上のリストに記載されていない情報も利用できることがあります。 詳細については各サービス提供者のドキュメントを参照してください。

Note that not all of the above fields are available from every service provider. Some providers may contain additional information not described here. Consult the provider-specific documentation for further details.