API:Query - Properties/ja

From MediaWiki.org

Jump to: navigation, search
Tools clipart.png このページは MediaWiki API ドキュメントの一部です。
Languages 言語: 

English  • Deutsch  • Español  • 日本語  • Русский
MediaWiki API


プロパティはtitles=、pageids=、もしくはrevids=パラメータで、もしくはジェネレータを使って、指定されたもしくはページの一覧に関する様々なデータを取得するために使われます。

Contents

[edit] info / in

MediaWiki version: 1.9

基本情報を取得する

[edit] パラメータ

  • inprop: 取得するプロパティ
    • protection: 保護レベル
    • talkid: それぞれのトークページではないページのためのトークページのページID
    • subjectid: それぞれのトークページのための親ページのページID

[edit] 例

en:Albert Einsteinページに関する情報を取得する

api.php ? action=query & titles=Albert%20Einstein & prop=info & inprop=protection|talkid
<?xml version="1.0" encoding="utf-8"?>
<api>
  <query>
    <pages>
      <page
       pageid="736" ns="0" title="Albert Einstein"
       touched="2008-03-27T04:42:56Z" lastrevid="201248286"
       counter="4698" length="81826" talkid="2177">
        <protection>
          <pr type="edit" level="autoconfirmed" expiry="infinity" />
          <pr type="move" level="sysop" expiry="infinity" />
        </protection>
      </page>
    </pages>
  </query>
</api>

[edit] 起こり得るエラー

無し。

[edit] revisions / rv

MediaWiki version: 1.8

任意のページのリビジョンもしくはそれぞれの複数ページのための最新のリビジョンを返します。(enum)とマークされたパラメータを使うとき、titles=は一覧表示される1つのタイトルのみを持たなければなりません。

[edit] パラメータ

  • rvprop: それぞれのリビジョンに対して取得するプロパティ
    • ids: リビジョンID (デフォルト)
    • flags: 細部の編集かどうか (デフォルト)
    • timestamp: リビジョンが作られた日付と時間(デフォルト)
    • user: リビジョンを作成したユーザ(デフォルト)
    • comment: 編集コメント(デフォルト)
    • size: バイト単位のリビジョンテキストのサイズ
    • content: リビジョンの内容
  • rvlimit: 返すリビジョンの最大数 (enum)
  • rvstartid: 一覧表示を始めるリビジョンID。(enum)
  • rvendid: 一覧表示を終わらせるリビジョンID。(enum)
  • rvstart: 一覧表示を始めるタイムスタンプ。(enum)
  • rvend: 一覧表示を終わらせるタイムスタンプ。(enum)
  • rvdir: 一覧表示するディレクション。 (enum)
    • older: 最新のリビジョンを最初から一覧表示する(デフォルト)。 注: rvstart/rvstartidはrvend/rvendidより高くなければなりません
    • newer: 一番古いリビジョンを最初から一覧表示する。注: rvstart/rvstartidはrvend/rvendidより低くなければなりません。
  • rvuser: このユーザによって作られたリビジョンのみを一覧表示する
  • rvexcludeuser: このユーザによって作られたリビジョンを一覧表示しない
  • rvexpandtemplates: テンプレートを rvprop=contentの出力に展開する
  • rvsection: rvprop=contentが設定されている場合、 このセクションの内容のみを取り出す
  • rvtoken: それぞれのリビジョンのための取得するトークン

[edit] 例

en:APIとen:Main Pageのタイトルの最後のリビジョンの内容を含むデータを取得する

api.php ? action=query & prop=revisions & titles=API|Main%20Page & rvprop=timestamp|user|comment|content
<api>
  <query>
    <pages>
      <page pageid="1191" ns="0" title="API">
        <revisions>
          <rev user="Harryboyles" timestamp="2006-10-31T05:39:01Z" comment="revert unexplained change: see talk ...">
            ...content...
          </rev>
        </revisions>
      </page>
      <page pageid="11105676" ns="0" title="Main Page">
        <revisions>
          <rev user="Ryan Postlethwaite" timestamp="2007-06-26T19:05:06Z" comment="rv - what was that for?">
            ...content...
          </rev>
        </revisions>
      </page>
    </pages>
  </query>
</api>

