Esta página foi traduzida pela API Cloud Translation.

Conetor do Google Drive

O conetor do Google Drive permite-lhe criar e configurar uma ligação ao Google Drive nos Integration Connectors. Pode usar esta ligação nas suas aplicações empresariais para trocar dados em segurança e realizar operações com o Google Drive.

Para ver a lista de entidades e operações suportadas, consulte o artigo Entidades e operações suportadas. Para obter informações sobre as ações específicas do conetor suportadas, consulte o artigo Ações suportadas.

Versões do conector do Google Drive

O conector do Google Drive suporta duas versões:

Google Drive v1: use esta versão do conetor para aceder à API Google Drive v3.
Google Drive v2: use esta versão do conector para aceder à API Google Drive v2.

Para obter informações sobre como criar uma ligação ao Google Drive, consulte o artigo Crie e configure um conetor do Google Drive.

Entidades e operações suportadas

O conector do Google Drive suporta as seguintes entidades e operações:

Entidade	Descrição	Operações
`File`	Representa um ficheiro no Google Drive.	`Get`, `List`, `Create`, `Update` e `Delete`
`Folder`	Representa uma pasta no Google Drive.	`Get`, `List`, `Create`, `Update` e `Delete`
`Permission`	Representa uma autorização para um ficheiro ou uma pasta no Google Drive.	`Get`, `List`, `Create`, `Update` e `Delete`
`Drive`	Representa uma unidade no Google Drive.	`Get`, `List`, `Create`, `Update` e `Delete`

Para ver exemplos de utilização da integração de aplicações, consulte o artigo Exemplos de utilização na integração de aplicações.

Ações suportadas

O conector do Google Drive suporta as seguintes ações:

CopyResource

Descrição: cria uma cópia de um recurso especificado no Google Drive. Pode definir um novo nome para o ficheiro copiado e especificar a respetiva pasta de destino através de uma lista de IDs de pastas principais .

Parâmetros de entrada

Nome do parâmetro	Tipo de dados	Obrigatória	Descrição
`Id`	String	Sim	O ID do recurso a ser copiado.
`NewName`	String	Sim	O novo nome do ficheiro copiado.
`ParentIDs`	String	Não	Uma lista separada por vírgulas de IDs de pastas principais nas quais o ficheiro copiado vai ser colocado. Se não for especificado, o ficheiro é copiado para a mesma pasta onde se encontrava.
`IgnoreDefaultVisibility`	Booleano	Não	Determina se as predefinições de visibilidade do ficheiro criado recentemente devem ser ignoradas. Se o domínio estiver configurado para tornar todos os ficheiros carregados visíveis por predefinição, a definição deste parâmetro como true substitui esse comportamento para este pedido específico. O valor predefinido é false.
`IncludeLabels`	String	Não	Uma lista de IDs de etiquetas separadas por vírgulas a incluir na parte labelInfo da resposta.
`IncludePermissionsForView`	String	Sim	Este campo especifica que autorizações de visualização adicionais incluir na resposta. O valor suportado é publicado.
`KeepRevisionForever`	Booleano	Não	Indica se as revisões do ficheiro devem ser mantidas sempre. Esta funcionalidade aplica-se apenas a ficheiros com conteúdo binário no Google Drive. É possível manter um máximo de 200 revisões para sempre por ficheiro. Se o limite for atingido, tem de eliminar revisões existentes para adicionar novas. O valor predefinido é false.
`OCRLanguage`	String	Não	Este campo fornece uma sugestão de idioma para o OCR (reconhecimento ótico de carateres) ao importar ficheiros de imagem. Especifique o idioma através de um código de idioma ISO 639-1 de duas letras, como `en` para inglês e `de` para alemão.
`SupportsAllDrives`	Booleano	Sim	Este parâmetro indica se as alterações em O meu disco e nos discos partilhados devem ser monitorizadas. Defina este parâmetro como true para ativar o acesso a discos partilhados. O valor predefinido é false.

Parâmetros de saída

Nome do parâmetro	Tipo de dados	Descrição
`CopiedFileID`	String	O ID do ficheiro copiado.
`Success`	String	Este parâmetro indica se a operação foi bem-sucedida ou não.

Exemplo de utilização

O exemplo seguinte mostra como configurar a ação CopyResource na integração de aplicações:

Na caixa de diálogo Configurar tarefa do conetor, clique em Ações.
Selecione a ação CopyResource e, de seguida, clique em Concluído.

