LinkedIn

Il connettore LinkedIn consente di eseguire operazioni di lettura sui dati di LinkedIn.

Prima di iniziare

Nel tuo progetto Google Cloud, esegui le seguenti attività:

• Assicurati che la connettività di rete sia configurata. Per informazioni sui pattern di rete, consulta Connettività di rete.
• Concedi il ruolo IAM roles/connectors.admin all'utente che configura il connettore.
• Concedi i ruoli IAM roles/secretmanager.viewer e roles/secretmanager.secretAccessor all'account di servizio che vuoi utilizzare per il connettore.
• Attiva i seguenti servizi:
  • secretmanager.googleapis.com (API Secret Manager)
  • connectors.googleapis.com (Connettori API)

  Per scoprire come attivare i servizi, consulta Attivare i servizi. Se questi servizi o queste autorizzazioni non sono stati attivati in precedenza per il tuo progetto, ti verrà chiesto di attivarli quando configuri il connettore.

Configurare il connettore

Una connessione è specifica per un'origine dati. Ciò significa che se hai molte origini dati, devi creare una connessione separata per ogni origine dati. Per creare una connessione:

1. Nella console Cloud, vai alla pagina Integration Connectors > Connessioni e seleziona o crea un progetto Google Cloud.

   Vai alla pagina Connessioni

2. Fai clic su + CREA NUOVA per aprire la pagina Crea connessione.
3. Nella sezione Località, scegli la località per la connessione.
   1. Regione: seleziona una località dall'elenco a discesa.

      Per un elenco di tutte le regioni supportate, consulta Località.

   2. Fai clic su AVANTI.
