このガイドは、Autodesk Platform Services (APS) 内のデベロッパーハブの理解と使用に役立ちます。デベロッパーハブを使用すると、チームの開発活動、アプリケーション、API アクセスを 1 つの集中ワークスペースで管理することが出来ます。
デモ
デベロッパー ハブの始め方
デベロッパーハブは、チームの API アクセス、アプリケーション、使用状況を管理するための APS 内の一元化されたワークスペースです。これにより、可視性が向上し、コラボレーションが容易になります。
- 各デベロッパー ハブは 1 つのチームに接続されます。この接続は後で変更出来ません。
- ハブを作成または参加するには、APS サブスクリプションが必要です。
パスを選択してください：
1. 最初のデベロッパーハブを作成する (資格を確認する - 詳細情報はこちら )
チーム管理者のみがデベロッパーハブを作成出来ます。各チームは 1 つのデベロッパーハブを持つことが出来ます。
- Autodesk Account > [製品とサービス] > [ハブ] に移動します。
- [ハブの作成] をクリックします。
- 製品として [Autodesk Platform Services] を選択します。
- ハブの名前と説明を入力します。
- [作成 & アクティブ化] をクリックします。
ハブの作成者は、自動的に最初のハブ管理者になります。
2. 既存のチーム ハブに参加する
チーム管理者に、チームの既存の開発者ハブに招待するよう依頼します。
- ハブ管理者から招待メールが送信されます。
- ハブに参加するための招待を受け入れます。
- Autodesk Platform Services サイトの右上にある [Developer hub] をクリックして、ハブにアクセスします。
留意すべき点
- チーム管理者は誰でもハブを作成できます。
- ハブは常にチーム コンテキスト内に作成されます。
- 各チームにはハブを 1 つしか持つことが出来ません。
- ハブが接続するチームは、作成後に変更することは出来ません。
ハブメンバーの管理
ハブ管理者は、チーム メンバーを招待し、ロールを割り当て、デヴェロッパーハブへのアクセスを管理することが出来ます。
ハブメンバーの管理
- ベロッパーハブで [Roles and access] に移動して [Hub members] にアクセスします。
- [Add member] をクリックします。
- ユーザーのメールアドレスを入力します。
- Access levelドロップダウンメニューからロールを選択します。
- Admin:完全な管理権限を持ちます。
- Developer：所有アプリを編集し、共有アプリで共同作業をおこなうことが出来ます。
- [Add] をクリックします。
ユーザーは電子メールを受信し、ハブへの参加を承諾する必要があります。
ハブ メンバーのロールを変更する
- [Roles and access] に移動して [Hub members] にアクセスします。
- リストからロールを変更したいメンバーを見つけます。
- 名前の横にある [Access level] ドロップダウンをクリックして、新しいロールを選択します。
変更はすぐに有効になります。
外部のコラボレーターと作業するには
外部コラボレーターは、ハブ メンバーでなくても特定のアプリケーションにアクセスすることが出来ます。
- [Roles and access ] に移動して [External collaborators] にアクセスします。
- [Add collaborator] をクリックします。
- メールアドレスを入力します。
- アクセスできるアプリケーションを選択します。
- 各アプリケーションのロールを選択します。
- App owner : 編集、削除、転送を含むフルコントロールを持ちます。
- App editor : アプリを編集し、使用状況レポートを表示出来ます。
- App viewer :アプリと使用状況レポートを表示するための読み取り専用アクセスを持ちます。
- [Add] をクリックします。
ハブからメンバーを削除するには
- [ロール] に移動し、> Hub メンバーにアクセスします。
- 削除するメンバーを見つけます。
- 名前の隣にある [Remove] をクリックします。
- 削除を確認します。
留意すべき点
- ハブ管理者は、他の管理者を含むすべてのメンバーを削除出来ます。
- ハブには、常に少なくとも 1 人の管理者が必要です。
- アプリの所有権が譲渡されるまで、アプリを所有するメンバーを削除することはできません。
アプリケーションの管理
ハブ管理者とアプリ所有者は、開発者ハブ内でアプリケーションを作成、構成、管理することが出来ます。
アプリを作成および構成するには
- デベロッパーハブで、[Applications] に移動します。
- [Create application] をクリックします。
- アプリ名と説明を入力します。
- アプリケーションの種類を選択します。
- コールバック URL とその他の設定を構成します。
- アプリがアクセスできる API を選択します。
- [作成] をクリックします。
アプリは [Applications] セクションに 3 つのタブと共に表示されます。：
- App settings : クレデンシャル (デベロッパーキー)、権限、コラボレーターを管理するために使用します。
- Token Usage : トークンの使用状況を表示します。
- API usage : アプリの使用状況を表示します。
アプリの所有権を譲渡するには
所有権を譲渡できるのは、ハブ管理者とアプリ所有者のみです。
- [Applications] に移動し、アプリを選択します。
- ⋮ アイコンをクリックして [Transfer ownership] を選択します。
- 新しい所有者のメールアドレスを入力します。
- [Next] > [Confirm] をクリックします。
新しい所有者はメールを受信し、転送を受け入れる必要があります。
新しい所有者がハブ メンバーでない場合は、アプリをホストする場所を選択します。
ハブ間でアプリを移動するには
ハブ間または [My Applications] ページにアプリを移動できます。
- Applications] に移動してアプリを選択します。
- ⋮ アイコンをクリックして [Move app] を選択します。
- 移動先を選択します。
- アクセスできる別のハブ
- My Applications ページ
- 移動を確認します。
アプリを移動するための要件
- アプリの移動はアプリ所有者またはハブ管理者である必要があります。
- 送信元ハブと宛先ハブの両方のメンバーである必要があります。
アプリのコラボレーターを管理するには
アプリの所有者は、特定のアプリケーションにコラボレーターを追加できます。
- [Applications] に移動し、アプリを選択します。
- [App settings] タブに移動します。
- [Collaborators] までスクロールします。
- [Add collaborator] をクリックします。
- メールアドレスを入力し、ロールを選択します。
- [Add] をクリックします。
重要 : アプリを移動しても所有権は変更されません。アプリの所有者は、アプリをホストするハブに関係なく同じままです。
分析とレポートを理解する
チームの API 使用状況を監視し、ハブ分析とアプリ レベルのレポートを通じてアプリケーションのパフォーマンスを追跡します。
ハブ分析を表示するには
Hub analytics は、チームの全体的な API 消費量を示します。
- ベロッパーハブで、Hub analytics に移動します。
- タブを切り替えます。
- Token usage :すべてのハブ アプリケーションにわたるトークン消費を追跡します。
- API usage :特定の API 呼び出しと対話を監視します。
- ドロップダウンでフィルターを使用する:
- Applications : 特定のアプリまたはすべてのアプリの使用状況を表示します。
- API : 特定のサービスにフィルターします。
- Date range : 報告する期間を選択します。
- [Download] をクリックして、使用状況データをエクスポートします。
アプリレベルの API 使用状況を監視するには
- [Applications] に移動し、アプリを選択します。
- [API usage] タブをクリックします。
- 使用状況のメトリックとグラフを確認します。
- API タイプと日付範囲でフィルタリングします。
- 必要に応じて、詳細な使用状況レポートをダウンロードします。
アプリの移動時の使用状況データの仕組み
アプリレベルのレポート:
- 使用状況の履歴は、場所に関係なくアプリに残ります。
- アプリの使用状況レポートは、移動後も変わりません。
- すべての履歴データには、アプリの所有者がアクセスできます。
ハブレベルのレポート:
- 使用状況は、発生した期間の元のハブのレポートに表示されます。
- 遡及的な変更はありません - 過去の使用状況は転送されず、移動後の将来の使用状況のみが新しいハブに表示されます。
原則:
使用法にはタイムスタンプと場所スタンプが付けられます。データには、API 呼び出しがいつどこで行われたかが常に反映されます。
トラブルシューティング
チームのデベロッパーハブが表示されませんか?
- まだメンバーになっていないかもしれませんので、ハブ管理者に招待を依頼してください。
- チームでハブが作成されていない場合は、チーム管理者にハブの作成を依頼してください。
- 複数のチームに属している場合は、正しいチームに所属しているかどうかを確認してください。
デベロッパーハブを作成できませんか?
- チーム管理者のみが開発者ハブを作成できます。
- チームのプライマリ管理者またはセカンダリ管理者にハブの作成を依頼するか、ロールに必要な場合は管理者アクセスをリクエストします。
アプリを移動しましたが、新しいハブに過去の使用状況が表示されません。これは不具合ですか?
- これは仕様です。使用履歴は元のハブに残ります。新しい使用状況が新しいハブに表示されます。
ハブメンバーを削除できないのはなぜですか?
- アプリを所有するメンバーは、アプリの所有権を別のメンバーに譲渡するまで削除できません。
共有アプリはどこにありますか?
- ユーザー プロファイル メニューに移動し、[Shared app] を選択します。これらは、あなたがメンバーではないハブから共有されるアプリです。
外部コラボレーターはすべてのハブ アプリを表示できますか?
- いいえ、共有している特定のアプリのみが表示され、他のハブ アプリケーションやメンバー情報は表示されません。
リファレンス
用語集
- Autodesk Platform Services (APS) : オートデスク製品と統合するアプリケーションを開発するための API とツール。
- アプリ コラボレーター (App collaborator) : ハブ内の特定のアプリケーションに対する閲覧者または編集者のアクセス許可を持つユーザー。
- アプリ編集者 (App editor) : アプリの使用状況レポートを編集および表示できます。所有権を削除または譲渡することはできません。
- アプリ所有者 (App owner) : アプリの完全な制御(編集、削除、所有権の譲渡、場所間の移動など)。
- アプリビューア (App Viewer) : アプリとその使用状況レポートへの読み取り専用アクセス。
- デベロッパーハブ : 開発チームをつなぐ一元化されたAPSワークスペース。
- 外部コラボレーター (External collaborators) : 指定されたアプリにのみアクセスできるチーム以外のユーザー。
- ハブ管理者 : ハブ内のすべてのアプリケーション、メンバー、およびアクセス許可を管理できます。
- ハブメンバー : 開発者ハブにアクセスできるチーム ユーザー。
- My applications : APS ページには、ハブにない所有しているアプリと、自分と共有されているアプリが表示されます。
- 共有アプリ : あなたがメンバーではないハブからあなたと共有されたアプリは、プロフィールメニューからアクセスできます。
- チーム : 製品、サービス、およびユーザを管理するための Autodesk Account のコンテナ。各チームには 1 つの開発者ハブがあります。
- チームのプライマリ管理者 : チームを完全に制御できる指定された管理者 (チームごとに 1 人)。
- チームのセカンダリ管理者 : チーム ユーザー/製品の可視性を持つ追加の管理者 (チームごとに複数)。
ハブの役割と権限
ハブ管理者
- ハブ メンバーの招待/削除
- 役割の変更
- ハブの使用状況レポートへのアクセス
- 管理者と開発者のリストを表示する
- すべてのハブ アプリを編集する
- アプリの所有権を譲渡する
- 場所間でアプリを移動する
- アプリレベルの使用状況レポートにアクセスする
デベロッパー
- ハブで所有するアプリを編集する
- 共同作業アプリの表示または編集
- アプリレベルの使用状況レポートにアクセスする
チーム管理者
- 開発者ハブを作成する
- Autodesk Account でハブ プロファイルを表示する
- ハブの作成時に自動的にハブ管理者になる
アプリ レベルのロールとアクセス許可
アプリ所有者
- アプリの編集、削除
- アプリの所有権を譲渡する
- 場所間でアプリを移動する
- アプリレベルの使用状況レポートを表示する
- 共同編集者の管理
アプリ編集者
- アプリを編集する
- アプリレベルの使用状況レポートを表示する
アプリビューア
- アプリを見る
- 使用状況レポートを表示する