Diferencias entre las unidades compartidas y la API de My Drive

Las unidades compartidas siguen diferentes modelos de organización, uso compartido y propiedad de los elementos de Mi unidad. Por lo tanto, algunas operaciones de Mi unidad no están permitidas para el contenido de una unidad compartida. En este documento, se describen las diferencias de API específicas de las unidades compartidas.

recurso Files

Los siguientes campos solo se propagan para los archivos ubicados en una unidad compartida:

  • hasAugmentedPermissions: Indica si se otorga acceso a los archivos a los usuarios directamente en este archivo.
  • capabilities/canAddFolderFromAnotherDrive: Indica si el usuario actual puede agregar una carpeta de otra unidad (o unidad compartida diferente o Mi unidad) a esta carpeta.
  • capabilities/canDeleteChildren: Indica si el usuario actual puede borrar elementos secundarios de esta carpeta.
  • capabilities/canMoveChildrenOutOfDrive: Indica si el usuario actual puede mover los elementos secundarios de esta carpeta fuera de la unidad compartida.
  • capabilities/canMoveChildrenWithinDrive: Indica si el usuario actual puede mover elementos secundarios de esta carpeta dentro de la unidad compartida.
  • capabilities/canMoveItemWithinDrive: Indica si el usuario actual puede mover este elemento de unidad compartida dentro de la unidad compartida.
  • capabilities/canReadDrive: Indica si el usuario actual tiene acceso de lectura a la unidad compartida a la que pertenece este archivo.
  • capabilities/canTrashChildren: Indica si el usuario actual puede enviar a la papelera los elementos secundarios de esta carpeta.
  • driveId: Es el ID de la unidad compartida en la que se encuentra el archivo.
  • trashingUser: Si el archivo se envió a la papelera de manera explícita, el usuario que lo envió a la papelera.

  • trashedTime: Indica la hora a la que se envió el elemento a la papelera.

Los siguientes campos no se propagan para los archivos ubicados en una unidad compartida:

  • permissions: Debido al tamaño potencial de las LCA de las unidades compartidas, los permisos no se muestran como parte de los archivos. Usa el método permissions.list, que admite la paginación, para enumerar los permisos de un archivo dentro de una unidad compartida o de la propia unidad compartida.
  • owners, ownerNames, ownedByMe: Los archivos de una unidad compartida pertenecen a la unidad compartida, no a usuarios individuales.
  • folderColorRgb: Las carpetas no se pueden colorear de forma individual.
  • shared: Se comparten todos los elementos de una unidad compartida.
  • writersCanShare: En este momento, no es posible restringir el uso compartido por función en las unidades compartidas.

Los siguientes campos solo se configuran cuando al usuario se le otorgaron permisos de acceso a archivos en un elemento:

  • sharedWithMeDate
  • sharingUser

Los siguientes campos requieren una consideración especial cuando los usas con unidades compartidas:

  • parents.isRoot: Este campo solo es verdadero para la carpeta raíz de Mi unidad; es falso para la carpeta de nivel superior de la unidad compartida.

  • parents: Un elemento superior no aparece en la lista de elementos superiores si el usuario solicitante no es miembro de la unidad compartida y no tiene acceso a la unidad superior. Además, a excepción de la carpeta de nivel superior, la lista de elementos superiores debe contener exactamente un elemento si el archivo se encuentra dentro de una unidad compartida.

  • capabilities/canRemoveChildren: Usa capabilities/canDeleteChildren o capabilities/canTrashChildren.

recurso Permissions

El campo permissionDetails solo se propaga para los archivos ubicados dentro de una unidad compartida. Este campo es una lista de permisos condensados que este archivo de la unidad compartida hereda o contiene. Este campo es de solo salida y está presente únicamente para los elementos de la unidad compartida. Además:

  • Se definieron dos funciones nuevas de organizer y fileOrganizer.
  • permissions.list ahora admite la paginación.

recurso Changes

Los siguientes campos nuevos están disponibles en el recurso Changes de una unidad compartida:

  • changeType: Es el tipo de cambio. Los valores posibles son file y drive.
  • driveId: Es el ID de la unidad compartida asociada con este cambio.
  • drive: Es el estado actualizado de la unidad compartida. Presente si changeType es drive y el usuario sigue siendo miembro de la unidad compartida.

Es posible que se requieran cambios adicionales para las aplicaciones que necesiten sincronizar contenido con unidades compartidas o realizar un seguimiento de la actividad. Para obtener más detalles, consulta cómo realizar un seguimiento de los cambios para los usuarios y las unidades compartidas.