> ## Documentation Index
> Fetch the complete documentation index at: https://help.dingtalk.io/llms.txt
> Use this file to discover all available pages before exploring further.

# FCM プッシュ通知の設定ガイド

> FCM を設定し、Firebase への登録と構成を通じて、海外の Android、iOS、Web デバイスで専用 DingTalk アプリのオフラインプッシュ通知を有効にします。

FCM（Firebase Cloud Messaging）は、Android、iOS、Web プラットフォームに対応するクロスプラットフォームのメッセージングソリューションです。GCM（Google Cloud Messaging）の拡張版にあたります。

専用アプリで海外デバイスのオフラインプッシュ通知を受信したい場合は、FCM を申請し、必要な素材を提供してください。

***

## FCM を申請する

<Steps>
  <Step title="(1) Google Developer アカウントを申請する" />

  <Step title="(2) Firebase に登録する">
    Firebase でプロジェクトを作成し、アプリを登録します。登録 URL：[https://console.firebase.google.com/](https://console.firebase.google.com/)

    プロジェクトを作成した後、Android のアイコンを選択して Android アプリを設定します。

    <Frame>
      <img src="https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/oJGq750ZzNR62lAK/img/c4aad5dd-2700-4c73-8ca9-12d7982b655e.png?x-oss-process=image/crop,x_0,y_0,w_2123,h_1256/ignore-error,1" alt="Firebase で Android アプリを設定する" />
    </Frame>

    <Note>
      ご注意ください：

      * **Android パッケージ名**：正しい専用 DingTalk のパッケージ名を入力します
      * **アプリのニックネーム（任意）**：専用 DingTalk のアプリ名を入力します
    </Note>

    <Frame>
      <img src="https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/oJGq750ZzNR62lAK/img/101a77fa-1f28-41e1-a02d-54c25993bd9e.png" alt="Android パッケージ名とアプリのニックネームを入力する" />
    </Frame>
  </Step>

  <Step title="(3) 設定ファイルをダウンロードし、DingTalk パッケージングプラットフォームにアップロードする">
    クリックして **google-services.json** をダウンロードします。ファイルを保存し、DingTalk テクニカルサポートに送信して設定してもらいます。

    <Frame>
      <img src="https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/oJGq750ZzNR62lAK/img/5e35c707-9ce5-476f-ab49-5edf39df96ee.png" alt="google-services.json をダウンロードする" />
    </Frame>
  </Step>

  <Step title="(4) コンソールにアクセスして追加パラメーターを設定する">
    最後のステップに進み、コンソールに移動します。

    <Frame>
      <img src="https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/oJGq750ZzNR62lAK/img/76639f3f-62a5-493a-8138-42f1fe8027d9.png" alt="コンソールに移動する" />
    </Frame>
  </Step>

  <Step title="(5) サービスアカウントキーを作成する">
    **Project settings > Service accounts > Generate new private key** に移動します（下図参照）。

    <Frame>
      <img src="https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/oJGq750ZzNR62lAK/img/df3d85fa-c5a6-49ba-bbe3-55eb86b80f42.png?x-oss-process=image/crop,x_0,y_0,w_2123,h_1256/ignore-error,1" alt="Project settings、Service accounts、Generate new private key" />
    </Frame>

    <div style={{display: 'flex', gap: '12px', justifyContent: 'center', flexWrap: 'wrap', margin: '16px 0'}}>
      <img src="https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/oJGq750ZzNR62lAK/img/03d425ad-ee49-44ef-a16e-a37cbd4ea8f3.png" alt="秘密鍵の生成ダイアログ" style={{width: '48%', minWidth: '280px', borderRadius: '8px', boxShadow: '0 2px 12px rgba(0,0,0,0.08)', margin: 0}} />

      <img src="https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/oJGq750ZzNR62lAK/img/2479da7f-c331-4f51-826e-243b7c261aa2.png" alt="秘密鍵の生成を確認する" style={{width: '48%', minWidth: '280px', borderRadius: '8px', boxShadow: '0 2px 12px rgba(0,0,0,0.08)', margin: 0}} />
    </div>

    **Generate key** をクリックすると、JSON ファイルが自動的に生成されます。ファイルを保存し、DingTalk テクニカルサポートに送信します。

    <Frame>
      <img src="https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/LAJdl6zMMMDQlke1/img/adb6ae9a-4fa7-4764-87af-5dd4afd82d38.png" alt="生成されたサービスアカウントキーの JSON ファイル" />
    </Frame>
  </Step>

  <Step title="(6) Realtime Database を作成する">
    **Create Database** をクリックします。

    <Frame>
      <img src="https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/oJGq750ZzNR62lAK/img/ab8c9db6-2bad-4c34-9358-a9b65051a3d1.png" alt="Create Database" />
    </Frame>

    <div style={{display: 'flex', gap: '12px', justifyContent: 'center', flexWrap: 'wrap', margin: '16px 0'}}>
      <img src="https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/oJGq750ZzNR62lAK/img/a5fa837c-2683-4850-aa0a-0ad7625cac12.png" alt="Realtime Database のセットアップステップ" style={{width: '48%', minWidth: '280px', borderRadius: '8px', boxShadow: '0 2px 12px rgba(0,0,0,0.08)', margin: 0}} />

      <img src="https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/oJGq750ZzNR62lAK/img/003a8cd3-04c4-4ab8-b7a0-6290a50a54e0.png" alt="Realtime Database のルール設定ステップ" style={{width: '48%', minWidth: '280px', borderRadius: '8px', boxShadow: '0 2px 12px rgba(0,0,0,0.08)', margin: 0}} />
    </div>

    **Enable** をクリックし、データベースの URL をコピーしてパッケージング素材とします。

    <Frame>
      <img src="https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/oJGq750ZzNR62lAK/img/f417ba2c-bb63-47a4-a099-f78d598bf473.png" alt="データベースの URL をコピーする" />
    </Frame>
  </Step>

  <Step title="(7) 上記の素材を DingTalk に提供して設定してもらう">
    <Check>
      * google-services.json
      * サービスアカウントキーの JSON ファイル
      * Realtime Database の URL
    </Check>
  </Step>

  <Step title="(8) Firebase コンソールで FCM をテストする（任意）">
    <Note>
      **注意：このステップは任意です。**
    </Note>

    FCM を検証するには、Google プッシュサービスに対応したデバイス（Pixel デバイス推奨）を用意する必要があります。Firebase コンソールに移動し、**Messaging** を選択します。

    <Frame>
      <img src="https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/oJGq750ZzNR62lAK/img/3ab137e0-1067-4a11-a519-c10fc121a042.png" alt="Firebase コンソールで Messaging を選択する" />
    </Frame>

    画面の指示に従って順番にテスト通知を送信します。**重要：本番公開前にのみテストしてください。サービス障害を防ぐため、全ユーザーへの送信は避けてください。**

    <Frame>
      <img src="https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/oJGq750ZzNR62lAK/img/9327cdf4-d064-4acb-a47d-f42cf13af335.png" alt="テスト通知を送信する" />
    </Frame>

    送信後、デバイスがテスト通知を受信すれば、FCM の設定が成功したことを示します。

    <Frame>
      <img src="https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/LAJdl6zMMMDQlke1/img/fb12f2da-5680-4df3-a285-e394f73f979a.png?x-oss-process=image/crop,x_0,y_305,w_760,h_291/ignore-error,1" alt="デバイスがテスト通知を受信する" />
    </Frame>
  </Step>
</Steps>