Skip to main content
workspace は、他の Square Cloud ユーザーとそれぞれのロールでアプリを共有する仕組みです。c.Workspaces は workspace を、c.Workspaces.Members はそのメンバーを、c.Workspaces.Apps は共有アプリを管理します。 workspace を作成するには Standard、Pro、または Enterprise プランが必要です。 以下の各スニペットは、このプログラムの中で単独で動作します。1 つずつ main に貼り付けて goimports を実行してください (サンプルの実行を参照)。

Workspace

Workspaces.List(ctx) は、自分が所有または参加しているすべての workspace を同じフィールドで返します:
メンバーとして workspace から退出する、または所有者として workspace を削除するには:
所有者は退出できません (400 CANNOT_LEAVE_OWNER)。代わりに workspace を削除してください。

メンバー

メンバーを追加するには、そのメンバーが Members.InviteCode(ctx) で生成した招待コードが必要です。コードの有効期間は 5 分間です。
メンバーのロールを変更する、またはメンバーを削除するには、Workspaces.Get で取得したその ID を渡します:
ロール (WorkspaceGroup): GroupView (view)、GroupManager (manager)、GroupMaintain (maintain)、GroupAdmin (admin)。メンバーの Group は "owner" になることもあるため、通常の string です。自分のロールで許可されていないメソッドを呼び出すと、403 PERMISSION_DENIED になります。

共有アプリケーション

1 つの workspace には最大 100 個のアプリを追加できます (400 APPLICATIONS_LIMIT_REACHED)。

共有アプリの操作

自分と共有されたアプリを操作するには、任意の c.Apps メソッドに複合 ID <appId>-<workspaceId> を渡します。Workspaces.Get と Workspaces.List は素の ID を返すので、複合 ID は自分で組み立てます:

エラー

Get 以外の workspace のルートは ID をリクエストボディで送信するため、そこでの空の ID はサーバーから返される 400 INVALID_ID になります (ローカルのエラーではありません)。Get は ID をパスで送信するため、空の ID はローカルで INVALID_ID (ステータス 0) として失敗します。

次のステップ

AI

AI Gateway を通じたチャット補完。

Workspace API リファレンス

これらのメソッドが呼び出す REST endpoint。

CLI で workspace を操作

同じ操作をターミナルから行います。