MetaWeblogAPI metaWeblog.newPost メソッド
metaWeblog.newPost メソッドは、ブログに新しい記事を投稿します。
構文
public string metaWeblog.newPost(string blogid,
string username,
string password,
struct content,
bool publish);
パラメータ
blogid [in]
記事の作成先がユーザーのブログであることを示す "MyBlog" という文字列にする必要があります。
username [in]
ユーザーのスペースの名前。
password [in]
ユーザーの秘密のキーワード。
content [in]
更新するコンテンツを表す構造体。"title"、"description"、"dateCreated"、"categories" の各フィールドがサポートされます。その他の要素はすべて無視されます。複数のカテゴリが指定された場合、最大数に達するまでカテゴリの一覧に個々のカテゴリが追加され、残りのカテゴリはすべて無視されます。"title " が指定されていない場合は、エラーが返されます。"description" が指定されていない場合、または "categories" が指定されていない場合は、それぞれ、本文なし、またはカテゴリなしの記事が投稿されます。
struct {
string title;
string description;
dateTime.iso8601 dateCreated;
string[] categories;
}
publish [in]
false の場合、下書きの記事です。
戻り値
string [out]
新しく作成された記事の postid。
XML-RPC 要求のサンプル (XML 形式)
<methodCall>
<methodName>metaWeblog.newPost</methodName>
<params>
<param>
<value>
<string>MyBlog</string>
</value>
</param>
<param>
<value>!spacename!</value>
</param>
<param>
<value>
<string>secretword</string>
</value>
</param>
<param>
<struct>
<member>
<name>categories</name>
<value>
<array>
<data>
<value>Adventures</value>
</data>
</array>
</value>
</member>
<member>
<name>description</name>
<value>Dr. Quest はイエティを捜索する探検の途中で行方不明になりました。Jonny とその友人は彼を見つけるためにヒマラヤへ向かいましたが、イエティを連れて帰ることを決意した別の科学者に遭遇しました。
</value>
</member>
<member>
<name>title</name>
<value>クンブの探検</value>
</member>
<member>
<name>dateCreated</name>
<value>
<dateTime.iso8601>20040716T19:20:30</ dateTime.iso8601>
</value>
</member>
</struct>
</param>
<param>
<value>
<boolean>1</boolean>
</value>
</param>
</params>
</methodCall>
XML-RPC 応答のサンプル (XML 形式)
<methodResponse>
<params>
<param>
<value>
<i4>1829</i4>
</value>
</param>
</params>
</methodResponse>