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>