TMDB APIキーを作成してKodiに追加する方法

KodiアドオンがTMDB認証情報を要求してきた場合は、TMDBアカウントから認証情報をリクエストし、そのアドオンの設定に入力してください。Kodi自体にはシステム全体で使用できるTMDB APIキーフィールドがないため、アドオンがカスタムキーをサポートする必要があります。アドオンが共有認証情報に依存している場合は、個人用キーが役立つ可能性がありますが、TMDBのレート制限を回避したり、クラッシュの修正を保証するものではありません。

以下のインターフェース画像はイメージです。TMDBはアカウント管理機能を変更する可能性があり、Kodiのメニューはスキン、デバイス、アドオンによって異なります。

始める前に

TMDBアカウントと、TMDBのAPIを使用し、カスタム認証情報の設定を公開するKodiアドオンが必要です。TMDBのAPI登録フローはモバイル向けに最適化されていないため、デスクトップブラウザからの申請を推奨します。TMDBの入門ガイドでは、アクセスをリクエストする方法と、同意する必要のある利用規約へのリンクが説明されています。

TMDBには、 APIキー（v3認証）とAPI読み取りアクセストークン（v4認証）という2種類のアプリケーション認証情報が記載されています。TMDBでは、どちらもAPIリクエストの認証方法として説明されていますが、特定のアドオンはどちらか一方の形式しか受け付けない場合があります。認証情報は、アドオンが実際に要求するフィールドに一致させてください。v4ベアラートークンを要求するフィールドにv3キーを貼り付けないでください。

TMDB APIキーの作成方法

1. TMDBアカウントを作成またはログインしてください。The Movie Databaseにアクセスし、必要に応じて登録を行い、要求されたアカウント認証を完了してください。その後、デスクトップブラウザを使用してログインしてください。

   

2. API設定ページを開きます。アカウントにログイン後、「設定」を開き、アカウントナビゲーションから「API」を選択してください。現在のTMDBドキュメントでは、APIリンクはアカウント設定の一部として記載されていますが、正確な位置や文言は変更される可能性があります。

   

3. API申請リクエストを開始してください。APIページのリクエストまたは作成フローに従ってください。実際の用途に合ったアプリケーションタイプを選択し、ソフトウェアとAPIの利用計画について正確な説明を入力し、利用規約とAPIガイドラインを確認してから同意してください。架空の連絡先情報やプロジェクト情報は使用しないでください。

   

4. TMDBが認証情報を発行するまでお待ちください。申請が承認されたら、API設定に戻り、APIキー（v3認証）とAPI読み取りアクセストークン（v4認証）の2つの項目を確認してください。これらは別々のアプリケーション認証情報です。利用可能な認証方法については、 TMDB認証ガイドをご覧ください。

   

5. アドオンが要求する認証情報をコピーしてください。フィールドに「APIキー」と記載されている場合は、APIキー（v3認証）をコピーしてください。API読み取りアクセストークンまたはベアラートークンを明示的に要求されている場合は、代わりにそのv4値を使用してください。どちらかを推測して使用しないでください。また、認証情報を公開投稿やスクリーンショットには含めないでください。

   

Kodiにキーを追加する方法

6. Kodiの「アドオン」エリアを開きます。ホーム画面から「アドオン」を選択し、アドオンブラウザまたはインストール済みのアドオンを開きます。名前やレイアウトは、Kodiのバージョンやスキンによって異なる場合があります。

   

7. 互換性のあるアドオンの設定を開きます。TMDBから映画またはテレビ番組のメタデータを取得するアドオンを見つけて選択し、Kodiのコンテキストメニューを開いて「設定」を選択します。Kodiのアドオンに関するドキュメントにこの手順が記載されています。コンテキストメニューのコントロール名は、リモコンやデバイスによって異なる場合があります。アドオンのドキュメントで、カスタムTMDB認証情報がサポートされていることを確認してください。

   

8. キーを入力して保存します。アドオンのアカウント、メタデータ、またはAPIセクションを開き、TMDB APIキーフィールドを探します。コピーした値を貼り付け、両端にスペースが追加されていないことを確認してから、「OK」または「保存」を選択します。アドオンが別の認証情報タイプを要求する場合は、TMDBから一致する値を使用します。アドオンのドキュメントに、設定が再起動後に有効になると記載されている場合にのみ、アドオンを再起動してください。

   

アドオンにまだエラーがある場合

• APIキーフィールドがない場合：このアドオンはカスタムTMDB認証情報をサポートしていない可能性があります。Kodiには、アドオン独自の構成に代わるグローバル設定がありません。
• 認証エラー：値が完全にコピーされたこと、およびアドオンで指定された認証情報タイプを使用したことを確認してください。APIキーとAPI読み取りアクセストークンは、TMDBアカウント設定の異なるフィールドです。
• レート制限または接続エラー：個人キーを使用しても、TMDBの制限からリクエストが除外されるわけではありません。アドオンが依然として過剰なリクエストを送信しているか、TMDBが一時的に利用できない状態になっている可能性があります。設定を変更する前に、アドオンのログとTMDBのサービスステータスを確認してください。
• カテゴリがクラッシュする原因は、キーでは無関係なアドオンコード、古いメタデータ統合、または壊れた依存関係を修復できないためです。信頼できるソースからのみアップデートし、そのアドオンの最新のドキュメントに従ってください。古いガイドではCovenantやElysiumについて言及されているかもしれませんが、これらのアドオンには独自の設定とバージョン履歴があり、そのメニューパスはすべてのKodiアドオンに適用されるわけではありません。

TMDBのAPI FAQによると、非商用API利用の場合、データと画像には出典を明記する必要があります。商用プロジェクトの場合は、ライセンスについてTMDBに問い合わせるよう指示されています。既存のアドオンを設定するだけの場合は、アドオンのメンテナーの指示に従い、個人の認証情報を公開しないでください。