Contratos de recolección — Asana
01Cómo leer esta página #sec_bba4e109
Cada recurso que REVIEWIT puede recolectar para Asana tiene un contrato publicado. Se lee como una referencia de API: lo que REVIEWIT llama en el servicio recolectado y por qué medio, lo que el contrato exige para que la recolección se ejecute, y los datos que REVIEWIT conserva. REVIEWIT solo realiza lecturas.
- Llamadas: las solicitudes que REVIEWIT dirige al servicio recolectado, todas en lectura.
- Exigencias: cada una debe ser satisfecha. Su naturaleza indica lo que solicita: un derecho a conceder al identificador, una condición de administración (una configuración o asignación en el proveedor que el token no incluye, constatada por una llamada real en lectura), o la pertenencia del identificador a la organización Asana de la conexión. La regla indica cuántas opciones se necesitan: « requerida » para la opción única, « una al elección » cuando una sola es suficiente (están ordenadas de la más estrecha a la más amplia: prefiera la primera), « todas », o « N al elección entre M ».
- Condiciones de funcionamiento: lo que REVIEWIT constata antes de cada recolección, más allá de los requisitos.
- Frescura: la edad máxima de las verificaciones sobre las que el veredicto se basa, fijada por cada contrato (aquí: verificaciones de menos de 24 h; los derechos deben ser constatados por una llamada real). REVIEWIT vuelve a hacer automáticamente dentro de este plazo las verificaciones que puede realizar (token obtenido, servicio que responde); « Verificar los derechos », en el menú de la conexión, los vuelve a hacer bajo demanda. Mientras la llamada real no se haya realizado, los derechos permanecen no constatados.
- Datos conservados: los campos que REVIEWIT guarda de cada objeto; el rol indica qué hace la revisión con ellos.
El veredicto de cada recurso, para su conexión, se lee en su ficha. Un recurso que la conexión no recolecta siempre puede ser alimentado por la importación de un informe (« Importar un informe »).
02Cómo REVIEWIT verifica los requisitos #sec_4b0123b7
El token de Asana no incluye sus derechos: el contrato exige que sean constatados por una llamada real, en lectura. REVIEWIT aún no hace esta llamada para Asana: constata que el token está obtenido y que el servicio responde, pero no los derechos listados aquí. Los recursos aparecen como « No verificado »; siempre pueden ser alimentados por la importación de un informe (« Importar un informe »).
03Las vías de llamada #sec_cf8230c1
Una vía indica qué token REVIEWIT obtiene para el identificador: quién lo emite y para qué audiencia. Las direcciones llamadas aparecen en las llamadas de cada recurso; un camino que comienza con « / » se llama sobre la audiencia del token de su vía.
| Vía | Token emitido por | Audiencia del token | Autenticación del identificador |
|---|---|---|---|
| asana.api.reviewit.service-account | https://app.asana.com | https://app.asana.com/api/1.0 | cuenta de servicio |
04Directory · Guests #sec_b8689674
asana.directory.guests:collect · revisión 2 del contrato, publicado el 18 octubre 2026 · vía asana.api.reviewit.service-account
Colaboradores externos admitidos en la organización
Llamadas
- GET /workspaces/{gid}/workspace_memberships (is_guest)
Requisitos
| Naturaleza | Regla | Opciones |
|---|---|---|
| Condición de administración | requerida | la cuenta de servicio Asana es creada por un super-administrador de la organización (Asana Enterprise); su token otorga acceso completo en lectura, constatado por llamada |
| Pertenencia | requerida | el identificador pertenece a la organización Asana de la conexión |
Condiciones de funcionamiento
- un token está obtenido para el identificador
- el servicio https://app.asana.com/api/1.0 responde
Frescura: verificaciones de menos de 24 h; los derechos deben ser constatados por una llamada real.
Datos conservados
| Campo | Rol | Tipo | Obligatorio |
|---|---|---|---|
| Gid | clave del objeto | texto | sí |
| Name | mostrado para reconocer el objeto | texto | sí |
| mostrado para reconocer el objeto | texto | no | |
| IsActive | contexto, sin efecto sobre la revisión | booleano | no |
| Teams | contexto, sin efecto sobre la revisión | texto | no |
| Projects | contexto, sin efecto sobre la revisión | texto | no |
05Directorio · Usuarios #sec_1061454b
asana.directory.users:collect · revisión 2 del contrato, publicada el 18 octubre 2026 · vía asana.api.reviewit.service-account
Cuentas de la organización y su estado de actividad
Llamadas
- GET /workspaces/{gid}/users
- GET /workspaces/{gid}/workspace_memberships
- GET /users/{user_gid}/teams?organization={gid} (campo Teams)
Requisitos
| Naturaleza | Regla | Opciones |
|---|---|---|
| Condición de administración | requerida | la cuenta de servicio Asana es creada por un super-administrador de la organización (Asana Enterprise) ; su token da acceso completo de lectura, constatado por llamada |
| Pertenencia | requerida | el identificador pertenece a la organización Asana de la conexión |
Condiciones de funcionamiento
- se obtiene un token para el identificador
- el servicio https://app.asana.com/api/1.0 responde
Frescura : verificaciones de menos de 24 h ; los derechos deben ser constatados por una llamada real.
Datos conservados
| Campo | Rol | Tipo | Obligatorio |
|---|---|---|---|
| Gid | clave del objeto | texto | sí |
| Name | mostrado para reconocer el objeto | texto | sí |
| mostrado para reconocer el objeto | texto | no | |
| IsActive | contexto, sin efecto sobre la revisión | booleano | no |
| IsAdmin | contexto, sin efecto sobre la revisión | booleano | no |
| IsGuest | contexto, sin efecto sobre la revisión | booleano | no |
| Teams | contexto, sin efecto sobre la revisión | texto | no |
06Portafolios · Miembros del portafolio #sec_bdfc2222
asana.portfolios.memberships:collect · revisión 2 del contrato, publicada el 18 octubre 2026 · vía asana.api.reviewit.service-account
Miembros de un portafolio y su nivel de acceso. Clave de fila : PortfolioGid | UserGid.
Llamadas
- GET /portfolios/{gid}/portfolio_memberships
Requisitos
| Naturaleza | Regla | Opciones |
|---|---|---|
| Condición de administración | requerida | la cuenta de servicio Asana es creada por un super-administrador de la organización (Asana Enterprise) ; su token da acceso completo de lectura, constatado por llamada |
| Pertenencia | requerida | el identificador pertenece a la organización Asana de la conexión |
Condiciones de funcionamiento
- se obtiene un token para el identificador
- el servicio https://app.asana.com/api/1.0 responde
Frescura : verificaciones de menos de 24 h ; los derechos deben ser constatados por una llamada real.
Datos conservados
| Campo | Rol | Tipo | Obligatorio |
|---|---|---|---|
| MembershipKey | clave del objeto | texto | sí |
| PortfolioGid | contexto, sin efecto sobre la revisión | texto | sí |
| PortfolioName | contexto, sin efecto sobre la revisión | texto | no |
| UserGid | contexto, sin efecto sobre la revisión | texto | sí |
| UserName | contexto, sin efecto sobre la revisión | texto | no |
| mostrado para reconocer el objeto | texto | sí | |
| AccessLevel | contexto, sin efecto sobre la revisión | texto | no |
07Portafolios #sec_c80b6d56
asana.portfolios.portfolios:collect · revisión 2 del contrato, publicada el 18 octubre 2026 · vía asana.api.reviewit.service-account
Portafolios, su propietario, sus miembros y el número de proyectos que agrupan
Llamadas
- GET /portfolios?workspace={gid}
- GET /portfolios/{gid}/items
Requisitos
| Naturaleza | Regla | Opciones |
|---|---|---|
| Condición de administración | requerida | la cuenta de servicio Asana es creada por un super-administrador de la organización (Asana Enterprise) ; su token da acceso completo de lectura, constatado por llamada |
| Pertenencia | requerida | el identificador pertenece a la organización Asana de la conexión |
Condiciones de funcionamiento
- se obtiene un token para el identificador
- el servicio https://app.asana.com/api/1.0 responde
Frescura : verificaciones de menos de 24 h ; los derechos deben ser constatados por una llamada real.
Datos conservados
| Campo | Rol | Tipo | Obligatorio |
|---|---|---|---|
| Gid | clave del objeto | texto | sí |
| Name | mostrado para reconocer el objeto | texto | sí |
| Owner | acceso sujeto a la revisión | lista de identidades | no |
| Public | evaluado por las políticas REVIEWIT (visibilidad) | booleano | no |
| Created | contexto, sin efecto sobre la revisión | fecha y hora | no |
| Members | acceso sujeto a la revisión | lista de identidades | no |
| ProjectCount | contexto, sin efecto sobre la revisión | entero | no |
08Roles privilegiados · Administradores #sec_901c7249
asana.privileged-roles.admins:collect · revisión 2 del contrato, publicada el 18 octubre 2026 · vía asana.api.reviewit.service-account
Administradores de la organización
Llamadas
- GET /workspaces/{gid}/workspace_memberships (is_admin)
Requisitos
| Naturaleza | Regla | Opciones |
|---|---|---|
| Condición de administración | requerida | la cuenta de servicio Asana es creada por un super-administrador de la organización (Asana Enterprise) ; su token da acceso completo de lectura, constatado por llamada |
| Pertenencia | requerida | el identificador pertenece a la organización Asana de la conexión |
Condiciones de funcionamiento
- se obtiene un token para el identificador
- el servicio https://app.asana.com/api/1.0 responde
Frescura : verificaciones de menos de 24 h ; los derechos deben ser constatados por una llamada real.
Datos conservados
| Campo | Rol | Tipo | Obligatorio |
|---|---|---|---|
| Gid | clave del objeto | texto | sí |
| Name | mostrado para reconocer el objeto | texto | sí |
| mostrado para reconocer el objeto | texto | no | |
| AdminScope | contexto, sin efecto sobre la revisión | texto | no |
| IsActive | contexto, sin efecto sobre la revisión | booleano | no |
09Proyectos · Miembros del proyecto #sec_f9f5d31c
asana.projects.memberships:collect · revisión 2 del contrato, publicada el 18 octubre 2026 · vía asana.api.reviewit.service-account
Miembros de un proyecto y su nivel de acceso. Clave de fila: ProjectGid | UserGid.
Llamadas
- GET /projects/{gid}/project_memberships
Requisitos
| Naturaleza | Regla | Opciones |
|---|---|---|
| Condición de administración | requerida | la cuenta de servicio Asana está creada por un superadministrador de la organización (Asana Enterprise); su token otorga acceso completo de lectura, comprobado por llamada |
| Pertenencia | requerida | el identificador pertenece a la organización Asana de la conexión |
Condiciones de funcionamiento
- se obtiene un token para el identificador
- el servicio https://app.asana.com/api/1.0 responde
Frescura: comprobaciones de menos de 24 h; los derechos deben ser comprobados por una llamada real.
Datos conservados
| Campo | Rol | Tipo | Obligatorio |
|---|---|---|---|
| MembershipKey | clave del objeto | texto | sí |
| ProjectGid | contexto, sin efecto sobre la revisión | texto | sí |
| ProjectName | contexto, sin efecto sobre la revisión | texto | no |
| UserGid | contexto, sin efecto sobre la revisión | texto | sí |
| UserName | contexto, sin efecto sobre la revisión | texto | no |
| mostrado para reconocer el objeto | texto | sí | |
| AccessLevel | contexto, sin efecto sobre la revisión | texto | no |
| IsGuest | contexto, sin efecto sobre la revisión | booleano | no |
10Proyectos #sec_82d9dfcf
asana.projects.projects:collect · revisión 2 del contrato, publicada el 18 octubre 2026 · vía asana.api.reviewit.service-account
Proyectos de la organización, su propietario y su visibilidad
Llamadas
- GET /workspaces/{gid}/projects
Requisitos
| Naturaleza | Regla | Opciones |
|---|---|---|
| Condición de administración | requerida | la cuenta de servicio Asana está creada por un superadministrador de la organización (Asana Enterprise); su token otorga acceso completo de lectura, comprobado por llamada |
| Pertenencia | requerida | el identificador pertenece a la organización Asana de la conexión |
Condiciones de funcionamiento
- se obtiene un token para el identificador
- el servicio https://app.asana.com/api/1.0 responde
Frescura: comprobaciones de menos de 24 h; los derechos deben ser comprobados por una llamada real.
Datos conservados
| Campo | Rol | Tipo | Obligatorio |
|---|---|---|---|
| Gid | clave del objeto | texto | sí |
| Name | mostrado para reconocer el objeto | texto | sí |
| Team | contexto, sin efecto sobre la revisión | texto | no |
| Owner | acceso sujeto a la revisión | lista de identidades | no |
| Privacy | evaluado por las políticas REVIEWIT (visibilidad) | texto | no |
| Archived | contexto, sin efecto sobre la revisión | booleano | no |
| Created | contexto, sin efecto sobre la revisión | fecha y hora | no |
| Modified | evaluado por las políticas REVIEWIT (fecha de última actividad) | fecha y hora | no |
| Members | acceso sujeto a la revisión | lista de identidades | no |
| Followers | acceso sujeto a la revisión | lista de identidades | no |
11Equipos · Miembros del equipo #sec_3fa08c09
asana.teams.memberships:collect · revisión 2 del contrato, publicada el 18 octubre 2026 · vía asana.api.reviewit.service-account
Afiliaciones de equipo, invitados y acceso limitado incluido. Clave de fila: TeamGid | UserGid.
Llamadas
- GET /teams/{gid}/team_memberships
Requisitos
| Naturaleza | Regla | Opciones |
|---|---|---|
| Condición de administración | requerida | la cuenta de servicio Asana está creada por un superadministrador de la organización (Asana Enterprise); su token otorga acceso completo de lectura, comprobado por llamada |
| Pertenencia | requerida | el identificador pertenece a la organización Asana de la conexión |
Condiciones de funcionamiento
- se obtiene un token para el identificador
- el servicio https://app.asana.com/api/1.0 responde
Frescura: comprobaciones de menos de 24 h; los derechos deben ser comprobados por una llamada real.
Datos conservados
| Campo | Rol | Tipo | Obligatorio |
|---|---|---|---|
| MembershipKey | clave del objeto | texto | sí |
| TeamGid | contexto, sin efecto sobre la revisión | texto | sí |
| TeamName | contexto, sin efecto sobre la revisión | texto | no |
| UserGid | contexto, sin efecto sobre la revisión | texto | sí |
| UserName | contexto, sin efecto sobre la revisión | texto | no |
| mostrado para reconocer el objeto | texto | sí | |
| IsAdmin | contexto, sin efecto sobre la revisión | booleano | no |
| IsGuest | contexto, sin efecto sobre la revisión | booleano | no |
| IsLimitedAccess | contexto, sin efecto sobre la revisión | booleano | no |
12Equipos #sec_29bcc8ef
asana.teams.teams:collect · revisión 2 del contrato, publicada el 18 octubre 2026 · vía asana.api.reviewit.service-account
Equipos de la organización y su visibilidad
Llamadas
- GET /workspaces/{gid}/teams
- GET /teams/{gid}/team_memberships
Requisitos
| Naturaleza | Regla | Opciones |
|---|---|---|
| Condición de administración | requerida | la cuenta de servicio Asana está creada por un superadministrador de la organización (Asana Enterprise); su token otorga acceso completo de lectura, comprobado por llamada |
| Pertenencia | requerida | el identificador pertenece a la organización Asana de la conexión |
Condiciones de funcionamiento
- se obtiene un token para el identificador
- el servicio https://app.asana.com/api/1.0 responde
Frescura: comprobaciones de menos de 24 h; los derechos deben ser comprobados por una llamada real.
Datos conservados
| Campo | Rol | Tipo | Obligatorio |
|---|---|---|---|
| Gid | clave del objeto | texto | sí |
| Name | mostrado para reconocer el objeto | texto | sí |
| Description | contexto, sin efecto sobre la revisión | texto | no |
| Visibility | evaluado por las políticas REVIEWIT (visibilidad) | texto | no |
| Organization | contexto, sin efecto sobre la revisión | texto | no |
| MemberCount | contexto, sin efecto sobre la revisión | entero | no |
13Para ir más allá #sec_b2bf5f50
- Comprender una conexión de recolección
- Referencia de derechos por recurso
- Leer un veredicto