「chatter」でGoogleサジェスト検索した結果がひどかった。

http://wiki.developerforce.com/index.php/Chatter_Code_Recipes
上記掲載のChatterCodeRecipesを実際に検証しましたので、翻訳と注釈を記載しました。

<apex:inputText value="{!status}" id="status" maxlength="100" />
<apex:commandLink style="button" value="Update User Status" action="{!doUserStatus}" />

public string status     { get; set; }

public PageReference doUserStatus()   {
       User user = [select id, CurrentStatus from User where id = :UserInfo.getUserId()];
       user.CurrentStatus = status;
       update user;
       return null;
}

<apex:image id="profileImage" url="{!profileImageUrl}" />

public string profileImageUrl    { get; set; }

profileImageUrl = [select FullPhotoUrl from User where Id = '1234'];

<chatter:followers entityId="User Id or record Id"/>
<chatter:feedWithFollowers entityId="User Id or record Id"/>

List<EntitySubscription> followers =
     [select id, subscriberid, subscriber.name
      from EntitySubscription
      where parentid =:uid]; // the id of the user/record for which you want to list followers

Integer noOfFollowers = followers.size();

// Everyone you're following
EntitySubscription[] followingES = [select id, parentid, subscriberid, parent.name
                                    from EntitySubscription
                                    where subscriberid =:uid];//Set to the User's Id

List<EntitySubscription> following = new List<EntitySubscription> ();
String userSObjectPrefix =  User.sObjectType.getDescribe().getKeyPrefix();
for( EntitySubscription es: followingES )
{
      if( ('' + es.parentid).substring(0,3) ==
                        userSObjectPrefix) // users only
      {
             following.add(es);
      }
}
Integer followingUserCount = following.size();

<chatter:follow entityId="User or Record Id that you want to follow"/>

EntitySubscription follow = new EntitySubscription (
                                 parentId = '<User Record Id you want to follow'
                                 subscriberid = :UserInfo.getUserId); //your User Id
insert follow;

EntitySubscription follow = new EntitySubscription ();
follow.parentId = 'User Record Id you want to follow';
follow.subscriberid = UserInfo.getUserId(); //your User Id
insert follow;

//Adding a Text post
FeedItem post = new FeedItem();
post.ParentId = oId; //eg. Opportunity id, custom object id..
post.Body = 'Enter post text here';
insert post;

//Adding a Link post
FeedItem post = new FeedItem();
post.ParentId = oId; //eg. Opportunity id, custom object id..
post.Body = 'Enter post text here';
post.LinkUrl = 'http://www.someurl.com';
insert post;

//Adding a Content post
FeedItem post = new FeedItem();
post.ParentId = oId; //eg. Opportunity id, custom object id..
post.Body = 'Enter post text here';
post.ContentData = base64EncodedFileData;
post.ContentFileName = 'sample.pdf';
insert post;

FeedComment fcomment = new FeedComment();
fcomment.FeedItemId = fId; //Id of the FeedItem on which you want to comment
fcomment.CommentBody = 'Enter your comment here';
insert fcomment;

List<NewsFeed> myfeed = [SELECT Id, Type,
                         CreatedById, CreatedBy.FirstName, CreatedBy.LastName,
                         ParentId, Parent.Name,
                         Body, Title, LinkUrl, ContentData, ContentFileName,
                             (SELECT Id, FieldName, OldValue, NewValue
                              FROM FeedTrackedChanges ORDER BY Id DESC),
                             (SELECT Id, CommentBody, CreatedDate,
                              CreatedBy.FirstName, CreatedBy.LastName
                              FROM FeedComments ORDER BY CreatedDate LIMIT 10),
                             (SELECT CreatedBy.FirstName, CreatedBy.LastName
                              FROM FeedLikes)
                         FROM NewsFeed
                         ORDER BY CreatedDate DESC, Id DESC
                         LIMIT 20];

List<AccountFeed> myfeed = [SELECT Id, Type,
                         CreatedById, CreatedBy.FirstName, CreatedBy.LastName,
                         ParentId, Parent.Name,
                         Body, Title, LinkUrl, ContentData, ContentFileName,
                             (SELECT Id, FieldName, OldValue, NewValue
                              FROM FeedTrackedChanges ORDER BY Id DESC),
                             (SELECT Id, CommentBody, CreatedDate,
                              CreatedBy.FirstName, CreatedBy.LastName
                              FROM FeedComments ORDER BY CreatedDate LIMIT 10),
                             (SELECT CreatedBy.FirstName, CreatedBy.LastName
                              FROM FeedLikes)
                         FROM AccountFeed
                         WHERE ParentID = '<Account Id>'
                         ORDER BY CreatedDate DESC, Id DESC
                         LIMIT 20];

List<ContentDocumentLink> shares = [SELECT id, LinkedEntityId, ContentDocumentId
                                    FROM ContentDocumentLink
                                    WHERE ContentDocumentId = '<File Id>'];

trigger CheckChatterPostsOnOpportunity on FeedItem (before insert) {
    //Get the key prefix for the Opportunity object via a describe call.
    String oppKeyPrefix = Opportunity.sObjectType.getDescribe().getKeyPrefix();

    for (FeedItem f: trigger.new)
    {
        String parentId = f.parentId;
        //We compare the start of the 'parentID' field to the Opportunity key prefix to
        //restrict the trigger to act on posts made to the Opportunity object.
        if (parentId.startsWith(oppKeyPrefix) &&
            f.Body == '!close')
        {
            //Add business logic here
        }
    }
}

