ロシアのヨーロッパ侵略をとめてください。ウクライナの抵抗を支援する方法についてはこちらをご覧くださいこちら

キーワードグループ

キーワードグループの作成

このメソッドはプロジェクトのキーワードにグループを追加する事ができます。

パラメータ’

名称 必須 説明
name はい 追加されたプロジェクト キーワード グループ名
site_id はい キーワード グループを追加したプロジェクト ID

リクエスト フォーマット

POST https://api4.seranking.com/keyword-groups
{
“name”: “groupname”,
“site_id”: 1
}

結果

成功すると、サーバーは201 HTTP コードと、プロジェクト キーワード グループのIDが含まれます。

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

レスポンス例

{
“group_id”: 123456
}

エラー

HTTP コード エラーメッセージ
404Empty name
404Empty site_id

キーワードを別にグループに移動

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

パラメータ

名称 必須 説明
keywords_ids はい 移動されたキーワードのIDの配列

リクエスト フォーマット

POST /keyword-groups/{group_id}/keywords
{
“keywords_ids”: [1,2,3,4,5]
}

結果

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

エラー

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

キーワード グループ名の変更

このメソッドは、プロジェクト キーワード グループ名を変更する事ができます。

パラメータ

名称 必須 説明
name はい 新しいキーワード グループ名

リクエスト フォーマット

PUT /keyword-groups/{group_id}
{
“name”: “new name”
}

結果

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

エラー

HTTP コード エラーメッセージ
404Empty name
404Group not found

キーワード グループの削除

このメソッドはプロジェクト キーワード グループを削除する事ができます。

リクエスト フォーマット

DELETE /keyword-groups/{group_id}

結果

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

エラー

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

キーワード グループのリスト取得

このメソッドは、特定のプロジェクトのキーワード グループのリストを取得する事ができます。

リクエスト フォーマット

GET /keyword-groups/{site_id}

結果

成功すると、サーバーは特定のプロジェクトのキーワード グループの配列を返します。

名称 必須 説明
id はい プロジェクト キーワード グループ ID
name はい 新しいキーワード グループ名
creation_date はい プロジェクト キーワード グループ作成日

レスポンス例

[
{
“id”: “123”,
“name”: “NewKeyGroup”,
“creation_date”: “2018-08-27”
},
{
“id”: “456”,
“name”: “NewKeyGroup1”,
“creation_date”: “2018-08-27”
},
{
“id”: “789”,
“name”: “NewKeyGroup2”,
“creation_date”: “2018-08-27”
}
]

エラー

HTTP コード エラーメッセージ
404Group not found
404 No keywords ids in request