開発者ガイド:パートナーとして参加し、アプリを作成し、サンドボックスでテストして認証に提出する
招待された開発パートナー向け:招待を受け取り、アプリとバージョンを作成し、専用サンドボックスでセルフテストし、認証に提出し、差し戻しを修正し、メンバーとアカウントを管理します。
ステップ1:招待を受け取る#
開発者アクセスは招待制です。プラットフォームチームから招待されると、受け取りリンク付きのメールが届きます(リンクは7日間有効)。リンクを開き、招待が送られたのと同じメールアドレスでログインして確認すると、開発者アカウントが有効になり、開発者センターに入ります。別のメールアドレスでログインすると受け取りは拒否され、招待は消費されません。ログアウトして招待されたアドレスでログインし直してください。リンクの期限が切れた場合は、チームに再送を依頼してください。
ステップ2:アプリと最初のバージョンを作成する#
開発者センターで「新しいアプリ」を選び、コードと表示名を付けます。次にアプリを開いてバージョンを追加します。バージョン番号を入力し、そのバージョンが必要とするものを宣言します——要求するデータ権限(スコープ)、埋め込みを許可するウェブ出所、テナントメニュー内でのページの表示位置、持ち込む既成コンテンツパックです。宣言を編集できるのは、バージョンが下書きのとき、または修正のため差し戻されたときだけです。その後はロックされ、変更には新しいバージョンが必要です。見られるのは自分の開発者アカウント配下のアプリだけです。他のパートナーのアプリを見ることも開くこともできません。
ステップ3:まずサンドボックスでテストする#
「サンドボックス」ページを開いてサンドボックスを開通します。開発者アカウントごとに専用のテスト組織が1つあり、実際のテナントとは完全に分離されています。サンドボックス内では、認証前でも自分のアプリをインストールでき、サンドボックス用認証情報を発行し、それを使って公開APIを呼び、連携をエンドツーエンドで確認できます。提出前にサンドボックスページでセルフテストを実行してください。認証ゲートが実行するのと同じ自動チェック(接続、組織をまたぐ拒否、イベント署名の検証)が走り、結果が記録に残るので、問題を早めに直せます。サンドボックスをリセットすると中身はすべて消えて空から始まりますが、セルフテスト履歴は保持されます。サンドボックス用認証情報は自分のサンドボックス内でのみ有効で、実際のテナントのデータには決して届きません。
ステップ4:認証に提出する#
バージョンを開いて「提出」を選びます。まず自動チェックが実行されます。実行には、自アプリがサンドボックスにインストール済みで、イベント購読が作成済みである必要があります(セルフテストの準備と同じ)。自動チェックがまだ実行できない場合、提出は止められ、何が不足しているかがメッセージで示されます。静かに承認されることは決してありません。自動部分が通った後は、プラットフォームのレビューチームがリストの残りの項目を処理します。進捗はバージョンページでいつでも確認できます。各項目に結果が表示され、差し戻された項目にはレビュアーの理由が分かりやすい言葉で示されます(レビューの内部詳細が見えることはありません)。
ステップ5:バージョンが差し戻されたとき#
バージョンの差し戻し(「修正依頼」)はアプリの却下ではありません。具体的な項目に手直しが必要という意味です。各項目の理由を読み、連携を修正し、必要ならバージョンの宣言を編集します(差し戻されたバージョンは再び編集可能になります)。サンドボックスのセルフテストをもう一度実行し、同じバージョンページから再提出してください。すべての項目が通ると、バージョンは12か月間認証されます。認証後は、同じバージョンページから自分で公開できます。特定のテナントだけに公開したい場合は、バージョンのリスト(allowlist)欄に組織リストを入力して保存してください。その組織だけがバージョンを見てインストールでき、リストはいつでも更新できます。全体公開はプラットフォームチームが開放します。
メンバーとアカウント情報#
「メンバー」ページでは、アカウント所有者がメールでチームメイトを招待したり、既存ユーザーを直接追加したり、メンバーを削除したりできます。招待された人はステップ1と同じ方法で受け取ります。メンバーはアカウント配下のアプリで作業できますが、メンバー管理は所有者のみ可能です。「アカウント」ページでは開発者アカウントの詳細を確認できます。所有者はアカウント名と連絡先メールを更新できます。ステータスなどプラットフォームが管理する項目は読み取り専用で表示されます。プラットフォームチームに開発者アカウントを停止された場合、再有効化されるまでアプリの新規インストールも提出もできません。その場合はチームへ連絡してください。インストール済みのアプリは既存の状態を保ち、プラットフォームチームが扱います。
評価とフィードバックを見る#
開発者センターのアプリページでは、アプリをインストールした組織からの評価を確認できます。実際の平均、評価の件数、星ごとの内訳です。これらは実際の合計で、あなただけが見られます。公開カタログにスコアが表示されるのは、アプリに少なくとも3件の評価が集まってからです。それまでは「まだ評価が不足しています」と表示されます。あなたのページにサンプルがまだ少ないと出る場合、それがカタログにスコアが出ない理由です。
組織は星と一緒に短い非公開メモを残すこともできます。メモと星は見られますが、どの組織からかは決して分かりません。フィードバックは意図的に匿名です。評価が実在の顧客ではなく偽のインストールから来たと思う場合は、通常のサポート通道からプラットフォームチームへ連絡し、どのアプリか、いつ頃の評価かを伝えてください。チームはインストール記録を確認し、カウントすべきでない評価を非表示にできます。プラットフォームが星を変更することは決してありません。確認で問題がなければ、非表示の評価は復元できます。