REVIEWITDocumentação
Esta página é gerada a partir de Catalogue publié — Asana — não se corrige à mão.Corrigir o contrato corrige a página. Modificá-la aqui perder-se-ia na próxima geração.GERADA EM 18 outubro 2026 · catalogue v23 · 2fe6febf
Referência geradaAtualizada · gerada em 18 outubro 2026

Contratos de coleta — Asana

Tradução automática, ainda não revistaEsta página foi traduzida por um modelo a partir da versão francesa, que faz fé. Ler a versão francesa.

01Como ler esta página #sec_bba4e109

Cada recurso que o REVIEWIT pode coletar para o Asana tem um contrato publicado. Ele é lido como uma referência de API: o que o REVIEWIT chama no serviço coletado e por qual meio, o que o contrato exige para que a coleta seja executada e os dados que o REVIEWIT mantém. O REVIEWIT apenas realiza leituras.

  • Chamadas: as requisições que o REVIEWIT faz ao serviço coletado, todas em leitura.
  • Exigências: cada uma deve ser satisfeita. Sua natureza indica o que ela solicita: um direito a conceder ao identificador, uma condição de administração (uma configuração ou atribuição no fornecedor que o token não possui, constatada por uma chamada real em leitura) ou a pertença do identificador à organização Asana da conexão. A regra indica quantas opções são necessárias: « obrigatória » para a única opção, « uma à escolha » quando uma única basta (elas são ordenadas da mais estreita à mais ampla: prefira a primeira), « todas » ou « N à escolha entre M ».
  • Condições de funcionamento: o que o REVIEWIT constata antes de cada coleta, além das exigências.
  • Frescura: a idade máxima das verificações nas quais o veredicto se baseia, definida por cada contrato (aqui: verificações de menos de 24 h; os direitos devem ser constatados por uma chamada real). O REVIEWIT refaz automaticamente dentro desse prazo as verificações que ele sabe fazer (token obtido, serviço que responde); « Verificar os direitos », no menu da conexão, os refaz sob demanda. Enquanto a chamada real não for feita, os direitos permanecem não constatados.
  • Dados mantidos: os campos que o REVIEWIT mantém de cada objeto; o papel indica o que a revisão faz com eles.

O veredicto de cada recurso, para sua conexão, é lido em sua ficha. Um recurso que a conexão não coleta pode sempre ser alimentado pela importação de um relatório (« Importar um relatório »).

02Como o REVIEWIT verifica as exigências #sec_4b0123b7

O token Asana não possui seus direitos: o contrato exige que eles sejam constatados por uma chamada real, em leitura. O REVIEWIT ainda não faz essa chamada para o Asana: ele constata que o token é obtido e que o serviço responde, mas não os direitos listados aqui. Os recursos são exibidos como « Não verificado »; eles podem sempre ser alimentados pela importação de um relatório (« Importar um relatório »).

03As vias de chamada #sec_cf8230c1

Uma via indica qual token o REVIEWIT obtém para o identificador: quem o emite e para qual audiência. Os endereços chamados aparecem nas chamadas de cada recurso; um caminho que começa com « / » é chamado na audiência do token de sua via.

ViaToken emitido porAudiência do tokenAutenticação do identificador
asana.api.reviewit.service-accounthttps://app.asana.comhttps://app.asana.com/api/1.0conta de serviço

04Directory · Guests #sec_b8689674

asana.directory.guests:collect · revisão 2 do contrato, publicada em 18 de outubro de 2026 · via asana.api.reviewit.service-account

Colaboradores externos admitidos na organização

Chamadas

  • GET /workspaces/{gid}/workspace_memberships (is_guest)

Exigências

NaturezaRegraOpções
Condição de administraçãoobrigatóriaa conta de serviço Asana é criada por um super-administrador da organização (Asana Enterprise); seu token dá acesso completo em leitura, constatado por chamada
Pertençaobrigatóriao identificador pertence à organização Asana da conexão

