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

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

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

楽天市場API：全商品ディレクトリIDに紐づくタグコード取得API

楽天市場API：全商品ディレクトリIDに紐づくタグコード取得API
目次

全商品ディレクトリIDを指定してタグコードを取得するAPI

【全商品ディレクトリID(ジャンルID)】と共に誤った値を入力し更新するとエラーとなるタグコード。

厄介なことに毎週見直しがあり新たなタグが生まれたり統一されて無くなったりなど変化をしています。他社が利用していないタグコードを採用できれば楽天市場のレフトナビから集客も可能です。

APIメソッド：navigation.genre.tag.get

この機能を利用すると、 ジャンルIDを指定してジャンル情報とそのジャンルに紐づくタグ情報を取得することができます。

Endpoint / HTTP Method

Endpoint HTTP Method
https://api.rms.rakuten.co.jp/es/1.0/navigation/genre/tag/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.tag.get
2 result.navigationGenreTagGetResult ジャンル、タグ情報取得結果 XML : navigationGenreGetResult – 1

 

XML:navigationGenreGetResult
No Element Description Type Size(byte) Multiplicity Note
1 navigationGenreTagGetResult.status 結果ステータス String 255 1
2 navigationGenreTagGetResult.message メッセージ String 255 1 異常終了時のエラー内容が返却されます。正常終了時は要素自体が返却されません。
3 navigationGenreTagGetResult.genreLastUpdateDate ジャンル最終更新日時 String 255 0,1 ジャンルデータの最終更新日時。異常終了時は要素自体が返却されません。
4 navigationGenreTagGetResult.tagLastUpdateDate タグ最終更新日時 String 255 0,1 タグデータの最終更新日時。異常終了時は要素自体が返却されません。
5 navigationGenreTagGetResult.genre ジャンル情報 XML : genre – 0,1 以下ジャンルに関しては、楽天にて登録されたジャンル情報からタグの自動付与を現在おこなっている為、本APIでタグの紐付き情報の返却はおこなっておりません。
以下ジャンル配下のジャンル情報を取得した場合、navigation.genre.getよりデータを取得してください。

  • ジャンルID：510915/ビール・洋酒
  • ジャンルID：551169/医薬品・コンタクト・介護

 

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 このジャンル情報の子ジャンル
6 genre.tagGroups タググループ情報 XML : tagGroups – 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の子ジャンル情報

 

XML：tagGroups
No Element Description Type Size(byte) Multiplicity Note
1 tagGroups.tagGroup タググループ情報 XML : tagGroup – 0..n このジャンルに関連しているタググループ情報

 

XML：tagGroup
No Element Description Type Size(byte) Multiplicity Note
1 tagGroup.tagGroupId タググループID String 255 1
2 tagGroup.tagGroupName タググループ名 String 255 1
3 tagGroup.tags タグ情報リスト XML : tags – 1

 

XML：tags
No Element Description Type Size(byte) Multiplicity Note
1 tags.tag タグ情報 XML : tag – 0..n

 

XML：tag
No Element Description Type Size(byte) Multiplicity Note
1 tag.tagId タグID String 255 1
2 tag.tagName タグ名 String 255 1
3 tag.parentTagId 親タグID String 255 1