翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# ワンクリック埋め込みコードを使用した Amazon Quick Sight のビジュアルとダッシュボードの埋め込み
<a name="1-click-embedding"></a>

この埋め込みコードをにより、ビジュアルまたはダッシュボードをアプリケーションに埋め込むことができます。このコードは、ダッシュボードを共有するか、Amazon Quick Sight の**埋め込みビジュアル**メニューから取得できます。

ビジュアルまたはダッシュボードは、登録ユーザー用として内部アプリケーションに埋め込むことも可能です。または、Amazon Quick Sight コンソールでパブリック共有を有効にすることもできます。これにより、インターネットにアクセス可能なすべてのユーザーが、公開アプリケーション、Wiki、またはポータルに埋め込まれている、共有ビジュアルまたは共有ダッシュボードにアクセスできるようになります。

以下で、ビジュアルまたはダッシュボード埋め込みのワンクリックコードを使用して、これらを埋め込む方法について説明します。

**Topics**
+ [ワンクリック埋め込みコードを使用して登録済みユーザーに Amazon Quick Sight ビジュアルとダッシュボードを埋め込む](embedded-analytics-1-click.md)
+ [ワンクリック埋め込みコードを使用して匿名ユーザー向けに Amazon Quick Sight ビジュアルとダッシュボードを埋め込む](embedded-analytics-1-click-public.md)

# ワンクリック埋め込みコードを使用して登録済みユーザーに Amazon Quick Sight ビジュアルとダッシュボードを埋め込む
<a name="embedded-analytics-1-click"></a>


|  | 
| --- |
|  適用対象: Enterprise Edition  | 

Amazon Quick Sight アカウントの登録済みユーザー向けに、ビジュアルまたはダッシュボードを内部アプリケーションに埋め込むことができます。そのためには、ダッシュボードを共有するときに取得する埋め込みコードを使用するか、Amazon Quick Sight の**埋め込みビジュアル**メニューから取得します。埋め込みコードを生成するために Amazon Quick Sight 埋め込み API を実行する必要はありません。Amazon Quick Sight から埋め込みコードをコピーし、内部アプリケーションの HTML コードに貼り付けることができます。