Condições de funcionamento

  • um token é obtido para o identificador
  • o serviço https://app.asana.com/api/1.0 responde

Frescura: verificações de menos de 24 h; os direitos devem ser constatados por uma chamada real.

Dados mantidos

CampoPapelTipoObrigatório
Gidchave do objetotextosim
Nameexibido para reconhecer o objetotextosim
Emailexibido para reconhecer o objetotextonão
IsActivecontexto, sem efeito sobre a revisãobooleanonão
Teamscontexto, sem efeito sobre a revisãotextonão
Projectscontexto, sem efeito sobre a revisãotextonão

05Directory · Utilisateurs #sec_1061454b

asana.directory.users:collect · révision 2 du contrat, publiée le 18 octobre 2026 · voie asana.api.reviewit.service-account

Comptes de l'organisation et leur état d'activité

Appels

  • GET /workspaces/{gid}/users
  • GET /workspaces/{gid}/workspace_memberships
  • GET /users/{user_gid}/teams?organization={gid} (champ Teams)

Exigences

NatureRègleOptions
Condition d'administrationrequisele compte de service Asana est créé par un super-administrateur de l'organisation (Asana Enterprise) ; son jeton donne l'accès complet en lecture, constaté par appel
Appartenancerequisel'identifiant appartient à l'organisation Asana de la connexion

Conditions de fonctionnement

  • un jeton est obtenu pour l'identifiant
  • le service https://app.asana.com/api/1.0 répond

Fraîcheur : vérifications de moins de 24 h ; les droits doivent être constatés par un appel réel.

Données conservées

ChampRôleTypeObligatoire
Gidclé de l'objettexteoui
Nameaffiché pour reconnaître l'objettexteoui
Emailaffiché pour reconnaître l'objettextenon
IsActivecontexte, sans effet sur la revuebooléennon
IsAdmincontexte, sans effet sur la revuebooléennon
IsGuestcontexte, sans effet sur la revuebooléennon
Teamscontexte, sans effet sur la revuetextenon

06Portfolios · Membres du portfolio #sec_bdfc2222

asana.portfolios.memberships:collect · révision 2 du contrat, publiée le 18 octobre 2026 · voie asana.api.reviewit.service-account

Membres d'un portefeuille et leur niveau d'accès. Clé de ligne : PortfolioGid | UserGid.

Appels

  • GET /portfolios/{gid}/portfolio_memberships

Exigences

NatureRègleOptions
Condition d'administrationrequisele compte de service Asana est créé par un super-administrateur de l'organisation (Asana Enterprise) ; son jeton donne l'accès complet en lecture, constaté par appel
Appartenancerequisel'identifiant appartient à l'organisation Asana de la connexion

Conditions de fonctionnement

  • un jeton est obtenu pour l'identifiant
  • le service https://app.asana.com/api/1.0 répond

Fraîcheur : vérifications de moins de 24 h ; les droits doivent être constatés par un appel réel.

Données conservées

ChampRôleTypeObligatoire
MembershipKeyclé de l'objettexteoui
PortfolioGidcontexte, sans effet sur la revuetexteoui
PortfolioNamecontexte, sans effet sur la revuetextenon
UserGidcontexte, sans effet sur la revuetexteoui
UserNamecontexte, sans effet sur la revuetextenon
Emailaffiché pour reconnaître l'objettexteoui
AccessLevelcontexte, sans effet sur la revuetextenon

07Portfolios #sec_c80b6d56

asana.portfolios.portfolios:collect · révision 2 du contrat, publiée le 18 octobre 2026 · voie asana.api.reviewit.service-account

Portefeuilles, leur propriétaire, leurs membres et le nombre de projets qu'ils regroupent

Appels

  • GET /portfolios?workspace={gid}
  • GET /portfolios/{gid}/items

Exigences

NatureRègleOptions
Condition d'administrationrequisele compte de service Asana est créé par un super-administrateur de l'organisation (Asana Enterprise) ; son jeton donne l'accès complet en lecture, constaté par appel
Appartenancerequisel'identifiant appartient à l'organisation Asana de la connexion