trigger MonitorUserStatusUpdates on User (before update) {
    for (Integer i = 0; i < trigger.new.size(); i++)
    {
        if (trigger.old[i].CurrentStatus != trigger.new[i].CurrentStatus)
        {
            //User has changed their Chatter status - take necessary action here.
        }
    }
}

//Note that this code can only be executed by a user with the 'Insert System Field Values
//for Chatter Feeds' permission
FeedItem post = new FeedItem();
post.ParentId = oId; //eg. Opportunity id, custom object id..
post.Body = 'Enter post text here';
post.CreatedById = <Salesforce User Id of the original post author>;
post.CreatedDate = <Date and time of original post>;
insert post;

FeedItem f = [select InsertedById from FeedItem where id =:post.Id];
System.assertEquals (f.InsertedById, UserInfo.getUserId());

Chatter Cheat Sheetを一通り検証し日本語に翻訳をしました。
※翻訳に誤ってる箇所がありましたらコメントにて指摘を頂けると助かります。
※「Chatterで使用している標準オブジェクト」と一緒にご覧ください。

Chatter Data Model
Chatterで使用する主なモデルは下記となります。

これら上記モデルがChatterデータの大部分を占めています。

• UserProfileFeedは、ユーザのプロフィール、ユーザのフィード変更情報が格納されています。
• NewsFeedはユーザのフォローしているユーザのフィード情報および所属しているグループのフィード情報が格納されます。
• CollaborationGroupFeedは所属しているグループのユーザの情報が格納されます。
• Record feedsは共有された各オブジェクトの情報が格納されます。

これらを総称してfeed itemsと呼びます。

ですがfeed itemsに全てのChatterデータが格納されるわけではありません。
コメントはFeedComment、フィードの詳細についてはFeedTrackedChangeに格納されます。
またこれらはUserProfile、NewsFeedから必要情報を取得して参照可能となります。

Feed Items

このオブジェクトはNewsFeed、UserProfileFeed、record feedsからできています。
Type項目は、何の情報であるかを意味します。（TextPost, LinkPost,ContentPost, TrackedChangeなど）
TrackedChangeの場合にはFeedTrackedChangeに詳細情報が格納されていいます。
これら以外のTypeの場合にはAccountFeed,CollaborationGroupFeed,NewsFeedのいずれかにデータが格納されています。
またフィードの情報はそれぞれ何によって作成されたかといった情報を持っています。
例えば自分のプロフィールを変更した際に作成されるプロフィール変更のフィードには自分のUserIDがParentIDとしてセットされます。

Record Feeds

Record Feedsは基本的に殆どのfeed情報が格納されています。
全てのfeed情報にFeedItemIDがあり、このIDを使用してUserProfileFeed、NewsFeedを取得することができます。

Create a new Text Post

FeedItem fItem = new FeedItem();
fItem.Type = 'TextPost';
fItem.ParentId = <Id of User or Record>;
fItem.Body = 'The mice will see you now';
insert fItem;

Typeについては変更できません。詳細はCurrentStatusを参照してください。
追加したデータは下記のページで確認できます。

• ホームタブ
• 投稿したデータの特定ページ
• プロフィールタブ

Record Feeds – FeedTrackedChanges

フィードの変更があったオブジェクト（ユーザやデータ）については、変更情報をrecord feedsに保持しています。
Record Feedsは標準オブジェクト用の名前が付与されます。例えばAccountはrecord feedを表すAccountFeedオブジェクトがあります。
カスタムオブジェクトについては、Foo__ｃが持ってるrecord feedsはFoo__Feedといった形になります。
項目が変更された等の詳細についてはFeedTrackedChangeに格納されます。

OpportunityFeed Feed Items on a Record

ID OpportunityId = <Id of an opportunity>;
List<OpportunityFeed> oRFeed = [
　　　　SELECT Id, Type, CreatedBy.Name, Parent.Name, Body
　　　　FROM OpportunityFeed WHERE ParentId = :OpportunityId
　　　　ORDER BY CreatedDate DESC, Id DESC LIMIT 20
　　　　];

Record Detail Page Query

ID accountId = <Id of an Account>;
List<AccountFeed> aRFeed = [
　　　　SELECT Id, Type, CreatedDate, CreatedById, CreatedBy.Name,
　　　　ParentId, Parent.Name, FeedItemId, Body,
　　　　Title, LinkUrl,
　　　　(SELECT Id, FieldName, OldValue, NewValue
　　　　　　　　FROM FeedTrackedChanges),
　　　　(SELECT Id, CreatedDate, CreatedById,
　　　　　　　　CreatedBy.Name, CommentBody
　　　　　　　　FROM FeedComments ORDER BY CreatedDate DESC)
　　　　FROM AccountFeed WHERE ParentId = :accountId
　　　　ORDER BY CreatedDate DESC, Id DESC LIMIT 10
　　　　];

このQueryはAccountレコードの詳細を表示するために使用します。
このクエリを少々変えることで、AccontFeedと異なるrecord feedを一緒に表示することも可能です。
結果についてはProfile Tab Queryでも記述しています。

