Box

O conetor do Box permite-lhe estabelecer ligação a um back-end do Box e usar SQL para obter e atualizar dados do Box.

Versões suportadas

Este conetor suporta a versão 2.0 da API Box Content.

Antes de começar

Antes de usar o conector do Box, faça as seguintes tarefas:

• No seu projeto do Google Cloud:
  • Certifique-se de que a conetividade de rede está configurada. Para obter informações sobre padrões de rede, consulte o artigo Conetividade de rede.
  • Conceda a função IAM roles/connectors.admin ao utilizador que está a configurar o conetor.
  • Conceda as seguintes funções de IAM à conta de serviço que quer usar para o conector:
    • roles/secretmanager.viewer
    • roles/secretmanager.secretAccessor

    Uma conta de serviço é um tipo especial de Conta Google destinada a representar um utilizador não humano que precisa de autenticação e autorização para aceder a dados nas APIs Google. Se não tiver uma conta de serviço, tem de criar uma. O conector e a conta de serviço têm de pertencer ao mesmo projeto. Para mais informações, consulte Criar uma conta de serviço.

  • Ative os seguintes serviços:
    • secretmanager.googleapis.com (Secret Manager API)
    • connectors.googleapis.com (API Connectors)

    Para saber como ativar serviços, consulte o artigo Ativar serviços.

  Se estes serviços ou autorizações não tiverem sido ativados anteriormente para o seu projeto, é-lhe pedido que os ative quando configurar o conector.

Configure o conetor

Uma associação é específica de uma origem de dados. Isto significa que, se tiver muitas origens de dados, tem de criar uma associação separada para cada origem de dados. Para criar uma associação, faça o seguinte:

1. Na Cloud Console, aceda à página Integration Connectors > Ligações e, de seguida, selecione ou crie um projeto do Google Cloud.

   Aceda à página Ligações

2. Clique em + CRIAR NOVO para abrir a página Criar associação.
3. Na secção Localização, escolha a localização para a ligação.
   1. Região: selecione uma localização na lista pendente.

      Para ver a lista de todas as regiões suportadas, consulte o artigo Localizações.

   2. Clique em SEGUINTE.
4. Na secção Detalhes da associação, conclua o seguinte:
   1. Conector: selecione Box na lista pendente de conectores disponíveis.
   2. Versão do conetor: selecione a versão do conetor na lista pendente de versões disponíveis.
   3. No campo Nome da ligação, introduza um nome para a instância de ligação.

      Os nomes das associações têm de cumprir os seguintes critérios:

      • Os nomes das associações podem usar letras, números ou hífenes.
      • As letras têm de ser minúsculas.
      • Os nomes das associações têm de começar com uma letra e terminar com uma letra ou um número.
      • Os nomes das associações não podem exceder 49 carateres.
   4. Opcionalmente, introduza uma Descrição para a instância de associação.
   5. Opcionalmente, ative o Registo na nuvem e, em seguida, selecione um nível de registo. Por predefinição, o nível do registo está definido como Error.
   6. Conta de serviço: selecione uma conta de serviço que tenha as funções necessárias.
   7. Opcionalmente, configure as definições do nó de associação:
      • Número mínimo de nós: introduza o número mínimo de nós de ligação.
      • Número máximo de nós: introduza o número máximo de nós de ligação.

      Um nó é uma unidade (ou uma réplica) de uma ligação que processa transações. São necessários mais nós para processar mais transações para uma ligação e, inversamente, são necessários menos nós para processar menos transações. Para compreender como os nós afetam os preços dos conectores, consulte o artigo Preços dos nós de ligação. Se não introduzir valores, por predefinição, os nós mínimos são definidos como 2 (para uma melhor disponibilidade) e os nós máximos são definidos como 50.

   Nota: só pode personalizar os valores dos nós de associação se for cliente de pagamento conforme o uso.
   8. Modo de assumir a identidade do utilizador: especifique o tipo de função de assumir a identidade do utilizador. Deve ser o modo de utilizador ou o modo de administrador.
   9. (Opcional) Na secção Definições avançadas, selecione a caixa de verificação Usar proxy para configurar um servidor proxy para a ligação e configurar os seguintes valores:
   • Esquema de autenticação de proxy: selecione o tipo de autenticação para autenticar com o servidor proxy. Os seguintes tipos de autenticação são suportados:
     • Básica: autenticação HTTP básica.
     • Resumo: autenticação HTTP de resumo.
   • Utilizador do proxy: um nome de utilizador a ser usado para autenticação com o servidor proxy.
   • Palavra-passe do proxy: o segredo do Secret Manager da palavra-passe do utilizador.
   • Tipo de SSL do proxy: o tipo de SSL a usar quando se liga ao servidor proxy. Os seguintes tipos de autenticação são suportados:
     • Automático: predefinição. Se o URL for um URL HTTPS, é usada a opção Túnel. Se o URL for um URL HTTP, é usada a opção NUNCA.
     • Sempre: a ligação está sempre ativada com SSL.
     • Nunca: a ligação não tem o SSL ativado.
     • Túnel: a ligação é feita através de um proxy de túnel. O servidor proxy abre uma ligação ao anfitrião remoto e o tráfego flui em ambas as direções através do proxy.
   • Na secção Servidor proxy, introduza os detalhes do servidor proxy.
     1. Clique em + Adicionar destino.
     2. Selecione um Tipo de destino.
        • Endereço do anfitrião: especifique o nome do anfitrião ou o endereço IP do destino.

          Se quiser estabelecer uma ligação privada ao seu sistema de back-end, faça o seguinte:

          • Crie uma associação de serviço do PSC.
          • Crie uma associação de ponto final e, em seguida, introduza os detalhes da associação de ponto final no campo Endereço do anfitrião.
   10. Opcionalmente, clique em + ADICIONAR ETIQUETA para adicionar uma etiqueta à associação sob a forma de um par chave/valor.
   11. Clique em SEGUINTE.
