Saltar al contenido principal
GET
Python (SDK)

Autorizaciones

Authorization
string
header
requerido

Send Authorization: Bearer , using an MKA1 API key for automation or an OAuth API access token for a signed-in application. Use a dynamic security callback to refresh OAuth access tokens. Browser session-only operations still require their declared cookie.

Encabezados

X-On-Behalf-Of
string

Optional external end-user identifier forwarded by the API gateway.

Parámetros de ruta

file_id
string
requerido

La ID del archivo.

user_id
string
requerido

El principal: el ID de usuario de un miembro, el ID del usuario final al que se delega una solicitud con X-On-Behalf-Of, o 'team' para el permiso que se aplica a todos los miembros del equipo del archivo.

Minimum string length: 1

Respuesta

200 - application/json

Está bien

El permiso efectivo de un principal sobre un archivo y de dónde proviene.

object
any
requerido

El tipo de objeto, que siempre es "file.permission".

file_id
string
requerido

La ID del archivo.

grantee_type
enum<string>
requerido

A quién se aplica el permiso: un principal (user), o cada miembro del equipo del recurso (team).

Opciones disponibles:
user,
team
user_id
string | null
requerido

El principal al que se aplica el permiso: el ID de usuario de un miembro, o el ID del usuario final al que se delega una solicitud con X-On-Behalf-Of. null cuando el permiso se aplica al equipo del archivo.

role
enum<string> | null
requerido

El rol más alto que posee el principal en el archivo, o null cuando no posee ninguno.

Opciones disponibles:
owner,
writer,
reader
source
enum<string>
requerido

De dónde proviene el rol: del propietario del recurso, de un permiso que posee este principal, del permiso team del recurso, o de nada: el principal solo accede al recurso como administrador de la organización de su equipo, si es que lo hace.

Opciones disponibles:
owner,
grant,
team,
none