Na secção Entrada da tarefa da tarefa Conectores, clique em connectorInputPayload e, de seguida, introduza um valor semelhante ao seguinte no campo Default Value:

        { "Id": "10QIXnPK3DjiLnVL1QvpIsuHPo16zVkYQuJsTVvt_B-c", "NewName": "Copied of Untitles Document.txt1750848165952", "ParentIDs": "1uaAUsRZLLF07KypCDNUBvHn3Xx2lxmo5"}

Se a ação for bem-sucedida, o parâmetro de resposta connectorOutputPayload da tarefa do conector terá um valor semelhante ao seguinte:

        [{"CopiedFileID": "15NUzJGarp-b8TdT0tXBGD9hJMnYjZbiydaE4lbZV0EU", "Success": "TRUE"}]

CreateFolder

Descrição: cria uma nova pasta no Google Drive. Tem de indicar um nome para a nova pasta e especificar a respetiva localização, indicando os IDs das pastas principais. Também pode adicionar uma descrição opcional e marcar a pasta com uma estrela.

Parâmetros de entrada

Nome do parâmetro	Tipo de dados	Obrigatória	Descrição
`Name`	String	Sim	O título da pasta.
`Description`	String	Não	A descrição da pasta.
`Starred`	Booleano	Não	Este parâmetro indica se a pasta tem uma estrela. O valor predefinido é false.
`ParentIds`	String	Sim	Uma lista separada por vírgulas dos IDs das pastas principais nas quais a nova pasta vai ser criada.

Parâmetros de saída

Nome do parâmetro	Tipo de dados	Descrição
`Success`	String	Este parâmetro indica se a operação foi bem-sucedida ou não.
`Id`	String	O ID da nova pasta.

Exemplo de utilização

O exemplo seguinte mostra como configurar a ação CreateFolder na integração de aplicações:

Na caixa de diálogo Configurar tarefa do conetor, clique em Ações.
Selecione a ação CreateFolder e, de seguida, clique em Concluído.
Na secção Entrada da tarefa da tarefa Conetores, clique em connectorInputPayload e, de seguida, introduza um valor semelhante ao seguinte no campo Default Value:
```
        { "Name": "Test Folder", "ParentIds": "1uaAUsRZLLF07KypCDNUBvHn3Xx2lxmo5"}
      
```
Se a ação for bem-sucedida, o parâmetro de resposta connectorOutputPayload da tarefa do conector terá um valor semelhante ao seguinte:
```
        [{"Success": "TRUE", "Id": "10QIXnPK3DjiLnVL1QvpIsuHPo16zVkYQuJsTVvt_B-c"}]
      
```

DeleteResource

Descrição: remove permanentemente um ficheiro ou uma pasta do Google Drive. Para usar esta ação, tem de fornecer o ID exclusivo do recurso que quer eliminar.

Parâmetros de entrada

Nome do parâmetro	Tipo de dados	Obrigatória	Descrição
`Id`	String	Sim	O ID do recurso a eliminar.

Parâmetros de saída

Nome do parâmetro	Tipo de dados	Descrição
`Success`	String	Este parâmetro indica se a operação foi bem-sucedida ou não.

Exemplo de utilização

O exemplo seguinte mostra como configurar a ação DeleteResource na integração de aplicações:

Na caixa de diálogo Configurar tarefa do conetor, clique em Ações.
Selecione a ação DeleteResource e, de seguida, clique em Concluído.
Na secção Entrada da tarefa da tarefa Conectores, clique em connectorInputPayload e, de seguida, introduza um valor semelhante ao seguinte no campo Default Value:
```
        { "Id": "10QIXnPK3DjiLnVL1QvpIsuHPo16zVkYQuJsTVvt_B-c"}
      
```
Se a ação for bem-sucedida, o parâmetro de resposta connectorOutputPayload da tarefa do conector terá um valor semelhante ao seguinte:
```
        [{"Success": "TRUE"}]
      
```

DownloadFile

Descrição: transfere um ficheiro do Google Drive

Parâmetros de entrada

Nome do parâmetro	Tipo de dados	Obrigatória	Descrição
`Id`	String	Sim	O ID do ficheiro a transferir.
`LocalFile`	String	Não	O caminho e o nome do ficheiro onde o ficheiro vai ser guardado. Deixe em branco para armazenar o ficheiro na memória.
`Encoding`	String	Não	O tipo de codificação dos dados do ficheiro. Se LocalFile estiver vazio, os dados do ficheiro são devolvidos na codificação especificada. Os valores permitidos são NONE e BASE64. O valor predefinido é BASE64.
`Overwrite`	Booleano	Não	Este parâmetro determina se o ficheiro deve ser substituído se já existir quando for transferido. O valor predefinido é falso. Defina o parâmetro como TRUE para substituir o ficheiro.
`FileFormat`	String	Não	O formato no qual o ficheiro pode ser transferido. O tamanho máximo do ficheiro pode ser de 10 MB. Deixe este parâmetro em branco para transferir no formato original. Os formatos suportados são DOCX, ODT, RTF, HTML, TXT e PDF.