NewsFeed

このオブジェクトは自分の投稿、フォローしているユーザの投稿、所属しているグループの投稿情報が格納されています。このオブジェクトはChatterタブに表示されています。
feedのParentIdにはユーザのID、フォローしているユーザのID、所属グループのIDがセットされます。
NewsFeedは自分自身の情報の閲覧可能です。

注意：
もしAcmeが私をフォローしたfeedを、私をフォローしているJACKが見た場合、ParentIDにはAcmeが設定されています。
誰による投稿か確認する場合はCreatedBy（システム項目）を使用します。

NewsFeed Feed Items on Users and Records I Follow

List <NewsFeed> aNewsFeed = [
　　　　SELECT Id, Type, CreatedBy.Name, Parent.Name, Body
　　　　FROM NewsFeed
　　　　ORDER BY CreatedDate DESC, Id DESC LIMIT 20
　　　　];

下記の例は使用中のChatterタブに表示されているフィードから省略したデータを戻します。
CreatedBy.Nameはフィードを作成したユーザを表示するため指定します。
Parent.Nameは使用ユーザ名またはフォローしているアイテム名が設定されます。
また対象フィードのTypeがTrackedChangeでない限り、nullとなる事はありません。

Chatter Tab Query

List <NewsFeed> aNewsFeed = [
　　　　SELECT Id Type CreatedDate
　　　　ParentId Parent.Name FeedItemId
　　　　Title LinkUrl
　　　　(SELECT Id FieldName OldValue
　　　　　　　　FROM FeedTrackedChanges)
　　　　(SELECT Id CreatedDate CreatedById
　　　　　　　　CreatedBy.Name CommentBody
　　　　　　　　FROM FeedComments ORDER BY CreatedDate DESC)
　　　　FROM NewsFeed ORDER BY CreatedDate DESC Id DESC LIMIT 10
　　　　];

UserProfileFeed

このオブジェクトは自分の投稿、プロフィールの変更情報および@を使用したダイレクトメッセージ情報が格納されています。
またこのフィード情報はSalesforce Chatterアプリケーションのプロファイルタブに表示されています。
UserProfileFeedのフィード情報では作成ユーザの情報を閲覧する事も可能です。

注意：UserProfileFeedを参照する場合、条件にUserIDが必須となります。

UserProfileFeed Feed Items indicating Posts a User has Made

ID userID = <id of User>;
List <UserProfileFeed> uposts = [
　　　　SELECT Id
　　　　FROM UserProfileFeed WHERE Type = 'TextPost'
　　　　WITH UserId=:userId
　　　　ORDER BY CreatedDate DESC, Id DESC LIMIT 10
　　　　];

このクエリでは指定したユーザに関連する直近10件の投稿情報を戻しています。
WITHを使用してどのユーザのプロファイル情報を取得するか指定します。
上記の例でWHERE句を省略した場合はType=trackedchangesを含んだレコードが戻ります。
ParentIdには更新したオブジェクトのIDがセットされています。

Profile Tab Query

ID userID = <id of User>;
List <UserProfileFeed> = [
　　　　SELECT Id Type CreatedDate
　　　　ParentId Parent.Name FeedItemId
　　　　Title LinkUrl LikeCount
　　　　(SELECT Id FieldName OldValue
　　　　　　　　FROM FeedTrackedChanges)
　　　　(SELECT Id CreatedDate CreatedById
　　　　　　　　CreatedBy.Name CommentBody
　　　　　　　　FROM FeedComments ORDER BY CreatedDate DESC)
　　　　FROM UserProfileFeed WITH UserId = :userId
　　　　ORDER BY CreatedDate DESC Id DESC LIMIT 10
];

このクエリではプロファイルタブの表示データを取得しています。
フィードに対して、コメントや「いいね」が紐付いてる場合には、1レコードに対して複数のリスト型のデータが戻ってきます。
またフィードのTypeがtrackedchangesの場合には、FeedTrackedChangeオブジェクトに関連するデータが格納され、プロファイル情報の更新ごとのレコードが作成されています。
なので、プロファイルを変更するユーザはFeedTrackedChangeオブジェクトを更新する権限が必要となります。

FeedTrackedChange

各フィードの変更情報が格納されています。このオブジェクトを参照する場合にはUserProfileFeed、NewsFeed、record feedを通じて行ってください。

Tracked Changes to a Record

ID OpportunityId = <Id of an opportunity>;
List<OpportunityFeed> oEFeedT = [
　　　　SELECT Id Type CreatedBy.Name
　　　　(SELECT OldValue NewValue FROM FeedTrackedChanges)
　　　　FROM OpportunityFeed
　　　　WHERE ParentId = :OpportunityId AND Type = 'TrackedChange'
　　　　ORDER BY CreatedDate DESC Id DESC LIMIT 20
];

上記の例は商談オブジェクトの変更情報を抽出しています。

FeedComment

このオブジェクトにはコメント情報が格納されています。
コメントは各フィードの子オブジェクトとなっており、UserProfileFeedやNewsFeedと紐付けての取得のみ可能となっています。

また投稿データのIDはユーザの変更により変わる可能性があるため、ParentIDを使用してどのオブジェクトに紐付いてるか確認することができます。

