Crea un Google Cloud Storage connessione di base utilizzando Flow Service API

Una connessione di base rappresenta la connessione autenticata tra un'origine e Adobe Experience Platform.

Questa esercitazione descrive i passaggi necessari per creare una connessione di base per Google Cloud Storage utilizzando Flow Service API.

Introduzione

Questa guida richiede una buona comprensione dei seguenti componenti di Adobe Experience Platform:

  • Origini: Experience Platform consente l’acquisizione di dati da varie sorgenti, fornendo al contempo la possibilità di strutturare, etichettare e migliorare i dati in arrivo utilizzando Platform servizi.
  • Sandbox: Experience Platform fornisce sandbox virtuali che suddividono un singolo Platform in ambienti virtuali separati per sviluppare e sviluppare applicazioni di esperienza digitale.

Le sezioni seguenti forniscono informazioni aggiuntive che sarà necessario conoscere per connettersi correttamente a un account di Google Cloud Storage utilizzando Flow Service API.

Raccogli credenziali richieste

Per Flow Service per connettersi con Google Cloud Storage account, è necessario fornire valori per le seguenti proprietà di connessione:

Credenziali Descrizione
accessKeyId Una stringa alfanumerica di 61 caratteri utilizzata per autenticare il tuo Google Cloud Storage a Platform.
secretAccessKey Una stringa con codifica base a 64 caratteri utilizzata per l'autenticazione Google Cloud Storage a Platform.
bucketName Il nome del tuo Google Cloud Storage secchio. È necessario specificare un nome per il bucket se si desidera fornire l’accesso a una sottocartella specifica nell’archiviazione cloud.
folderPath Percorso della cartella a cui si desidera fornire l'accesso.

Per ulteriori informazioni su questi valori, consulta la sezione Chiavi HMAC di Google Cloud Storage guida. Per i passaggi su come generare il tuo ID chiave di accesso e la chiave di accesso segreta, consulta Google Cloud Storage panoramica.

Utilizzo delle API di Platform

Per informazioni su come effettuare correttamente le chiamate alle API di Platform, consulta la guida su guida introduttiva alle API di Platform.

Creare una connessione di base

Una connessione di base conserva le informazioni tra l'origine e la piattaforma, incluse le credenziali di autenticazione dell'origine, lo stato corrente della connessione e l'ID di connessione di base univoco. L’ID di connessione di base consente di esplorare e navigare tra i file di origine e di identificare gli elementi specifici da acquisire, comprese le informazioni relative ai tipi di dati e ai formati corrispondenti.

Per creare un ID di connessione di base, invia una richiesta POST al /connections l'endpoint durante la fornitura del Google Cloud Storage credenziali di autenticazione come parte dei parametri della richiesta.

SUGGERIMENTO

Durante questo passaggio, puoi anche definire le sottocartelle a cui l’account avrà accesso definendo il nome del bucket e il percorso della sottocartella.

Formato API

POST /connections

Richiesta

La richiesta seguente crea una connessione di base per Google Cloud Storage:

curl -X POST \
  'https://platform.adobe.io/data/foundation/flowservice/connections' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -H 'Content-Type: application/json' \
  -d '{
      "name": "Google Cloud Storage connection",
      "description": "Connector for Google Cloud Storage",
      "auth": {
          "specName": "Basic Authentication for google-cloud",
          "params": {
              "accessKeyId": "accessKeyId",
              "secretAccessKey": "secretAccessKey",
              "bucketName": "acme-google-cloud-bucket",
              "folderPath": "/acme/customers/sales"
          }
      },
      "connectionSpec": {
          "id": "32e8f412-cdf7-464c-9885-78184cb113fd",
          "version": "1.0"
      }
  }'
Proprietà Descrizione
auth.params.accessKeyId L'ID chiave di accesso associato al tuo Google Cloud Storage conto.
auth.params.secretAccessKey Chiave di accesso segreto associata al tuo Google Cloud Storage conto.
auth.params.bucketName Il nome del tuo Google Cloud Storage secchio. È necessario specificare un nome per il bucket se si desidera fornire l’accesso a una sottocartella specifica nell’archiviazione cloud.
auth.params.folderPath Percorso della cartella a cui si desidera fornire l'accesso.
connectionSpec.id La Google Cloud Storage ID specifica di connessione: 32e8f412-cdf7-464c-9885-78184cb113fd

Risposta

Una risposta corretta restituisce i dettagli della nuova connessione creata, incluso il relativo identificatore univoco (id). Questo ID è necessario per esplorare i dati di archiviazione cloud nell’esercitazione successiva.

{
    "id": "4cb0c374-d3bb-4557-b139-5712880adc55",
    "etag": "\"6507cfd8-0000-0200-0000-5e18fc600000\""
}

Passaggi successivi

Seguendo questa esercitazione, hai creato un Google Cloud Storage è stata ottenuta una connessione utilizzando le API e un ID univoco come parte del corpo della risposta. Puoi usare questo ID connessione per esplorare gli archivi cloud utilizzando l’API del servizio di flusso.

In questa pagina