Skip to main content
Un workspace condivide app con altri utenti di Square Cloud, ciascuno con un ruolo. c.Workspaces gestisce i workspace, c.Workspaces.Members i loro membri e c.Workspaces.Apps le app condivise. La creazione di workspace richiede un piano Standard, Pro o Enterprise. Ogni snippet qui sotto funziona da solo all’interno di questo programma: incollane uno alla volta in main ed esegui goimports (vedi Eseguire gli esempi).

Workspace

Workspaces.List(ctx) restituisce ogni workspace di cui sei proprietario o membro, con gli stessi campi:
Per uscire da un workspace come membro, o eliminarlo come proprietario:
Il proprietario non può uscire (400 CANNOT_LEAVE_OWNER): elimina invece il workspace.

Membri

Per aggiungere un membro serve un codice di invito che il membro genera con Members.InviteCode(ctx). Il codice è valido per 5 minuti.
Per cambiare il ruolo di un membro o rimuoverlo, passa il suo ID ottenuto da Workspaces.Get:
Ruoli (WorkspaceGroup): GroupView (view), GroupManager (manager), GroupMaintain (maintain) e GroupAdmin (admin). Il Group di un membro è una semplice string, poiché può essere anche "owner". Chiamare un metodo che il tuo ruolo non consente produce 403 PERMISSION_DENIED.

Applicazioni condivise

Un workspace può contenere fino a 100 app (400 APPLICATIONS_LIMIT_REACHED).

Agire su un’app condivisa

Per agire su un’app condivisa con te, passa l’id composto <appId>-<workspaceId> a qualsiasi metodo di c.Apps. Workspaces.Get e Workspaces.List restituiscono gli id grezzi, quindi costruiscilo tu:

Errori

Le route dei workspace diverse da Get inviano gli id nel body della richiesta, quindi un id vuoto lì produce 400 INVALID_ID dal server (non un errore locale). Get invia l’id nel percorso, quindi un id vuoto fallisce localmente con INVALID_ID (status 0).

Prossimi passi

AI

Chat completion tramite l’AI Gateway.

Riferimento API dei workspace

Gli endpoint REST dietro questi metodi.

Workspace dalla CLI

Le stesse azioni dal terminale.