[edit] 起こり得るエラー

  • code: rvrevids
    • info: revids= parameterは一覧表示のオプション付き(limit、startid、endid、dirNewer、start、end)で使うことが許可されていません。
  • code: rvmultpages
    • info: titles、pageidsもしくはgeneratorが複数のページを提供するために使われましたが、limit、startid、endid、dirNewer、user、excludeuser、startとendパラメータは単独のページ上のみで使うことが許可されます。
  • code: rvaccessdenied
    • info: 現在のユーザはtitleを読むことが許可されていません
  • code: rvbadparams
    • info: startとstartidを一緒に使うことはできません
  • code: rvbadparams
    • info: endとendidは一緒に使うことはできません
    • info: ユーザと排除されたユーザを一緒に使うことはできません
  • code: rvnosuchsection
    • info: section in r'revidにsectionセクションが存在しません

[edit] categories / cl

MediaWiki version: 1.11

用意されたページ上で使われるすべてのカテゴリの一覧を取得する。このモジュールはジェネレータとして使うことができます。

[edit] パラメータ

  • clprop: 取得するプロパティ
    • sortkey: ソートキー

[edit] 例

en:Albert Einsteinが所属するカテゴリの一覧を取得する

api.php ? action=query & titles=Albert%20Einstein & prop=categories
<api>
  <query>
    <pages>
      <page pageid="736" ns="0" title="Albert Einstein">
        <categories>
          <cl ns="14" title="Category:1879 births" />
          <cl ns="14" title="Category:1955 deaths" />
          <cl ns="14" title="Category:Albert Einstein" />
          ...
        </categories>
      </page>
    </pages>
  </query>
</api>

[edit] 起こり得るエラー

無し

[edit] imageinfo / ii

MediaWiki version: 1.11

画像の名前空間に対する任意のタイトルの画像情報を取得する

[edit] パラメータ

  • iiprop: 取得するプロパティ
    • timestamp: リビジョンの時間と日付(デフォルト)
    • user: リビジョンを作ったユーザ(デフォルト)
    • comment: 編集コメント
    • url: 画像のURL
    • size: バイト単位の画像のサイズ
    • sha1: 画像のSHA-1ハッシュ
    • metadata: 利用できるのであれば、画像のメタデータ
  • iilimit: 返す画像のリビジョンの件数 (デフォルトで1)
  • iistart: 一覧表示を始めるタイムスタンプ
  • iiend: 一覧表示を止めるタイムスタンプ
  • iiurlwidth: iiprop=urlが設定されていると、この幅に拡大縮小された画像へのURLが同様に返されます。画像の古いバージョンは拡大縮小できません
  • iiurlheight: iiurlwidthと同様

[edit] 例

en:Image:Albert Einstein Head.jpgに関する画像情報を取得する。画像がcommonsに存在するとき画像ページが見つからない可能性があることにご注意下さい。

api.php ? action=query & titles=Image:Albert%20Einstein%20Head.jpg & prop=imageinfo
<?xml version="1.0" encoding="utf-8"?>
<api>
  <query>
    <pages>
      <page ns="6" title="Image:Albert Einstein Head.jpg" missing="" imagerepository="shared">
        <imageinfo>
          <ii timestamp="2007-10-20T02:29:04Z" user="Rocket000" />
        </imageinfo>
      </page>
    </pages>
  </query>
  <query-continue>
    <imageinfo iistart="20071020022358" />
  </query-continue>
</api>

[edit] langlinks / ll

MediaWiki version: 1.9

提供されたページから他の言語へのすべての言語リンクの一覧を取得する。

[edit] パラメータ

無し

[edit] 例

en:Albert Einsteinに含まれる言語リンクの一覧を取得する

api.php ? action=query & titles=Albert%20Einstein & prop=langlinks
<?xml version="1.0" encoding="utf-8"?>
<api>
  <query>
    <pages>
      <page pageid="736" ns="0" title="Albert Einstein">
        <langlinks>
          <ll lang="af">Albert Einstein</ll>
          <ll lang="als">Albert Einstein</ll>
          <ll lang="an">Albert Einstein</ll>
          <ll lang="ar">ألبرت أينشتاين</ll>
          <ll lang="ast">Albert Einstein</ll>
          <ll lang="az">Albert Eynşteyn</ll>
          ...
        </langlinks>
      </page>
    </pages>
  </query>
</api>

[edit] 起こり得るエラー

無し

[edit] links / pl

MediaWiki version: 1.9

提供されたページ上のすべてのリンクの一覧を取得する。 このモジュールはジェネレータとして使うことができます。