Create a Comment

FeedComment fcomment = new FeedComment();
fcomment.FeedItemId = <feedItemId>;
fcomment.CommentBody = 'This is a profound comment.';
insert fcomment;

上記の例を行うには、コメントを付加するFeedのItemIDが必要となります。

EntitySubscription

このオブジェクトでは、ユーザ／データのフォロー／フォロワーの関係が格納されています。

Followers of a User or Record

ID uid = <Id of User or Record>;
List<EntitySubscription> followers = [
　　　　SELECT Id, SubscriberId, Subscriber.Name
　　　　FROM EntitySubscription WHERE ParentId = :uid
　　　　];

List the Users and Records I Follow

ID uid = <Id of User>;
EntitySubscription[] followingES = [
　　　　SELECT Id, ParentId, SubscriberId, Parent.Name
　　　　FROM EntitySubscription WHERE SubscriberId = :uid
　　　　];

WHERE句にParent.Type=’User’を付加することでユーザのみ表示することが可能です。

List Subscriptions to Records

ID uid = <Id of User>;
List<EntitySubscription> les = [
　　　　SELECT Id, Parent.Name FROM EntitySubscription
　　　　WHERE SubscriberId = :uid AND ParentId IN
　　　　(SELECT Id FROM Account WHERE NumberOfEmployees >= 10)
　　　　];

上記の例は、従業員が10人以上取引先企業でフォローしているデータが取得できます。

CollaborationGroup

このオブジェクトにはChatterのグループ情報が格納されています。

CollaborationGroupにはCollaborationGroupFeedと呼ばれるGroup内のフィード情報を格納したデータを持っており、グループに所属するフィードを取得する際に使用します。

List Groups

List<CollaborationGroup> oG = [SELECT Name, Description,
CollaborationType, OwnerId from CollaborationGroup];

上記の例では、組織内全てのChatterグループを取得しています。CollaborationTypeにはPublicかPrivateのいずれかが設定されています。

List a Group’s Feed

ID cgid = <Id of a group>;
List<CollaborationGroupFeed> ic = [
　　　　SELECT Id, Type, ParentId, Parent.Name, FeedItem.Id,
　　　　FeedItem.Type , FeedItem.Body, FeedItem.Title,
　　　　(SELECT Id, FieldName, OldValue, NewValue
　　　　　　　　FROM FeedTrackedChanges ORDER BY Id DESC),
　　　　(SELECT Id, CommentBody, CreatedDate, CreatedById,
　　　　　　　　CreatedBy.FirstName, CreatedBy.LastName
　　　　　　　　FROM FeedComments
　　　　　　　　ORDER BY CreatedDate DESC, Id DESC LIMIT 4)
　　　　FROM CollaborationGroupFeed WHERE ParentId = :cgid
　　　　ORDER BY CreatedDate DESC, Id DESC LIMIT 20
　　　　];

グループの名前や説明を変更した際には、変更情報が表示されます。
上記の例ではグループのフィード・変更情報および付随するコメントを取得しています。

CollaborationGroupMember

このオブジェクトにはChatterグループのメンバー情報が格納されています。

List Members of a Group

ID cg = <Id of a Chatter group>;
List<CollaborationGroupMember> oM = [
　　　　SELECT MemberId, CollaborationGroup.Name
　　　　FROM CollaborationGroupMember WHERE CollaborationGroupId = :cg
　　　　];

上記の例では、指定したグループのメンバーIDと名称を取得します。

Add a User to a Group

ID uid = <Id of a user>;
ID cgid = <Id of a group>;
CollaborationGroupMember cgm = new CollaborationGroupMember(
memberid = uid, collaborationgroupid = cgid);
insert cgm;

CollaborationGroupMemberRequest

このオブジェクトでは、非公開グループにおけるユーザの申請情報が格納されています。
また自分が管理者となっているグループにおいては、承認・却下の操作も可能です。
create()を使用することで、グループの管理者に対して申請メールを送る事ができます。
グループの管理者による承認・却下を行った際に、申請者にメールで通知されます。
また却下の場合は理由を通知する事が可能です。

CurrentStatus

ユーザがChatterで投稿を行った際には、UserオブジェクトのCurrentStatusが更新されます。
またUserProfileFeedにおいても更新が行われます。

Update a User’s Status

ID uid = <Id of User>;
User user = [SELECT Id, CurrentStatus FROM User WHERE Id = :uid];
user.CurrentStatus = 'new and exciting status message';
update u;

上記の例ではユーザ投稿の更新を行います。
注意：ユーザ投稿を削除した場合、CurrentStatusの値はクリアされません。

Chatter Triggers

FeedItem、FeedCommentではApexTriggerを作成する事ができます。
record feedにおいては作成できませんが、ユーザの行動のrecord feedにおいては作成可能です。
Triggerは追加・削除のみ対応しています。FeedItemのTypeがTextPost,LinkPost,ContentPostの追加時に行うことができます。
ユーザのステータス情報更新ではTriggerは動作しません。

Apex CodeではChatterコンテキスト内の処理のみ追記可能です。

トリガーを使用して非公開グループに対して投稿を行う際には、グループに所属しているメンバーでなければなりません。
グループに所属していないメンバーの場合は、CreatedByIdにメンバーのIDがセットされFeedItemが作成されます。