5. Na secção Autenticação, introduza os detalhes de autenticação.
   1. Selecione um Tipo de autenticação e introduza os detalhes relevantes.

      Os seguintes tipos de autenticação são suportados pela ligação do Box:

      • Autenticação JWT
      • OAuth 2.0 – Código de autorização
      • JSON da caixa
      • OAuth 2.0 – Credenciais de cliente

   Para saber como configurar estes tipos de autenticação, consulte o artigo Configurar autenticação.

   2. Clique em SEGUINTE.
6. Rever: reveja os detalhes da ligação e da autenticação.
7. Clique em Criar.

Configure a autenticação

Introduza os detalhes com base na autenticação que quer usar.

• Autenticação JWT
  • ID de cliente: o ID de cliente fornecido pela Box para a app que criou.
  • Segredo do cliente: segredo do Secret Manager que contém o segredo do cliente para a app que criou.
  • Versão do Secret: a versão do segredo do cliente.
  • Chave privada: segredo do Secret Manager que contém o conteúdo do ficheiro de chave privada. A chave privada deve corresponder à chave pública/certificado fornecido ao conector.
  • Versão do Secret: a versão do Secret da chave privada.
  • Palavra-passe da chave privada: o segredo do Secret Manager que contém a palavra-passe (frase de acesso) do ficheiro de chave privada.
  • Versão do segredo: a versão da palavra-passe da chave privada.
  • Nível de acesso da aplicação Box: o nível de acesso da aplicação para a app Box.
  • ID da empresa/ID do utilizador: ID da empresa se o nível da app for empresarial e ID do utilizador se o nível da app for de utilizador
  • ID da chave pública JWT do OAuth: o ID da chave pública para JWT.
  • Esquema de autorização: esquema de autorização para o conector do Box.
  • Iniciar OAuth: inicie o parâmetro OAuth para o conector do Box.
  • Tipo de certificado JWT OAuth: o tipo de certificado JWT OAuth para o conetor do Box.
• OAuth 2.0 – Código de autorização
• ID de cliente: o ID de cliente fornecido pela Box para a app que criou.
• Âmbitos: âmbitos de autorização. Por exemplo, root_readonly. Para compreender como funcionam os âmbitos e ver todos os âmbitos disponíveis para o Box, consulte Âmbitos.
• Segredo do cliente: selecione o segredo do Secret Manager. Antes de configurar esta autorização, tem de criar o Secret do Secret Manager.
• Versão do Secret: versão do Secret do Secret Manager para o segredo do cliente.
• JSON da caixa
  • JSON da caixa para autenticação JWT: o segredo que contém o conteúdo do ficheiro JSON fornecido pela caixa.
  • Versão do Secret: a versão do Secret do ficheiro JSON.
