Diferenças entre o drive compartilhado e a API My Drive

Os drives compartilhados seguem modelos diferentes de organização, compartilhamento e propriedade do Meu Drive. Por isso, algumas operações do Meu Drive não são permitidas para conteúdo em um drive compartilhado. Este documento descreve as diferenças de API específicas do drive compartilhado.

Files Recurso

Os seguintes campos são preenchidos apenas para arquivos em um drive compartilhado:

  • hasAugmentedPermissions: indica se algum usuário recebeu acesso ao arquivo diretamente.
  • capabilities/canAddFolderFromAnotherDrive: indica se o usuário atual pode adicionar uma pasta de outro drive (drive compartilhado diferente ou Meu Drive) a essa pasta.
  • capabilities/canDeleteChildren: indica se o usuário atual pode excluir subpastas dessa pasta.
  • capabilities/canMoveChildrenOutOfDrive: indica se o usuário atual pode mover as crianças dessa pasta para fora do drive compartilhado.
  • capabilities/canMoveChildrenWithinDrive: indica se o usuário atual pode mover as subpastas dessa pasta no drive compartilhado.
  • capabilities/canMoveItemWithinDrive: indica se o usuário atual pode mover esse item do drive compartilhado.
  • capabilities/canReadDrive: indica se o usuário atual tem acesso de leitura ao drive compartilhado ao qual o arquivo pertence.
  • capabilities/canTrashChildren: indica se o usuário atual pode excluir subpastas dessa pasta.
  • driveId: o ID do drive compartilhado em que o arquivo está localizado.
  • trashingUser: se o arquivo foi excluído explicitamente, o usuário que o excluiu.

  • trashedTime: o horário em que o item foi transferido para a lixeira.

Os seguintes campos não são preenchidos para arquivos em um drive compartilhado:

  • permissions: devido ao tamanho potencial das ACLs de drive compartilhado, as permissões não são retornadas como parte dos arquivos. Use o método permissions.list, que oferece suporte à paginação, para listar as permissões de um arquivo em um drive compartilhado ou no próprio drive compartilhado.
  • owners, ownerNames, ownedByMe: os arquivos em um drive compartilhado são de propriedade do drive compartilhado, não de usuários individuais.
  • folderColorRgb: não é possível colorir as pastas individualmente
  • shared: todos os itens em um drive compartilhado são compartilhados.
  • writersCanShare: no momento, não é possível restringir o compartilhamento por função nos drives compartilhados.

Os campos a seguir são definidos apenas quando o usuário recebeu permissões de acesso a arquivos em um item:

  • sharedWithMeDate
  • sharingUser

Os campos a seguir exigem consideração especial quando usados com unidades compartilhadas:

  • parents.isRoot: esse campo é verdadeiro apenas para a pasta raiz do Meu Drive. Ele é falso para a pasta de nível superior do drive compartilhado.

  • parents: um item pai não aparece na lista de itens pais se o usuário solicitante não for um participante do drive compartilhado e não tiver acesso ao item pai. Além disso, com exceção da pasta de nível superior, a lista de pais precisa conter exatamente um item se o arquivo estiver localizado em um drive compartilhado.

  • capabilities/canRemoveChildren: use capabilities/canDeleteChildren ou capabilities/canTrashChildren.

Permissions Recurso

O campo permissionDetails só é preenchido para arquivos localizados em um drive compartilhado. Esse campo é uma lista de permissões condensadas que estão no ou herdadas por este arquivo de drive compartilhado. Esse campo é somente saída e está presente apenas para itens de unidade compartilhada. Além disso:

  • duas novas funções de organizer e fileOrganizer foram definidas.
  • permissions.list agora oferece suporte à paginação.

Changes Recurso

Os seguintes novos campos estão disponíveis no recurso Changes para um drive compartilhado:

  • changeType: o tipo da mudança. Os valores possíveis são file e drive.
  • driveId: o ID do drive compartilhado associado a essa mudança.
  • drive: o estado atualizado do drive compartilhado. Apresente se o changeType for drive e o usuário ainda for participante do drive compartilhado.

Outras mudanças podem ser necessárias para aplicativos que precisam sincronizar conteúdo com unidades compartilhadas ou rastrear atividades. Confira mais detalhes em rastrear mudanças de usuários e drives compartilhados.