埋め込むダッシュボードにアクセスできるユーザーとグループ (または Amazon Quick Sight アカウントのすべてのユーザー）、または内部アプリケーションへのアクセスを埋め込むビジュアルを保持するユーザーとグループは、認証情報を使用して Amazon Quick Sight アカウントにサインインするように求められます。ユーザーは認証後に、内部ページから、ビジュアルやダッシュボードにアクセスできるようになります。シングルサインオンが有効になっている場合は、ユーザーにサインインが再度求められることはありません。

以下で、ビジュアルまたはダッシュボードの埋め込みコードを使用して、登録済みユーザー向けに。ビジュアルまたはダッシュボードを埋め込む方法を説明します。

## 開始する前に
<a name="embedded-analytics-1-click-prerequisites"></a>

作業を始める前に、以下を確認してください。
+ ポップアップと iframe 間の通信を許可するため、インターネットブラウザの設定に以下のいずれかが含まれている。
  + Mozilla Broadcast Channel API のネイティブサポート。詳細については、Mozilla ドキュメントで [Broadcast Channel API](https://developer.mozilla.org/en-US/docs/Web/API/Broadcast_Channel_API) を参照してください。
  + IndexedDB のサポート。
  + LocalStorage のサポート。
+ インターネットブラウザの「すべての cookie をブロック」設定がオフになっている。

## ステップ 1: ダッシュボードへのアクセス権を付与する
<a name="embedded-analystics-1-click-share"></a>

ユーザーが埋め込みダッシュボードにアクセスできるように、ダッシュボードを表示するためのアクセス権をユーザーに付与します。個々のユーザーやグループにダッシュボードへのアクセス権を付与する、またはアカウント内の全ユーザーにアクセス権を付与することができます。ビジュアルのアクセス許可はダッシュボードレベルで決定されます。埋め込みビジュアルに対するアクセス許可を付与するには、そのビジュアルが属するダッシュボードへのアクセスを許可します。詳しくは、「[ダッシュボードに対するアクセス権の付与](share-a-dashboard.md)」を参照してください。

## ステップ 2: ビジュアルもしくはダッシュボードを埋め込むドメインを許可リストに入れる
<a name="embedded-analytics-1-click-allow-list"></a>

ビジュアルとダッシュボードを内部アプリケーションに埋め込むには、埋め込むドメインが Amazon Quick Sight アカウントに許可リストに登録されていることを確認します。詳細については、「[静的ドメインを許可リストに追加する](manage-domains.md#embedding-static)」を参照してください。

## ステップ 3: 埋め込みコードを取得する
<a name="embedded-analytics-1-click-code"></a>

以下の手順を使用して、ビジュアルもしくはダッシュボードの埋め込み用コードを取得します。

**ダッシュボードの埋め込み用コードを取得する**

1. Amazon Quick Sight で公開されたダッシュボードを開き、右上**の共有**を選択します。次に、**[Share dashboard]** (ダッシュボードの共有) をクリックします。

1. 開いた **[Share dashboard]** (ダッシュボードの共有) ページで、左上の **[Copy embed code]** (埋め込みコードをコピー) をクリックします。

   以下のような埋め込みコードがクリップボードにコピーされます。この例`quicksightdomain`の は、Amazon Quick Sight アカウントへのアクセスに使用する URL です。

   ```
   <iframe
           width="960"
           height="720"
           src="https://quicksightdomain/sn/embed/share/accounts/accountid/dashboards/dashboardid?directory_alias=account_directory_alias">
       </iframe>
   ```

**ビジュアルの埋め込み用コードを取得する**

1. Amazon Quick Sight で公開されたダッシュボードを開き、埋め込むビジュアルを選択します。次に、ビジュアルの右上にあるビジュアルのメニューを展開した後、**[Embed visual]** (埋め込みビジュアル) を選択します。

1. **[Embed visual]** (埋め込みビジュアル) ペインが開くので、**[Copy code]** (コードをコピー) を選択します。

   以下のような埋め込みコードがクリップボードにコピーされます。この例`quicksightdomain`の は、Amazon Quick Sight アカウントへのアクセスに使用する URL です。

   ```
   <iframe
           width="600"
           height="400"
           src="https://quicksightdomain/sn/embed/share/accounts/111122223333/dashboards/DASHBOARDID/sheets/SHEETID>/visuals/VISUALID">
       </iframe>
   ```

## ステップ 4: 内部アプリケーションの HTML ページにコードを貼り付ける
<a name="embedded-analytics-1-click-html"></a>

以下の手順を使用して、埋め込みコードを内部アプリケーションの HTML ページに貼り付けます。

**内部アプリケーションの HTML ページにコードを貼り付ける**
+ ダッシュボードを埋め込むページの HTML コードを開き、埋め込みコードを貼り付けます。

  埋め込まれたダッシュボードでは、この表示は以下の例のようになります。この例`quicksightdomain`の は、Amazon Quick Sight アカウントへのアクセスに使用する URL です。

  ```
  <!DOCTYPE html>
      <html>
      <body>
  
      <h2>Example.com - Employee Portal</h2>
      <h3>Current shipment stats</h3>
          <iframe
          width="960"
          height="720"
          src="https://quicksightdomain/sn/embed/share/accounts/accountid/dashboards/dashboardid?directory_alias=account_directory_alias">
      </iframe>
  
      </body>
      </html>
  ```

  埋め込まれたビジュアルでは、この表示は以下の例のようになります。この例`quicksightdomain`の は、Amazon Quick Sight アカウントへのアクセスに使用する URL です。

  ```
  <!DOCTYPE html>
      <html>
      <body>
  
      <h2>Example.com - Employee Portal</h2>
      <h3>Current shipment stats</h3>
          <iframe
          width="600"
          height="400"
          src="https://quicksightdomain/sn/embed/share/accounts/111122223333/dashboards/DASHBOARDID/sheets/SHEETID>/visuals/VISUALID?directory_alias=account_directory_alias">
      </iframe>
  
      </body>
      </html>
  ```

例えば、ビジュアルもしくはダッシュボードを、内部的な Google サイトのページに埋め込みたいとしましょう。Google サイトのページを開いて、埋め込みウィジェットに埋め込みコードを貼り付けることができます。

ビジュアルかダッシュボードを、内部の Microsoft SharePoint サイトに埋め込みたい場合には、新しいページを作成してから、ウェブの埋め込み部分に埋め込みコードを貼り付けます。

# ワンクリック埋め込みコードを使用して匿名ユーザー向けに Amazon Quick Sight ビジュアルとダッシュボードを埋め込む
<a name="embedded-analytics-1-click-public"></a>


|  | 
| --- |
|  適用対象: Enterprise Edition  | 

Amazon Quick Sight でビジュアルまたはダッシュボードを共有するときに取得する埋め込みコードを使用して、パブリックサイトにビジュアルまたはダッシュボードを埋め込むことができます。Amazon Quick Sight コンソールを使用してパブリック共有を有効にし、インターネット上のすべてのユーザーに共有ビジュアルまたはダッシュボードへのアクセスを自動的に許可することもできます。

以下では、ビジュアルあるいはダッシュボードのパブリック共有を有効にし、それらを、インターネット上の全員が閲覧できるように埋め込む方法について説明します。どちらの場合も、ワンクリック埋め込みコードを使用してこれを行います。

## 開始する前に
<a name="embedded-analytics-1-click-prerequisites"></a>

作業を始める前に、以下を確認してください。
+ ポップアップと共有で使用する iframe との通信を許可するため、インターネットブラウザの設定に以下のいずれかが含まれている。
  + Mozilla Broadcast Channel API のネイティブサポート。詳細については、Mozilla ドキュメントで [Broadcast Channel API](https://developer.mozilla.org/en-US/docs/Web/API/Broadcast_Channel_API) を参照してください。
  + IndexedDB のサポート。
  + LocalStorage のサポート。
+ インターネットブラウザの「すべての cookie をブロック」設定がオフになっている。

## ステップ 1: ダッシュボードのパブリックアクセスを有効にする
<a name="embedded-analytics-1-click-step-1"></a>

インターネット上の全員が、埋め込みのビジュアルやダッシュボードにアクセスできるようにするには、まずダッシュボードのパブリックアクセスを有効にします。ビジュアルのアクセス許可はダッシュボードレベルで決定されます。埋め込みビジュアルに対するアクセス許可を付与するには、そのビジュアルが属するダッシュボードへのアクセスを許可します。詳しくは、「[インターネット上のすべてのユーザーに Amazon Quick Sight ダッシュボードへのアクセスを許可する](share-a-dashboard-grant-access-anyone.md)」を参照してください。

## ステップ 2: ビジュアルもしくはダッシュボードを埋め込むドメインを許可リストに入れる
<a name="embedded-analytics-1-click-step-2"></a>

ビジュアルとダッシュボードをパブリックアプリケーション、Wiki、またはポータルに埋め込むには、埋め込むドメインが Amazon Quick Sight アカウントの許可リストに含まれていることを確認します。

## ステップ 3: 埋め込みコードを取得する
<a name="embedded-analytics-1-click-step-3"></a>

以下の手順を使用して、ビジュアルもしくはダッシュボードの埋め込み用コードを取得します。

**ダッシュボードの埋め込み用コードを取得する**

1. Amazon Quick Sight で公開されたダッシュボードを開き、右上**の共有**を選択します。次に、**[Share dashboard]** (ダッシュボードの共有) をクリックします。

1. 開いた **[Share dashboard]** (ダッシュボードの共有) ページで、左上の **[Copy embed code]** (埋め込みコードをコピー) をクリックします。

   以下のような埋め込みコードがクリップボードにコピーされます。この例`quicksightdomain`の は、Amazon Quick Sight アカウントへのアクセスに使用する URL です。

   ```
   <iframe
           width="960"
           height="720"
           src="https://quicksightdomain/sn/
               embed/share/accounts/accountid/dashboards/dashboardid">
       </iframe>
   ```

**ビジュアルの埋め込み用コードを取得する**

1. Amazon Quick Sight で公開されたダッシュボードを開き、埋め込むビジュアルを選択します。次に、ビジュアルの右上隅にあるビジュアルのメニューを開き、**[Embed visual]** (埋め込みビジュアル) を選択します。

1. **[Embed visual]** (埋め込みビジュアル) ペインが開くので、**[Copy code]** (コードをコピー) を選択します。

   以下のような埋め込みコードがクリップボードにコピーされます。この例`quicksightdomain`の は、Amazon Quick Sight アカウントへのアクセスに使用する URL です。

   ```
   <iframe
           width="600"
           height="400"
           src="https://quicksightdomain/sn/embed/share/accounts/111122223333/dashboards/DASHBOARDID/sheets/SHEETID>/visuals/VISUALID">
       </iframe>
   ```

## ステップ 4: 埋め込みコードを HTML ページ、Wiki ページ、またはポータルに貼り付ける
<a name="embedded-analytics-1-click-step-4"></a>

以下の手順を使用して、埋め込みコードを HTML ページ、Wiki ページ、またはポータルに貼り付けます。

**埋め込みコードを貼り付けるには**
+ ビジュアルもしくはダッシュボードを埋め込む場所の HTML コードを開き、その中に埋め込みコードを貼り付けます。

  埋め込まれたダッシュボードでは、この表示は以下の例のようになります。この例`quicksightdomain`の は、Amazon Quick Sight アカウントへのアクセスに使用する URL です。

  ```
  <!DOCTYPE html>
      <html>
      <body>
  
      <h2>Example.com - Employee Portal</h2>
      <h3>Current shipment stats</h3>
          <iframe
          width="960"
          height="720"
          src="https://quicksightdomain/sn/
              embed/share/accounts/accountid/dashboards/dashboardid">
      </iframe>
  
      </body>
      </html>
  ```

  埋め込まれたビジュアルでは、この表示は以下の例のようになります。この例`quicksightdomain`の は、Amazon Quick Sight アカウントへのアクセスに使用する URL です。

  ```
  <!DOCTYPE html>
      <html>
      <body>
  
      <h2>Example.com - Employee Portal</h2>
      <h3>Current shipment stats</h3>
          <iframe
          width="600"
          height="400"
          src="https://quicksightdomain/sn/embed/share/accounts/111122223333/dashboards/DASHBOARDID/sheets/SHEETID>/visuals/VISUALID">
      </iframe>
  
      </body>
      </html>
  ```

一般向けのアプリケーションを Google サイト上に構築している場合は、Google サイトのページを開いて、埋め込みウィジェットを使用して埋め込みコードを貼り付けます。

Google サイトに埋め込むときは、Amazon Quick Sight の次のドメインが許可リストに含まれていることを確認してください。
+ `https://googleusercontent.com` (サブドメインをオンにします)
+ `https://www.gstatic.com`
+ `https://sites.google.com`

アプリケーションにビジュアルかダッシュボードを埋め込むと、そのアプリケーションにアクセスできるすべてのユーザーが、埋め込まれたビジュアルやダッシュボードにもアクセス可能になります。パブリックに共有されているダッシュボードを更新するには、「[パブリックに共有されているダッシュボードの更新](share-a-dashboard-grant-access-anyone-update.md)」を参照してください。パブリック共有をオフにするには、「[パブリック共有設定をオフにする](share-a-dashboard-grant-access-anyone-no-share.md)」を参照してください。

パブリック共有をオフにすると、パブリックアプリケーションに埋め込んだり、リンクで共有したりしたダッシュボードにインターネットからアクセスできなくなります。次回インターネットからそのようなダッシュボードを表示しようとすると、そのダッシュボードを表示するためのアクセス権がないというメッセージが表示されます。