ServiceUser

最終更新: 2026年7月3日

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

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

リソース構造

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

{
  "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,
  "isAdmin": false
}

主なキー:

  • sys.email: 会員がサインアップに使ったメールアドレスです。sys.providerとともに、どのアカウントでサインアップしたかを表します。
  • sys.provider: サインアップに使った OAuth プロバイダです(例: google)。
  • roleOverride: この会員にだけ別のServiceUserRoleを割り当てるときに入れる Referです。空の場合(null)はServiceLoginのデフォルトロールに従います。
  • isAdmin: 有効にすると、この会員が他の会員の作成したリソースを削除できるようになります。狭い権限であり、他の会員のリソースに対する更新・読み取り権限は付与しません。

システムプロパティ (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ログイン許可の可否。無効にするとこの会員のログインを禁止します。
isAdminboolean有効にすると他の会員が作成したリソースを削除できます。狭い権限であり、他の会員のリソースに対する更新・読み取り権限は付与しません。

会員管理

ServiceUserはサインアップで生成されるため作成エンドポイントがなく、削除エンドポイントもありません。管理者(Weegloo User)が更新(PUT・PATCH)で調整できるのは次の 3 つです。

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

isAdminは他の会員のリソースに対する削除のみを追加する狭いフラグです。他の会員のリソースに対する更新・読み取り権限は付与せず、この会員を Weegloo コンテンツスタジオ管理者(CMA 管理者)へ昇格させることもありません。また、会員が持つServiceUserRoleがそもそも許可していない操作まで開放することはありません。

API

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

  • ServiceUserRole: roleOverrideに割り当てる権限のまとまり。
  • ServiceLogin: 会員のサインアップ・デフォルトロール(defaultRole)設定。
  • ACMA/ACDA 概要: ServiceUserが呼び出す API。