このページは Cloud Translation API によって翻訳されました。

デベロッパーガイド: .NET

重要: v2.0 Google Data API のサポートは 2024 年 9 月 30 日に終了します。機能が継続して利用できるように、v2.0 Google Data API に依存するアプリケーションを最新の API バージョンに更新してください。最新バージョンについては、左側のナビゲーションバーのリンクを使用してください。注: 一部の GET リクエスト（リスティング投稿など）は引き続きフィード URL としてサポートされますが、動作に若干の違いがあります。詳しくは、Blogger ヘルプのドキュメントをご覧ください。

Blogger Data API を使用すると、クライアントアプリケーションは Google Data API フィード形式で Blogger コンテンツを表示および更新できます。

クライアントアプリケーションは Blogger Data API を使用して、新しいブログ投稿の作成、既存のブログ投稿の編集または削除、特定の条件に一致するブログ投稿のクエリを実行できます。

このドキュメントでは、Blogger Data API の機能に関する背景情報に加えて、.NET クライアントライブラリを使用した Data API の基本的な操作例も説明します。ライブラリで使用される基盤となるプロトコルの詳細については、このデベロッパーガイドのプロトコルセクションをご覧ください。

対象
スタートガイド
1. Blogger アカウントを作成する
2. サンプルコードの実行
Blogger サービスへの認証
1. AuthSub プロキシ認証
2. ClientLogin のユーザー名/パスワード認証
ブログのリストを取得する
投稿を作成する
1. ブログ投稿を公開する
2. ブログ投稿の下書きを作成する
投稿の取得
1. すべてのブログ投稿を取得する
2. クエリパラメータを使用して投稿を取得する
投稿の更新
投稿の削除
コメント

オーディエンス

このドキュメントは、Blogger とやり取りできる .NET クライアントアプリケーションを作成するプログラマを対象としています。

このドキュメントは、Google Data APIs プロトコルの基本的な考え方を理解していることを前提としています。

クライアントライブラリで提供されるクラスとメソッドに関するリファレンス情報については、.NET クライアントライブラリ API リファレンスをご覧ください。Blogger Data API の一般的なリファレンス情報については、プロトコルリファレンスガイドをご覧ください。

スタートガイド

クライアントライブラリの設定については、スタートガイドをご覧ください。

.NET クライアントライブラリを使用するには、.NET 1.1 ランタイムが必要です。また、すべてのパッチが最新の状態である必要があります。クライアントライブラリをダウンロードすると、ディストリビューションの lib/Release サブディレクトリに、使用開始に必要な DLL が見つかります。

Blogger アカウントを作成する

テスト用に Blogger アカウントを登録することをおすすめします。Blogger は Google アカウントを使用しているため、すでに Google アカウントをお持ちの場合は、すぐにご利用いただけます。

サンプルコードの実行

このドキュメントに記載されているすべてのサンプルコードを含む、完全なサンプルクライアントは、.NET クライアントライブラリプロジェクトで入手できます。このサンプルは、SVN リポジトリの [ソース] タブの /trunk/clients/cs/samples/blogger/ConsoleSample.cs にあります。

このサンプルをコンパイルして実行する前に、username、password、blogName、postId の値を適切な値に更新します。username 値と password 値は、Blogger へのログインに使用される認証情報を表します。blogName 値は、ブログの blogspot URL の先頭です。

サンプルクライアントは、指定されたブログに対していくつかのオペレーションを実行し、Blogger Data API の使用方法を示します。

このドキュメントのサンプルを独自のコードにコンパイルするには、次の using ステートメントが必要です。

using Google.GData.Client;
using System.Net;
using System.Xml;
using System.Text.RegularExpressions;

Blogger サービスへの認証

Blogger Data API を使用すると、公開フィードと限定公開フィードの両方にアクセスできます。公開フィードには認証は必要ありませんが、読み取り専用です。ブログを変更する場合は、クライアントが限定公開フィードをリクエストする前に認証する必要があります。AuthSub プロキシ認証または ClientLogin ユーザー名とパスワードによる認証のいずれかを使用して認証できます。