[edit] パラメータ

  • plnamespace: これらの名前空間のページへのリンクのみを一覧表示する

[edit] 例

en:Albert Einstein上のリンクの一覧を取得する

api.php ? action=query & titles=Albert%20Einstein & prop=links
<api>
  <query>
    <pages>
      <page pageid="736" ns="0" title="Albert Einstein">
        <links>
          <pl ns="0" title="1879" />
          <pl ns="0" title="1901" />
          ...
          <pl ns="0" title="Albert Einstein: The Practical Bohemian" />
          <pl ns="0" title="Albert Einstein Archives" />
          <pl ns="0" title="Albert Einstein Award" />
          <pl ns="0" title="Albert Einstein Foundation for Higher Learning, Inc." />
          <pl ns="0" title="Albert Einstein Memorial" />
          <pl ns="0" title="Albert Einstein Peace Prize" />
          ...
          <pl ns="0" title="Zurich" />
          <pl ns="4" title="Wikipedia:Citing sources" />
          <pl ns="4" title="Wikipedia:Media help" />
          <pl ns="4" title="Wikipedia:Persondata" />
          <pl ns="4" title="Wikipedia:Protection policy" />
          <pl ns="4" title="Wikipedia:Sister projects" />
          <pl ns="6" title="Image:Albert Einstein german.ogg" />
          <pl ns="10" title="Template:Nobel Prize in Physics" />
          ...
          <pl ns="10" title="Template:Nobel Prize in Physics Laureates 2001-2025" />
          <pl ns="11" title="Template talk:Nobel Prize in Physics Laureates 1901-1925" />
        </links>
      </page>
    </pages>
  </query>
</api>

[edit] 起こり得るエラー

無し

[edit] templates / tl

MediaWiki version: 1.9

提供されたページに含まれるすべてのページの一覧を取得する。 このモジュールはジェネレータとして使うことができる。

[edit] パラメータ

  • tlnamespace: これらの名前空間のページのみ一覧表示する

[edit] 例

en:Albert Einsteinのページ上で使われるテンプレートの一覧を取得する

api.php ? action=query & titles=Albert%20Einstein & prop=templates
<api>
  <query>
    <pages>
      <page pageid="736" ns="0" title="Albert Einstein">
        <templates>
          <tl ns="10" title="Template:Academia" />
          <tl ns="10" title="Template:Age at date" />
          <tl ns="10" title="Template:Audio" />
          <tl ns="10" title="Template:Birth date" />
          ...
        </templates>
      </page>
    </pages>
  </query>
</api>

[edit] 起こり得るエラー

無し。

[edit] images / im

MediaWiki version: 1.9

クエリAPIインターフェイスで、このコマンドは任意の画像を埋め込むページを見つけます。これはimageusageにリネームされました。

提供されたページ上で使われるすべての画像の一覧を取得する。このモジュールはジェネレータとして使うことができます。

[edit] パラメータ

無し。

[edit] 例

en:Albert Einsteinのページ上の画像の一覧を取得する

api.php ? action=query & titles=Albert%20Einstein & prop=images
<api>
  <query>
    <pages>
      <page pageid="736" ns="0" title="Albert Einstein">
        <images>
          <im ns="6" title="Image:1919 eclipse positive.jpg" />
          <im ns="6" title="Image:Albert Einstein Head.jpg" />
          <im ns="6" title="Image:Albert Einstein german.ogg" />
          <im ns="6" title="Image:Albert Einstein photo 1921.jpg" />
          ...
        </images>
      </page>
    </pages>
  </query>
</api>

[edit] 起こり得るエラー

無し。

[edit] extlinks / el

MediaWiki version: 1.11

提供されたページ上のすべての外部リンクの一覧を取得する

[edit] パラメータ

無し。

[edit] 例

en:Albert Einsteinのページ上の外部リンクの一覧を取得する

api.php ? action=query & titles=Albert%20Einstein & prop=extlinks
<api>
  <query>
    <pages>
      <page pageid="736" ns="0" title="Albert Einstein">
        <extlinks>
          <el>http://albert-einstein.org/</el>
          <el>http://albert-einstein.org/history5.html</el>
          <el>http://ame.epfl.ch/biblio/schlatter1.pdf</el>
          ...
        </extlinks>
      </page>
    </pages>
  </query>
</api>

[edit] 起こり得るエラー

無し。

Retrieved from "http://www.mediawiki.org/wiki/API:Query_-_Properties/ja"