Documentatie Experience Platform Gids voor Source Connectors

Ultimate

Verbinding maken met Experience Platform via de Flow Service APIGoogle BigQuery

Laatst bijgewerkt: 27 maart 2025

Onderwerpen:

Gemaakt voor:

Ontwikkelaar

IMPORTANT

De Google BigQuery -bron is in de broncatalogus beschikbaar voor gebruikers die Real-Time Customer Data Platform Ultimate hebben aangeschaft.

Lees deze gids om te leren hoe te om uw Google BigQuery gegevensbestand met Adobe Experience Platform te verbinden gebruikend Flow Service API.

Aan de slag

Deze handleiding vereist een goed begrip van de volgende onderdelen van 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 de diensten van het Platform.
Sandboxes: Experience Platform verstrekt virtuele zandbakken die één enkele instantie van het Platform in afzonderlijke virtuele milieu's verdelen helpen digitale ervaringstoepassingen ontwikkelen en ontwikkelen.

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.

Vereiste referenties verzamelen

Lees de Google BigQuery authentificatiegidsvoor gedetailleerde stappen bij het terugwinnen van uw Google BigQuery geloofsbrieven.

Verbind Google BigQuery met Experience Platform op Azure

Lees de onderstaande stappen voor informatie over hoe u uw Google BigQuery -bron kunt verbinden met Experience Platform on Azure.

Een basisverbinding maken voor Google BigQuery op Experience Platform in Azure

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-aanvraag naar het /connections -eindpunt en geeft u de Google BigQuery -verificatiegegevens op als onderdeel van de aanvraagparameters.

API formaat

POST /connections

verzoek

Met de volgende aanvraag wordt een basisverbinding voor Google BigQuery gemaakt met behulp van basisverificatie.

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 BigQuery connection with basic authentication",
        "description": "Google BigQuery connection with basic authentication",
        "auth": {
            "specName": "Basic Authentication",
            "type": "OAuth2.0",
            "params": {
                    "project": "{PROJECT}",
                    "clientId": "{CLIENT_ID},
                    "clientSecret": "{CLIENT_SECRET}",
                    "refreshToken": "{REFRESH_TOKEN}"
                }
        },
        "connectionSpec": {
            "id": "3c9b37f8-13a6-43d8-bad3-b863b941fedd",
            "version": "1.0"
        }
    }'

Eigenschap

Beschrijving

auth.params.project

De project-id van het standaard Google BigQuery -project waarop moet worden gezocht. tegen.

auth.params.clientId

De waarde van identiteitskaart die wordt gebruikt om het vernieuwingstoken te produceren.

auth.params.clientSecret

De clientwaarde die wordt gebruikt om het vernieuwingstoken te genereren.

auth.params.refreshToken

Het vernieuwingstoken dat u van Google hebt gekregen om toegang tot Google BigQuery te verlenen.

connectionSpec.id

The Google BigQuery connection specification ID: 3c9b37f8-13a6-43d8-bad3-b863b941fedd .

Response

Een succesvolle reactie keert details van de pas gecreëerde verbinding, met inbegrip van zijn uniek herkenningsteken (id) terug. Deze id is vereist om uw gegevens te kunnen bekijken in de volgende zelfstudie.

{
    "id": "6990abad-977d-41b9-a85d-17ea8cf1c0e4",
    "etag": "\"ca00acbf-0000-0200-0000-60149e1e0000\""
}

verzoek

Met de volgende aanvraag wordt een basisverbinding voor Google BigQuery gemaakt met behulp van service-verificatie:

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 BigQuery base connection with service account",
      "description": "Google BigQuery connection with service account",
      "auth": {
          "specName": "Service Authentication",
          "params": {
                  "projectId": "{PROJECT_ID}",
                  "keyFileContent": "{KEY_FILE_CONTENT},
                  "largeResultsDataSetId": "{LARGE_RESULTS_DATASET_ID}"
              }
      },
      "connectionSpec": {
          "id": "3c9b37f8-13a6-43d8-bad3-b863b941fedd",
          "version": "1.0"
      }
  }'

Eigenschap

Beschrijving

auth.params.projectId

De project-id van het standaard Google BigQuery -project waarop moet worden gezocht. tegen.

auth.params.keyFileContent

Het sleuteldossier dat wordt gebruikt om de de dienstrekening voor authentiek te verklaren. U moet de inhoud van het sleutelbestand coderen in Base64 .

auth.params.largeResultsDataSetId

(Optioneel) De vooraf gemaakte Google BigQuery dataset-id die vereist is om ondersteuning voor grote resultaatsets mogelijk te maken.

Response

Een succesvolle reactie keert details van de pas gecreëerde verbinding, met inbegrip van zijn uniek herkenningsteken (id) terug. Deze id is vereist om uw gegevens te kunnen bekijken in de volgende zelfstudie.

{
    "id": "6990abad-977d-41b9-a85d-17ea8cf1c0e4",
    "etag": "\"ca00acbf-0000-0200-0000-60149e1e0000\""
}

Verbinding maken Google BigQuery met Experience Platform op Amazon Web Services (AWS)

Lees de onderstaande stappen voor informatie over hoe u uw Google BigQuery -database kunt verbinden met Experience Platform op AWS.

Een basisverbinding maken voor Google BigQuery op Experience Platform op AWS

AVAILABILITY

Deze sectie is van toepassing op implementaties van Experience Platform die op Amazon Web Services (AWS) worden uitgevoerd. Experience Platform die op AWS wordt uitgevoerd, is momenteel beschikbaar voor een beperkt aantal klanten. Meer over de gesteunde infrastructuur van Experience Platform leren, zie het multi-wolkenoverzicht van Experience Platform.

API formaat

POST /connections

Verzoek

Met de volgende aanvraag wordt een basisverbinding gemaakt om Google BigQuery op AWS te verbinden met Experience Platform.

Selecteren om voorbeeld weer te geven

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 BigQuery base connection on AWS",
      "description": "Google BigQuery base connection on AWS",
      "auth": {
          "specName": "Service Authentication",
          "params": {
                  "projectId": "{PROJECT_ID}",
                  "keyFileContent": "{KEY_FILE_CONTENT},
                  "datasetId": "{DATASET_ID}"
      },
      "connectionSpec": {
          "id": "3c9b37f8-13a6-43d8-bad3-b863b941fedd",
          "version": "1.0"
      }
  }'

Eigenschap

Beschrijving

auth.params.projectId

De project-id van het standaard Google BigQuery -project waarop moet worden gezocht. tegen.

auth.params.keyFileContent

Het sleuteldossier dat wordt gebruikt om de de dienstrekening voor authentiek te verklaren. U moet de inhoud van het sleutelbestand coderen in Base64 .

auth.params.datasetId

De gegevensset-id die overeenkomt met uw Google BigQuery -bron. Deze id geeft aan waar de gegevenstabellen zich bevinden.

Reactie

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

Selecteren om voorbeeld weer te geven

{
    "id": "6990abad-977d-41b9-a85d-17ea8cf1c0e4",
    "etag": "\"ca00acbf-0000-0200-0000-60149e1e0000\""
}

Volgende stappen

Aan de hand van deze zelfstudie hebt u een Google BigQuery basisverbinding gemaakt met de Flow Service API. U kunt deze basis verbindings-id in de volgende zelfstudies gebruiken:

recommendation-more-help