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

リファレンスガイド

重要: これはこのページの古いバージョンです。最新バージョンについては、左側のナビゲーションバーのリンクを使用してください。

このドキュメントでは、Blogger Data API の未加工プロトコル（XML と HTTP）に関する詳細なリファレンスドキュメントを提供します。

このドキュメントには、プログラミング言語に関する情報はクライアントライブラリを使用します。クライアントライブラリのリファレンス情報については、デベロッパーガイドのプログラミング言語固有のセクションにあるリンクをご覧ください。

オーディエンス

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

これはリファレンスドキュメントであり、デベロッパーガイドで説明されているコンセプトと、Google Data APIs プロトコルの基本的な考え方を理解していることを前提としています。

Blogger のフィードタイプ

Blogger では、完全なフィードと概要フィードという 2 つの方法でブログコンテンツをフィードに表示できます。完全なフィードにはブログ投稿の全文が含まれ、概要フィードは概要フィードです各投稿の短いスニペットのみを含む。

ブログの所有者は、GUI 設定を使用して、ブログにフルフィードまたは概要フィードをシンジケータやアグリゲータに提供します。

クライアントアプリが認証されていないフィードのリクエストを送信すると、ブログ所有者が指定したタイプのフィードが受信されます。

ただし、クライアントアプリが認証済みリクエストを送信すると、ブログ所有者が指定したものに関係なく、常に完全なフィードが受信されます。

Blogger のクエリパラメータリファレンス

Blogger Data API は、標準の Google Data API クエリパラメータをご覧ください。

Blogger では、q（テキスト検索）パラメータと author パラメータはサポートされていません。

orderby パラメータが updated に設定されていない限り、updated-min クエリパラメータと updated-max クエリパラメータは無視されます。たとえば、次の URL はすべてのブログを取得します。 2008 年 3 月 16 日～ 2008 年 3 月 24 日に更新された投稿：

http://www.blogger.com/feeds/blogID/posts/default?updated-min=2008-03-16T00:00:00&updated-max=2008-03-24T23:59:59&orderby=updated

Blogger 要素のリファレンス

Blogger Data API では、標準の Atom 要素のみが使用されます。詳細については Atom 1.0 シンジケーション形式の仕様と Atom Publishing Protocol をご覧ください。

このセクションの残りの部分では、Blogger の標準要素を使用する。

下書きのエントリ

下書きのブログエントリは、<app:draft> を使用してマークされます。 Atom Publishing Protocol ドキュメントで定義されている拡張要素です。下記は下書きエントリの例です。

<entry xmlns:app='http://purl.org/atom/app#'>
...
<app:control>
<app:draft>yes</app:draft>
</app:control>
</entry>

<draft> 要素が指定されていない場合、エントリは下書きではありません。

公開日と更新日

標準の Atom <published> で指定されるタイムスタンプ要素は「post date」に対応しますユーザーが設定できる Blogger の GUI。

クライアントが新しいエントリを作成するとき（クライアントが値を指定していない場合） <published> の場合、Blogger によってエントリの投稿日が現在のサーバー時刻。クライアントがエントリを編集したものの、 <published> 値の場合、Blogger はエントリの投稿日を削除します。ありません。

ただし、クライアントがエントリを作成または編集するときに <published> 要素を指定し、 Blogger では、エントリの投稿日を指定された値に設定します。この情報は古いエントリを別のブログシステムからインポートするなど、元の作成日も確認できます）。

Blogger では、標準の Atom <updated> 要素を使用して、エントリが最後に変更された日時を指定します。クライアントが <updated> 値。Blogger では、常にエントリの最終更新日時がクライアントがイベントを送信または編集するたびに、現在のサーバー時刻にあります。

標準の Google Data API published-min を使用できます。 published-max、updated-min、 updated-max クエリパラメータで、 <published> または <updated> の値。ただし、更新日のクエリについては、Blogger クエリパラメータのリファレンスをご覧ください。

コメントを投稿にリンクする

Blogger のエクスポート形式では、1 つの Atom フィードドキュメントに投稿エントリとコメントエントリの両方が含まれます。この 2 種類のエントリを区別するために、Blogger では <atom:category> 要素。この要素には、エントリが投稿とコメントのどちらに該当するかを示す term パラメータがあります。

さらに、コメントエントリをそれが属する投稿エントリにリンクすると、 Atom Threading Extension（Atom スレッド化拡張機能）を使用できます。コメント内の <thr:in-reply-to> 要素について確認できます。エントリは、 ref パラメータ。また、href パラメータを使用して投稿の HTML URL にもリンクします。

<feed xmlns="http://www.w3.org/2005/Atom" xmlns:openSearch="http://a9.com/-/spec/opensearchrss/1.0/"
      xmlns:thr="http://purl.org/syndication/thread/1.0">
  ...

  <-- A blog post entry -->
  <entry>
    <id>tag:blogger.com,1999:blog-blogID.post-postID</id>
    <content type="html">This is my first post</content>
    <link rel="alternate" type="text/html"
      href="http://blogName.blogspot.com/2007/04/first-post.html">
    </link>
    <category scheme="http://schemas.google.com/g/2005#kind" 
              term="http://schemas.google.com/blogger/2008/kind#post"/>
    ...
  </entry>

  <-- A comment to the blog post entry -->
  <entry>
    <id>tag:blogger.com,1999:blog-blogID.post-postID.comment-commentID</id>
    <content type="html">This is my first commment</content>
    <category scheme="http://schemas.google.com/g/2005#kind" 
              term="http://schemas.google.com/blogger/2008/kind#comment"/>
    <thr:in-reply-to href="http://blogName.blogspot.com/2007/04/first-post.html" 
                     ref="tag:blogger.com,1999:blog-blogID.post-postID" 
                     type="text/html"/>
    ...
  </entry>
</feed>

トップへ戻る

リファレンス ガイド

目次