Google Data API での認証の詳細については、認証のドキュメントをご覧ください。

AuthSub プロキシ認証

AuthSub プロキシ認証は、Google アカウントのユーザーを認証する必要があるウェブアプリケーションで使用されます。ウェブサイト運営者とクライアントコードは、Blogger ユーザーのユーザー名とパスワードにアクセスできません。代わりに、クライアントは、特定のユーザーに代わってクライアントが操作できるようにする特別な AuthSub トークンを取得します。詳細については、AuthSub のドキュメントをご覧ください。

ユーザーが初めてアプリケーションにアクセスした時点では、認証は行われていません。この場合は、ブログへのアクセスリクエストの認証を行う Google ページにユーザーを誘導する情報とリンクを表示する必要があります。

ページに次の ASP ハイパーリンクが定義されているとします。

<asp:HyperLink ID="GotoAuthSubLink" runat="server"/>

次に、アプリケーションの AuthSubRequest URL を作成するために、次のように .NET クライアントライブラリを呼び出します。

GotoAuthSubLink.Text = "Login to your Google Account";
GotoAuthSubLink.NavigateUrl =
  AuthSubUtil.getRequestUrl("http://www.example.com/RetrieveToken",
  "http://www.blogger.com/feeds/",
  false,
  true);

getRequestUrl メソッドは、AuthSubRequest ハンドラで使用されるクエリパラメータに対応する次のパラメータを受け取ります。

次へ: 認証後にユーザーをリダイレクトするページの URL。
スコープ: Blogger フィードにアクセスするためのトークンをアプリがリクエストしていることを示します。使用するスコープ文字列は http://www.blogger.com/feeds/ です（もちろん URL エンコードされています）。
安全: クライアントがセキュアトークンをリクエストしているかどうかを示します。
セッション: 返されたトークンを複数回使用（セッション）トークンと交換できるかどうかを示します。

上記の例は、安全なトークンをリクエストしない呼び出しを示しています（secure の値は false です）。結果として生成されるリクエスト URL は次のようになります。

https://www.google.com/accounts/AuthSubRequest?scope=http%3A%2F%2Fwww.blogger.com%2Ffeeds%2F&session=1&secure=0&next=http%3A%2F%2Fwww.example.com%2FRetrieveToken

ユーザーが Google のサイトにリンクをたどり、Google アカウントで認証します。

ユーザーが認証されると、AuthSub システムは AuthSubRequest URL の next クエリパラメータで指定した URL にユーザーをリダイレクトします。AuthSub システムは、token クエリパラメータの値として、その URL に認証トークンを追加します。したがって、トークンは ASP ページの Request.QueryString オブジェクト内の変数としてアクセスできます。ユーザーは次のような URL にリダイレクトされます。

http://www.example.com/RetrieveToken?token=yourAuthToken

このトークン値は、1 回限りの AuthSub トークンを表します。この例では、session = true が指定されているため、このトークンは次のように AuthSub セッショントークンと交換できます。

SessionsessionToken = AuthSubUtil.exchangeForSessionToken(Request.QueryStringtoken, null);

つまり、1 回限りのトークンを exchangeForSessionToken メソッドに渡し、null（未登録モードの場合）または秘密鍵（登録済みモードの場合）を渡すと、AuthSub インターフェースがセッショントークンを返します。登録済みのアプリケーションと秘密鍵の詳細については、AuthSub のドキュメントのリクエストの署名セクションをご覧ください。

その後、アプリケーションは、Blogger との以降のやり取りでセッショントークン値を使用できます。リクエストごとに（セッショントークンを含む）Authorization ヘッダーを自動的に送信するように .NET クライアントライブラリに指示するには、次の操作を行います。

