LinkedIn

O conetor do LinkedIn permite-lhe realizar operações de leitura em dados do LinkedIn.

Antes de começar

No seu projeto do Google Cloud, faça as seguintes tarefas:

• 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 funções de IAM roles/secretmanager.viewer e roles/secretmanager.secretAccessor à conta de serviço que quer usar para o conector.
• 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 LinkedIn 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. ID da empresa: o ID da empresa do LinkedIn exclusivo da sua organização. Se especificar o ID da empresa na consulta, use o seguinte formato: urn:li:organization:COMPANY_ID.
   9. Clique em SEGUINTE.
   10. Na secção Autorização, introduza os detalhes do ID de cliente e do segredo do cliente.
       • ID de cliente: o ID de cliente usado para pedir tokens de acesso.
       • Âmbito: uma lista separada por vírgulas dos âmbitos pretendidos da conta de programador do LinkedIn.
       • Segredo do cliente: segredo do Secret Manager que contém o segredo do cliente da app associada que criou.
       • Versão do Secret: versão do Secret para o Secret selecionado.
   11. Clique em SEGUINTE.
   12. Rever: reveja os detalhes da ligação e da autenticação.
   13. Clique em Criar.

   Limitações do sistema

   O conector do LinkedIn pode processar um máximo de 5 transações por segundo, por nó e limita todas as transações que excedam este limite. O LinkedIn aplica um limite de 10 mil pedidos por utilizador a cada 24 horas.

   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.

   Use a associação do LinkedIn 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.

   Entidades

   O conector do LinkedIn suporta entidades, como comentários e perfis. Para compreender como configurar as entidades, consulte Exemplos de entidades.

   Exemplos de operações de entidades

   Exemplo: liste todos os comentários da página do perfil do LinkedIn.

   Este exemplo lista todos os comentários das publicações nas páginas da organização que administra

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

   Exemplo: obter perfis a partir de um ID específico

   Este exemplo obtém os perfis com base no ID da entidade Profiles.

   1. Na caixa de diálogo Configure connector task, clique em Entities.
   2. Selecione Profiles na lista Entity.
   3. Selecione a operação GET e, de seguida, clique em Concluído.
   4. Na secção Entrada de tarefas da tarefa Conetores, clique em entityId e, de seguida, introduza 2t7k5s4fgC no campo Valor predefinido.

      Aqui, Id [KEY] é o valor-chave principal da entidade Profiles.

   5. Clique em Concluído.

   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.