ServiceUser

ServiceUserはServiceLoginでサインアップした製品の end-user、つまり会員アカウントです。Weegloo プラットフォームアカウント(コンテンツスタジオにログインする Weegloo User)とは別の identity であり、ServiceUserのトークンは ACMA/ACDA に対して認証されます。

ServiceUserは会員がServiceLoginで直接サインアップしたときに作成されます。そのため、この API には作成エンドポイントがなく、照会と管理者(Weegloo User)による一部の更新のみが提供されます。

リソース構造

以下はServiceUser1 件の単一照会レスポンスです。sys(システムプロパティ)とともに、会員の表示情報と権限設定を保持する本文プロパティ nickname・avatarUrl・roleOverride・enableLoginを持ちます。

{
  "sys": {
    "id": "3trmXRM3RqbgSnifyg7PSusr01Ex",
    "type": "ServiceUser",
    "space": { "sys": { "id": "HnQ32YiH", "type": "Refer", "targetType": "Space" } },
    "provider": "google",
    "email": "buyer@example.com",
    "createdAt": "2026-06-18T12:50:00.000Z",
    "updatedAt": "2026-06-18T12:50:00.000Z"
  },
  "nickname": "常連客",
  "avatarUrl": "https://lh3.example.com/a/buyer-avatar",
  "roleOverride": null,
  "enableLogin": true
}

主なキー:

  • sys.email: 会員がサインアップに使ったメールアドレスです。sys.providerとともに、どのアカウントでサインアップしたかを表します。
  • sys.provider: サインアップに使った OAuth プロバイダです(例: google)。
  • roleOverride: この会員にだけ別のServiceUserRoleを割り当てるときに入れる Referです。空の場合(null)はServiceLoginのデフォルトロールに従います。

システムプロパティ (sys)

すべてのServiceUserは共通のシステムプロパティを sysオブジェクトに保持します。spaceは Referの形({ "sys": { "id", "type": "Refer", "targetType" } })で入ります。

プロパティタイプ説明
idstringリソース固有の識別子。
typestringリソースの種類。ServiceUserは常に "ServiceUser"。
spaceRefer<Space>このServiceUserが属するSpace。
providerstringサインアップに使った OAuth プロバイダ (例: google)。
emailstringサインアップに使ったメールアドレス。
createdAtstring (date-time)サインアップ(作成)日時。
updatedAtstring (date-time)最終更新日時。

ServiceUserは会員が自身のサインアップで作成するリソースのため、他の CMA リソースと異なり sysに createdBy・updatedBy・versionがありません。versionがないため、更新(PUT・PATCH)でも X-Weegloo-Versionヘッダーを送りません。発行の概念もないため publish・archive・statusもありません。

本文プロパティ

プロパティタイプ説明
nicknamestring会員の表示名。
avatarUrlstringプロフィール画像のアドレス (任意)。
roleOverrideRefer<ServiceUserRole>この会員にだけ割り当てるServiceUserRole (任意)。指定するとServiceLoginのデフォルトロールより優先されます。
enableLoginbooleanログイン許可の可否。無効にするとこの会員のログインを禁止します。

会員管理

ServiceUserはサインアップで生成されます。管理者(Weegloo User)が更新(PUT・PATCH)で調整できるのは次の 2 つです。

  • roleOverrideの指定/解除: 特定の会員にだけ別のServiceUserRoleを割り当てます。有料プラン、モデレーター、ベータグループのように 1 人の会員だけを別扱いする場合に使います。指定した roleOverrideはServiceLoginの defaultRoleより優先されます。
  • enableLoginのトグル: 無効にするとその会員のログインを禁止します。

会員を名簿から外す作業はコンテンツスタジオで行います。手順と一緒に消えるものはサービス会員を管理するで扱います。

ある会員に他の会員が作成したリソースまで扱わせるには、その権限を持つServiceUserRoleを別途作成し、その会員の roleOverrideに指定します。会員が何にアクセスできるかは、その会員に適用されるServiceUserRoleが決めます。ルールの createdByフィルターを :selfにすると、そのアクションは自分が作成したものだけを対象とし、フィルターを付けなければ他の会員が作成したものまで対象とします。2 つのロールを分けて作る方法はServiceUserRoleで扱います。

API

以下のすべてのエンドポイントの基準 URL は https://cma.weegloo.com/v1であり、Authorizationヘッダーに CMA を認証する Bearer トークンが必要です。ServiceUserは versionを持たないリソースのため、更新(PUT・PATCH)でも X-Weegloo-Versionヘッダーを送りません。作成エンドポイントはありません(サインアップで作成)。

一覧照会を sys.emailで絞り込むときは、完全一致系の演算子だけを使います(eq・ne・in・nin)。会員のアドレスは暗号化して保存されるため、その表現の上では同じか違うかだけを判定でき、prefixや順序比較はエラーにならず 0 件を返します。アドレスで会員を探したのに結果が空であれば、まず演算子を確認してください。アドレスの一部で探す検索は、このフィルターでは代替できません。