• OAuth 2.0 – Credenciais de cliente
  • ID de cliente OAuth: o ID de cliente fornecido pela Box para a app que criou.
  • Segredo do cliente: segredo do Secret Manager que contém o segredo do cliente para a app que criou.
  • Versão do Secret: a versão do segredo do cliente.
  • ID do assunto: o assunto do utilizador para o qual a aplicação está a pedir acesso delegado.
  • Nível de acesso da aplicação Box: o nível de acesso da aplicação para a app Box.

Para o tipo de autenticação Authorization code, depois de criar a associação, tem de efetuar alguns passos adicionais para configurar a autenticação. Para mais informações, consulte Passos adicionais após a criação da associação.

Nota: se estiver a usar o tipo de autenticação Authorization code e tiver feito alterações de configuração na sua aplicação Box, tem de voltar a autorizar a ligação ao Box. Para saber como autorizar novamente, consulte o artigo Autorização novamente para o código de autorização.

Exemplos de configuração de ligação

Nota: antes de criar uma associação do Box, tem de criar uma conta do Box. Para mais informações, consulte Crie uma conta do Box. Depois de criar uma conta do Box, pode criar uma aplicação na conta do Box e, em seguida, usar os parâmetros na associação. Para mais informações, consulte o artigo Crie a sua primeira aplicação OAuth.

Esta secção apresenta os valores de exemplo dos vários campos que configura quando cria a associação.

Tipo de ligação do método de token JWT OAuth

Nome do campo	Detalhes
Localização	us-central1
Conetor	Box
Versão do conetor	1
Nome da ligação	box-conn
Ative o Cloud Logging	sim
Conta de serviço	XXXX@serviceaccount
Modo de assumir a identidade do utilizador	Utilizador
Número mínimo de nós	2
Número máximo de nós	2
Autenticação	Autenticação JWT
ID do cliente	XXXX
Segredo do cliente	XXXX
Versão do secret	1
Chave privada	XXXX
Versão do secret	1
Palavra-passe da chave privada	XXXX
Versão do secret	1
Nível de acesso da aplicação Box	Empresarial
ID de empresa/ID do utilizador	XXXX
ID da chave pública JWT OAuth	XXXX
Esquema de autenticação	OAuthJWT
Inicie o OAuth	GETANDREFRESH
Tipo de certificado JWT OAuth	PEMKEY_BLOB

Pode aceder ao ID de cliente, ao segredo do cliente, ao nível de acesso da aplicação Box e ao ID da empresa/ID do utilizador a partir da conta do Box.

Pode aceder à chave privada e à palavra-passe da chave privada a partir do ficheiro Private keypair.json que transferiu. Para mais informações, consulte o artigo Informações sobre o par de chaves públicas e privadas. Além disso, antes de transmitir a palavra-passe da chave privada, substitua o \n no ficheiro json por uma nova linha.

Tipo de ligação de código de autorização OAuth

Nome do campo	Detalhes
Localização	us-central1
Conetor	Box
Versão do conetor	1
Nome da ligação	box-conn
Ative o Cloud Logging	sim
Conta de serviço	XXXX@serviceaccount
Modo de assumir a identidade do utilizador	Utilizador
Autorização	OAuth 2.0 – Código de autorização
Número mínimo de nós	2
Número máximo de nós	2
ID do cliente	XXXX
Âmbitos	root_readwrite
Segredo do cliente	XXXX
Versão do secret	1

Para ver informações sobre a configuração de OAuth do Box, consulte o artigo Crie a sua aplicação OAuth.

JSON do Box para o tipo de ligação do método de autenticação JWT

Nome do campo	Detalhes
Localização	us-central1
Conetor	Box
Versão do conetor	1
Nome da ligação	gcp-box-conn-new
Ative o Cloud Logging	sim
Conta de serviço	XXXX@serviceaccount
Modo de assumir a identidade do utilizador	Utilizador
Como ID do utilizador	XXXX
Número mínimo de nós	2
Número máximo de nós	2
Autenticação	JSON da caixa
JSON da caixa para autenticação JWT	XXXX
Versão do secret	1

Pode usar a conta do Box para configurar o JSON do Box para a autenticação JWT. Para obter informações sobre como configurar o JSON da caixa para JWT, consulte os passos de criação do token JWT