Conditions de fonctionnement

  • un jeton est obtenu pour l'identifiant
  • le service https://app.asana.com/api/1.0 répond

Fraîcheur : vérifications de moins de 24 h ; les droits doivent être constatés par un appel réel.

Données conservées

ChampRôleTypeObligatoire
Gidclé de l'objettexteoui
Nameaffiché pour reconnaître l'objettexteoui
Owneraccès soumis à la revueliste d'identitésnon
Publicévalué par les politiques REVIEWIT (visibilité)booléennon
Createdcontexte, sans effet sur la revuedate et heurenon
Membersaccès soumis à la revueliste d'identitésnon
ProjectCountcontexte, sans effet sur la revueentiernon

08Rôles privilégiés · Administrateurs #sec_901c7249

asana.privileged-roles.admins:collect · révision 2 du contrat, publiée le 18 octobre 2026 · voie asana.api.reviewit.service-account

Administrateurs de l'organisation

Appels

  • GET /workspaces/{gid}/workspace_memberships (is_admin)

Exigences

NatureRègleOptions
Condition d'administrationrequisele compte de service Asana est créé par un super-administrateur de l'organisation (Asana Enterprise) ; son jeton donne l'accès complet en lecture, constaté par appel
Appartenancerequisel'identifiant appartient à l'organisation Asana de la connexion

Conditions de fonctionnement

  • un jeton est obtenu pour l'identifiant
  • le service https://app.asana.com/api/1.0 répond

Fraîcheur : vérifications de moins de 24 h ; les droits doivent être constatés par un appel réel.

Données conservées

ChampRôleTypeObligatoire
Gidclé de l'objettexteoui
Nameaffiché pour reconnaître l'objettexteoui
Emailaffiché pour reconnaître l'objettextenon
AdminScopecontexte, sans effet sur la revuetextenon
IsActivecontexte, sans effet sur la revuebooléennon

09Projetos · Membros do projeto #sec_f9f5d31c

asana.projects.memberships:collect · revisão 2 do contrato, publicada em 18 de outubro de 2026 · via asana.api.reviewit.service-account

Membros de um projeto e seu nível de acesso. Chave de linha: ProjectGid | UserGid.

Chamadas

  • GET /projects/{gid}/project_memberships

Requisitos

NaturezaRegraOpções
Condição de administraçãoobrigatóriaa conta de serviço Asana é criada por um super-administrador da organização (Asana Enterprise); seu token concede acesso completo de leitura, verificado por chamada
Afiliaçãoobrigatóriao identificador pertence à organização Asana da conexão

Condições de funcionamento

  • um token é obtido para o identificador
  • o serviço https://app.asana.com/api/1.0 responde

Frescura: verificações em menos de 24 h; os direitos devem ser verificados por uma chamada real.

Dados mantidos

CampoFunçãoTipoObrigatório
MembershipKeychave do objetotextosim
ProjectGidcontexto, sem efeito na revisãotextosim
ProjectNamecontexto, sem efeito na revisãotextonão
UserGidcontexto, sem efeito na revisãotextosim
UserNamecontexto, sem efeito na revisãotextonão
Emailexibido para reconhecer o objetotextosim
AccessLevelcontexto, sem efeito na revisãotextonão
IsGuestcontexto, sem efeito na revisãobooleanonão

10Projetos #sec_82d9dfcf

asana.projects.projects:collect · revisão 2 do contrato, publicada em 18 de outubro de 2026 · via asana.api.reviewit.service-account

Projetos da organização, seu proprietário e visibilidade

Chamadas

  • GET /workspaces/{gid}/projects

Requisitos

NaturezaRegraOpções
Condição de administraçãoobrigatóriaa conta de serviço Asana é criada por um super-administrador da organização (Asana Enterprise); seu token concede acesso completo de leitura, verificado por chamada
Afiliaçãoobrigatóriao identificador pertence à organização Asana da conexão

