Een Google Cloud Storage basisverbinding maken met de Flow Service API

Laatst bijgewerkt: 16 juli 2024
  • Onderwerpen:

Gemaakt voor:

  • Ontwikkelaar

Een basisverbinding vertegenwoordigt de geverifieerde verbinding tussen een bron en Adobe Experience Platform.

Dit leerprogramma begeleidt u door de stappen om een basisverbinding voor Google Cloud Storage tot stand te brengen gebruikend Flow Service API.

Aan de slag

Deze handleiding vereist een goed begrip van de volgende onderdelen van Adobe Experience Platform:

  • Bronnen: Experience Platform staat gegevens toe om van diverse bronnen worden opgenomen terwijl het voorzien van u van de capaciteit om, inkomende gegevens te structureren te etiketteren en te verbeteren gebruikend Platform diensten.
  • Sandboxen: Experience Platform verstrekt virtuele zandbakken die één enkele Platform instantie in afzonderlijke virtuele milieu's verdelen helpen digitale ervaringstoepassingen ontwikkelen en ontwikkelen.

De volgende secties bevatten aanvullende informatie die u moet weten om verbinding te kunnen maken met een Google Cloud Storage-account met de Flow Service API.

Vereiste referenties verzamelen

Flow Service kan alleen verbinding maken met uw Google Cloud Storage -account als u waarden opgeeft voor de volgende verbindingseigenschappen:

CredentialsBeschrijving
accessKeyIdEen alfanumerieke tekenreeks van 61 tekens die wordt gebruikt voor het verifiëren van uw Google Cloud Storage -account bij Platform.
secretAccessKeyEen tekenreeks van 40 tekens met basiscode 64 die wordt gebruikt voor het verifiëren van uw Google Cloud Storage -account bij Platform.
bucketNameDe naam van uw Google Cloud Storage emmertje. U moet een emmernaam specificeren als u toegang tot een specifieke subomslag in uw wolkenopslag wilt verlenen.
folderPathHet pad naar de map waartoe u toegang wilt verlenen.

Voor meer informatie over deze waarden, zie de de sleutels van HMAC van de Opslag van de Wolk van Google HMACgids. Voor stappen op hoe te om uw eigen toegangs zeer belangrijke identiteitskaart en geheime toegangssleutel te produceren, verwijs naar het Google Cloud Storage overzicht.

Platform-API's gebruiken

Voor informatie over hoe te om vraag aan Platform APIs met succes te maken, zie de gids op begonnen wordt met Platform APIs.

Een basisverbinding maken

Een basisverbinding behoudt informatie tussen uw bron en Platform, met inbegrip van de de authentificatiegeloofsbrieven van uw bron, de huidige staat van de verbinding, en uw unieke identiteitskaart van de basisverbinding. Met de ID van de basisverbinding kunt u bestanden verkennen en door bestanden navigeren vanuit uw bron en kunt u de specifieke items identificeren die u wilt opnemen, inclusief informatie over hun gegevenstypen en indelingen.

Als u een basis-verbindings-id wilt maken, vraagt u een POST naar het /connections -eindpunt en geeft u de Google Cloud Storage -verificatiegegevens op als onderdeel van de aanvraagparameters.

TIP
Tijdens deze stap kunt u ook de submappen aangeven waartoe uw account toegang heeft door de naam van de emmertje en het pad naar de submap te definiëren.

API formaat

POST /connections

Verzoek

Met de volgende aanvraag wordt een basisverbinding voor Google Cloud Storage gemaakt:

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"
      }
  }'
EigenschapBeschrijving
auth.params.accessKeyIdDe toegangs sleutel-id die aan uw Google Cloud Storage account is gekoppeld.
auth.params.secretAccessKeyDe geheime toegangstoets die aan uw Google Cloud Storage account is gekoppeld.
auth.params.bucketNameDe naam van uw Google Cloud Storage emmertje. U moet een emmernaam specificeren als u toegang tot specifieke subfolder in uw wolkenopslag wilt verlenen.
auth.params.folderPathHet pad naar de map waartoe u toegang wilt verlenen.
connectionSpec.idDe Google Cloud Storage connection specification ID: 32e8f412-cdf7-464c-9885-78184cb113fd

Reactie

Een succesvolle reactie keert details van de pas gecreëerde verbinding, met inbegrip van zijn uniek herkenningsteken (id) terug. Deze id is vereist voor het verkennen van uw gegevens voor cloudopslag in de volgende zelfstudie.

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