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

Os drives compartilhados seguem organizações, compartilhamentos e propriedades diferentes modelos em "Meu Drive". Sendo assim, algumas operações do "Meu Drive" não são permitidas para conteúdo em um drive compartilhado. Este documento descreve diretrizes específicas para cada drive Diferenças de API.

Files Recurso

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

  • hasAugmentedPermissions: se algum usuário tem acesso aos arquivos diretamente neste arquivo.
  • capabilities/canAddFolderFromAnotherDrive: se o usuário atual podem adicionar uma pasta de outro drive (outro drive compartilhado ou "Meu Drive") para: nesta pasta.
  • capabilities/canDeleteChildren: se o usuário atual pode excluir filhos desta pasta.
  • capabilities/canMoveChildrenOutOfDrive: se o usuário atual pode mover os filhos desta pasta para fora do drive compartilhado.
  • capabilities/canMoveChildrenWithinDrive: se o usuário atual pode mover os filhos desta pasta no drive compartilhado.
  • capabilities/canMoveItemWithinDrive: se o usuário atual pode mover este item do drive compartilhado dentro do drive compartilhado.
  • capabilities/canReadDrive: se o usuário atual fez a leitura acesso ao drive compartilhado ao qual o arquivo pertence.
  • capabilities/canTrashChildren: se o usuário atual pode enviar para a lixeira filhos desta pasta.
  • driveId: o ID do drive compartilhado onde o arquivo está localizado.
  • trashingUser: se o arquivo foi explicitamente excluído para a lixeira, o usuário que o moveu para a lixeira.

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

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

  • permissions: devido ao possível tamanho das ACLs e das permissões dos drives compartilhados não são retornados como parte dos arquivos. Use o método permissions.list, compatível com paginação, para listar as permissões para um arquivo em um no drive compartilhado ou no próprio drive compartilhado.
  • owners, ownerNames, ownedByMe: os arquivos em um drive compartilhado são que pertençam ao drive compartilhado, não aos usuários.
  • folderColorRgb: não é possível colorir pastas individualmente
  • shared: todos os itens em um drive compartilhado são compartilhados.
  • writersCanShare — No momento, não é possível restringir o compartilhamento por nos drives compartilhados.

Os campos a seguir só são definidos quando o usuário tem acesso ao arquivo permissões em um item:

  • sharedWithMeDate
  • sharingUser

Os campos a seguir exigem consideração especial quando são usados com drives compartilhados:

  • parents.isRoot: este campo só é verdadeiro para a pasta raiz "Meu Drive". "false" para a pasta de nível superior do drive compartilhado.

  • parents: o pai não aparece na lista de pais se o O usuário solicitante não é participante do drive compartilhado e não tem acesso ao pai. Além disso, com exceção da pasta de nível superior, a lista de pais deve 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. Este campo é uma lista de permissões condensadas que estão ou herdadas por este arquivo do drive compartilhado. Este é um campo somente para saída e só aparece nos itens do drive compartilhado. Além disso:

  • Dois novos papéis de organizer e fileOrganizer foram definidos.
  • permissions.list agora é compatível com paginação.

Changes Recurso

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

  • changeType: o tipo de alteração. Os valores possíveis são file e drive.
  • driveId: o código do drive compartilhado associado a essa alteração.
  • drive: o estado atualizado do drive compartilhado. Presente se o changeType tem drive, e o usuário ainda participa do drive compartilhado.

Outras mudanças podem ser necessárias para apps que precisam ser sincronizados conteúdo com drives compartilhados ou monitorar atividades. Para mais detalhes, consulte controlar as alterações de usuários e drives compartilhados.