Ferramentas de visibilidade do website
Veja ou altere quem pode aceder ao website através do Connector.
Nesta página
Veja ou altere quem pode ver o website. Os websites privados exigem início de sessão na TEISENDA.
Nota
A ligação aplica-se ao Space. Pertence a ele e o Space não está bloqueado. Um Space é uma área de trabalho partilhada na app.
hosting_get_visibility pode ser chamado com qualquer função, incluindo Apenas leitura. Para hosting_set_visibility, precisa de Proprietário, Administrador ou Utilizador.
hosting_get_visibility Get visibility
apenas lê
Mostra a visibilidade e o público. Para pessoas ou equipas selecionadas, só indica a quantidade, não os nomes.
| Parâmetro | Tipo | Indicação | Descrição |
|---|---|---|---|
space | Número inteiro | obrigatório | A Space-ID de dez dígitos. |
project | Número inteiro | obrigatório | O número do projeto indicado por hosting_list_projects. |
hosting_set_visibility Set visibility
altera dadoselimina, substitui ou altera o que é visíveldois passos
Torna um projeto público ou privado. Um website privado exige início de sessão na TEISENDA; audience indica quem pode vê-lo depois.
Atenção
A mudança de privado para público exige duas chamadas: a primeira, sem confirm, indica a frase de confirmação; a segunda, com essa frase, torna o website público.
A aplicação só deve enviar a frase depois do seu consentimento; consulte Três ferramentas exigem uma frase de confirmação. Tornar um projeto privado ou alterar quem pode ver um website privado só exige uma chamada.
audience tem três níveis. Cada um só se aplica a pessoas que pertencem atualmente ao Space.
owner: só a conta que criou o projeto vê o website. Isto não depende da função Proprietário no Space e nenhuma ferramenta altera qual é essa conta. Se saiu do Space, ninguém pode abrir o website até escolher outro nível.selected: as pessoas e equipas selecionadas na TEISENDA veem o website, além da conta que criou o projeto. Nenhuma ferramenta as seleciona; faça-o na TEISENDA em Escolher a visibilidade do website.space: todos os membros do Space veem o website.
| Parâmetro | Tipo | Indicação | Descrição |
|---|---|---|---|
space | Número inteiro | obrigatório | A Space-ID de dez dígitos. |
project | Número inteiro | obrigatório | O número do projeto indicado por hosting_list_projects. |
visibility | Texto, um dos valores public, private | obrigatório | public torna o projeto público e private torna-o privado. |
audience | Texto, um dos valores owner, selected, space | opcional | Quem pode ver um website privado: owner, selected ou space. Se o valor faltar com private, mantém-se a definição do projeto; um novo projeto tem owner. Com public, não produz efeitos: se a chamada incluir um valor, a TEISENDA guarda-o e aplica-se novamente quando o projeto voltar a ser privado. |
confirm | Texto | opcional | A aplicação deve omiti-lo na primeira chamada; a resposta indica então uma frase de confirmação. Só deve enviar essa mesma frase depois do seu consentimento. Só é necessário numa chamada que torne público um projeto ainda não público. |
Se algo não funcionar
Quando uma solução indicar uma ferramenta, peça à aplicação que a chame.
O argumento … está em falta ou não tem a forma esperada.
Em hosting_set_visibility, visibility é diferente de public ou private, ou audience é diferente de owner, selected ou space; a mensagem indica o argumento. Chame novamente a ferramenta com public ou private e, para private, com um de owner, selected ou space.
As mensagens sobre o Space e o número de projeto estão nas ferramentas de Spaces e projetos. Todas as restantes que podem aparecer em qualquer ferramenta estão em Resolver problemas do Connector.