Parâmetros de saída

Nome do parâmetro	Tipo de dados	Descrição
`FileData`	String	Se LocalFile não for fornecido, os dados do ficheiro são devolvidos através da codificação especificada.
`Success`	String	Este parâmetro indica se a operação foi bem-sucedida ou não.

Exemplo de utilização

O exemplo seguinte mostra como configurar a ação DownloadFile na integração de aplicações:

Na caixa de diálogo Configurar tarefa do conetor, clique em Ações.
Selecione a ação DownloadFile e, de seguida, clique em Concluído.
Na secção Entrada da tarefa da tarefa Conectores, clique em connectorInputPayload e, de seguida, introduza um valor semelhante ao seguinte no campo Default Value:
```
        { "Id": "10QIXnPK3DjiLnVL1QvpIsuHPo16zVkYQuJsTVvt_B-c", "LocalFile": "gs://test-bucket/test-file.txt", "Encoding": "NONE", "Overwrite": true, "FileFormat": "HTML"}
      
```
Se a ação for bem-sucedida, o parâmetro de resposta connectorOutputPayload da tarefa do conector terá um valor semelhante ao seguinte:
```
        [{"FileData": "This is a test file.", "Success": "TRUE"}]
      
```

MoveResource

Descrição: move um ficheiro ou uma pasta para uma localização diferente no Google Drive. Tem de indicar o ID do recurso a mover e os IDs das novas pastas principais.

Parâmetros de entrada

Nome do parâmetro	Tipo de dados	Obrigatória	Descrição
`Id`	String	Sim	O ID do recurso a mover.
`ParentIDs`	String	Sim	Uma lista de IDs separados por vírgulas a usar como pastas principais. Um recurso num disco partilhado tem de ter exatamente uma pasta principal e apenas os utilizadores com a função "organizador de ficheiros" ou "organizador" podem mover ficheiros e pastas num disco partilhado.

Parâmetros de saída

Nome do parâmetro	Tipo de dados	Descrição
`Success`	String	Este parâmetro indica se a operação foi bem-sucedida ou não.

Exemplo de utilização

O exemplo seguinte mostra como configurar a ação MoveResource na integração de aplicações:

Na caixa de diálogo Configurar tarefa do conetor, clique em Ações.
Selecione a ação MoveResource e, de seguida, clique em Concluído.
Na secção Entrada da tarefa da tarefa Conectores, clique em connectorInputPayload e, de seguida, introduza um valor semelhante ao seguinte no campo Default Value:
```
        { "Id": "10QIXnPK3DjiLnVL1QvpIsuHPo16zVkYQuJsTVvt_B-c", "ParentIDs": "1uaAUsRZLLF07KypCDNUBvHn3Xx2lxmo5"}
      
```
Se a ação for bem-sucedida, o parâmetro de resposta connectorOutputPayload da tarefa do conector terá um valor semelhante ao seguinte:
```
        [{"Success": "TRUE"}]
      
```

UpdateResource

Descrição: atualiza os metadados de um ficheiro ou uma pasta no Google Drive. Pode modificar o nome, a descrição, o tipo MIME e se está marcado com uma estrela.

Parâmetros de entrada

Nome do parâmetro	Tipo de dados	Obrigatória	Descrição
`Id`	String	Sim	O ID do recurso a atualizar.
`Name`	String	Sim	O novo nome do ficheiro atualizado.
`Description`	String	Não	Uma descrição do ficheiro ou da pasta.
`MIMEType`	String	Não	O tipo MIME do ficheiro.
`Starred`	String	Não	Este parâmetro indica se o recurso tem uma estrela. O valor predefinido é false.

Parâmetros de saída

Nome do parâmetro	Tipo de dados	Descrição
`Success`	String	Este parâmetro indica se a operação foi bem-sucedida ou não.

Exemplo de utilização

O exemplo seguinte mostra como configurar a ação UpdateResource na integração de aplicações:

