AppHtmlME 3.0 PHG 対応その他

新しい AppHtmlME をお届けします。

目次

• PHG 対応
• 項目選択操作の改善
• 曲、アルバム、映画、電子書籍の検索
  • 曲の例
  • アルバムの例
  • 映画の例
  • 電子書籍の例
• デフォルトテンプレート変更
• 予約語の見直し
• ダウンロードはこちら
• インストール/起動
  • インストール
  • 起動
• カスタマイズ方法の変更
• Mac アプリ検索の暫定対処

PHG 対応

iTunes のアフィリエイトプログラムの提携業者が PHG に変更となり、リンクの形式が変更されました。

新しい AppHtmlME は PHG のリンクを生成できるようになりました。

項目選択操作の改善

選択項目の先頭に数字をつけるようにしました。 キーボードで数字を入力すると、該当する項目を選択することができます。

これまでも、カーソルキーの上下で項目を選択することはできましたが、よりすばやくリンクの挿入ができるようになりました。

曲、アルバム、映画、電子書籍の検索

iTunes Store からの検索対象として、曲、アルバム、映画、電子書籍を追加しました。

以下の例はデフォルトテンプレートの「アイコン付き(大)」を使用しています。

曲の例

More Than Words
カテゴリ: Rock

アルバムの例

Pornograffitti
カテゴリ: Rock

映画の例

マトリックス（字幕版）
カテゴリ: Sci-Fi & Fantasy

電子書籍の例

スティーブ・ジョブズ　I
カテゴリ: 伝記／自叙伝, ブック

デフォルトテンプレート変更

デフォルトテンプレートは以下のものです。

• 小さいボタン
• 大きいボタン
• テキストのみ
• アイコン付き(小)
• アイコン付き(大)

3 つ目までは iTunes Link Maker と同じものが出力されます。

「アイコン付き(大)」は上記の例のようになります。 「アイコン付き(小)」は以下のようにアイコンとバッジが小さいものになります。

スティーブ・ジョブズ　II
カテゴリ: 伝記／自叙伝, ブック

予約語の見直し

予約語を以下のように見直しました。 AppHtml と予約語は統一しています。

名称	予約語	使用可能な検索対象
小さいボタン	${badgeS}	すべて
大きいボタン	${badgeL}	すべて
テキストのみ	${textonly}	すべて
名前	${name}	すべて
ストアへのリンク	${url}	すべて
プレビューURL	${preview}	Song/Movie
価格	${price}	すべて
カテゴリ	${category}	すべて
再生時間	${playtime}	Movie
トラック数	${trackcnt}	Song/Album
リリース日	${pubdate}	すべて
アイコン100	${icon100url}	すべて
アイコン60	${icon60url}	すべて
アーティスト名	${artist}	すべて
アーティストURL	${artisturl}	すべて
販売元	${seller}	アプリ(iPhone/iPad/Mac)
販売元サイトURL	${sellerurl}	アプリ(iPhone/iPad/Mac)
コピーライト	${copyr}	Album
説明	${desc}	アプリ(iPhone/iPad/Mac)/Movie/Book
What’s New	${descnew}	アプリ(iPhone/iPad/Mac)
短い説明	${shortdesc}	Movie
バージョン	${version}	アプリ(iPhone/iPad/Mac)
レーティング	${rating}	アプリ(iPhone/iPad/Mac)
評価★	${userrating}	アプリ(iPhone/iPad/Mac)/Book
レビュー件数	${userratingcnt}	アプリ(iPhone/iPad/Mac)/Book
評価★(現)	${curuserrating}	アプリ(iPhone/iPad/Mac)
レビュー件数(現)	${curuserratingcnt}	アプリ(iPhone/iPad/Mac)
サイズ	${appsize}	アプリ(iPhone/iPad/Mac)
サポートデバイス	${moveos}	iPhone/iPadアプリ
言語	${lang}	アプリ(iPhone/iPad/Mac)
GameCenter対応	${gamecenter}	iPhone/iPadアプリ
ユニバーサル対応	${univ}	iPhone/iPadアプリ
スクリーンショット1	${image1}	アプリ(iPhone/iPad/Mac)
スクリーンショット2	${image2}	アプリ(iPhone/iPad/Mac)
スクリーンショット3	${image3}	アプリ(iPhone/iPad/Mac)
スクリーンショット4	${image4}	アプリ(iPhone/iPad/Mac)
スクリーンショット5	${image5}	アプリ(iPhone/iPad/Mac)
スクリーンショット(univ)1	${univimage1}	iPhone/iPadアプリ
スクリーンショット(univ)2	${univimage2}	iPhone/iPadアプリ
スクリーンショット(univ)3	${univimage3}	iPhone/iPadアプリ
スクリーンショット(univ)4	${univimage4}	iPhone/iPadアプリ
スクリーンショット(univ)5	${univimage5}	iPhone/iPadアプリ

