プロジェクトグループ

プロジェクトグループの追加

このメソッドは、ユーザーアカウントに新しいプロジェクトグループを追加する事ができます。

リクエストフォーマット

POST https://api4.seranking.com/site-groups

{ “name” : “text” }

パラメータ

名称	必須	説明
name	はい	N追加されるプロジェクトグループ名

結果

成功すると、サーバーは削除ステータスを含む配列を返します。

名称	必須	説明
group_id	はい	追加されたプロジェクトグループのID

レスポンス例

{

    “group_id”: 9545

}

エラー

HTTP コード	エラーメッセージ/th>
400	Empty name

リクエストフォーマット

PUT https://api4.seranking.com/site-groups/{group_id}

{

“name”: “new name”

}

パラメータ

名称	必須	説明
name	はい	N追加されるプロジェクトグループ名

結果

成功すると、サーバーは 200 HTTP コードを返します。

エラー

リクエストフォーマット

DELETE https://api4.seranking.com/site-groups/{group_id}

結果

成功すると、サーバーは 204 HTTP コードを返します。

エラー

HHTTP コード	エラーメッセージ
404	Group not found

このメソッドは、ユーザーアカウントから全てのグループのリストを取得する事ができます。

リクエストフォーマット

GET https://api4.seranking.com/site-groups

結果

成功すると、サーバーはグループのリストを返します。

レスポンス例

[

    {

        “id”: “123”,

        “name”: “Group1”

    },

    {

        “id”: “456”,

        “name”: “Group2”

    }

]

このメソッドは、あるグループから別のグループへプロジェクトを移動させることができます

Parameters

名称	必須	説明
site_ids	はい	移動されたウェブサイトのIDを含む配列

リクエストフォーマット

POST  https://api4.seranking.com/site-groups/{group_id}/sites

{

“site_ids” : [1,2,3,4,5]

}

結果

成功すると、サーバーは 204 HTTP コードを返します。

エラー

HHTTP コード	エラーメッセージ
404	Group not found