> ## Documentation Index
> Fetch the complete documentation index at: https://hc.saas-manager.biz.nuro.jp/llms.txt
> Use this file to discover all available pages before exploring further.

# Merge identity with addressless entities Tool の使用方法

> APIで不明SaaSアカウントを自動マージ。ディレクトリ間連携を簡易化するツール。

## Merge identity with addressless entities Tool で出来ること

APIも用いて、メールアドレスが連携されないSaaSアカウントを、他のディレクトリにマージ（名寄せ/紐付け）を行います。

マージに必要なPeopleIDもAPIを用いて、自動で取得します。

Githubなどメールアドレスが取得出来ず、不明アカウントとなっているユーザーデータを、本来のディレクトリデータに紐付けることが手動で行うよりも簡易に可能です。

参考： [SaaSアカウントを他のアカウントに手動で紐付け（名寄せ/マージ）する](/it-management/saas-management/d97dy5z2l7-merge)

## 対象環境

* Google スプレッドシート

## 前提条件

マージ元（メールアドレスのないディレクトリ）の表示名（SaaSIDに該当）と、マージ先（紐付け先のメールアドレスのあるディレクトリ）のメールアドレスが紐付いているリストをご準備ください。

## 導入手順

## 事前準備

1. 設定＞APIキー一覧より、"組織ID"と"APIキー"を取得します。

<img src="https://mintcdn.com/admina-sbn/WPHiBCfq57EV8M2N/images/it-management/6ax6mziqu2/1733404488057-image.png?fit=max&auto=format&n=WPHiBCfq57EV8M2N&q=85&s=799eefa9d7a1560d24527cf6c8d066dd" alt="設定メニューの組織IDをコピーする画面" width="1970" height="472" data-path="images/it-management/6ax6mziqu2/1733404488057-image.png" />

<img src="https://mintcdn.com/admina-sbn/tPHvPFcArb7ZNwqY/images/it-management/6ax6mziqu2/apikey.png?fit=max&auto=format&n=tPHvPFcArb7ZNwqY&q=85&s=d4f40f9c09db8d7e8e9b4c409a687b7d" alt="AdminaのAPIキー一覧画面でAPIキーを生成する画面" width="1740" height="786" data-path="images/it-management/6ax6mziqu2/apikey.png" />

