Contratos de recolección — Dropbox
01Cómo leer esta página #sec_ad073a7d
Cada recurso que REVIEWIT puede recolectar para Dropbox 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 al equipo de Dropbox 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 cuales 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_baec0ba7
El token de Dropbox no incluye sus derechos: el contrato exige que sean constatados por una llamada real, en lectura. REVIEWIT aún no hace esta llamada para Dropbox: constata que el token está obtenido y que el servicio responde, pero no los derechos listados aquí. Los recursos aparecen « No verificado »; siempre pueden ser alimentados por la importación de un informe (« Importar un informe »).
03Las vías de llamada #sec_aa579778
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 |
|---|---|---|---|
| dropbox.team.reviewit.app | https://api.dropboxapi.com/oauth2/token | https://api.dropboxapi.com | token o secreto de API |
04Directory · Miembros del equipo #sec_b383ef81
dropbox.directory.members:collect · revisión 2 del contrato, publicada el 18 octubre 2026 · vía dropbox.team.reviewit.app
Miembros del equipo, su estado y su rol
Llamadas
- POST /2/team/members/list_v2
- POST /2/team/members/list/continue_v2
Requisitos
| Naturaleza | Regla | Opciones |
|---|---|---|
| Derecho | requerida | members.read |
| Pertenencia | requerida | el identificador pertenece al equipo de Dropbox de la conexión |
Condiciones de funcionamiento
- un token está obtenido para el identificador
- el servicio https://api.dropboxapi.com responde
Frescura: verificaciones de menos de 24 h; los derechos deben ser constatados por una llamada real.
Datos conservados
| Campo | Rol | Tipo | Obligatorio |
|---|---|---|---|
| TeamMemberId | clave del objeto | texto | sí |
| mostrado para reconocer el objeto | texto | sí | |
| DisplayName | mostrado para reconocer el objeto | texto | no |
| Status | contexto, sin efecto sobre la revisión | texto | no |
| Role | contexto, sin efecto sobre la revisión | texto | no |
| JoinedOn | contexto, sin efecto sobre la revisión | fecha y hora | no |
| ExternalId | contexto, sin efecto sobre la revisión | texto | no |
05Grupos #sec_8e4bf902
dropbox.groups.groups:collect · revisión 2 del contrato, publicada el 18 octubre 2026 · vía dropbox.team.reviewit.app
Grupos de equipo, gestionados por la empresa o por el usuario
Llamadas
- POST /2/team/groups/list
- POST /2/team/groups/list/continue
Requisitos
| Naturaleza | Regla | Opciones |
|---|---|---|
| Permiso | requerido | groups.read |
| Pertenencia | requerido | el identificador pertenece al equipo Dropbox de la conexión |
Condiciones de funcionamiento
- se obtiene un token para el identificador
- el servicio https://api.dropboxapi.com responde
Frescura: comprobaciones de menos de 24 h; los permisos deben ser constatados por una llamada real.
Datos conservados
| Campo | Rol | Tipo | Obligatorio |
|---|---|---|---|
| GroupId | clave del objeto | texto | sí |
| GroupName | mostrado para reconocer el objeto | texto | sí |
| ManagementType | contexto, sin efecto sobre la revisión | texto | no |
| MemberCount | contexto, sin efecto sobre la revisión | entero | no |
| ExternalId | contexto, sin efecto sobre la revisión | texto | no |
06Grupos · Miembros del grupo #sec_0f3a6cc8
dropbox.groups.memberships:collect · revisión 2 del contrato, publicada el 18 octubre 2026 · vía dropbox.team.reviewit.app
Pertenencias de grupo y rol (miembro o administrador). Clave de fila: GroupId | TeamMemberId.
Llamadas
- POST /2/team/groups/members/list
- POST /2/team/groups/members/list/continue
Requisitos
| Naturaleza | Regla | Opciones |
|---|---|---|
| Permiso | requerido | groups.read |
| Pertenencia | requerido | el identificador pertenece al equipo Dropbox de la conexión |
Condiciones de funcionamiento
- se obtiene un token para el identificador
- el servicio https://api.dropboxapi.com responde
Frescura: comprobaciones de menos de 24 h; los permisos deben ser constatados por una llamada real.
Datos conservados
| Campo | Rol | Tipo | Obligatorio |
|---|---|---|---|
| MembershipKey | clave del objeto | texto | sí |
| GroupId | contexto, sin efecto sobre la revisión | texto | sí |
| GroupName | contexto, sin efecto sobre la revisión | texto | no |
| TeamMemberId | contexto, sin efecto sobre la revisión | texto | sí |
| mostrado para reconocer el objeto | texto | sí | |
| AccessType | contexto, sin efecto sobre la revisión | texto | no |
07Roles privilegiados · Administradores del equipo #sec_2bf483df
dropbox.privileged-roles.admins:collect · revisión 2 del contrato, publicada el 18 octubre 2026 · vía dropbox.team.reviewit.app
Administradores del equipo y su ámbito de administración
Llamadas
- POST /2/team/members/list_v2 (roles)
- POST /2/team/members/get_available_team_member_roles
Requisitos
| Naturaleza | Regla | Opciones |
|---|---|---|
| Permiso | requerido | members.read |
| Pertenencia | requerido | el identificador pertenece al equipo Dropbox de la conexión |
Condiciones de funcionamiento
- se obtiene un token para el identificador
- el servicio https://api.dropboxapi.com responde
Frescura: comprobaciones de menos de 24 h; los permisos deben ser constatados por una llamada real.
Datos conservados
| Campo | Rol | Tipo | Obligatorio |
|---|---|---|---|
| TeamMemberId | clave del objeto | texto | sí |
| mostrado para reconocer el objeto | texto | sí | |
| DisplayName | mostrado para reconocer el objeto | texto | no |
| Role | contexto, sin efecto sobre la revisión | texto | no |
| Status | contexto, sin efecto sobre la revisión | texto | no |
| JoinedOn | contexto, sin efecto sobre la revisión | fecha y hora | no |
08Contenido compartido · Miembros y invitaciones compartidas #sec_c6e9d19c
dropbox.sharing.memberships:collect · revisión 2 del contrato, publicada el 18 octubre 2026 · vía dropbox.team.reviewit.app
Miembros de un compartir y invitaciones aún pendientes. Clave de fila: SharedFolderId | PrincipalId (cuenta, grupo o dirección del invitado).
Llamadas
- POST /2/sharing/list_folder_members (en nombre de cada miembro)
- POST /2/sharing/list_folder_members/continue (en nombre de cada miembro)
Requisitos
| Naturaleza | Regla | Opciones |
|---|---|---|
| Permiso | requerido | members.read |
| Permiso | requerido | team_data.member |
| Permiso | requerido | sharing.read |
| Pertenencia | requerido | el identificador pertenece al equipo Dropbox de la conexión |
Condiciones de funcionamiento
- se obtiene un token para el identificador
- el servicio https://api.dropboxapi.com responde
Frescura: comprobaciones de menos de 24 h; los permisos deben ser constatados por una llamada real.
Datos conservados
| Campo | Rol | Tipo | Obligatorio |
|---|---|---|---|
| MembershipKey | clave del objeto | texto | sí |
| SharedFolderId | contexto, sin efecto sobre la revisión | texto | sí |
| SharedFolderName | contexto, sin efecto sobre la revisión | texto | no |
| PrincipalId | contexto, sin efecto sobre la revisión | texto | sí |
| PrincipalType | contexto, sin efecto sobre la revisión | texto | no |
| mostrado para reconocer el objeto | texto | sí | |
| AccessType | contexto, sin efecto sobre la revisión | texto | no |
| IsInherited | contexto, sin efecto sobre la revisión | booleano | no |
| InvitationPending | contexto, sin efecto sobre la revisión | booleano | no |
09Contenido compartido · Carpetas compartidas #sec_892c126b
dropbox.sharing.shared-folders:collect · revisión 2 del contrato, publicada el 18 octubre 2026 · vía dropbox.team.reviewit.app
Carpetas compartidas, su propietario y su política de compartir
Llamadas
- POST /2/sharing/list_folders (en nombre de cada miembro)
- POST /2/sharing/list_folders/continue (en nombre de cada miembro)
Requisitos
| Naturaleza | Regla | Opciones |
|---|---|---|
| Permiso | requerido | members.read |
| Permiso | requerido | team_data.member |
| Permiso | requerido | sharing.read |
| Pertenencia | requerido | el identificador pertenece al equipo Dropbox de la conexión |
Condiciones de funcionamiento
- se obtiene un token para el identificador
- el servicio https://api.dropboxapi.com responde
Frescura: comprobaciones de menos de 24 h; los permisos deben ser constatados por una llamada real.
Datos conservados
| Campo | Rol | Tipo | Obligatorio |
|---|---|---|---|
| SharedFolderId | clave del objeto | texto | sí |
| Name | mostrado para reconocer el objeto | texto | sí |
| PathLower | contexto, sin efecto sobre la revisión | texto | no |
| OwnerTeam | contexto, sin efecto sobre la revisión | texto | no |
| AccessType | contexto, sin efecto sobre la revisión | texto | no |
| IsInsideTeamFolder | contexto, sin efecto sobre la revisión | booleano | no |
| PolicyMemberPolicy | contexto, sin efecto sobre la revisión | texto | no |
10Contenido compartido · Enlaces compartidos #sec_ef07fa72
dropbox.sharing.shared-links:collect · revisión 2 del contrato, publicada el 18 octubre 2026 · vía dropbox.team.reviewit.app
Enlaces compartidos: audiencia, contraseña, fecha de caducidad
Llamadas
- POST /2/sharing/list_shared_links (en nombre de cada miembro)
Requisitos
| Naturaleza | Regla | Opciones |
|---|---|---|
| Permiso | requerido | members.read |
| Permiso | requerido | team_data.member |
| Permiso | requerido | sharing.read |
| Pertenencia | requerido | el identificador pertenece al equipo Dropbox de la conexión |
Condiciones de funcionamiento
- se obtiene un token para el identificador
- el servicio https://api.dropboxapi.com responde
Frescura: comprobaciones de menos de 24 h; los permisos deben ser constatados por una llamada real.
Datos conservados
| Campo | Rol | Tipo | Obligatorio |
|---|---|---|---|
| LinkId | clave del objeto | texto | sí |
| Url | mostrado para reconocer el objeto | texto | sí |
| PathLower | contexto, sin efecto sobre la revisión | texto | no |
| Visibility | evaluado por las políticas REVIEWIT (visibilidad) | texto | no |
| HasPassword | contexto, sin efecto sobre la revisión | booleano | no |
| Expires | contexto, sin efecto sobre la revisión | fecha y hora | no |
| CreatedBy | acceso sujeto a la revisión | lista de identidades | no |
11Espacios del equipo · Acceso a carpetas del equipo #sec_cdb4c7fe
dropbox.team-space.memberships:collect · revisión 2 del contrato, publicada el 18 octubre 2026 · vía dropbox.team.reviewit.app
Grupos y miembros con acceso a una carpeta del equipo. Clave de fila: TeamFolderId | PrincipalId.
Llamadas
- POST /2/team/team_folder/list
- POST /2/sharing/list_folder_members (carpetas del equipo, en nombre de un administrador)
Requisitos
| Naturaleza | Regla | Opciones |
|---|---|---|
| Permiso | requerido | team_data.team_space |
| Permiso | requerido | sharing.read |
| Pertenencia | requerido | el identificador pertenece al equipo Dropbox de la conexión |
Condiciones de funcionamiento
- se obtiene un token para el identificador
- el servicio https://api.dropboxapi.com responde
Frescura: comprobaciones de menos de 24 h; los permisos deben ser constatados por una llamada real.
Datos conservados
| Campo | Rol | Tipo | Obligatorio |
|---|---|---|---|
| MembershipKey | clave del objeto | texto | sí |
| TeamFolderId | contexto, sin efecto sobre la revisión | texto | sí |
| TeamFolderName | mostrado para reconocer el objeto | texto | sí |
| PrincipalId | contexto, sin efecto sobre la revisión | texto | sí |
| PrincipalType | contexto, sin efecto sobre la revisión | texto | no |
| AccessType | contexto, sin efecto sobre la revisión | texto | no |
| IsInherited | contexto, sin efecto sobre la revisión | booleano | no |
12Espacios del equipo #sec_9bc60b77
dropbox.team-space.namespaces:collect · revisión 2 del contrato, publicada el 18 octubre 2026 · vía dropbox.team.reviewit.app
Espacios de nombres del equipo (namespaces): carpetas de miembros, carpetas compartidas, carpetas del equipo y carpetas de aplicación
Llamadas
- POST /2/team/namespaces/list
- POST /2/team/namespaces/list/continue
Requisitos
| Naturaleza | Regla | Opciones |
|---|---|---|
| Permiso | una a elección | team_data.member o team_data.team_space |
| Pertenencia | requerido | el identificador pertenece al equipo Dropbox de la conexión |
Condiciones de funcionamiento
- se obtiene un token para el identificador
- el servicio https://api.dropboxapi.com responde
Frescura: comprobaciones de menos de 24 h; los permisos deben ser constatados por una llamada real.
Datos conservados
| Campo | Rol | Tipo | Obligatorio |
|---|---|---|---|
| NamespaceId | clave del objeto | texto | sí |
| Name | mostrado para reconocer el objeto | texto | sí |
| NamespaceType | contexto, sin efecto sobre la revisión | texto | no |
| TeamMemberId | contexto, sin efecto sobre la revisión | texto | no |
| IsInsideTeamFolder | contexto, sin efecto sobre la revisión | booleano | no |
13Espacios de equipo · Carpetas de equipo #sec_42cb5e57
dropbox.team-space.team-folders:collect · revisión 2 del contrato, publicada el 18 octubre 2026 · vía dropbox.team.reviewit.app
Carpetas de equipo, su estado y su sincronización
Llamadas
- POST /2/team/team_folder/list
- POST /2/team/team_folder/list/continue
Requisitos
| Naturaleza | Regla | Opciones |
|---|---|---|
| Permiso | uno a elección | team_data.team_space o team_data.content.read |
| Pertenencia | requerida | el identificador pertenece al equipo Dropbox de la conexión |
Condiciones de funcionamiento
- se obtiene un token para el identificador
- el servicio https://api.dropboxapi.com responde
Frescura: comprobaciones de menos de 24 h; los permisos deben ser constatados por una llamada real.
Datos conservados
| Campo | Rol | Tipo | Obligatorio |
|---|---|---|---|
| TeamFolderId | clave del objeto | texto | sí |
| Name | mostrado para reconocer el objeto | texto | sí |
| Status | contexto, sin efecto sobre la revisión | texto | no |
| IsTeamSharedDropbox | contexto, sin efecto sobre la revisión | booleano | no |
| SyncSetting | contexto, sin efecto sobre la revisión | texto | no |
| ContentPolicy | contexto, sin efecto sobre la revisión | texto | no |
14Aplicaciones de terceros · Aplicaciones vinculadas #sec_692fcc7b
dropbox.apps.linked-apps:collect · revisión 3 del contrato, publicada el 18 octubre 2026 · vía dropbox.team.reviewit.app
Aplicaciones de terceros asociadas a las cuentas de los miembros del equipo, una fila por aplicación y por miembro. Clave de fila: TeamMemberId | AppId.
Llamadas
- POST /2/team/linked_apps/list_members_linked_apps
- POST /2/team/members/get_info_v2 (Email)
Requisitos
| Naturaleza | Regla | Opciones |
|---|---|---|
| Permiso | requerida | sessions.list |
| Permiso | requerida | members.read |
| Pertenencia | requerida | el identificador pertenece al equipo Dropbox de la conexión |
Condiciones de funcionamiento
- se obtiene un token para el identificador
- el servicio https://api.dropboxapi.com responde
Frescura: comprobaciones de menos de 24 h; los permisos deben ser constatados por una llamada real.
Datos conservados
| Campo | Rol | Tipo | Obligatorio |
|---|---|---|---|
| LinkKey | clave del objeto | texto | sí |
| AppId | contexto, sin efecto sobre la revisión | texto | sí |
| AppName | contexto, sin efecto sobre la revisión | texto | no |
| Publisher | contexto, sin efecto sobre la revisión | texto | no |
| TeamMemberId | contexto, sin efecto sobre la revisión | texto | sí |
| mostrado para reconocer el objeto | texto | sí | |
| LinkedOn | contexto, sin efecto sobre la revisión | fecha y hora | no |
| IsAppFolder | contexto, sin efecto sobre la revisión | booleano | no |
15Para ir más allá #sec_feb78037
- Comprender una conexión de recolección
- Referencia de permisos por recurso
- Leer un veredicto