デバイス管理機能のご利用には Device管理プランのご契約が必要です。50ID以下の場合は、Device管理プランも無料でご利用いただけます。トライアルや無料でのご利用を希望される場合は、チャットの「サポート担当者に直接質問する」からご連絡ください。
概要
デバイス画面の一括削除では、50件ごとに削除します。削除するデバイスが多いときや、利用者のメールアドレスなどの条件で探して削除したいときは、Public APIを使うと、まとめて削除できます。 使うAPIは次の2つです。MDM連携のワークスペースを削除しても、そのワークスペースから取り込まれたデバイスは削除されず、デバイス一覧に残ります。
事前準備
- 設定 > APIキー一覧で、APIキーを作成します。手順は「APIキーの発行」をご覧ください。
- 設定 > APIキー一覧で、組織IDを確認します。手順は「OrganizationIDの確認」をご覧ください。
- 削除する前に、デバイス一覧をCSVでエクスポートして、控えを残してください。手順は「デバイスエクスポート」をご覧ください。
手順1. 削除するデバイスのIDを集める
Search devices for an organizationで、削除するデバイスを検索します。次の例では、利用者のメールアドレス（people.primaryEmail）に「@example.com」を含むデバイスを検索します。
- レスポンスの
items[].idが、デバイスのIDです。 - レスポンスの
meta.nextCursorに値が入っているときは、続きがあります。URLに&cursor=<nextCursor の値>を付けて、同じリクエストをもう一度送ります。値に+・/・=が含まれるときは、それぞれ%2B・%2F・%3Dに置き換えます。meta.nextCursorがnullになるまで繰り返します。 - 集めたIDを、事前準備でエクスポートしたCSVと見比べて、削除してはいけないデバイスが含まれていないか確認します。
手順2. デバイスをまとめて削除する
Delete multiple devices of an organizationで、集めたIDのデバイスを削除します。deviceIds に、削除するデバイスのIDを指定します。
- 存在しないIDが1件でもあると、1件も削除されずにエラーになります。削除済みのIDと、重複したIDも、存在しないIDと同じ扱いです。