Professional Services（制限付き）ロール

このロールはServices API v1（ベースパス/service/v1/）を制御します。AmazonのServices API v1ユースケースガイドによると、これはすべての操作において唯一必須となるロールであり、北米（NA）、欧州（EU）、および極東（FE）リージョンの販売事業者（Sellers）のみが利用可能です。

Amazonのロールに関するドキュメントでは、このロールに明示的に含まれる操作として2つ挙げられています。getServiceJobs（「指定されたフィルタークエリに基づき、サービスジョブの詳細リストを返す」）およびaddAppointmentForServiceJobByServiceJobId（「指定されたサービスジョブIDに対応するサービスジョブにアポイントメントを追加する」）です。ただし、このロールはこれら2つの操作だけでなく、Services API v1の全操作セットを制限対象としています。

「制限付き（Restricted）」という分類はAmazon自身によるもので、「個人を特定できる情報（PII）など機密性の高い情報を必要とする」ことを意味します。「制限付きロール」を使用するには、「データの使用方法およびセキュリティ管理について追加情報を提供する必要がある」ことになります。これが実際にはAmazonが評価対象とする書類です。

ステージ1：サービスジョブデータの取得。 getServiceJobs はフィルタークエリ（marketplaceIds は必須）により、販売者が対応すべきジョブの一覧を返します。getServiceJobByServiceJobId はIDで単一のジョブを取得します。Amazon はこれらについて、「サービスプロバイダーが自身のサービス注文を取得および変更できるようにする」ものであると説明しています。

ステージ2：予約の設定とリソースの割り当て。 addAppointmentForServiceJobByServiceJobId は予約を登録し、rescheduleAppointmentForServiceJobByServiceJobId は予約を変更し、assignAppointmentResources はその時間枠に技術者を割り当てます。

ステージ3：サービスジョブの完了処理。 setAppointmentFulfillmentData は履行情報を記録し、createServiceDocumentUploadDestination は履行証明書類などのアップロード先を作成し、completeServiceJobByServiceJobId および cancelServiceJobByServiceJobId はジョブを完了またはキャンセルします。

ステージ4：容量とスケジュール管理。 updateSchedule、createReservation、updateReservation、cancelReservation は作業員の空き状況を設定します。getAppointmentSlots、getAppointmentSlotsByJobId、getRangeSlotCapacity、getFixedSlotCapacity は利用可能な容量を読み取ります。Amazon の機能概要では、ジョブ詳細へのアクセス、予約の確定または再スケジュール、リソース割り当ておよび履行データの設定、予約可能枠を決定する容量スケジュールの設定、そしてルートおよび履行計画のためのサービスデータ統合が含まれるとされています。

コアとなる serviceJobStatus 列挙型には7つの値があります：NOT_SERVICED、CANCELLED、COMPLETED、PENDING_SCHEDULE、NOT_FULFILLABLE、HOLD、および PAYMENT_DECLINED。getServiceJobs では、serviceOrderIds、productOrderIds、trackingIds、スケジュール日付、ASIN、必要なスキル、ストアIDでもフィルタリングできます。

buyer：購入者の氏名、電話番号、およびisPrimeMember。

serviceLocation → address：購入者の自宅／サービス先の完全な住所と電話番号：addressLine1、addressLine2、addressLine3、city、county、district、stateOrRegion、postalCode、countryCode、phone、およびname。

appointmentTime：startTimeおよびdurationInMinutes：技術者がその住所を訪問する日時。

scopeOfWork（asin、title、quantity、requiredSkills）およびassociatedItems（asin、title、quantity、orderId、itemStatus、brandName、itemDelivery）、さらにassignedTechnicians（technicianId、name）。

Amazonが制限する理由。 購入者の氏名＋完全な住所＋電話番号＋予約された訪問時刻という情報は、特定の瞬間に個人を物理的に特定できるのに十分です。Amazonの役割定義は明確で、「制限付きロールは、個人を特定可能な情報（PII）を含む可能性のある機密情報を必要とします。」としています。

Restricted Data Token（RDT）。 このペイロードにはPIIが含まれるため、制限付きServices APIの操作にはTokens API（createRestrictedDataToken）によって発行されたRestricted Data Tokenが必要です。このRDTは、通常のアクセストークンに代わって制限付きAPI呼び出し時に使用され、その後PIIフィールドが返されます。

一貫性のあるアプリケーション回答。 すべてのアンケートおよび自由記述形式のセキュリティに関する回答を通じて、一つのストーリーを伝えます：そのロールが必要な理由、使用するPIIフィールド、およびそれらをどのように保護するか。

ロールごとの正当性説明。 ロールが返す購入者氏名、電話番号、サービス住所、予約時間について、明確な目的、法的根拠、および保持期間を示します。これらはサービス提供に必要な範囲内に限定され、それ以上の用途はありません。

公開可能なデータ取扱いおよびプライバシーポリシー。 Amazonがプライベートアプリに対して確認する2つの要件のうちの1つです：収集、処理、保存、利用、共有、廃棄をカバーした実際のポリシーページが必要です。

実装チェックリスト。 すべてのコントロールを平易な言葉で記載しています。具体的には、PIIはサービス提供完了後30日を超えて保持せず、その後安全に削除すること、通信中はTLS 1.2以上、保存時はAES-128以上を使用すること、最小権限アクセスとMFAの導入、PIIを含まないログを12か月以上保持すること、24時間以内の通知を含むインシデント対応手順書、および認証はAmazonのOAuth（Login with Amazon）のみを使用することです。

私たちはマーケットプレイス・コンプライアンス専門ファームであり、開発エージェンシーではありません。お客様のコード、サーバー、Amazonアカウントを必要としません。私たちはファイルを作成し、お客様のIT責任者がお客様のインフラ上でこのチェックリストを実装します。