下記の例では、誰かが投稿を行った時に動作するTriggerです。
例えば特定の文字に基づいて処理を実施することもできます。
（例：商談がクローズとなった場合に処理を行う。）

Trigger CheckChatterPostsOnOpportunity on FeedItem (before insert)
{
　　　　// Get the key prefix for the Opportunity object
　　　　// using a describe call.
　　　　String oppKeyPrefix = Opportunity.sObjectType.getDescribe().
　　　　getKeyPrefix();
　　　　for (FeedItem f: trigger.new)
　　　　{
　　　　　　　　String parentId = f.parentId;
　　　　　　　　// Compare the start of the 'parentID' field
　　　　　　　　// to the Opportunity key prefix to
　　　　　　　　// restrict the trigger to act on posts made to the
　　　　　　　　// Opportunity object.
　　　　　　　　if (parentId.startsWith(oppKeyPrefix) &&
　　　　　　　　f.Body == '!close')
　　　　　　　　{
　　　　　　　　　　　　// Add your business logic here
　　　　　　　　}
　　　　}
}

Writing Efficient Chatter Triggers

• 組織内のトリガーはすべて把握しておく
• isEmptyを使用して、ロジックの制限を行う
• トリガー処理の共通化
  ※殆どのトリガーはFeedItemまたはFeedCommentで起動
• UserStatusはUser上にある事に注意する
• FeedItemは絞り込んで処理を行う。
  ※トリガーでのフィードTypeの種類は、TextPost, LinkPost, ContentPost
  ※トリガーで、オブジェクトのTypeを識別するのは下記の形式を使用する

ContentDocumentLink

ContentDocumentLinkではSalesForceCRMやChatterにアップされたファイルが、Chatterで共有された情報が格納されます。
ファイルは他のユーザ、Chatterグループ、SalesForceCRMと共有する事ができます。
例えばChatterでアップロードを行ったファイルのタイトル、説明を検索する事ができます。

SELECT ContentDocument.LatestPublishedVersion.Title,
　　　　ContentDocument.LatestPublishedVersion.Description
　　　　FROM ContentDocumentLink
　　　　WHERE LinkedEntityid = '<entity-id>'

CollaborationInvite

このオブジェクトを使用する事でChatterに招待／削除ができます。
招待ではChatter（グループなし）またはChatter内グループのいずれかとなります。
Chatter内グループに招待する事でChatter（グループなし）の閲覧も可能となります。
招待されたユーザはグループ内のプロファイルやフィードの閲覧は可能ですが、他のデータについては閲覧できません。

Writing Efficient SOQL Queries

• フィードを抽出する際はLIMITを使用して、1回20件程度とする
• 抽出条件は(ParentId、Id、ParentType、CreatedById)を使用する
• records feedの取得ではParentID = を使用する
• ORDER BY CreateDate DESC, ID DESCで抽出を行う
  ※直近のデータを抽出

Chatterで使用する主な標準オブジェクトは下記となります。

UserProfileFeed
ユーザのプロフィール、ユーザのフィード変更情報が格納。条件にWITH UserId=’＊＊＊’が必須。

NewsFeed
Chatter内全体のデータが参照できる。非公開としているグループのデータも参照可能

CollaborationGroupFeed
グループで発信しているFeedの情報が格納

UserFeed（record feed）
ユーザに関するフィードのみ集約されている。（オブジェクトのフィードはなし）

AccountFeed（record feed）
取引先におけるフィード情報（LeadFeed、ContactFeedも類似）

FeedTrackedChange
フィードの変更があったオブジェクト（ユーザやデータ）を保持。直接オブジェクトの参照はできない。

FeedComments
フィードに対するコメント情報

FeedLikes
フィードに対する「いいね」情報

FeedPost
バージョン21において削除。FeedItemに移行。

FeedItem
使用する際には必ずIDを条件にセットする必要がある。

EntitySubscription
Chatterにおけるフォロー・フォロワーの関係情報

CollaborationGroup
組織内に存在するグループ情報

CollaborationGroupMember
組織内に存在するグループの所属メンバー情報

CollaborationGroupMemberRequest
ユーザがグループに所属申請を実施した場合に作成されるデータ

CollaborationInvitation
Chatterに同僚をメールで招待した際に作成される情報

ContentDocument
組織内において、CRMやChatterでアップロードしたファイルの情報

ContentDocumentLink
アップロードされたファイルのリンク情報

先日の「F8」において様々な新機能が発表され、更に躍進を見せるFaceBookですが
ここでAPEXによる基本的なFaceBookGraphAPIの使用方法をまとめてみました。

①アクセストークン取得の流れ

事前準備
下記サイトにアクセスし、開発者の許可を行い、FaceBookアプリを作成しAppID、AppSecretを取得します。
https://www.facebook.com/developers/
＜開発者の許可画面＞

＜アプリ作成画面＞

１．Webアプリ上から、下記URLにGETパラメータを付加して、FaceBookの認証画面にリダイレクトを行います。
＜認証ダイアログURL＞
https://graph.facebook.com/oauth/authorize

パラメータ名	値
client_id	AppID
redirect_uri	FaceBook認証画面からリダイレクトされるURL
scope	使用するGraphAPIの権限（カンマ区切り）