Aceda ao JSON da caixa para o valor de autorização JWT a partir do ficheiro Private keypair.json que transferiu. Para mais informações, consulte o artigo Informações sobre o par de chaves públicas e privadas. Tem de transmitir o conteúdo completo do ficheiro .json no campo JSON da caixa para autenticação JWT.

Tipo de ligação de credenciais do cliente OAuth

Nome do campo	Detalhes
Localização	us-central1
Conetor	Box
Versão do conetor	1
Nome da ligação	oauth-clientcred-conn
Ative o Cloud Logging	sim
Conta de serviço	XXXX@serviceaccount
Modo de assumir a identidade do utilizador	Utilizador
Como ID do utilizador	XXXX
Número mínimo de nós	2
Número máximo de nós	2
Autenticação	Credenciais do cliente OAuth
ID de cliente OAuth	XXXX
Segredo do cliente OAuth	XXXX
Versão do secret	1
ID do assunto	XXXX
Nível de acesso da aplicação Box	empresarial

Pode aceder ao ID de cliente, ao segredo do cliente, ao nível de acesso da aplicação Box e ao ID da empresa/ID do utilizador a partir da conta do Box.

Nova autorização para o código de autorização

Se estiver a usar o tipo de autenticação Authorization code e tiver feito alterações de configuração na sua aplicação Box, tem de voltar a autorizar a ligação do Box. Para autorizar novamente uma associação, siga estes passos:

1. Clique na associação necessária na página Associações.

   É apresentada a página de detalhes da associação.

2. Clique em Editar para editar os detalhes da associação.
3. Valide os detalhes de OAuth 2.0 – Código de autorização na secção Autenticação.

   Se necessário, faça as alterações necessárias.

4. Clique em Guardar. Esta ação direciona para a página de detalhes da associação.
5. Clique em Editar autorização na secção Autenticação. É apresentado o painel Autorizar.
6. Clique em Autorizar.

   Se a autorização for bem-sucedida, o estado da ligação é definido como Ativo na página Ligações.

Passos adicionais após a criação da associação

Se selecionou OAuth 2.0 - Authorization code para a autenticação, tem de realizar os seguintes passos adicionais após criar a associação:

1. Na página Ligações, encontre a ligação criada recentemente.

   Tenha em atenção que o Estado do novo conetor é Autorização necessária.

2. Clique em Autorização obrigatória.

   É apresentado o painel Editar autorização.

3. Copie o valor do URI de redirecionamento para a sua aplicação externa.
4. Valide os detalhes da autorização.
5. Clique em Autorizar.

   Se a autorização for bem-sucedida, o estado da ligação é definido como Ativo na página Ligações.

Entidades, operações e ações

Todos os conetores de integração oferecem uma camada de abstração para os objetos da aplicação ligada. Só pode aceder aos objetos de uma aplicação através desta abstração. A abstração é exposta como entidades, operações e ações.

Nota: pode ver as entidades, as operações e as ações de um conector na tarefa Conectores.

• Entidade: pode considerar uma entidade como um objeto ou uma coleção de propriedades na aplicação ou no serviço associado. A definição de uma entidade difere de um conetor para um conetor. Por exemplo, num conetor de base de dados, as tabelas são as entidades. Num conetor de servidor de ficheiros, as pastas são as entidades. Num conetor de sistema de mensagens, as filas são as entidades.

  No entanto, é possível que um conector não suporte ou não tenha entidades, caso em que a lista Entities estará vazia.

• Operação: uma operação é a atividade que pode realizar numa entidade. Pode realizar qualquer uma das seguintes operações numa entidade:
  • Lista
  • Obter
  • Criar
  • Atualizar
  • Eliminar

  Selecionar uma entidade na lista disponível gera uma lista de operações disponíveis para a entidade. Para uma descrição detalhada das operações, consulte as operações de entidades da tarefa de conectores. No entanto, se um conector não suportar nenhuma das operações de entidades, essas operações não suportadas não são apresentadas na lista Operations.

• Ação: uma ação é uma função de primeira classe que é disponibilizada à integração através da interface do conetor. Uma ação permite-lhe fazer alterações a uma ou mais entidades e varia de conetor para conetor. Normalmente, uma ação tem alguns parâmetros de entrada e um parâmetro de saída. No entanto, é possível que um conector não suporte nenhuma ação, caso em que a lista Actions está vazia.