4. Nella sezione Dettagli connessione, completa quanto segue:
   1. Connettore: seleziona LinkedIn dall'elenco a discesa dei connettori disponibili.
   2. Versione connettore: seleziona la versione del connettore dall'elenco a discesa delle versioni disponibili.
   3. Nel campo Nome connessione, inserisci un nome per l'istanza di connessione.

      I nomi delle connessioni devono soddisfare i seguenti criteri:

      • I nomi delle connessioni possono contenere lettere, numeri o trattini.
      • Le lettere devono essere minuscole.
      • I nomi delle connessioni devono iniziare con una lettera e terminare con una lettera o un numero.
      • I nomi delle connessioni non possono superare i 49 caratteri.
   4. (Facoltativo) Inserisci una Descrizione per l'istanza di connessione.
   5. (Facoltativo) Attiva Cloud Logging e seleziona un livello di log. Per impostazione predefinita, il livello di log è impostato su Error.
   6. Account di servizio: seleziona un account di servizio con i ruoli richiesti.
   7. (Facoltativo) Configura le Impostazioni del nodo di connessione:
      • Numero minimo di nodi: inserisci il numero minimo di nodi di connessione.
      • Numero massimo di nodi: inserisci il numero massimo di nodi di connessione.

      Un nodo è un'unità (o una replica) di una connessione che elabora le transazioni. Sono necessari più nodi per elaborare più transazioni per una connessione e, al contrario, sono necessari meno nodi per elaborare meno transazioni. Per capire in che modo i nodi influiscono sui prezzi del connettore, consulta Prezzi dei nodi di connessione. Se non inserisci alcun valore, per impostazione predefinita i nodi minimi sono impostati su 2 (per una maggiore disponibilità) e i nodi massimi sono impostati su 50.

   Nota: puoi personalizzare i valori dei nodi di connessione solo se sei un cliente con pagamento a consumo.
   8. ID azienda: l'ID azienda LinkedIn univoco per la tua organizzazione. Se specifichi l'ID azienda nella query, utilizza il seguente formato: urn:li:organization:COMPANY_ID.
   9. Fai clic su AVANTI.
   10. Nella sezione Autorizzazione, inserisci i dettagli dell'ID client e del client secret.
       • ID client: l'ID client utilizzato per richiedere i token di accesso.
       • Ambito: un elenco separato da virgole degli ambiti desiderati dall'account sviluppatore LinkedIn.
       • Client secret: il secret di Secret Manager contenente il client secret per l'app connessa che hai creato.
       • Versione secret: la versione del secret selezionato.
       Quando configuri l'applicazione OAuth di terze parti, utilizza questo URI di reindirizzamento autorizzato (URL di callback):

       https://console.cloud.google.com//connectors/oauth?project=PROJECT_ID

       Sostituisci PROJECT_ID con l'ID progetto Google Cloud .

   11. Fai clic su AVANTI.
   12. Rivedi: esamina i dettagli della connessione e dell'autenticazione.
   13. Fai clic su Crea.

   Limitazioni di sistema

   Il connettore LinkedIn può elaborare un massimo di 5 transazioni al secondo, per nodo e limita le transazioni oltre questo limite. LinkedIn impone un limite di 10.000 richieste per utente ogni 24 ore.

   Per impostazione predefinita, Integration Connectors alloca 2 nodi (per una maggiore disponibilità) per una connessione.

   Per informazioni sui limiti applicabili a Integration Connectors, consulta Limiti.

   Nota: il numero di nodi di Integration Connectors verrà scalato automaticamente in modo dinamico in base all'utilizzo. Tuttavia, se vuoi riservare capacità per volumi elevati senza attendere la scalabilità automatica, puoi modificare il valore minimo del nodo per una connessione. Sono necessari più nodi per elaborare più transazioni per una connessione. Al contrario, sono necessari meno nodi se una connessione elabora meno transazioni. Per configurare i valori dei nodi :

   • Se sei un cliente con pagamento a consumo, configura il valore minimo e massimo del nodo nella pagina di modifica della connessione.
   • Se sei un cliente con abbonamento, contatta l'assistenza.

   Il numero massimo di transazioni che un nodo può gestire dipende da vari fattori. Pertanto, prima di modificare i nodi minimi per un throughput migliore, ti consigliamo di verificare se i tuoi sistemi di backend sono configurati in modo ottimale per gestire il traffico richiesto.

   Utilizzare la connessione LinkedIn in un'integrazione

   Dopo aver creato la connessione, questa diventa disponibile sia in Apigee Integration che in Application Integration. Puoi utilizzare la connessione in un'integrazione tramite l'attività Connettori.

   • Per scoprire come creare e utilizzare l'attività Connettori in Apigee Integration, consulta Attività Connettori.
   • Per scoprire come creare e utilizzare l'attività Connettori in Application Integration, consulta Attività Connettori.

   Entità

   Il connettore LinkedIn supporta entità come Commenti e Profili. Per scoprire come configurare le entità, consulta Esempi di entità.

   Esempi di operazioni sulle entità

   Esempio: elencare tutti i commenti dalla pagina del profilo LinkedIn.

   Questo esempio elenca tutti i commenti dei post nelle pagine dell'organizzazione che amministri.

   1. Nella finestra di dialogo Configure connector task (Configura attività connettore), fai clic su Entities (Entità).
   2. Seleziona Commenti dall'elenco Entity (Entità).
   3. Seleziona l'operazione LIST e fai clic su Fine.

   Esempio: ottenere i profili da un ID specifico

   Questo esempio recupera i profili in base all'ID dell'entità Profiles (Profili).

   1. Nella finestra di dialogo Configure connector task (Configura attività connettore), fai clic su Entities (Entità).
   2. Seleziona Profiles (Profili) dall'elenco Entity (Entità).
   3. Seleziona l'operazione GET e fai clic su Fine.
   4. Nella sezione Task Input (Input attività) dell'attività Connettori, fai clic su entityId e quindi inserisci 2t7k5s4fgC nel campo Default Value (Valore predefinito).

      Qui, Id [KEY] è il valore della chiave primaria dell'entità Profiles (Profili).

   5. Fai clic su Fine.

   Chiedere assistenza alla community di Google Cloud

   Puoi pubblicare le tue domande e discutere di questo connettore nella community di Google Cloud nei forum di Cloud.

   Passaggi successivi

   • Scopri come sospendere e riprendere una connessione.
   • Scopri come monitorare l'utilizzo del connettore.
   • Scopri come visualizzare i log del connettore.