Añadir enlace compartido al archivo

Compatibilidad de proyectos

Windows | Multiplataforma

Información general

Descripción	método API	Ruta de la API
Crea un enlace compartido para un archivo en Box.	PONER	/files/{file_id}/add_shared_link

Entrada

Parámetro	Descripción	Tipo de datos
Archivo	El objeto de archivo para el que se está creando el enlace compartido.	Lista de datos
Acceso	Define quién puede acceder al enlace compartido. Valores admitidos: Abierto: cualquier persona con el enlace Empresa: solo los usuarios de tu organización Colaboradores: solo los usuarios que son colaboradores del archivo o su carpeta principal	options
Contraseña	Se requiere una contraseña opcional para acceder al enlace compartido. Establezca como nulo para eliminar una contraseña existente. Las contraseñas deben tener al menos 8 caracteres e incluir un número, una letra mayúscula o un símbolo. La protección por contraseña solo está permitida cuando access = open.	String
Descargar	Indica si los usuarios pueden descargar el archivo a través del enlace compartido. Esto solo se puede habilitar cuando access = open o company.	Booleano
Preliminar	Indica si los usuarios pueden previsualizar el archivo a través del enlace compartido. Este valor es siempre verdadero. Para los enlaces compartidos de carpetas, esto se aplica a todos los elementos dentro de la carpeta.	Booleano
Tiempo para dejar de compartir	Marca de tiempo opcional que especifica cuándo caducará automáticamente el enlace compartido.	datetime
Nombre personalizado del enlace compartido	Un identificador personalizado y fácil de usar que se utiliza en el vanity_url del enlace compartido.	String

Salida

Parámetro	Descripción	Tipo de datos
Añadir enlace compartido al archivo	El objeto de enlace compartido creado o actualizado para el archivo.	options
ID	El identificador único del archivo.	String
ID de las entradas de la colección de rutas	El ID de cada componente en la jerarquía de la ruta de la carpeta del archivo.	String
Creado por ID	El ID del usuario que creó originalmente el archivo.	String
IDPrincipal	El ID de la carpeta principal que contiene el archivo.	String
Propiedad de ID	El ID del usuario propietario del archivo.	String
Modificado por ID	El ID del usuario que modificó el archivo por última vez.	String
ID de la versión del archivo	El ID de la versión del archivo	String

Nota:

• En los flujos de trabajo de la API, se devuelve un único objeto de respuesta como salida. Cualquier campo obligatorio puede extraerse directamente de este objeto.
• En los flujos de trabajo de RPA, algunos parámetros de salida pueden diferir, pero los valores necesarios pueden recuperarse del objeto de respuesta incluso si no se exponen explícitamente.