Nota: todas as entidades e ações têm um esquema associado. Por exemplo, um esquema de ação tem os detalhes dos parâmetros, como os nomes dos parâmetros e o respetivo tipo de dados. O esquema (metadados) para entidades e ações é obtido pela ligação em tempo de execução a partir do seu back-end. Se existirem atualizações ao esquema, estas não são refletidas automaticamente nas suas associações existentes. Tem de atualizar o esquema manualmente. Para atualizar o esquema de uma associação, abra a página Detalhes da associação da associação e, de seguida, clique em Atualizar esquema da associação.

Ações

Esta secção apresenta todas as ações suportadas pela ligação do Box.

Ação DownloadFile

Esta ação permite-lhe transferir um ficheiro da sua instância do Box.

Introduza os parâmetros da ação DownloadFile

Nome do parâmetro	Tipo de dados	Obrigatória	Descrição
FileID	String	Sim	O ID do ficheiro a transferir.
HasBytes	Booleano	Sim	Especifica se o ficheiro deve ser transferido como uma string ou como uma string codificada em Base64.

Parâmetros de saída da ação DownloadFile

Esta ação devolve o estado 200 (OK) com um corpo de resposta que indica os resultados.

Nome do parâmetro	Tipo de dados	Descrição
Concluído	String	Especifica se a transferência do ficheiro foi bem-sucedida.
ContentBytes	String	O conteúdo do ficheiro como uma string codificada em Base64.

Por exemplo, para saber como configurar a ação DownloadFile, consulte os exemplos de ações.

Ação UploadFile

Esta ação permite-lhe carregar um ficheiro para a sua instância do Box.

Parâmetros de entrada da ação UploadFile

Nome do parâmetro	Tipo de dados	Obrigatória	Descrição
ParentID	String	Sim	ID da pasta na qual quer carregar o ficheiro. Se este parâmetro não for especificado, o ficheiro é carregado para a raiz da conta do Box. O valor predefinido é 0.
Conteúdo	String	Sim	O conteúdo do ficheiro a carregar.

Parâmetros de saída da ação UploadFile

Esta ação devolve o estado 200 (OK) com um corpo de resposta que indica os resultados.

Nome do parâmetro	Tipo de dados	Descrição
Concluído	String	Especifica se o carregamento do ficheiro foi bem-sucedido.
ID	String	ID do ficheiro criado recentemente.
VersionID	String	ID de uma versão específica do ficheiro.
Hash	String	O hash SHA1 do ficheiro.
Etag	String	Valor Etag do ficheiro ou da pasta. O valor predefinido é 0.

Por exemplo, para saber como configurar a ação UploadFile, consulte os exemplos de ações.

Ação CopyFile

Esta ação permite-lhe copiar um ficheiro da sua instância do Box.

Introduza os parâmetros da ação CopyFile

Nome do parâmetro	Tipo de dados	Obrigatória	Descrição
FileID	String	Sim	ID do ficheiro que quer copiar.
DestinationFolderId	String	Não	ID da pasta de destino para a qual quer copiar o ficheiro. Se não especificar nenhum valor, é copiada a versão mais recente do ficheiro.
NewName	String	Sim	Novo nome de ficheiro para o ficheiro copiado.

Parâmetros de saída da ação CopyFile

Esta ação devolve o estado 200 (OK) com um corpo de resposta que indica os resultados.

Nome do parâmetro	Tipo de dados	Descrição
Concluído	String	Especifica se a cópia do ficheiro foi bem-sucedida.
ID	String	ID do ficheiro copiado.

Por exemplo, para saber como configurar a ação CopyFile, consulte os exemplos de ações.

Ação CopyFolder

Esta ação permite-lhe copiar uma pasta inteira da sua instância do Box.

Parâmetros de entrada da ação CopyFolder

Nome do parâmetro	Tipo de dados	Obrigatória	Descrição
FolderID	String	Sim	ID da pasta que quer copiar.
DestinationFolderId	String	Sim	ID da pasta de destino para onde quer copiar a pasta.
NewName	String	Não	Novo nome do ficheiro para a pasta copiada.

Parâmetros de saída da ação CopyFolder

Esta ação devolve o estado 200 (OK) com um corpo de resposta que indica os resultados.

Nome do parâmetro	Tipo de dados	Descrição
Concluído	String	Especifica se a cópia da pasta foi bem-sucedida.
ID	String	ID da pasta copiada.