Condições de funcionamento

  • um token é obtido para o identificador
  • o serviço https://app.asana.com/api/1.0 responde

Frescura: verificações em menos de 24 h; os direitos devem ser verificados por uma chamada real.

Dados mantidos

CampoFunçãoTipoObrigatório
Gidchave do objetotextosim
Nameexibido para reconhecer o objetotextosim
Teamcontexto, sem efeito na revisãotextonão
Owneracesso sujeito à revisãolista de identidadesnão
Privacyavaliado pelas políticas REVIEWIT (visibilidade)textonão
Archivedcontexto, sem efeito na revisãobooleanonão
Createdcontexto, sem efeito na revisãodata e horanão
Modifiedavaliado pelas políticas REVIEWIT (data da última atividade)data e horanão
Membersacesso sujeito à revisãolista de identidadesnão
Followersacesso sujeito à revisãolista de identidadesnão

11Equipes · Membros da equipe #sec_3fa08c09

asana.teams.memberships:collect · revisão 2 do contrato, publicada em 18 de outubro de 2026 · via asana.api.reviewit.service-account

Associações de equipe, convidados e acesso limitado incluídos. Chave de linha: TeamGid | UserGid.

Chamadas

  • GET /teams/{gid}/team_memberships

Requisitos

NaturezaRegraOpções
Condição de administraçãoobrigatóriaa conta de serviço Asana é criada por um super-administrador da organização (Asana Enterprise); seu token concede acesso completo de leitura, verificado por chamada
Afiliaçãoobrigatóriao identificador pertence à organização Asana da conexão

Condições de funcionamento

  • um token é obtido para o identificador
  • o serviço https://app.asana.com/api/1.0 responde

Frescura: verificações em menos de 24 h; os direitos devem ser verificados por uma chamada real.

Dados mantidos

CampoFunçãoTipoObrigatório
MembershipKeychave do objetotextosim
TeamGidcontexto, sem efeito na revisãotextosim
TeamNamecontexto, sem efeito na revisãotextonão
UserGidcontexto, sem efeito na revisãotextosim
UserNamecontexto, sem efeito na revisãotextonão
Emailexibido para reconhecer o objetotextosim
IsAdmincontexto, sem efeito na revisãobooleanonão
IsGuestcontexto, sem efeito na revisãobooleanonão
IsLimitedAccesscontexto, sem efeito na revisãobooleanonão

12Equipes #sec_29bcc8ef

asana.teams.teams:collect · revisão 2 do contrato, publicada em 18 de outubro de 2026 · via asana.api.reviewit.service-account

Equipes da organização e sua visibilidade

Chamadas

  • GET /workspaces/{gid}/teams
  • GET /teams/{gid}/team_memberships

Requisitos

NaturezaRegraOpções
Condição de administraçãoobrigatóriaa conta de serviço Asana é criada por um super-administrador da organização (Asana Enterprise); seu token concede acesso completo de leitura, verificado por chamada
Afiliaçãoobrigatóriao identificador pertence à organização Asana da conexão

Condições de funcionamento

  • um token é obtido para o identificador
  • o serviço https://app.asana.com/api/1.0 responde

Frescura: verificações em menos de 24 h; os direitos devem ser verificados por uma chamada real.

Dados mantidos

CampoFunçãoTipoObrigatório
Gidchave do objetotextosim
Nameexibido para reconhecer o objetotextosim
Descriptioncontexto, sem efeito na revisãotextonão
Visibilityavaliado pelas políticas REVIEWIT (visibilidade)textonão
Organizationcontexto, sem efeito na revisãotextonão
MemberCountcontexto, sem efeito na revisãointeironão

13Para ir mais longe #sec_b2bf5f50

  • Compreender uma ligação de coleta
  • Referência dos direitos por recurso
  • Ler um veredicto
Esc
↑↓ navegar↵ abrirVer todos os resultados →