アプリの追加と登録—ArcGIS Online ヘルプ

参照 URL を既存のアプリへ追加すると、組織や一般ユーザーのメンバーと作業を共有する際に効果的です (共有権限によります)。 URL に加えて、アプリのタイプ、目的、概要、説明、アプリの作成に使用されるコードを含む .zip ファイルなどの、その他の詳細情報も共有できます。アプリを ArcGIS Online に追加すると、アプリの URL への参照のみが追加されます。ArcGIS Online には、アプリファイルは保存されません。

組織アカウントを持つアプリ開発者は、プラットフォームにアプリを登録することもできます。これには、組織のメンバーや組織外のユーザーがアプリにサインインできるよう OAuth アプリケーションを登録する作業も含まれます。詳細については、以下の「開発者の認証情報を使用してアプリを追加し、登録する」セクションをご参照ください。

コードサンプルをアップロードする場合など、アプリを登録する必要がない場合は、以下の「URL からのアプリの追加」セクションの手順に従います。

ヒント:

アプリを組織や一般ユーザーのメンバーと共有する別の方法として、マップを使用したアプリとグループを使用したギャラリーアプリを作成する方法があります。

URL からのアプリの追加

URL を使用して Web 上のアプリにアクセスするが、登録する必要がないアイテム (コードサンプルなど) を追加するには、次の手順に従います。

注意:

登録済みのアプリを追加するには、開発者の認証情報を使用してアプリを追加し、登録する手順に従います。