Por exemplo, para saber como configurar a ação CopyFolder, consulte os exemplos de ações.

Exemplos de ações

Esta secção descreve como realizar algumas das ações neste conector.

Exemplo: transferir um ficheiro

1. Na caixa de diálogo Configure connector task, clique em Actions.
2. Selecione a ação DownloadFile e, de seguida, clique em Concluído.
3. 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:

   {
   "FileID": "1283194869422", 
   "HasBytes": true
   }

Este exemplo transfere um ficheiro como uma string codificada em Base64. Se a ação for bem-sucedida, o parâmetro de resposta da tarefa do conector tem um valor semelhante ao seguinte:connectorOutputPayload

[
{ "Success": "True"},
{"ContentBytes": "JVBERi0xLjQKJcfl9OXwCjIgMCBvYmoKJSBbMjRdIAo8PAovRmlsdGVy"}
]

Nota: se quiser transferir um ficheiro não binário, defina o valor de HasBytes como false.

Exemplo: carregar um ficheiro

1. Na caixa de diálogo Configure connector task, clique em Actions.
2. Selecione a ação UploadFile e, de seguida, clique em Concluído.
3. 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:

   {
   "ParentId": "0",
   "Content": "12345"
   }

Este exemplo carrega conteúdo de string como um ficheiro. Se a ação for bem-sucedida, o parâmetro de resposta da tarefa do conector tem um valor semelhante ao seguinte:connectorOutputPayload

[{
"Success": "true",
"ID": "1283902965389",
"VersionID": "1403546001389",
"Hash": "8cb2237d0679ca88db6464eac60da96345513964",
"Etag": "0"
}]

Exemplo: copie um ficheiro

1. Na caixa de diálogo Configure connector task, clique em Actions.
2. Selecione a ação CopyFile e, de seguida, clique em Concluído.
3. 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": "1288751886061",
   "DestinationFolderId": "219105724517", 
   "NewName": "NewCopiedFile"
   }

Este exemplo copia o ficheiro com o ID 1288751886061 para a pasta com o ID 219105724517. Se a ação for bem-sucedida, o parâmetro de resposta da tarefa do conector tem um valor semelhante ao seguinte:connectorOutputPayload

[{
"Success": "true",
"ID": "1308006018536"
}]

Exemplo: copie uma pasta

1. Na caixa de diálogo Configure connector task, clique em Actions.
2. Selecione a ação CopyFolder e, de seguida, clique em Concluído.
3. 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:

   {
   "FolderID": "218475301279",
   "DestinationFolderId": "0", 
   "NewName": "NewCopiedFolder"
   }

Este exemplo copia a pasta com o ID 218475301279 para a pasta com o ID 219105724517. Se a ação for bem-sucedida, o parâmetro de resposta da tarefa do conector tem um valor semelhante ao seguinte:connectorOutputPayload

[{
"Success": "true",
"ID": "226312444517"
}]

Exemplos de operações de entidades

Exemplo: listar todos os ficheiros

1. Na caixa de diálogo Configure connector task, clique em Entities.
2. Selecione Ficheiros na Entity lista.
3. Selecione a operação LIST e, de seguida, clique em Concluído.

Pode realizar a operação LIST nas seguintes entidades: Folders, TrashedItems, SharedItems, Collaborations, TaskAssignments e Tasks

Exemplo: obtenha os ficheiros

1. Na caixa de diálogo Configure connector task, clique em Entities.
2. Selecione Ficheiros na lista Entity.
3. Selecione a operação GET e, de seguida, clique em Concluído.
4. Defina o ID da entidade como 1262397830475, que é a chave a ser transmitida. Para definir o ID da entidade, na secção Entrada da tarefa da tarefa Conetores, clique em EntityId e, em seguida, introduza 1262397830475 no campo Valor predefinido.

O valor do ID da entidade tem de ser transmitido diretamente, como 1262397830475. Em que 1262397830475 é o valor da chave principal exclusivo.

Pode executar a operação GET nas seguintes entidades: Folders, SharedItems, Collaborations, TaskAssignments e Tasks

Exemplo: eliminar ficheiros