GAuthSubRequestFactory authFactory = new GAuthSubRequestFactory("blogger", "BloggerSampleApp");
authFactory.Token = SessionsessionToken.ToString();
Service service = new Service(authFactory.ApplicationName);
service.RequestFactory = authFactory;

ClientLogin ユーザー名/パスワード認証

クライアントがスタンドアロンのシングルユーザーの「インストール済み」クライアント（デスクトップアプリケーションなど）の場合は、ClientLogin 認証を使用します。次のように、Service オブジェクトの認証情報を設定します。

Service service = new Service("blogger", "exampleCo-exampleApp-1");
service.Credentials = new GDataCredentials("user@example.com", "secretPassword");
GDataGAuthRequestFactory factory = (GDataGAuthRequestFactory) service.RequestFactory;
factory.AccountType = "GOOGLE";

上のスニペットでは、2 つのパラメータを Service コンストラクタに渡しています。最初のパラメータは、操作するサービスの名前です。2 番目のパラメータは、companyName-applicationName-versionID 形式のアプリケーション名です。また、G Suite ユーザーの適切な認証を可能にするため、Service.RequestFactory を GOOGLE アカウントタイプのみを使用するように設定しています。

リクエストとレスポンスのサンプルなど、ClientLogin 認証の詳細については、インストール済みアプリケーションの認証のドキュメントをご覧ください。

注: 特定のセッション内のすべてのリクエストに同じトークンを使用します。Blogger リクエストごとに新しいトークンを取得しないでください。

注: ClientLogin のドキュメントに記載されているように、認証リクエストが失敗し、CAPTCHA チャレンジがリクエストされる場合があります。Google に CAPTCHA チャレンジの発行と処理を任せる場合は、ユーザーを https://www.google.com/accounts/DisplayUnlockCaptcha?service=blogger にリダイレクトします（ClientLogin のドキュメントに記載されている CAPTCHA 処理 URL ではなく）。

ブログのリストを取得する

Blogger Data API は、特定のユーザーのブログを一覧表示するフィードを提供します。このフィードは「メタフィード」と呼ばれます。

次のサンプルコードでは、認証済みの Service オブジェクトを使用してメタフィードを取得し、各ブログのタイトルを出力します。

query.Uri = new Uri("http://www.blogger.com/feeds/default/blogs");
AtomFeed feed = null;
try
{
  feed = service.Query(query);
  foreach (AtomEntry entry in feed.Entries)
  {
    Console.WriteLine("Blog Title: " + entry.Title.Text);
  }
}

getFeed メソッドで使用されている URL をメモします。これはデフォルトのメタフィード URL で、現在認証されているユーザーのブログのリストを返します。別のユーザーのフィードにアクセスするには、メタフィード URL の default の代わりにユーザー ID を指定します。ユーザーの ID は、ユーザーのプロフィール URL の末尾にある数字の文字列です。

投稿の作成

Blogger Data API を使用すると、新しいブログ投稿を作成して公開したり、投稿の下書きを作成したりできます。

次のサンプルはすべて、認証済みの Service オブジェクトがあることを前提としています。

注: 現在のところ、投稿のカスタム作成者は設定できません。新しい投稿はすべて、現在認証されているユーザーによって作成されたものとして表示されます。

ブログ投稿の公開

.NET クライアントライブラリを使用して、新しいブログ投稿を公開できます。

まず、ブログ投稿を表す AtomEntry オブジェクトを作成します。次に、ブログ投稿のタイトル、コンテンツなどの属性を設定します。最後に、Service オブジェクトを使用して投稿を挿入します。新しいブログ投稿を公開する方法の例を次に示します。

AtomEntry newPost = new AtomEntry();
newPost.Title.Text = "Marriage!";
newPost.Content = new AtomContent();
newPost.Content.Content = "<div xmlns='http://www.w3.org/1999/xhtml'>" +
  "<p>Mr. Darcy has <em>proposed marriage</em> to me!</p>" +
  "<p>He is the last man on earth I would ever desire to marry.</p>" +
  "<p>Whatever shall I do?</p>" +
  "</div>";