Na caixa de diálogo Configurar tarefa do conetor, clique em Ações.
Selecione a ação UpdateResource e, de seguida, clique em Concluído.
Na secção Entrada da tarefa da tarefa Conectores, clique em connectorInputPayload e, de seguida, introduza um valor semelhante ao seguinte no campo Default Value:
```
        { "Id": "10QIXnPK3DjiLnVL1QvpIsuHPo16zVkYQuJsTVvt_B-c", "Name": "New Name", "Description": "New Description", "MIMEType": "application/vnd.google-apps.document", "Starred": true}
      
```
Se a ação for bem-sucedida, o parâmetro de resposta connectorOutputPayload da tarefa do conector terá um valor semelhante ao seguinte:
```
        [{"Success": "TRUE"}]
      
```

UploadFile

Descrição: carrega um ficheiro para o Google Drive. Tem de fornecer os dados do ficheiro e o respetivo tipo MIME. Também pode especificar a pasta principal onde o ficheiro vai ser colocado e um nome de ficheiro para o ficheiro carregado.

Parâmetros de entrada

Nome do parâmetro	Tipo de dados	Obrigatória	Descrição
`Id`	String	Sim	O ID do ficheiro a carregar.
`FileData`	String	Sim	Os dados do ficheiro a carregar.
`MIMEType`	String	Sim	O tipo MIME do ficheiro.
`ParentIDs`	String	Não	Uma lista separada por vírgulas de IDs de pastas principais nas quais o ficheiro carregado será colocado. Se não for especificado, o ficheiro é carregado para a pasta raiz de O meu disco do utilizador.
`Filename`	String	Não	O nome do ficheiro a carregar.

Parâmetros de saída

Nome do parâmetro	Tipo de dados	Descrição
`Success`	String	Este parâmetro indica se a operação foi bem-sucedida ou não.

Exemplo de utilização

O exemplo seguinte mostra como configurar a ação UploadFile na integração de aplicações:

Na caixa de diálogo Configurar tarefa do conetor, clique em Ações.
Selecione a ação UploadFile e, de seguida, clique em Concluído.
Na secção Entrada da tarefa da tarefa Conectores, clique em connectorInputPayload e, de seguida, introduza um valor semelhante ao seguinte no campo Default Value:
```
        { "Id": "10QIXnPK3DjiLnVL1QvpIsuHPo16zVkYQuJsTVvt_B-c", "FileData": "This is a test file.", "MIMEType": "text/plain", "ParentIDs": "1uaAUsRZLLF07KypCDNUBvHn3Xx2lxmo5", "Filename": "test-file.txt"}
      
```
Se a ação for bem-sucedida, o parâmetro de resposta connectorOutputPayload da tarefa do conector terá um valor semelhante ao seguinte:
```
        [{"Success": "TRUE"}]
      
```

SubscribeToFileChanges

Descrição: subscreve notificações de alterações a um ficheiro específico no Google Drive.

Parâmetros de entrada

Nome do parâmetro	Tipo de dados	Obrigatória	Descrição
`Id`	String	Sim	O ID do ficheiro ao qual se quer subscrever.
`Token`	String	Sim	O token a usar para subscrever alterações de ficheiros.

Parâmetros de saída

Nome do parâmetro	Tipo de dados	Descrição
`Success`	String	Este parâmetro indica se a operação foi bem-sucedida ou não.

Exemplo de utilização

O exemplo seguinte mostra como configurar a ação SubscribeToFileChanges na integração de aplicações:

Na caixa de diálogo Configurar tarefa do conetor, clique em Ações.
Selecione a ação SubscribeToFileChanges e, de seguida, clique em Concluído.

Na secção Entrada da tarefa da tarefa Conectores, clique em connectorInputPayload e, de seguida, introduza um valor semelhante ao seguinte no campo Default Value:

        {
          "FileId": "1o-SMcimUT91sfLNf6NoESirH9BsVqvym0YORLo2GAoY",
          "Id": "Id11752060129918",
          "Address": "https://cloudsearch.googleapis.net/notifications",
          "ChannelToken": "token"
        }

Se a ação for bem-sucedida, o parâmetro de resposta connectorOutputPayload da tarefa do conector terá um valor semelhante ao seguinte:

        [
          {
            "Kind": "api#channel",
            "Id": "Id11752060129918",
            "ResourceId": "BfrGPBKDiD1SH1dg6Ng73nLTfl0",
            "ResourceUri": "https://www.googleapis.com/drive/v3/files/1o-SMcimUT91sfLNf6NoESirH9BsVqvym0YORLo2GAoY?alt=json&supportsAllDrives=true",
            "Token": "token",
            "Expiration": "1752063731000"
          }
        ]

SubscribeToUserChanges