2\. 下記、リンクよりダウンロードを行なってください。
\[スプレッドシート]
[Merge identity with addressless entities](https://docs.google.com/spreadsheets/d/1EIwysIQJZadxhXMzSHBY-oxG5Tx7rskHiW-pKPI87B8/copy)
添付画像のような画面が表示されますが、ご自身の環境に保管し、使用することが出来ます。

<img src="https://mintcdn.com/admina-sbn/Bxo9DSzXAQtG_Fol/images/it-management/6ax6mziqu2/2025-02-26-23-59-46.png?fit=max&auto=format&n=Bxo9DSzXAQtG_Fol&q=85&s=e5776178247853a02e2c97b5c20d951e" alt="Googleスプレッドシートのコピー確認画面" width="1260" height="648" data-path="images/it-management/6ax6mziqu2/2025-02-26-23-59-46.png" />

3\. 拡張機能>Apps Scriptを開き、プロジェクトの設定>スクリプトプロパティより、
プロパティに"APItoken"及び"organizationId"と入力し、それぞれ①で取得した"APIキー"と"組織IDを"入力します。

<img src="https://mintcdn.com/admina-sbn/Bxo9DSzXAQtG_Fol/images/it-management/6ax6mziqu2/2025-02-27-0-08-18.png?fit=max&auto=format&n=Bxo9DSzXAQtG_Fol&q=85&s=ec654edde8835ae9db2711058077e414" alt="Googleスプレッドシートの拡張機能メニューからApps Scriptを開く" width="1536" height="316" data-path="images/it-management/6ax6mziqu2/2025-02-27-0-08-18.png" />

<img src="https://mintcdn.com/admina-sbn/Bxo9DSzXAQtG_Fol/images/it-management/6ax6mziqu2/2025-02-27-0-08-52.png?fit=max&auto=format&n=Bxo9DSzXAQtG_Fol&q=85&s=9c6931289fc19fd0b2399c30ba96c80f" alt="Apps Scriptのプロジェクト設定でスクリプトプロパティを開く" width="570" height="624" data-path="images/it-management/6ax6mziqu2/2025-02-27-0-08-52.png" />

<img src="https://mintcdn.com/admina-sbn/Bxo9DSzXAQtG_Fol/images/it-management/6ax6mziqu2/2025-08-06-19-41-33.png?fit=max&auto=format&n=Bxo9DSzXAQtG_Fol&q=85&s=7fd3eb039c2e3b2249473733abbccc4c" alt="スクリプトプロパティにAPIトークンと組織IDを入力する" width="722" height="289" data-path="images/it-management/6ax6mziqu2/2025-08-06-19-41-33.png" />

<h2 id="usage">
  Merge identity with addressless entities Tool の使用方法
</h2>

1. シート「Merge」のSettingにある、"serviceId"と"workspaceIds"を設定してください。
   "serviceId"：サービス>対象のSaaS（Githubなど）>サービス ID から確認が出来ます。

<img src="https://mintcdn.com/admina-sbn/Bxo9DSzXAQtG_Fol/images/it-management/6ax6mziqu2/2025-08-06-19-49-31.png?fit=max&auto=format&n=Bxo9DSzXAQtG_Fol&q=85&s=d7c9199ba1b18920f5de4a4621a5938b" alt="サービス設定からサービスIDを確認する" width="292" height="94" data-path="images/it-management/6ax6mziqu2/2025-08-06-19-49-31.png" />

"workspaceIds"：サービス>対象のSaaS（Githubなど）>該当のワークスペース>ワークスペースID から確認が出来ます。

<img src="https://mintcdn.com/admina-sbn/Bxo9DSzXAQtG_Fol/images/it-management/6ax6mziqu2/2025-08-06-19-53-45.png?fit=max&auto=format&n=Bxo9DSzXAQtG_Fol&q=85&s=3824b374616dae70c092fa153cdacc30" alt="サービス設定からワークスペースを選択する" width="615" height="517" data-path="images/it-management/6ax6mziqu2/2025-08-06-19-53-45.png" />

<img src="https://mintcdn.com/admina-sbn/Bxo9DSzXAQtG_Fol/images/it-management/6ax6mziqu2/2025-08-06-19-55-49.png?fit=max&auto=format&n=Bxo9DSzXAQtG_Fol&q=85&s=b78bd5455efaec526f2bea4ba78032b9" alt="サービス設定でワークスペースIDを確認する" width="806" height="527" data-path="images/it-management/6ax6mziqu2/2025-08-06-19-55-49.png" />

確認した"serviceId"と"workspaceIds"を、シート「Merge」のSettingに入力してください。

<img src="https://mintcdn.com/admina-sbn/Bxo9DSzXAQtG_Fol/images/it-management/6ax6mziqu2/2025-08-06-19-58-38.png?fit=max&auto=format&n=Bxo9DSzXAQtG_Fol&q=85&s=a8e8ec42b334a0dab04aded79cc757dc" alt="スプレッドシートのSettingセクションにサービスIDとワークスペースIDを入力する" width="217" height="80" data-path="images/it-management/6ax6mziqu2/2025-08-06-19-58-38.png" />

2\. 事前準備に記載しているリストをご準備頂き、"SaaSID"と"MailAddress"を記入してください。

<img src="https://mintcdn.com/admina-sbn/Bxo9DSzXAQtG_Fol/images/it-management/6ax6mziqu2/2025-08-06-20-29-09.png?fit=max&auto=format&n=Bxo9DSzXAQtG_Fol&q=85&s=a4eeebe405538db470b49d7c298ddbdf" alt="Mergeシートに取得対象となるSaaSIDとメールアドレスを入力" width="1250" height="58" data-path="images/it-management/6ax6mziqu2/2025-08-06-20-29-09.png" />

"SaaSID"：SaaSIDなどが取り込まれているマージ元の表示名やユーザーネーム

<img src="https://mintcdn.com/admina-sbn/Bxo9DSzXAQtG_Fol/images/it-management/6ax6mziqu2/2025-08-06-20-04-45.png?fit=max&auto=format&n=Bxo9DSzXAQtG_Fol&q=85&s=7f8c0d427d19154fe19de1d221040d5c" alt="マージ元ディレクトリに記載された表示名やユーザーネーム" width="1483" height="652" data-path="images/it-management/6ax6mziqu2/2025-08-06-20-04-45.png" />

表示名やユーザーネームと一致した場合、"identityId"と"fromPeopleId"に値を返します。

"MailAddress"：マージ元とマージ先のキーとなるメールアドレス

<img src="https://mintcdn.com/admina-sbn/Bxo9DSzXAQtG_Fol/images/it-management/6ax6mziqu2/2025-08-06-20-22-08.png?fit=max&auto=format&n=Bxo9DSzXAQtG_Fol&q=85&s=d90f86b89a760558b116b0f8fc5fd060" alt="マージ先ディレクトリのメールアドレスを入力する" width="701" height="549" data-path="images/it-management/6ax6mziqu2/2025-08-06-20-22-08.png" />

ディレクトリのメールアドレスと一致した場合、"toPeopleId"に値を返します。

3. スプレッドシートのボタン"PeopleID取得実行"を押下してください。

<img src="https://mintcdn.com/admina-sbn/Bxo9DSzXAQtG_Fol/images/it-management/6ax6mziqu2/2025-08-06-20-27-59.png?fit=max&auto=format&n=Bxo9DSzXAQtG_Fol&q=85&s=474db32f0c32f59332e7f9cdf486d91d" alt="スプレッドシートのPeopleID取得実行ボタン" width="1502" height="284" data-path="images/it-management/6ax6mziqu2/2025-08-06-20-27-59.png" />

取得が成功すると、"identityId"、"fromPeopleId"、"toPeopleId"に値が入力されます。

<img src="https://mintcdn.com/admina-sbn/Bxo9DSzXAQtG_Fol/images/it-management/6ax6mziqu2/2025-08-06-20-30-40.png?fit=max&auto=format&n=Bxo9DSzXAQtG_Fol&q=85&s=5f305753a788c681f0fe14c4fb15603a" alt="PeopleID取得後にスプレッドシートへ値が入力された状態" width="1497" height="283" data-path="images/it-management/6ax6mziqu2/2025-08-06-20-30-40.png" />

4\. スプレッドシートのボタン"マージ処理実行"を押下してください。

<img src="https://mintcdn.com/admina-sbn/Bxo9DSzXAQtG_Fol/images/it-management/6ax6mziqu2/2025-08-06-20-33-53.png?fit=max&auto=format&n=Bxo9DSzXAQtG_Fol&q=85&s=b7e7478befa15d812f841ac8b4ea8874" alt="スプレッドシートのマージ処理実行ボタン" width="1499" height="285" data-path="images/it-management/6ax6mziqu2/2025-08-06-20-33-53.png" />

マージに成功すると、"postMerge"に実行結果が記載され、当サービス上でマージされていることが確認出来ます。

<img src="https://mintcdn.com/admina-sbn/Bxo9DSzXAQtG_Fol/images/it-management/6ax6mziqu2/2025-08-06-20-36-28.png?fit=max&auto=format&n=Bxo9DSzXAQtG_Fol&q=85&s=bfb4ba8b9aeb5d8370b3c03f98d0d895" alt="マージ処理実行後のスプレッドシート実行結果" width="1252" height="55" data-path="images/it-management/6ax6mziqu2/2025-08-06-20-36-28.png" />

<img src="https://mintcdn.com/admina-sbn/Bxo9DSzXAQtG_Fol/images/it-management/6ax6mziqu2/2025-08-06-20-37-26.png?fit=max&auto=format&n=Bxo9DSzXAQtG_Fol&q=85&s=ebeaab938d08e3e2bc9c0317e5fc6086" alt="マージ結果を確認する画面" width="1487" height="531" data-path="images/it-management/6ax6mziqu2/2025-08-06-20-37-26.png" />

以上がMerge identity with addressless entities Toolの使用方法になります。

ご不明点やご相談事項がございましたら、お気軽にチャットサポートまでお問合せください。