＜例＞

PageReference pFbLogin = new PageReference('https://graph.facebook.com/oauth/authorize?client_id=AppID&redirect_uri=http%3A%2F%2Fsample.com%2F&scope=offline_access,read_stream');
return pFbLogin.setRedirect(true);

ログイン済みであれば下記のようなダイアログが表示されます。
（ダイアログの例では使用するGraphAPIの権限を全て設定した場合）

２．認証画面にてユーザが許可した場合、GETパラメータにcodeが付加された形式でリダイレクトされるので、下記URLにアクセスしAccessTokenを取得します。
＜AccessToken取得URL＞
https://graph.facebook.com/oauth/access_token

パラメータ名	値
client_id	アプリ登録画面で表示されたAppID
client_secret	アプリ登録画面で表示されたAppSecret
code	GETパラメータ”code”の値

＜例＞

Http h = new Http();
Httprequest req = new Httprequest();
req.setEndpoint('https://graph.facebook.com/oauth/access_token?client_id=AppID&client_secret=AppSecret&code=code');
req.setMethod('GET');
HttpResponse res = h.send(req);

３．上記の戻り値（res.getBody()）が”access_token=アクセストークン”の形式で戻ってくるので、この値を保持しGraphAPIのアクセス時に使用します。
※アプリのアクセストークンについてはGraphAPIにおいてUser情報のme/accountsから取得できます。
（後述参照）

②GraphAPI全体概要

③APIのURIおよび戻り値

・APIの戻り値（picture以外はJSON形式）

FaceBookの機能およびAPIは逐次追加されるので、当記事も合わせて更新していきます。

TwitterのAPIをForce.com上で使用するため、Oauth認証を用いたAPEXのライブラリを探してみましたが
これといったライブラリが見つからなかったため、自前で作成しました。

Webアプリにおいて、Oauth認証を用いて、TwitterAPIを利用するには以下の手順が必要となります。
　①Twitterにログインして、アプリ情報を登録する。
　②登録したアプリの情報を使用し、Twitterに通信してRequest tokenを取得する。
　③Request tokenを使用して、Twitter認証画面にリダイレクトする。
　④Twitter認証画面から戻ってきた際に付加されたGETパラメータを使用してAccesstokenを取得する。
　⑤Access tokenを使用して、各TwitterのAPIをコールする。

上記を踏まえて、下記に自分のタイムラインを表示する説明および例を記載します。

①Twitterにログインして、アプリ情報を登録します。
※こちらは参考サイトが多数ありますので説明は割愛します。

②アプリ登録画面に表示されたConsumer key、Consumer secret、Request token URLを使用してRequest tokenを取得します。Request token URLに対して、下記GETパラメータを付加して通信を行います。

Encodingutil.urlEncode('任意のURL','UTF8')

//1～9の値を使用して乱数を作成する
String CharList = '123456789';
String Res = '';
integer position;
//8桁の乱数を作成
for(Integer i = 0; i < 8; i++) {
 position = Integer.valueof(String.valueof(Math.roundToLong(CharList.length()*Math.random()))) -1;
 if(position==-1)position=0;
 Res += CharList.substring(position,position+1);
}
//現在のミリ秒を戻す
DateTime d = System.now();
String now_mm_second = String.valueOf(d.year() + d.month() + d.day() + d.hour() + d.minute() + d.second() + d.millisecond());
//乱数と現在日時を繋げた値からMD5に変換し、この値をセットする
EncodingUtil.convertToHex(Crypto.generateDigest('MD5', Blob.valueOf(now_mm_second + Res))) ;

String.valueOf(Datetime.now().getTime()).substring(0, 10);

//送信方式、送信URL、送信パラメータを&区切りでセットし、URLエンコードを行う
//注意点としてはoauth_callbackのURLは2回URLエンコードを行うイメージ
String sSignatureSource = 'GET&
							https%3A%2F%2Fapi.twitter.com%2Foauth%2Frequest_token&
							oauth_callback%3D【任意のURLを2回エンコードした文字列】%26
							oauth_consumer_key%3D【アプリ登録画面に表示されたConsum key】%26
							oauth_nonce%3D【上記方法で作成した文字列】%26
							oauth_signature_method%3DHMAC-SHA1%26
							oauth_timestamp%3D【上記方法で取得した文字列】%26
							oauth_version%3D1.0';

//アプリ登録画面で表示されたConsumer secretを利用してHMAC-SHA1ハッシュ変換で使用するキーを作成
String sHashKey = 【アプリ登録画面に表示されたConsumer secret】+'&';

//上記で作成した2つの文字列を使用して、oauth_signatureの値を作成
Blob blbSignature = Crypto.generateMac('HMacSHA1', Blob.valueOf(sSignatureSource),Blob.valueOf(sHashKey));
EncodingUtil.urlEncode(EncodingUtil.base64Encode(blbSignature), 'UTF-8');

//カスタムオブジェクトに登録
TwitterRequestToken__c oTwiOa_ins = new TwitterRequestToken__c();
oTwiOa_ins.token__c = oauth_token;
oTwiOa_ins.token_secret__c = oauth_token_secret;
insert oTwiOa_ins;