Descrição: subscreve notificações de alterações feitas por um utilizador específico no Google Drive.

Parâmetros de entrada

Nome do parâmetro	Tipo de dados	Obrigatória	Descrição
`Id`	String	Sim	O ID do utilizador ao qual se vai subscrever.
`Token`	String	Sim	O token a usar para subscrever alterações do utilizador.

Exemplo de utilização

O exemplo seguinte mostra como configurar a ação SubscribeToUserChanges na integração de aplicações:

Na caixa de diálogo Configurar tarefa do conetor, clique em Ações.
Selecione a ação SubscribeToUserChanges e, de seguida, clique em Concluído.

Na secção Entrada da tarefa da tarefa Conectores, clique em connectorInputPayload e, de seguida, introduza um valor semelhante ao seguinte no campo Default Value:

        {
          "Id": "11752060129918",
          "Address": "https://cloudsearch.googleapis.net/notifications",
          "ChannelToken": "token"
        }

Se a ação for bem-sucedida, o parâmetro de resposta connectorOutputPayload da tarefa do conector terá um valor semelhante ao seguinte:

        [
          {
            "Kind": "api#channel",
            "Id": "Id11752060129918",
            "ResourceId": "BfrGPBKDiD1SH1dg6Ng73nLTfl0",
            "ResourceUri": "https://www.googleapis.com/drive/v3/users/me?alt=json&supportsAllDrives=true",
            "Token": "token",
            "Expiration": "1752063731000"
          }
        ]

StopWatchingResources

Descrição: anula a subscrição de notificações de um recurso visto anteriormente.

Parâmetros de entrada

Nome do parâmetro	Tipo de dados	Obrigatória	Descrição
`Id`	String	Sim	O ID do recurso que vai deixar de ver.
`Token`	String	Sim	O token a usar para parar de ver recursos.

Exemplo de utilização

O exemplo seguinte mostra como configurar a ação StopWatchingResources na integração de aplicações:

Na caixa de diálogo Configurar tarefa do conetor, clique em Ações.
Selecione a ação StopWatchingResources e, de seguida, clique em Concluído.

Na secção Entrada da tarefa da tarefa Conectores, clique em connectorInputPayload e, de seguida, introduza um valor semelhante ao seguinte no campo Default Value:

        {
          "Id": "Id11752060129918",
          "Token": "token"
        }

Se a ação for bem-sucedida, o parâmetro de resposta connectorOutputPayload da tarefa do conector terá um valor semelhante ao seguinte:

        [
          {
            "Kind": "api#channel",
            "Id": "stopid1751971586168",
            "ResourceId": "CXPNGzAnYjqSazkd9-nNTFHTkwo",
            "ResourceUri": "https://www.googleapis.com/drive/v3/files/11OsOCgkV5hsRai6UwpkLngvqnCcrA4sy1tqfPi_VJio?alt=json&supportsAllDrives=true",
            "Token": null,
            "Expiration": "1751975186000"
          }
        ]

Limitações do sistema

O conetor do Google Drive pode processar um máximo de 2 transações de QPS por segundo, por nó e limita todas as transações que excedam este limite. Por predefinição, os Integration Connectors atribuem 2 nós (para uma melhor disponibilidade) a uma ligação.

Para informações sobre os limites aplicáveis aos Integration Connectors, consulte Limites.

Nota: o número de nós de conectores de integração é dimensionado automaticamente de forma dinâmica com base na sua utilização. No entanto, se quiser reservar capacidade para grandes volumes sem esperar pela escalabilidade automática, pode ajustar o valor mínimo de nós para uma ligação. São necessários mais nós para processar mais transações para uma associação. Por outro lado, são necessários menos nós se uma associação processar menos transações. Para configurar os valores dos nós, faça o seguinte:

Se for cliente de pagamento conforme o uso, configure o valor mínimo e máximo do nó na página de edição da associação.
Se for cliente com base numa subscrição, contacte o apoio técnico.

O número máximo de transações que um nó pode processar depende de vários fatores. Assim, antes de ajustar os nós mínimos para um melhor débito, é recomendável verificar se os seus sistemas de back-end estão configurados de forma ideal para processar o tráfego necessário.

O que se segue?

Saiba como criar e configurar uma associação do Google Drive.
Compreenda como suspender e retomar uma associação.
Compreenda como monitorizar a utilização do conector.
Compreenda como ver os registos do conector.

Obtenha ajuda da comunidade do Google Cloud

Pode publicar as suas perguntas e discutir este conector na comunidade do Google Cloud nos Fóruns do Cloud.