サインインしていることと、コンテンツを作成、更新、削除する権限を持っていることを確認します。
コンテンツページの [マイコンテンツ] タブから [新しいアイテム] をクリックし、[アプリケーション] をクリックします。
アプリのタイプを選択します。
- [Web マッピング] - JavaScript などの Web API で構築された Web アプリ。
- [デスクトップ] - Java や .NET (Microsoft Windows デスクトップ) などのデスクトッププラットフォームで構築されたデスクトップ用アプリ
- [モバイル] - iOS や Android などのモバイルデバイス用に SDK で構築されたダウンロード可能なアプリ
- [他のアプリケーション] - アプリケーションの目的、API、SDK、URL アドレスなどの詳細情報のない、デスクトップアプリケーション、Python スクリプト、または任意のタイプの一般アプリ。
Web マッピング、デスクトップ、またはモバイルの場合、アプリの URL (「https://<myServer>/myWebMapApp」など) を入力します。
デスクトップアプリの場合、[参照] をクリックし、アプリを含む .zip ファイルを選択します。
[次へ] をクリックします。
タイトルを入力します。
アイテムの保存先となる [マイコンテンツ] 内のフォルダーを選択します。
あるいは、メニューから [新しいフォルダーの作成] ボタンを選択し、フォルダー名を入力して、アイテムを新しいフォルダーに保存することもできます。
フォルダー名に 4 バイトの Unicode 文字は使用できません。
組織がコンテンツのカテゴリを設定している場合、[カテゴリの割り当て] をクリックして、最大 20 のカテゴリを選択して、アイテムの検索に役立てることができます。
また、カテゴリ名の入力を開始して、カテゴリのリストを絞り込むこともできます。
必要に応じて、アイテムを説明するタグを入力します。
語句をカンマで区切ります (たとえば、「Federal land」は 1 つのタグと見なされますが、「Federal, land」は 2 つのタグと見なされます)。
入力する際、以前に追加したタグから生成された推奨タグが表示されますので、そこから選択することができます。
必要に応じて、アプリについて説明するサマリーを追加します。
[保存] をクリックします。

アプリを追加すると、そのアプリがコンテンツに表示されます。後から登録する場合は、アプリのアイテムページの [設定] タブから行えます。詳細については、以下の「開発者の認証情報を使用してアプリを追加し、登録する」セクションをご参照ください。

必要に応じてアイテムの詳細を構成してコードを添付し、共有権限がある場合はアプリを共有できます。

開発者の認証情報を使用してアプリを追加し、登録する

組織アカウントを持つ開発者は、アプリをプラットフォームに追加および登録してアプリケーション ID を生成できます。使用に関する統計情報を収集する場合や、ユーザーが OAuth 2.0 (標準化された認証フレームワーク) を使用してプラットフォームにサインインできるようにする場合は、アプリ内でアプリケーション ID を使用します。 OAuth 2.0 を利用する場合、アプリはプラットフォームが提供するログインページを使用して、ユーザーがプラットフォームにサインインできるようにします。また、アプリは組織に関連付けられたユーザーコンテンツや、他の ArcGIS Online 機能 (ジオコーディング、ルート検索、GeoEnrichment など) と連携することもできるようになります。認証と OAuth 2.0 の詳細については、Esri Developer をご参照ください。

または、アプリの登録時にアプリに API キーを埋め込むこともできます。

アプリに含めることができる開発者の認証情報のタイプは、組織内での権限によって異なります。デフォルト管理者ロールのメンバー、または API キーを生成する権限を持つカスタムロールのメンバーの場合は、OAuth 2.0 または API キーのどちらの認証情報でもアプリで使用できます。それ以外の場合、アプリで使用できるのは OAuth 2.0 開発者の認証情報のみです。

注意:

ユーザーログインの実装パターンは、Web ベースのアプリを使用しているか、またはネイティブのアプリを使用しているかによって若干異なります。Web ベースのアプリおよびネイティブアプリの詳細とサンプルコードについては、Esri Developer ドキュメントをご参照ください。

OAuth 2.0 認証情報が埋め込まれたアプリの追加と登録

作成したアプリで OAuth 2.0 認証情報を使用すると、アプリにアクセスしたときにアクセストークンが動的に生成されます。アクセストークンは最大 14 日間有効です。

ロールに API キーを作成する権限がない場合は、次の手順に従います。

コンテンツを作成、更新、削除する権限のある組織アカウントでサインインしていることを確認します。
コンテンツページの [マイコンテンツ] タブをクリックし、[新しいアイテム] をクリックします。
[新しいアイテム] ウィンドウで [開発者の認証情報] をクリックします。

最初に表示されるウィンドウは、組織内での権限によって異なります。 API キーを作成する権限がないロールのメンバーである場合は、手順 5 に進みます。 API キーを作成する権限があるロールの場合は、手順 4 に進みます。

[OAuth 2.0 認証情報] オプションを選択し、[次へ] をクリックします。
[リダイレクト URL] に、ユーザーが正常にサインインした後にリダイレクトするために使用する Web ページまたはサーバーのエンドポイントの URL を入力します。 [追加] をクリックし、必要に応じてリダイレクト URL をさらに追加します。
認証時に指定されたリダイレクト URL は、登録済みの URL のいずれかと一致する必要があります。一致しなければ、認証は拒否されます。
認証許可に対し、特別な値である urn:ietf:wg:oauth:2.0:oob も指定できます。これにより、認証コードがポータル URL (/oauth2/approval) に配信されます。この値は通常、コードを配信できる Web サーバーやカスタム URL スキーマのないアプリで使用されます。
サポートされるリダイレクト URL の形式の例を以下に示します。
- https://app.foo.com
- urn:ietf:wg:oauth:2.0:oob
[参照元 URL] の下に、接続を許可する URL または IP アドレスを入力します。 [追加] をクリックし、必要に応じて参照元 URL または IP アドレスをさらに追加します。
[アプリケーション環境] で、アプリのアプリケーション環境 ([複数]、[ネイティブ]、[ブラウザー]、または [サーバー]) を選択します。
[URL] ボックスに、アプリの URL を https://<myServer>/myWebMapApp 形式で入力します。
[次へ] をクリックします。
OAuth 2.0 アプリケーションに権限を割り当てる権限を持つロールのメンバーの場合、[次へ] をクリックすると、アプリに許可する動作を定義できるウィンドウが表示されます。この権限がない場合は、手順 12 に進みます。
権限を割り当てることで、認証情報がアプリに許可するアクションを選択し、[次へ] をクリックします。
ArcGIS Location Platform サブスクリプションの有無や組織内での権限によって、使用できる権限のリストは異なります。アカウントが所有していない権限を付与することはできません。
権限のタイプについては、Esri 開発者ヘルプの「セキュリティと認証に関するガイド」をご参照ください。
[アイテムの参照] をクリックし、埋め込まれた認証情報を使用してアクセスできるアイテムを選択し、[アイテムの追加] をクリックします。
代わりに、[スキップ] をクリックすることもできます。
タイトルを入力します。
アイテムの保存先となる [マイコンテンツ] 内のフォルダーを選択します。
あるいは、メニューから [新しいフォルダーの作成] ボタンを選択し、フォルダー名を入力して、アイテムを新しいフォルダーに保存することもできます。
フォルダー名に 4 バイトの Unicode 文字は使用できません。
組織がコンテンツのカテゴリを設定している場合、[カテゴリの割り当て] をクリックして、最大 20 のカテゴリを選択して、アイテムの検索に役立てることができます。
また、カテゴリ名の入力を開始して、カテゴリのリストを絞り込むこともできます。
必要に応じて、アイテムを説明するタグを入力します。
語句をカンマで区切ります (たとえば、「Federal land」は 1 つのタグと見なされますが、「Federal, land」は 2 つのタグと見なされます)。
入力する際、以前に追加したタグから生成された推奨タグが表示されますので、そこから選択することができます。
必要に応じて、アプリについて説明するサマリーを追加します。
[次へ] をクリックします。
認証情報のサマリーを確認します。設定を変更するには、アイテムを作成する前に [戻る] をクリックして変更を行います。
個人権限を認証情報に付与した場合は、セキュリティの承認の横にあるチェックボックスをオンにして、読んで同意したことを確認し、[作成] をクリックして認証情報を作成します。

アプリがコンテンツに追加され、アイテムページが表示されます。 OAuth 2.0 認証情報がアプリで使用されていることを示すバッジがアイテムページに表示され、コンテンツページまたはアイテムプレビューウィンドウからアイテムを表示した場合にも表示されます。アイテムページの [概要] タブで、バッジは、認証情報に個人権限が含まれているか、標準権限のみが含まれているかを示します。

アプリのアイテム詳細を構成できます。

[設定] タブの [使用状況の表示] をクリックすると、アプリにサインインしたユーザーと、そのユーザーが消費したクレジット数に関する情報にアクセスできます。

注意:

[使用状況の表示] セクションは、ArcGIS Location Platform　サブスクリプションでサインインした場合、表示されません。

アプリに埋め込まれた認証情報の設定を管理することもできます。

API キー認証情報が埋め込まれたアプリの追加と登録

API キー認証情報をアプリに埋め込む必要があり、そのキーの有効期限が 14 日以上必要な場合は、API キー認証情報を使用します。

次の手順に従って、アプリを追加し、アプリに埋め込んで認証目的で使用する API キーを作成します。

組織アカウントにサインインしていることと、API キーの作成と、コンテンツの作成、更新、削除を行う権限を持っていることを確認します。
コンテンツページの [マイコンテンツ] タブをクリックし、[新しいアイテム] をクリックします。
[新しいアイテム] ウィンドウで [開発者の認証情報] をクリックします。
[API キー認証情報] オプションを選択し、[次へ] をクリックします。
カレンダーを使用して、認証情報の有効期限を指定します。
認証情報の有効期限は、翌日 (最短) から 365 日後 (最長) まで設定できます。有効期限として選択した日の午後 11 時 59 分に有効期限が切れます。アプリを追加し、認証情報を生成した時点でのブラウザーの時間に基づいて時間が格納されます。
[参照元 URL] の下に、アプリへの接続を許可する URL または IP アドレスを入力します。[追加] をクリックし、必要な参照元 URL または IP アドレスをさらに追加します。
認証時に指定された URL は、登録済みの URL のいずれかと一致する必要があります。一致しなければ、認証は拒否されます。
サポートされる参照元 URL の形式の例を以下に示します。
- https://www.example.com/pages
- https://www.example.com/pages/index.html
[次へ] をクリックします。
権限を割り当てることで、認証情報がアプリに許可するアクションを選択し、[次へ] をクリックします。
ArcGIS Location Platform サブスクリプションの有無や組織内での権限によって、使用できる権限のリストは異なります。アカウントが所有していない権限を付与することはできません。
権限のタイプについては、Esri 開発者ヘルプの「セキュリティと認証に関するガイド」をご参照ください。
[アイテムの参照] をクリックし、埋め込まれた認証情報を使用してアクセスできるアイテムを選択し、[アイテムの追加] をクリックします。
代わりに、[スキップ] をクリックすることもできます。
タイトルを入力します。
アイテムの保存先となる [マイコンテンツ] 内のフォルダーを選択します。
あるいは、メニューから [新しいフォルダーの作成] ボタンを選択し、フォルダー名を入力して、アイテムを新しいフォルダーに保存することもできます。
フォルダー名に 4 バイトの Unicode 文字は使用できません。
組織がコンテンツのカテゴリを設定している場合、[カテゴリの割り当て] をクリックして、最大 20 のカテゴリを選択して、アイテムの検索に役立てることができます。
また、カテゴリ名の入力を開始して、カテゴリのリストを絞り込むこともできます。
必要に応じて、アイテムを説明するタグを入力します。
語句をカンマで区切ります (たとえば、「Federal land」は 1 つのタグと見なされますが、「Federal, land」は 2 つのタグと見なされます)。
入力する際、以前に追加したタグから生成された推奨タグが表示されますので、そこから選択することができます。
必要に応じて、アプリについて説明するサマリーを追加します。
[次へ] をクリックします。
認証情報のサマリーを確認します。設定を変更するには、アイテムを作成する前に [戻る] をクリックして変更を行います。
個人権限を認証情報に付与した場合は、セキュリティの承認の横にあるチェックボックスをオンにして、読んで同意したことを確認し、[次へ] をクリックします。
API キーをすぐに生成するか、後で生成するかを指定し、[次へ] をクリックします。
API キーが生成されたら、すぐにコピーする必要があります。
- [API キーを生成して、アイテム詳細ページに移動します。キーをコピーして保存する準備ができました。] オプションをクリックした場合、[次へ] をクリックすると、[API キーの生成] ポップアップが表示されます。 [コピー] ボタンをクリックして、キーをコピーします。キーをセキュリティで保護された文書に貼り付けます。操作が完了したら、ポップアップを閉じます。
- [アイテム詳細ページに移動します。後で API キーを生成します。] オプションをクリックした場合、認証情報アイテムページが表示されます。 [次へ] をクリックすると、アイテムページが表示されます。アイテムページの [設定] タブから API キーを生成できます。

アプリがコンテンツに追加され、アイテムページが表示されます。 API キーがアプリに埋め込まれていることを示すバッジ API キー認証情報がアイテムページに表示され、コンテンツページまたはアイテムプレビューウィンドウからアイテムを表示した場合にも表示されます。アイテムページの [概要] タブで、バッジは、認証情報に個人権限が含まれているか、標準権限のみが含まれているかを示します。