参照 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 開発者の認証情報のみです。
開発者の認証情報を作成した後、アプリのアイテム ページの [設定] タブにある [使用状況の表示] をクリックすると、アプリにサイン インしたユーザーと、そのユーザーが消費したクレジット数に関する情報にアクセスできます。 アプリに埋め込まれた認証情報の設定を管理することもできます。
注意:
[使用状況の表示] セクションは、ArcGIS Location Platform サブスクリプションでサイン インした場合、表示されません。
ユーザー ログインの実装パターンは、Web ベースのアプリを使用しているか、またはネイティブのアプリを使用しているかによって若干異なります。Web ベースのアプリおよびネイティブ アプリの詳細とサンプル コードについては、Esri Developer ドキュメントをご参照ください。
ユーザー認証用 OAuth 2.0 認証情報の作成
アプリでユーザーに ArcGIS Online アカウントでサイン インしてもらう必要がある場合、次の手順を実行します。
- コンテンツを作成、更新、削除する権限のある組織アカウントでサイン インしていることを確認します。
- コンテンツ ページの [マイ コンテンツ] タブをクリックし、[新しいアイテム] をクリックします。
- [新しいアイテム] ウィンドウで [開発者の認証情報] をクリックします。
最初に表示されるウィンドウは、組織内での権限によって異なります。 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 を https://<myServer>/myWebMapApp 形式で入力します。
- [次へ] をクリックします。
- タイトルを入力します。
- アイテムの保存先となる [マイ コンテンツ] 内のフォルダーを選択します。
あるいは、メニューから [新しいフォルダーの作成] ボタンを選択し、フォルダー名を入力して、アイテムを新しいフォルダーに保存することもできます。
フォルダー名に 4 バイトの Unicode 文字は使用できません。
- 組織がコンテンツのカテゴリーを設定している場合、[カテゴリーの割り当て] をクリックして、最大 20 のカテゴリーを選択して、アイテムの検索に役立てることができます。
また、カテゴリー名の入力を開始して、カテゴリーのリストを絞り込むこともできます。
- 必要に応じて、アイテムを説明するタグを入力します。
語句をカンマで区切ります (たとえば、「Federal land」は 1 つのタグと見なされますが、「Federal, land」は 2 つのタグと見なされます)。
入力する際、以前に追加したタグから生成された推奨タグが表示されるので、そこから選択することができます。
- 必要に応じて、アプリについて説明するサマリーを追加します。
- [次へ] をクリックします。
認証情報のサマリーが表示されます。
- 認証情報のサマリーを確認します。 設定を変更するには、アイテムを作成する前に [戻る] をクリックして変更を行います。
- [作成] をクリックします。
アプリがコンテンツに追加され、アイテム ページが表示されます。 OAuth 2.0 認証情報がアプリで使用されていることを示すバッジ 
がアイテム ページに表示され、コンテンツ ページまたはアイテム プレビュー ウィンドウからアイテムを表示した場合にも表示されます。 アイテム ページの [概要] タブで、バッジは、認証情報に個人権限が含まれているか、標準権限のみが含まれているかを示します。
アプリ認証用 OAuth 2.0 認証情報の作成
パブリック アプリでユーザーのサイン インが必要がなく、サーバー側でアクセス トークンを生成する必要がない場合、次の手順を実行します。
- コンテンツを作成、更新、削除する権限のある組織アカウントでサイン インしていることを確認します。
- コンテンツ ページの [マイ コンテンツ] タブをクリックし、[新しいアイテム] をクリックします。
- [新しいアイテム] ウィンドウで [開発者の認証情報] をクリックします。
最初に表示されるウィンドウは、組織内での権限によって異なります。 API キーを作成する権限がないロールのメンバーである場合は、手順 5 に進みます。 API キーを作成する権限があるロールの場合は、手順 4 に進みます。
- [アプリ認証用の OAuth 2.0 認証情報] オプションを選択し、[次へ] をクリックします。
- [これらの認証情報はどこで使用しますか] で、次のいずれかのオプションを選択します:
- [選択した権限とアクセス権を持つプライベート アプリケーション] - アイテムのセットへのアクセス権と権限を付与するには、このオプションを選択します。 プライベート アプリに、またはパブリック アプリで使用されるサーバー側のコンポーネントにこれを埋め込むことができます。
- [ユーザーを偽装するプライベート アプリケーション] - 現在のすべての権限に加え、組織のコンテンツ、メンバー、設定へのアクセス権を付与するには、このオプションを選択します。
- [次へ] をクリックします。
- [選択した権限とアクセス権を持つプライベート アプリケーション] を選択した場合は、必要に応じて、次のいずれかのオプションを選択します:
- [アイテムへのアクセスなし] - この認証情報ではアイテムへのアクセスは必要ありません。 [次へ] をクリックします。
- [権限を使用してアイテムへのアクセス権を付与] - この認証情報では、アイテムへのアクセスを許可するために必要な権限を選択します。 [次へ] をクリックします。
- [特定のアイテムへのアクセス権を付与] - 所有しているアイテムを最初に選択してから、アクセス権を付与する必要があります。 [次へ] をクリックします。
- [選択した権限とアクセス権を持つプライベート アプリケーション] を選択した場合は、必要に応じて、権限を割り当てることで、認証情報がアプリに実行を許可するアクションを選択します。 [次へ] をクリックします。
ArcGIS Location Platform サブスクリプションの有無や組織内での権限によって、使用できる権限のリストは異なります。 アカウントが所有していない権限を付与することはできません。
権限のタイプについては、Esri 開発者ヘルプの「セキュリティーと認証に関するガイド」をご参照ください。
- [次へ] をクリックします。
- [参照元 URL] の下に、アプリへの接続を許可する URL または IP アドレスを入力します。[追加] をクリックし、必要な参照元 URL または IP アドレスをさらに追加します。
認証時に指定された URL は、登録済みの URL のいずれかと一致する必要があります。一致しなければ、認証は拒否されます。
サポートされる参照元 URL の形式の例を以下に示します。
- https://www.example.com/pages
- https://www.example.com/pages/index.html
- [次へ] をクリックします。
- タイトルを入力します。
- アイテムの保存先となる [マイ コンテンツ] 内のフォルダーを選択します。
あるいは、メニューから [新しいフォルダーの作成] ボタンを選択し、フォルダー名を入力して、アイテムを新しいフォルダーに保存することもできます。
フォルダー名に 4 バイトの Unicode 文字は使用できません。
- 組織がコンテンツのカテゴリーを設定している場合、[カテゴリーの割り当て] をクリックして、最大 20 のカテゴリーを選択して、アイテムの検索に役立てることができます。
また、カテゴリー名の入力を開始して、カテゴリーのリストを絞り込むこともできます。
- 必要に応じて、アイテムを説明するタグを入力します。
語句をカンマで区切ります (たとえば、「Federal land」は 1 つのタグと見なされますが、「Federal, land」は 2 つのタグと見なされます)。
入力する際、以前に追加したタグから生成された推奨タグが表示されるので、そこから選択することができます。
- 必要に応じて、アプリについて説明するサマリーを追加します。
- [次へ] をクリックします。
認証情報のサマリーが表示されます。
- 認証情報のサマリーを確認します。 設定を変更するには、アイテムを作成する前に [戻る] をクリックして変更を行います。
- [ユーザーを偽装するプライベート アプリケーション] を選択した場合、[選択した権限に関連付けられたセキュリティー要件を承認して受け入れます] の横のボックスをクリックします。
- [作成] をクリックします。
アプリがコンテンツに追加され、アイテム ページが表示されます。 コンテンツ ページまたはアイテム プレビュー ウィンドウからアイテムを表示すると、OAuth 2.0 認証情報を使用していることを示すバッジ が表示されます。 [これらの認証情報はどこで使用しますか] で [ユーザーを偽装するプライベート アプリケーション] を選択した場合、アイテム ページの [概要] タブにバッジ [OAuth 2.0 の認証情報 - アイテム所有者を偽装します] が表示されます。
API キー認証情報の作成
API キー認証情報を作成するには、次の手順を実行します。
- 組織アカウントにサイン インしていることと、API キーの作成と、コンテンツの作成、更新、削除を行う権限を持っていることを確認します。
- コンテンツ ページの [マイ コンテンツ] タブをクリックし、[新しいアイテム] をクリックします。
- [新しいアイテム] ウィンドウで [開発者の認証情報] をクリックします。
- [API キー認証情報] オプションを選択し、[次へ] をクリックします。
- [これらの認証情報はどこで使用しますか] で、次のいずれかのオプションを選択します:
- [パブリック アプリケーション] - 特定のアイテムへのアクセス権とサービス権限を付与するには、このオプションを選択します。
- [選択した権限とアクセス権を持つプライベート アプリケーション] - アイテムのセットへのアクセス権と権限を付与するには、このオプションを選択します。 プライベート アプリに、またはパブリック アプリで使用されるサーバー側のコンポーネントにこれを埋め込むことができます。
- [ユーザーを偽装するプライベート アプリケーション] - 現在のすべての権限に加え、組織のコンテンツ、メンバー、設定へのアクセス権を付与するには、このオプションを選択します。
- [次へ] をクリックします。
- [パブリック アプリケーション] を選択した場合は、必要に応じて、次のいずれかのオプションを選択します:
- [アイテムへのアクセスなし] - この認証情報ではアイテムへのアクセスは必要ありません。 [次へ] をクリックします。
- [特定のアイテムへのアクセス権を付与] - 所有しているアイテムを最初に選択してから、[次へ] をクリックします。
- [選択した権限とアクセス権を持つプライベート アプリケーション] を選択した場合は、必要に応じて、次のいずれかのオプションを選択します:
- [アイテムへのアクセスなし] - この認証情報ではアイテムへのアクセスは必要ありません。 [次へ] をクリックします。
- [権限を使用してアイテムへのアクセス権を付与] - この認証情報では、アイテムへのアクセスを許可するために必要な権限を選択します。 [次へ] をクリックします。
- [特定のアイテムへのアクセス権を付与] - 所有しているアイテムを最初に選択してから、[次へ] をクリックします。
- [パブリック アプリケーション] または [選択した権限とアクセス権を持つプライベート アプリケーション] を選択した場合は、必要に応じて、権限を割り当てることで、認証情報がアプリに実行を許可するアクションを選択します。 [次へ] をクリックします。
ArcGIS Location Platform サブスクリプションの有無や組織内での権限によって、使用できる権限のリストは異なります。 アカウントが所有していない権限を付与することはできません。
権限のタイプについては、Esri 開発者ヘルプの「セキュリティーと認証に関するガイド」をご参照ください。
- [ユーザーを偽装するプライベート アプリケーション] を選択した場合、必要に応じて、カレンダーを使用して認証情報の有効期限を指定します。
認証情報の有効期限は、翌日 (最短) から 365 日後 (最長) まで設定できます。 有効期限として選択した日の 23 時 59 分に有効期限が切れます。 アプリを追加し、認証情報を生成した時点でのブラウザーの時間に基づいて時間が格納されます。
- [参照元 URL] の下に、アプリへの接続を許可する URL または IP アドレスを入力します。[追加] をクリックし、必要な参照元 URL または IP アドレスをさらに追加します。
認証時に指定された URL は、登録済みの URL のいずれかと一致する必要があります。一致しなければ、認証は拒否されます。
サポートされる参照元 URL の形式の例を以下に示します。
- https://www.example.com/pages
- https://www.example.com/pages/index.html
- [次へ] をクリックします。
- タイトルを入力します。
- アイテムの保存先となる [マイ コンテンツ] 内のフォルダーを選択します。
あるいは、メニューから [新しいフォルダーの作成] ボタンを選択し、フォルダー名を入力して、アイテムを新しいフォルダーに保存することもできます。
フォルダー名に 4 バイトの Unicode 文字は使用できません。
- 組織がコンテンツのカテゴリーを設定している場合、[カテゴリーの割り当て] をクリックして、最大 20 のカテゴリーを選択して、アイテムの検索に役立てることができます。
また、カテゴリー名の入力を開始して、カテゴリーのリストを絞り込むこともできます。
- 必要に応じて、アイテムを説明するタグを入力します。
語句をカンマで区切ります (たとえば、「Federal land」は 1 つのタグと見なされますが、「Federal, land」は 2 つのタグと見なされます)。
入力する際、以前に追加したタグから生成された推奨タグが表示されるので、そこから選択することができます。
- 必要に応じて、アプリについて説明するサマリーを追加します。
- [次へ] をクリックします。
認証情報のサマリーが表示されます。
- 認証情報のサマリーを確認します。 設定を変更するには、アイテムを作成する前に [戻る] をクリックして変更を行います。
- [ユーザーを偽装するプライベート アプリケーション] を選択した場合、[選択した権限に関連付けられたセキュリティー要件を承認して受け入れます] の横のボックスをクリックします。
- [作成] をクリックします。
アプリがコンテンツに追加され、アイテム ページが表示されます。 API キーがアプリに埋め込まれていることを示すバッジ 
がアイテム ページに表示され、コンテンツ ページまたはアイテム プレビュー ウィンドウからアイテムを表示した場合にも表示されます。 アイテム ページの [概要] タブで、バッジは、認証情報に個人権限が含まれているか、標準権限のみが含まれているかを示します。