//ログイン画面にリダイレクト
PageReference pTwitterLogin = new PageReference('https://twitter.com/oauth/authenticate?oauth_token='+oauth_token);
return pTwitterLogin.setRedirect(true);

※アプリ登録画面のAuthorize URLではhttps://api.twitter.com/oauth/authorizeが表示されますが、上記のURL（/authenticate）を使用することで、既にTwtterにログイン済みでアプリの許可を行っている場合は認証画面が表示されず、コールバックに指定したURLに直接リダイレクトされます。

④コールバックされた際のGETパラメータであるoauth_token、oauth_verifierを使用してAccess tokenを取得します。アプリ登録画面に表示されたAccess token URLに対して、下記GETパラメータを付加して通信を行います。またoauth_token_secretも使用するので、先ほど登録したカスタムオブジェクトより、GETパラメータのoauth_tokenを条件に抽出します。

//Request token取得で作成した方法と基本的には同じ
//異なる点としてHMAC-SHA1ハッシュ変換で使用するキーにoauth_token_secretも使用
String sSignatureSource = 'GET&
							https%3A%2F%2Fapi.twitter.com%2Foauth%2Faccess_token&
							oauth_consumer_key%3D【アプリ登録画面に表示されたConsum key】%26
							oauth_nonce%3D【コールバック後、再作成するnonce文字列】%26
							oauth_signature_method%3DHMAC-SHA1%26
							oauth_timestamp%3D【コールバック後、再取得するtimestamp文字列】%26
							oauth_token%3D【コールバックされた際のGETパラメータ】%26
							oauth_verifier%3D【コールバックされた際のGETパラメータ】%26
							oauth_version%3D1.0';

//アプリ登録画面で表示されたConsumer secretおよびReqest tokenを利用してHMAC-SHA1ハッシュ変換で使用するキーを作成
String sHashKey = 【アプリ登録画面に表示されたConsumer secret】+'&'+【カスタムオブジェクトより取得したoauth_token_secret】;

//上記で作成した2つの文字列を使用して、oauth_signatureの値を作成
Blob blbSignature = Crypto.generateMac('HMacSHA1', Blob.valueOf(sSignatureSource),Blob.valueOf(sHashKey));
EncodingUtil.urlEncode(EncodingUtil.base64Encode(blbSignature), 'UTF-8');

⑤Access tokenを使用して、ログインユーザのタイムライン情報を取得します。
※各APIのアクセスURLについては他サイトに多数ありますので、そちらを参照してください。

ユーザのタイムラインを取得するURL：http://api.twitter.com/1/statuses/home_timeline.xml

//Access token取得で作成した方法と基本的には同じ
//異なる点としてはHMAC-SHA1ハッシュ変換で使用するキーにRequest tokenのoauth_token_secretから
//Access tokenのoauth_token_secretに変更
String sSignatureSource = 'GET&
							http%3A%2F%2Fapi.twitter.com%2F1%2Fstatuses%2Fhome_timeline.xml&
							oauth_consumer_key%3D【アプリ登録画面に表示されたConsum key】%26
							oauth_nonce%3D【リクエスト時に再作成するnonce文字列】%26
							oauth_signature_method%3DHMAC-SHA1%26
							oauth_timestamp%3D【リクエスト時に再取得するtimestamp文字列】%26
							oauth_token%3D【Access token】%26
							oauth_version%3D1.0%26
							source_screen_name%3D【ユーザ名】';

//アプリ登録画面で表示されたConsumer secretおよびAccess tokenを利用してHMAC-SHA1ハッシュ変換で使用するキーを作成
String sHashKey = 【アプリ登録画面に表示されたConsumer secret】+'&'+【Access tokenのoauth_token_secret】;

//上記で作成した2つの文字列を使用して、oauth_signatureの値を作成
Blob blbSignature = Crypto.generateMac('HMacSHA1', Blob.valueOf(sSignatureSource),Blob.valueOf(sHashKey));
EncodingUtil.urlEncode(EncodingUtil.base64Encode(blbSignature), 'UTF-8');

ここまでが一連の流れとなります。AccessTokenについてはユーザ・アプリ単位で一意となり
無期限で使用できるため、予め使用ユーザが分かっていれば上記④までの初回のみでOKです。
※RequestTokenについては1度しか使用できないようです。

また上記のサンプルソースをこちらで公開しています。

先日フィリピンにて短期英語留学をしてきました。1週間と短い期間でしたが非常に有意義な時間を過ごすことができました。

昨今スカイプ経由のフィリピン人との英会話が話題になっていますが、実際に現地で学ぶタイプの学校もいくつかあります。 私は検索で見つけたCNE1 という学校に滞在しました。この体験記が同様の検討をされている皆様の参考になれば幸いです。

