Team Admin API パブリックベータ

はじめに

チームの規模が大きくなるほど、誰がどのオートデスク製品を使えるかの管理は難しくなります。

Team Admin API のパブリックベータをリリースしました。チームのライセンス管理を、独自のスクリプトやアプリから自動化できます。

ベータは本番環境で動作し、実際のチーム、ユーザー、製品の割り当てを変更します。ただし、念のため変更しても問題のないチームでテストしてください。また、本番システムとの連携にはまだ使用しないでください。

可能な点

• チームの確認：自分が管理しているチームの一覧を取得出来ます。
• ユーザーの管理：チームのユーザー一覧の取得、メールアドレス（完全一致）または User ID によるユーザー検索、新規ユーザーの招待が出来ます。
• 製品の利用状況の確認：製品プールごとの総シート数と割り当て済みシート数を確認することが出来ます。
• 製品割り当ての管理：個々のユーザーへの直接の製品割り当てを確認、作成、削除出来ます。

たとえば、新しい社員をチームに招待し、製品を割り当てるまでを 1 本のスクリプトで一度に実行できます。このスクリプトは何度実行しても安全です。

ベータの仕様と制限

• 個別の割り当てのみ：一括操作にはまだ対応していないため、ユーザーの追加や割り当ての管理は 1 件ずつ行います。
• 直接の割り当てのみ：グループやチームから継承された割り当ては確認できますが、API で変更することはできません。
• ユーザーの招待はできますが、削除はできません。また、グループの確認や管理もできません。
• 3-legged OAuth のみに対応し、トークンの承認はチーム管理者が行います。アプリは Traditional Web App タイプである必要があります。Secure Service Accounts（SSA） にはまだ対応していません。サーバー間のワークフローで 3-legged トークンを使う方法は、こちらのブログをご覧ください。
• レート制限は、チームあたり 1 分間に 60 リクエストです。

制限事項と API の動作の詳細は、Team Admin API Developer’s Guide をご覧ください。

はじめ方

1. APS ポータルで Traditional Web App を登録し、Team Admin API を有効にします。
2. 必要な tmadmapi スコープを指定して、チーム管理者から 3-legged アクセストークンを取得します。
3. https://developer.api.autodesk.com/team-admin/v1/teams を呼び出してチームの一覧を取得し、ユーザーを招待して製品を割り当てます。

コードを書かずに API を試すには、Postman コレクションを利用してください。各手順は Developer’s Guide で説明しています。

フィードバックとサポート

ベータは誰でも利用でき、登録や許可リストへの追加は必要ありません。正式リリースの前に、足りない機能、わかりにくい点、追加してほしい機能などをお聞かせください。

質問、フィードバック、バグ報告は、APS ポータルの Get Help からお送りください。その際は、HTTP メソッドと URL パス、レスポンスのステータスコード、リクエストした時刻、X-Request-Id ヘッダーのリクエスト ID を記載してください。アクセストークンは絶対に含めないでください。

※ 本記事は Introducing the Team admin API, now in public beta! | Autodesk Platform Services から転写・翻訳したものです。