Esta página foi traduzida pela API Cloud Translation.

Conector do Google Drive

Com o conector do Google Drive, é possível criar e configurar uma conexão do Google Drive nos Conectores de integração. Você pode usar essa conexão nos seus aplicativos de negócios para trocar dados com segurança e realizar operações com o Google Drive.

Para conferir a lista de entidades e operações compatíveis, consulte Entidades e operações compatíveis. Para informações sobre as ações específicas do conector compatíveis, consulte Ações compatíveis.

Versões do conector do Google Drive

O conector do Google Drive é compatível com duas versões:

Google Drive v1: use esta versão do conector para acessar a API Google Drive v3.
Google Drive v2: use esta versão do conector para acessar a API Google Drive v2.

Para informações sobre como criar uma conexão do Google Drive, consulte Criar e configurar um conector do Google Drive.

Entidades e operações compatíveis

O conector do Google Drive é compatível com as seguintes entidades e operações:

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

Para exemplos de casos de uso da Application Integration, consulte Exemplos de casos de uso na Application Integration.

Ações compatíveis

O conector do Google Drive é compatível com as seguintes ações:

CopyResource

Descrição: cria uma cópia de um recurso especificado no Google Drive. É possível definir um novo nome para o arquivo copiado e especificar a pasta de destino fornecendo uma lista de IDs de pastas principais .

Parâmetros de entrada

Nome do parâmetro	Tipo de dados	Obrigatório	Descrição
`Id`	String	Sim	O ID do recurso a ser copiado.
`NewName`	String	Sim	O novo nome do arquivo copiado.
`ParentIDs`	String	Não	Uma lista separada por vírgulas de IDs de pastas principais em que o arquivo copiado será colocado. Se não for especificado, o arquivo será copiado para a mesma pasta em que estava.
`IgnoreDefaultVisibility`	Booleano	Não	Determina se as configurações de visibilidade padrão do arquivo recém-criado serão ignoradas. Se o domínio estiver configurado para tornar todos os arquivos enviados visíveis por padrão, definir esse parâmetro como "true" vai substituir esse comportamento para essa solicitação específica. O valor padrão é falso.
`IncludeLabels`	String	Não	Uma lista separada por vírgulas de IDs de rótulos a serem incluídos na parte "labelInfo" da resposta.
`IncludePermissionsForView`	String	Sim	Esse campo especifica quais permissões de visualização adicionais incluir na resposta. O valor aceito é publicado.
`KeepRevisionForever`	Booleano	Não	Indica se as revisões do arquivo serão mantidas para sempre. Esse recurso se aplica apenas a arquivos com conteúdo binário no Google Drive. É possível manter no máximo 200 revisões por arquivo para sempre. Se o limite for atingido, exclua as revisões atuais para adicionar novas. O valor padrão é falso.
`OCRLanguage`	String	Não	Esse campo fornece uma dica de idioma para o OCR (reconhecimento óptico de caracteres) ao importar arquivos de imagem. Especifique o idioma usando um código de idioma ISO 639-1 de duas letras, como `en` para inglês e `de` para alemão.
`SupportsAllDrives`	Booleano	Sim	Esse parâmetro indica se as mudanças em "Meu Drive" e nos drives compartilhados devem ser rastreadas. Defina esse parâmetro como "true" para ativar o acesso aos drives compartilhados. O valor padrão é falso.

Parâmetros de saída

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

Exemplo de caso de uso

O exemplo a seguir mostra como configurar a ação CopyResource na Application Integration:

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

Na seção Entrada da tarefa da tarefa Connectors, clique em connectorInputPayload e insira 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 a este:

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

CreateFolder

Descrição: cria uma pasta no Google Drive. Você precisa dar um nome para a nova pasta e especificar o local dela fornecendo os IDs das pastas mãe. Também é possível adicionar uma descrição opcional e marcar a pasta como favorita.

Parâmetros de entrada

Nome do parâmetro	Tipo de dados	Obrigatório	Descrição
`Name`	String	Sim	O título da pasta.
`Description`	String	Não	A descrição da pasta.
`Starred`	Booleano	Não	Esse parâmetro indica se a pasta está marcada com estrela. O valor padrão é falso.
`ParentIds`	String	Sim	Uma lista separada por vírgulas de IDs das pastas principais em que a nova pasta será criada.

Parâmetros de saída

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

Exemplo de caso de uso

O exemplo a seguir mostra como configurar a ação CreateFolder na Application Integration:

Na caixa de diálogo Configurar tarefa do conector, clique em Ações.
Selecione a ação CreateFolder e clique em Concluído.
Na seção Entrada da tarefa da tarefa Connectors, clique em connectorInputPayload e insira 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 a este:
```
        [{"Success": "TRUE", "Id": "10QIXnPK3DjiLnVL1QvpIsuHPo16zVkYQuJsTVvt_B-c"}]
      
```

DeleteResource

Descrição: remove permanentemente um arquivo ou pasta do Google Drive. Para usar essa ação, forneça o ID exclusivo do recurso que você quer excluir.

Parâmetros de entrada

Nome do parâmetro	Tipo de dados	Obrigatório	Descrição
`Id`	String	Sim	O ID do recurso a ser excluído.

Parâmetros de saída

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

Exemplo de caso de uso

O exemplo a seguir mostra como configurar a ação DeleteResource na Application Integration:

Na caixa de diálogo Configurar tarefa do conector, clique em Ações.
Selecione a ação DeleteResource e clique em Concluído.
Na seção Entrada da tarefa da tarefa Connectors, clique em connectorInputPayload e insira 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 a este:
```
        [{"Success": "TRUE"}]
      
```

DownloadFile

Descrição: baixa um arquivo do Google Drive

Parâmetros de entrada

Nome do parâmetro	Tipo de dados	Obrigatório	Descrição
`Id`	String	Sim	O ID do arquivo a ser baixado.
`LocalFile`	String	Não	O caminho e o nome do arquivo em que ele será salvo. Deixe em branco para armazenar o arquivo na memória.
`Encoding`	String	Não	O tipo de codificação dos dados do arquivo. Se LocalFile estiver vazio, os dados do arquivo serão retornados na codificação especificada. Os valores permitidos são NONE e BASE64. O valor padrão é BASE64.
`Overwrite`	Booleano	Não	Esse parâmetro determina se o arquivo será substituído se já existir durante o download. O valor padrão é "false". Defina o parâmetro como "TRUE" para substituir o arquivo.
`FileFormat`	String	Não	O formato em que o arquivo pode ser baixado. O tamanho máximo do arquivo é de 10 MB. Deixe esse parâmetro em branco para fazer o download no formato original. Os formatos aceitos 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 arquivo serão retornados usando a codificação especificada.
`Success`	String	Esse parâmetro indica se a operação foi bem-sucedida ou não.

Exemplo de caso de uso

O exemplo a seguir mostra como configurar a ação DownloadFile na Application Integration:

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

Na seção Entrada da tarefa da tarefa Connectors, clique em connectorInputPayload e insira 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 a este:

        [{"FileData": "This is a test file.", "Success": "TRUE"}]

MoveResource

Description: move um arquivo ou uma pasta para um local diferente no Google Drive. Você precisa fornecer o ID do recurso a ser movido e os IDs das novas pastas principais.

Parâmetros de entrada

Nome do parâmetro	Tipo de dados	Obrigatório	Descrição
`Id`	String	Sim	O ID do recurso a ser movido.
`ParentIDs`	String	Sim	Uma lista separada por vírgulas de IDs a serem usados como pastas principais. Um recurso em um drive compartilhado precisa ter exatamente uma pasta mãe, e somente usuários com a função "organizador de arquivos" ou "organizador" podem mover arquivos e pastas em um drive compartilhado.

Parâmetros de saída

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

Exemplo de caso de uso

O exemplo a seguir mostra como configurar a ação MoveResource na Application Integration:

Na caixa de diálogo Configurar tarefa do conector, clique em Ações.
Selecione a ação MoveResource e clique em Concluído.
Na seção Entrada da tarefa da tarefa Connectors, clique em connectorInputPayload e insira 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 a este:
```
        [{"Success": "TRUE"}]
      
```

UpdateResource

Descrição: atualiza os metadados de um arquivo ou pasta no Google Drive. É possível modificar o nome, a descrição, o tipo MIME e se ele está marcado com estrela.

Parâmetros de entrada

Nome do parâmetro	Tipo de dados	Obrigatório	Descrição
`Id`	String	Sim	O ID do recurso a ser atualizado.
`Name`	String	Sim	O novo nome do arquivo atualizado.
`Description`	String	Não	Uma descrição do arquivo ou da pasta.
`MIMEType`	String	Não	O tipo MIME do arquivo.
`Starred`	String	Não	Esse parâmetro indica se o recurso está marcado com estrela. O valor padrão é falso.

Parâmetros de saída

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

Exemplo de caso de uso

O exemplo a seguir mostra como configurar a ação UpdateResource na Application Integration:

Na caixa de diálogo Configurar tarefa do conector, clique em Ações.
Selecione a ação UpdateResource e clique em Concluído.
Na seção Entrada da tarefa da tarefa Connectors, clique em connectorInputPayload e insira 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 a este:
```
        [{"Success": "TRUE"}]
      
```