• 教育スタイル
  CNE1の一日の流れは以下のようになります。
  07:00～07:30　朝食
  08:00～09:50　レッスン2時間（途中10分間の休息）
  10:00～11:50　レッスン2時間（途中10分間の休息）
  12:00～12:50　ランチタイム
  13:00～14:50　レッスン2時間（途中10分間の休息）
  15:00～15:50　インターカルチャルプログラム ／ フリースタイルクラス
  16:00～17:50　レッスン2時間（途中10分間の休息）
  18:00～19:30　ディナータイム
  19:30～　自習・休息
  午後の2時間x2レッスンはとらないこともできます。私は1週間だったので大丈夫でしたが長期滞在の場合は8時間／日の授業はきつくなる場合があるようで、自分の体力、滞在時間、学習ペースとの相談になります。また土日はお休みで各々の時間を過ごします。休んだり勉強したりショッピングに行ったり海や山や観光地に行ったり自由です。
  私は発音・リスニングの授業に重点を置いていたのですが そのことを事前に伝えれば別のレッスンでも発音・リスニングを重点的に教えてくれます。先生達は生徒のレベルを的確に把握してガイドしてくれます。
  ほとんどの先生は20代女性で友達感覚で授業を受けられます。話題がレッスンから横道にそれる場合も多くそこから得るものも多かったです。また授業の課題もシリアスな物が多かったので（結婚、人種、IT技術、犯罪、等々）必然的に深いコミュニケーションをカジュアルに体験することができました。

• 生活環境
  学校と宿泊場所と食堂は同じ場所にあり滞在中は生活のほとんどの時間を生徒／先生と共に過ごします。住み込みの先生も多く、校庭や自習室や食堂には常に誰かがいて全員が気軽に話しかけ合い、家族のような感覚でした。勉強以外にも、ふざけあったり楽器弾いたり歌ったり運動したり、と好き勝手に過ごせます。生活を共に過ごす中で授業以外の時間から得るものは非常に多かったです。代表の井坂さんはそのような気軽にコミュニケーションできる空間を意識的に作っておられるとのことでした。

  また、学校はマニラから車で3時間ほど走る片田舎にあります。もちろんバス等で移動はできるのですが、現地はある種の隔離空間になっています。それ故の高揚感や連帯感が学習環境として非常に有用に機能しているように感じました。

• 生徒層
  時期とタイミングによって生徒層は異なりますが、私の滞在中は9割が日本人、8割が大学生といった感じでした。韓国人や社会人がもっと多いときもあるそうです。
• 仕事環境
  肝心の仕事環境ですが、4Mの無線LANが用意されています。インターネット環境は重視されており滞在中にもどんどんアンテナが追加されていました。コンセントの数はそれほど多いわけではないのでACタップを持参すると良いかもしれません。私の場合はほとんどクラウド環境で仕事しているということもあり、ノートPC一台あればPC環境的困ることはありませんでした。

  空調も整備されており暑さも余り気にならず、むしろ日差しの下で外で仕事するのも新鮮で心地よかったです。また、現在新校舎を建設中で年内には完成しそうでした。個室や電源や空調が整備されてより仕事のしやすい環境になりそうです。

  電話については、日本のを持って行ってローミングで通話もできますし、ほとんどの時間を校内で過ごすので無線LAN経由のSkypeでも十分です。また多くの方は現地のプリペイド携帯を使っていました。

• 訛り
  フィリピンでの英語学習ということで訛りを気にされる方も多いかと思います。私の印象としては人それぞれという感じで、訛りというよりも個々の先生の癖や学習環境に依存するような気がしました。基本的にはアメリカ英語を学習するにあたってはそれほど支障にはなりませんでした。
• 今後に期待する点
  唯一予想と違った点として、私の場合は完全に日本語を断絶する環境を求めていたのですが、ほとんどの生徒は日本人だったため生活の中で日本語を話すことができてしまうのが残念な点です。「English Speaking Only」というラベルを胸に貼ったりみんな色々工夫はしています。ただ次はもう少し長期で完全な日本語断絶環境にも挑戦してみたいと思っています。
• まとめ
  代表の井坂さんはインターネット業界出身で、1年半前からCNE1を始められました。非常にエネルギッシュな方で、ネットの世界で起きているさまざまな新しい考え方の潮流、フラット化／民主化／クラウド化などを別の業界にも応用したい、その一つがフィリピン英会話とおっしゃっておりました。その戦略は非常に的を射ているように感じます。

  多くの日本企業が英語を重視する中で、『TOEIC』で一定スコアをとるまでフィリピン英語学校に缶詰、というネット企業も出てきていると聞きました。地理的、経済的なメリットを活かし仕事も十分に両立可能なフィリピン英会話は今後も更に発展するのではないかと思います。

※ガジェット通信さんに寄稿させて頂きました。

連載第3回です。

TechTarget – おススメForce.comアプリ紹介【第3回】 Webサイト構築を支援するForce.comアプリケーション

ぜひご覧ください！

7月に注文していたChromebookがやっと届きました。購入してきてくれたまめこさんありがとう！

9月に日本でも販売開始するらしいですが、これは米国で販売されているサムスンのWifiモデルです。これは米Amazon経由だったようですが、日本では企業向け月額プランが開始するようなのでどんな流通で販売されるのでしょうかね。期待です。

まだまだ募集してます、クラウドシステム開発プログラマ。特に以下の経験者大歓迎です。

• プロジェクトマネジメント経験
• AJAX開発経験
• その他Web開発経験

詳細はこちら：
http://uhuru.co.jp/recruit/index.html#cs_engineer

今年度で社員数は倍増し現在約40名となりました。秋にはオフィス拡張のために引っ越しを行います。

クラウドに興味のある方、今までとはひと味違った業務システム開発をしてみたい方、Web技術の新しい可能性を追求してみたい方、ご応募お待ちしてます！