newPost.Content.Type = "xhtml";

Uri blogFeedUri = new Uri("http://www.blogger.com/feeds/" + blogId + "/posts/default");
AtomEntry createdEntry = service.Insert(blogFeedUri, newPost);

Insert メソッドは、サービスの投稿 URL をパラメータとして受け取ります。その後、このメソッドは Blogger によって保存されたエントリを返します。返されるエントリは送信したエントリと同じですが、投稿 ID など、Blogger によって追加されたさまざまな要素も含まれています。

なんらかの理由でリクエストが失敗した場合、Blogger から別のステータスコードが返されることがあります。ステータスコードについては、Google Data API プロトコルリファレンスドキュメントをご覧ください。

ブログ投稿の下書きを作成する

下書き投稿は公開投稿と同じ方法で作成されますが、AtomEntry オブジェクトの draft 属性を設定する必要があります。上記のブログ投稿は、ハイライト表示された行を追加することで下書きとして作成できます。

AtomEntry newPost = new AtomEntry();
newPost.Title.Text = "Marriage!";
newPost.Content = new AtomContent();
newPost.Content.Content = "<div xmlns='http://www.w3.org/1999/xhtml'>" +
    "<p>Mr. Darcy has <em>proposed marriage</em> to me!</p>" +
    "<p>He is the last man on earth I would ever desire to marry.</p>" +
    "<p>Whatever shall I do?</p>" +
    "</div>";
newPost.Content.Type = "xhtml";
newPost.IsDraft = true;

Uri blogFeedUri = new Uri("http://www.blogger.com/feeds/" + blogId + "/posts/default");
AtomEntry createdEntry = service.Insert(blogFeedUri, newPost);

既存の下書きのブログ投稿を公開済み投稿にするには、下書き投稿を取得し、下書き属性を false に設定してから、投稿を更新します。投稿の取得と更新については、次の 2 つのセクションで説明します。

投稿の取得

以降のセクションでは、クエリパラメータありとなしの場合の、ブログ投稿のリストを取得する方法について説明します。

Blogger の公開フィードを認証なしでクエリできます。したがって、公開ブログから投稿を取得する前に、認証情報を設定したり、AuthSub 認証を行う必要はありません。

すべてのブログ投稿を取得する

ユーザーの投稿を取得するには、ブログのメタフィードの取得に使用した getFeed メソッドを呼び出します。ただし、今回はブログ投稿フィードの URL を送信します。

query.Uri = new Uri("http://www.blogger.com/feeds/" + blogId + "/posts/default");
feed = service.Query(query);
Console.WriteLine(feed.Title.Text);
foreach (AtomEntry entry in feed.Entries)
{
  Console.WriteLine("Entry Title: " + entry.Title.Text);
}

クエリパラメータを使用して投稿を取得する

Blogger Data API を使用すると、指定した条件に一致するエントリセットをリクエストできます。たとえば、特定の日付範囲に公開または更新されたブログ投稿をリクエストできます。これを行うには、FeedQuery オブジェクトを作成し、Service.Query() メソッドに渡します。

たとえば、期間クエリを送信するには、FeedQuery オブジェクトの MinPublication メンバーと MaxPublication メンバーを設定します。次のコードスニペットは、指定された開始時間と終了時間の間に公開された各ブログ投稿のタイトルを出力します。

FeedQuery query = new FeedQuery();
query.Uri = new Uri("http://www.blogger.com/feeds/" + blogId + "/posts/default");
query.MinPublication = new DateTime(2006, 1, 1);
query.MaxPublication = new DateTime(2007, 4, 12);
AtomFeed feed = service.Query(query);
foreach (AtomEntry entry in feed.Entries)
{
  Console.WriteLine("  Entry Title: " + entry.Title.Text);
}

FeedQuery オブジェクトは、投稿の取得に使用されたものと同じ投稿フィード URL を使用して作成されます。

Blogger Data API は、次のクエリパラメータをサポートしています。