1. Na caixa de diálogo Configure connector task, clique em Entities.
2. Selecione Ficheiros na lista Entity.
3. Selecione a operação DELETE e, de seguida, clique em Concluído.
4. Defina o ID da entidade como 1258725940971, que é a chave a ser transmitida. Para definir o ID da entidade, na secção Entrada da tarefa da tarefa Conetores, clique em EntityId e, em seguida, introduza 1258725940971 no campo Valor predefinido.

   Em alternativa, se a entidade tiver duas chaves empresariais ou primárias compostas em vez de especificar o entityId, também pode definir o filterClause como Id='1258725940971'.

Pode executar a operação DELETE nas seguintes entidades: Folders, Tasks, Collaborations, SharedItems e TaskAssignments

Exemplo: criar pastas

1. Na caixa de diálogo Configure connector task, clique em Entities.
2. Selecione Pastas na lista Entity.
3. Selecione a operação Create e, de seguida, clique em Concluído.
4. 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": "Google Cloud Platforms_created_folders",
   "ParentId": "0"
   }

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

    
   {
   "Id": "222269371053"
   } 

Exemplo: crie colaborações

1. Na caixa de diálogo Configure connector task, clique em Entities.
2. Selecione Colaborações na lista Entity.
3. Selecione a operação Create e, de seguida, clique em Concluído.
4. 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:

   {
   "ItemId": "216592737829",
   "ItemType": "folder",
   "AccessibleById": "27370766275",
   "AccessibleByType": "user",
   "AccessibleByLogin": "[e-mail]",
   "Role": "editor"
   }

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

   {
   "Success": false
   } 

Exemplo: criar tarefas

1. Na caixa de diálogo Configure connector task, clique em Entities.
2. Selecione Tasks na lista Entity.
3. Selecione a operação Create e, de seguida, clique em Concluído.
4. 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:

   {
   "ItemId": "1253997361112",
   "ItemType": "file",
   "Action": "review",
   "Message": "Creating a task from Google Cloud Platform",
   "DueAt": "2023-12-12 09:01:15.0",
   "CompletionRule": "all_assignees"
   }

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

    
   {
   "Id": "1253997361112"
   }

Exemplo: criar atribuições de tarefas

1. Na caixa de diálogo Configure connector task, clique em Entities.
2. Selecione TaskAssignments na lista Entity.
3. Selecione a operação Create e, de seguida, clique em Concluído.
4. 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:

   {
   "TaskId": "21507516872",
   "AssignedToId": "27370766275"
   }

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

    
   {
   "Id": "50804351753"
   }

Exemplo: atualizar ficheiros

1. Na caixa de diálogo Configure connector task, clique em Entities.
2. Selecione Ficheiros na lista Entity.
3. Selecione a operação Update e, de seguida, clique em Concluído.
4. 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": "Get Started with Box Files.pdf"
   }

5. Defina o ID da entidade como 1253997361112. Para definir o ID da entidade, clique em entityId e, de seguida, introduza 1253997361112 no campo Valor predefinido.

   Em alternativa, em vez de especificar o entityId, também pode definir o filterClause como 1253997361112.

   A execução deste exemplo devolve uma resposta semelhante à seguinte na variável de saída connectorOutputPayload da tarefa Connector:

   {
   "Id": "1253997361112"
   }

Pode executar a operação UPDATE nas seguintes entidades: Folders, Tasks, Collaborations, SharedItems e TaskAssignments

Exemplo: atualizar pastas

1. Na caixa de diálogo Configure connector task, clique em Entities.
2. Selecione Pastas na lista Entity.
3. Selecione a operação Update e, de seguida, clique em Concluído.
4. 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": "Demo Update"
   }

5. Defina o ID da entidade como 216457668125. Para definir o ID da entidade, clique em entityId e, de seguida, introduza 216457668125 no campo Valor predefinido.

   Em alternativa, em vez de especificar o entityId, também pode definir o filterClause como 216457668125.

   A execução deste exemplo devolve uma resposta semelhante à seguinte na variável de saída connectorOutputPayload da tarefa Connector:

   {
   "Id": "216457668125"
   } 

Exemplo: atualize colaborações

1. Na caixa de diálogo Configure connector task, clique em Entities.
2. Selecione Colaborações na lista Entity.
3. Selecione a operação Update e, de seguida, clique em Concluído.
4. 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:

   {
   "Role": "Viewer"
   }

5. Defina o ID da entidade como 46685648757. Para definir o ID da entidade, clique em entityId e, de seguida, introduza 46685648757 no campo Valor predefinido.

   Em alternativa, em vez de especificar o entityId, também pode definir o filterClause como 46685648757.

   A execução deste exemplo devolve uma resposta semelhante à seguinte na variável de saída connectorOutputPayload da tarefa Connector:

   {
   
   }