• 小さいボタン(${badgeS})、大きいボタン(${badgeL})、テキストのみ(${text only}) は iTunes Link Maker と同等の出力になります。
• ストアへのリンク(${url})とアーティストURL(${artisturl})はアフィリエイトID指定時はアフィリエイトリンクになります。
• 価格(${price})は、「￥1,000」のように出力されます。
• 再生時間(${playtime})は「136分」のように出力されます。
• トラック数(${trackcnt})は「13曲」のように出力されます。
• アイコン100(${icon100url})およびアイコン60(${icon60url))は映画・電子書籍の場合は高さがそれぞれ 100・60 になるようです。
• レビュー件数(${userratingcnt})、レビュー件数(現)(${curuserratingcnt})は「3件の評価」のように出力されます。
• 評価★(${userrating})、評価★(現)(${curuserrating})は画像ではなく評価の数値が出力されます。
• サイズ(${appsize})は「2.0MB」のように出力されます。
• GameCenter対応(${gamecenter})は、GameCenter に対応したアプリの場合に「GameCenter対応」と出力されます。
• ユニバーサル対応(${univ})は、ユニバーサルアプリである場合に「iPhone/iPadの両方に対応」と出力されます。

ダウンロードはこちら

本バージョンから GitHub に置くことにしました。 こちら です。

インストール/起動

インストールや起動方法に変更はありませんが、 今回のバージョンからインストールしないと正常に動作しなくなりましたのでご注意ください。

インストール

AppHtmlME.workflow をダブルクリックすると表示される画面で [インストール] をクリックするとインストールされます。

起動

MarsEdit の Services メニューから AppHtmlME を選択すると起動できます。

[システム環境設定] > [キーボード] > [キーボードショートカット] でキーボードショートカットを設定するとキーボードで起動できます。

カスタマイズ方法の変更

カスタマイズ方法を変更しました。

~/Library/Services/AppHtmlMe.workflow/Scripts/apphtml_settings.py を ~/ にコピーして書き換えるとこちらの設定が使用されます。

template のキー(‘大きなボタン’など)が画面に表示されます。 キーの辞書順に表示されるため、先頭に数字をつけることをお勧めします。

設定値とその意味は以下の通りです。

• settings: 設定
  • phg: PHG のアフィリエイトID(s)
  • cnt: 検索する最大件数(i)
  • scs: スクリーンショットの長辺ピクセル
    • iphone: iPhoneアプリの場合(i)
    • ipad: iPadアプリの場合(i)
    • mac: Macアプリの場合(i)
  • template: テンプレート設定
    • software: iPhoneアプリ
    • iPadSoftware: iPadアプリ
    • macSoftware: Macアプリ
    • song: 曲
    • album: アルバム
    • movie: 映画
    • ebook: 電子書籍

(s):文字列 (i):整数

設定のキー名は文字列ですので、" または ' で囲む必要があります。

テンプレートは以下の形式で複数定義することができます(以下はiPhoneアプリの場合の定義イメージ)。

settings = {
    <省略>
    'template': {
        'software': {
            'テンプレート1': u'<a href="${url}">${name}</a>',
            'テンプレート2': u"""複数行の
テンプレートも
定義できます"""
        },
        'iPadSoftware': {
        <省略>
    },
    <省略>
}

上記はデフォルトテンプレートのように、名前を付けて定義して参照することも可能です。

iPhoneAppTemplate = {
    'テンプレート1': u'<a href="${url}">${name}</a>',
    'テンプレート2': u"""複数行の
テンプレートも
定義できます"""
}

settings = {
    <省略>
    'template': {
        'software': iPhoneAppTemplate,
        'iPadSoftware': {
        <省略>
    },
    <省略>
}

テンプレートのカスタマイズにより以下のような出力も可能です。 (めちゃめちゃお世話になっている 1Password です。)

1Password
バージョン: 4.2.7
現在の価格: ￥1,600
サイズ: 23.8 MB
カテゴリ: 仕事効率化, ユーティリティ
販売元: AgileBits Inc.
全てのバージョンの評価: ★3.5（218件の評価）
iPhone/iPadの両方に対応

カスタマイズの際には、以下の規約・ガイドライン・FAQ をご確認ください。

• PHG規約と諸条件 - Performance Hrizon Group (PDF)
• iTunes, App Store, iBookstore, and Mac App Store Affiliate Resources - Identity Guidelines
• iTunes, App Store, iBookstore, and Mac App Store Affiliate Resources - よくある質問

Mac アプリ検索の暫定対処

少し前から、iTunes Link Maker を含めて Mac アプリを検索しても結果が 0 件になる状況になっています。

AppHtmlME では回避策をとっていますが、その影響でアプリ名以外では検索できなくなっています。

iTunes Search API が従来の挙動に戻った際に、回避策を除去して従来の動作に戻したいと考えています。

別の回避手段として、Google 検索などによって Web ブラウザで Mac App Store 上のアプリのページを開いた状態で AppHtml ブックマークレットを実行する方法があります。

iPhone でも Google Chrome で PC 版サイトをリクエストすることでブックマークレットによるリンク取得が可能です。

関連記事

loading..