alt: 返すフィードのタイプ（atom（デフォルト）や rss など）。
/category: カテゴリ（ラベルとも呼ばれます）を指定して、フィード結果をフィルタします。たとえば、http://www.blogger.com/feeds/blogID/posts/default/-/Fritz/Laurie は、ラベル Fritz と Laurie の両方を含むエントリを返します。
max-results: 返されるエントリの最大数。
orderby: エントリを返す順序（lastmodified（デフォルト）、starttime、updated など）。
published-min、published-max: エントリの公開日の範囲。
start-index: 取得される最初の結果のインデックス（1 から始まる）（ページング用）。
updated-min、updated-max: エントリの更新日の上限と下限。これらのクエリパラメータは、orderby パラメータが updated に設定されていない限り無視されます。

クエリパラメータの詳細については、Blogger Data API リファレンスガイドと Google Data APIs リファレンスガイドをご覧ください。

投稿の更新

既存のブログ投稿を更新するには、まず更新するエントリを取得し、変更してから、エントリの Update() メソッドを使用して Blogger に送信します。次のコードスニペットは、サーバからエントリをすでに取得していることを前提として、ブログ投稿のタイトルを変更します。

static AtomEntry EditEntry(AtomEntry toEdit)
{
  // Edit the entry by changing the Title and calling Update().
  if (toEdit != null)
  {
    toEdit.Title.Text = "Marriage Woes!";
    toEdit = toEdit.Update();
  }
  return toEdit;
}

上記のコードは、新しく更新された投稿全体を含む AtomEntry を返します。他のプロパティを更新するには、Update() を呼び出す前に AtomEntry オブジェクトでプロパティを設定します。

注: 投稿に関連付けられた作成者データを変更することは現在サポートされていません。

投稿の削除

投稿を削除するには、既存の AtomEntry オブジェクトで Delete メソッドを呼び出します。

static void DeleteEntry(AtomEntry toDelete)
{
  // Delete the edited entry
  if (toDelete != null)
  {
    toDelete.Delete();
  }
}

Blogger Data API を使用すると、コメントの作成、取得、削除を行うことができます。コメントの更新はサポートされていません（ウェブインターフェースでも利用できません）。

コメントの作成

コメントを投稿するには、AtomEntry オブジェクトを作成し、次のように挿入します。

AtomEntry comment;
comment = new AtomEntry();
comment.Title.Text = "This is my first comment";
comment.Content.Content = "This is my first comment";
Uri commentPostUri = new Uri("http://www.blogger.com/feeds/" + blogId + "/" + entryId + "/comments/default");
postedComment = service.Insert(commentPostUri, comment);

注: 現在、コメントを投稿できるのは、認証済みユーザーが所有するブログに限られます。

注: 現在のところ、コメントのカスタム作成者を設定することはできません。新しいコメントはすべて、現在認証されているユーザーによって作成されたものとして表示されます。

コメントの取得

特定の投稿のコメントは、投稿のコメントフィード URL から取得できます。

static void ListEntryComments(Service service, Uri commentUri)
{
  if (commentUri != null)
  {
    // Retrieve all comments on a blog entry
    FeedQuery query = new FeedQuery();
    query.Uri = commentUri;
    AtomFeed feed = service.Query(query);
    foreach (AtomEntry entry in feed.Entries)
    {
      Console.WriteLine("  Comment Title: " + entry.Title.Text);
    }
  }
}

または、ブログのコメントフィード URL を使用して、すべての投稿のコメントを取得することもできます。

http://www.blogger.com/feeds/blogID/comments/default

コメントの削除

コメントを削除するには、既存のコメント AtomEntry オブジェクトで Delete() メソッドを呼び出します。

static void DeleteComment(AtomEntry commentEntry)
{
  if (commentEntry != null)
  {
    // Delete the comment.
    commentEntry.Delete();
  }
}

トップへ戻る

デベロッパー ガイド: .NET

目次