Exemplo: atualizar tarefas

1. Na caixa de diálogo Configure connector task, clique em Entities.
2. Selecione Tasks na lista Entity.
3. Selecione a operação Update e, de seguida, clique em Concluído.
4. 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:

   {
   "Message": "This is a new task is updated and assigned to you by me"
   }

5. Defina o ID da entidade como 21507516872. Para definir o ID da entidade, clique em entityId e, de seguida, introduza 21507516872 no campo Valor predefinido.

   Em alternativa, em vez de especificar o entityId, também pode definir o filterClause como 21507516872.

   A execução deste exemplo devolve uma resposta semelhante à seguinte na variável de saída connectorOutputPayload da tarefa Connector:

   {
   "Id": "21507516872"
   }

Exemplo: atualizar taskassignments

1. Na caixa de diálogo Configure connector task, clique em Entities.
2. Selecione TaskAssignments na lista Entity.
3. Selecione a operação Update e, de seguida, clique em Concluído.
4. 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:

   {
   "Message": "Looks good to me",
   "ResolutionState": "completed"
   }

5. Defina o ID da entidade como 49542929469. Para definir o ID da entidade, clique em entityId e, de seguida, introduza 49542929469 no campo Valor predefinido.

   Em alternativa, em vez de especificar o entityId, também pode definir o filterClause como 49542929469.

   A execução deste exemplo devolve uma resposta semelhante à seguinte na variável de saída connectorOutputPayload da tarefa Connector:

   {
   "Id": "49542929469"
   } 

Exemplo: atualizar Transferfolders

1. Na caixa de diálogo Configure connector task, clique em Entities.
2. Selecione Pastas na lista Entity.
3. Selecione a operação Update e, de seguida, clique em Concluído.
4. 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": "Demo Update"
   "ParentId": "216596059374"
   }

5. Defina o ID da entidade como 216457668125. Para definir o ID da entidade, clique em entityId e, de seguida, introduza 216457668125 no campo Valor predefinido.

   A execução deste exemplo devolve uma resposta semelhante à seguinte na variável de saída connectorOutputPayload da tarefa Connector:

   {
   "Id": "216457668125"
   }

Crie ligações com o Terraform

Pode usar o recurso do Terraform para criar uma nova associação.

Para saber como aplicar ou remover uma configuração do Terraform, consulte os comandos básicos do Terraform.

Para ver um modelo do Terraform de exemplo para a criação de ligações, consulte o modelo de exemplo.

Quando criar esta associação através do Terraform, tem de definir as seguintes variáveis no ficheiro de configuração do Terraform:

Nome do parâmetro	Tipo de dados	Obrigatória	Descrição
impersonate_user_mode	ENUM	True	Especifique o tipo de roubo de identidade do utilizador. Deve ser o modo de utilizador ou o modo de administrador. Os valores suportados são: User, Admin
proxy_enabled	BOOLEAN	Falso	Selecione esta caixa de verificação para configurar um servidor proxy para a ligação.
proxy_auth_scheme	ENUM	Falso	O tipo de autenticação a usar para autenticar no proxy ProxyServer. Os valores suportados são: BASIC, DIGEST, NONE
proxy_user	STRING	Falso	Um nome de utilizador a ser usado para autenticar no proxy ProxyServer.
proxy_password	SECRET	Falso	Uma palavra-passe a usar para autenticar no proxy ProxyServer.
proxy_ssltype	ENUM	Falso	O tipo de SSL a usar quando se liga ao proxy ProxyServer. Os valores suportados são: AUTO, ALWAYS, NEVER, TUNNEL

Use a associação do Box numa integração

Depois de criar a ligação, esta fica disponível no Apigee Integration e no Application Integration. Pode usar a ligação numa integração através da tarefa Conectores.

• Para compreender como criar e usar a tarefa Connectors no Apigee Integration, consulte o artigo Tarefa Connectors.
• Para compreender como criar e usar a tarefa Connectors na integração de aplicações, consulte o artigo Tarefa Connectors.

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.

O que se segue?

• Compreenda como suspender e retomar uma associação.
• Compreenda como monitorizar a utilização do conector.
• Compreenda como ver os registos do conetor.