UploadFile

Descrição: faz upload de um arquivo para o Google Drive. Você precisa fornecer os dados do arquivo e o tipo MIME. Você também pode especificar a pasta mãe em que o arquivo será colocado e um nome para ele.

Parâmetros de entrada

Nome do parâmetro	Tipo de dados	Obrigatório	Descrição
`Id`	String	Sim	O ID do arquivo a ser enviado por upload.
`FileData`	String	Sim	Os dados do arquivo a serem enviados.
`MIMEType`	String	Sim	O tipo MIME do arquivo.
`ParentIDs`	String	Não	Uma lista separada por vírgulas de IDs de pastas principais em que o arquivo enviado será colocado. Se não for especificado, o arquivo será enviado para a pasta raiz do Meu Drive do usuário.
`Filename`	String	Não	O nome do arquivo a ser enviado.

Parâmetros de saída

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

Exemplo de caso de uso

O exemplo a seguir mostra como configurar a ação UploadFile na Application Integration:

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

Na seção Entrada da tarefa da tarefa Connectors, clique em connectorInputPayload e insira 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 a este:

        [{"Success": "TRUE"}]

SubscribeToFileChanges

Descrição: assina as notificações de mudanças em um arquivo específico no Google Drive.

Parâmetros de entrada

Nome do parâmetro	Tipo de dados	Obrigatório	Descrição
`Id`	String	Sim	O ID do arquivo a ser assinado.
`Token`	String	Sim	O token a ser usado para assinar mudanças no arquivo.

Parâmetros de saída

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

Exemplo de caso de uso

O exemplo a seguir mostra como configurar a ação SubscribeToFileChanges na Application Integration:

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

Na seção Entrada da tarefa da tarefa Connectors, clique em connectorInputPayload e insira 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 a este:

        [
          {
            "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: assina as notificações de mudanças feitas por um usuário específico no Google Drive.

Parâmetros de entrada

Nome do parâmetro	Tipo de dados	Obrigatório	Descrição
`Id`	String	Sim	O ID do usuário a ser inscrito.
`Token`	String	Sim	O token a ser usado para assinar mudanças do usuário.

Exemplo de caso de uso

O exemplo a seguir mostra como configurar a ação SubscribeToUserChanges na Application Integration:

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

Na seção Entrada da tarefa da tarefa Connectors, clique em connectorInputPayload e insira 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 a este:

        [
          {
            "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: cancela sua inscrição para não receber notificações de um recurso assistido anteriormente.

Parâmetros de entrada

Nome do parâmetro	Tipo de dados	Obrigatório	Descrição
`Id`	String	Sim	O ID do recurso que você quer parar de observar.
`Token`	String	Sim	O token a ser usado para interromper a visualização de recursos.

Exemplo de caso de uso

O exemplo a seguir mostra como configurar a ação StopWatchingResources na Application Integration:

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

Na seção Entrada da tarefa da tarefa Connectors, clique em connectorInputPayload e insira 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 a este:

        [
          {
            "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 conector do Google Drive pode processar um máximo de 2 QPS por segundo, por nó, e limita todas as transações além desse limite. Por padrão, o Integration Connectors aloca dois nós (para melhor disponibilidade) para uma conexão.

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

Observação:o número de nós do Integration Connectors será escalonado automaticamente de forma dinâmica com base no seu uso. No entanto, se você quiser reservar capacidade para grandes volumes sem esperar pelo escalonamento automático, ajuste o valor mínimo do nó para uma conexão. Mais nós são necessários para processar mais transações para uma conexão. Por outro lado, menos nós são necessários se uma conexão processar menos transações. Para configurar os valores do nó, faça o seguinte:

Se você for um cliente de pagamento por utilização, configure o valor mínimo e máximo do nó na página de edição da conexão.
Se você for um cliente por assinatura, entre em contato com o suporte.

O número máximo de transações que um nó pode processar depende de vários fatores. Portanto, antes de ajustar o número mínimo de nós para melhorar a capacidade de processamento, recomendamos que você verifique se os sistemas de back-end estão configurados de maneira ideal para lidar com o tráfego necessário.

A seguir

Saiba como criar e configurar uma conexão do Google Drive.
Entenda como suspender e retomar uma conexão.
Entenda como monitorar o uso do conector.
Saiba como ver os registros do conector.

Receber ajuda da comunidade do Google Cloud

Poste suas dúvidas e converse sobre esse conector na comunidade do Google Cloud em Fóruns do Cloud.