多店舗展開ECシステム開発日誌

多店舗化の命題にシステム化を選択したひとり店長奮闘記

NEW ARTICLE
流行りのChatGPTにWordPressの記事生成をさせてみた

楽天市場API：全商品ディレクトリIDを取得するAPI

楽天市場API：全商品ディレクトリIDを取得するAPI
目次

楽天市場の全商品ディレクトリIDを取得するAPI

楽天市場RMS上で【全商品ディレクトリID】と呼ばれている情報はAPIでは【ジャンルID】と呼ばれています。

2018年10月現在、ジャンルIDは月1回以上の見直しがあります。古いジャンルに登録した商品は楽天市場によって自動で切り替えが行われます。しかし、更新情報を管理する場合、廃止ジャンルを理解していないとエラーを山積する事になる為日々のチェックが必要です。

APIメソッド：navigation.genre.get

この機能を利用すると、フォルダを作成することができます。

Endpoint / HTTP Method

Endpoint HTTP Method
https://api.rms.rakuten.co.jp/es/1.0/navigation/genre/get GET

Request

HTTP Header
No Key Value Note
1 Authorization ESA Base64(serviceSecret:licenseKey)
Query parameters
No Parameter Description Type Mandatory Multiplicity Note
1 genreId ジャンルID String 〇 1

Response

HTTP Header
No Key Value
1 Content-Type text/xml
HTTP Body
XML:result
No Element Description Type Size(byte) Multiplicity Note
1 result.status ステータス XML : status – 1 interfaceId = navigation.genre.get
2 result.navigationGenreGetResult ジャンル情報取得結果 XML : navigationGenreGetResult – 1

 

XML:navigationGenreGetResult
No Element Description Type Size(byte) Multiplicity Note
1 navigationGenreGetResult.status 結果ステータス String 255 1
2 navigationGenreGetResult.message メッセージ String 255 0,1 異常終了時のエラー内容が返却されます。正常終了時は要素自体が返却されません。
3 navigationGenreGetResult.genreLastUpdateDate ジャンル最終更新日時 String 255 0,1 ジャンルデータの最終更新日時。異常終了時は要素自体が返却されません。
4 navigationGenreGetResult.tagLastUpdateDate タグ最終更新日時 String 255 0,1 タグデータの最終更新日時。異常終了時は要素自体が返却されません。
5 navigationGenreGetResult.genre ジャンル情報 XML : genre – 0,1 指定したジャンルIDのジャンル情報

 

XML:genre
No Element Description Type Size(byte) Multiplicity Note
1 genre.genreId ジャンルID String 255 1
2 genre.genreName ジャンル名 String 255 1
3 genre.itemRegisterFlg 商品登録フラグ情報 XML : itemRegisterFlg – 1
4 genre.ancestorGenre 祖先ジャンル XML : ancestorGenre – 0,1 このジャンル情報の祖先ジャンル
5 genre.childGenre 子ジャンル XML : childGenre – 0,1 このジャンル情報の子ジャンル

 

XML：itemRegisterFlg
No Element Description Type Size(byte) Multiplicity Note
1 itemRegisterFlg.directory 通常商品登録フラグ String 1 1 1：登録可
0：登録不可
2 itemRegisterFlg.auction SA商品登録フラグ String 1 1 1：登録可
0：登録不可

 

XML：ancestorGenre
No Element Description Type Size(byte) Multiplicity Note
1 ancestorGenre.genre 祖先ジャンルのジャンル情報 XML : genre – 0..n 指定したジャンルIDの祖先ジャンル情報

 

XML：ancestorGenre
No Element Description Type Size(byte) Multiplicity Note
1 childGenre.genre 子ジャンルのジャンル情報 XML : genre – 0..n 指定したジャンルIDの子ジャンル情報