Ontdek uw mappen voor cloudopslag met de API van Flow Service

Laatst bijgewerkt: 4 april 2025
  • Onderwerpen:

Gemaakt voor:

  • Ontwikkelaar

Deze zelfstudie bevat stappen voor het verkennen en voorvertonen van de structuur en inhoud van uw cloudopslag met de Flow Service-API.

OPMERKING
Als u uw cloudopslag wilt verkennen, moet u al beschikken over een geldige basis-verbindings-id voor een bron voor cloudopslag. Als u dit identiteitskaart niet hebt, dan zie het overzicht van bronnenvoor een lijst van de bronnen van de wolkenopslag die u een basisverbinding kunt tot stand brengen met.

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 Experience Platform diensten.
  • Sandboxen: Experience Platform verstrekt virtuele zandbakken die één enkele Experience Platform instantie in afzonderlijke virtuele milieu's verdelen helpen digitale ervaringstoepassingen ontwikkelen en ontwikkelen.

Experience Platform API's gebruiken

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

Ontdek uw mappen voor cloudopslag

U kunt informatie ophalen over de structuur van uw mappen voor cloudopslag door een GET-aanvraag in te dienen bij de API van Flow Service en de basis-verbindings-id van uw bron op te geven.

Wanneer u GET-verzoeken uitvoert om uw cloudopslag te verkennen, moet u de queryparameters opnemen die in de onderstaande tabel worden vermeld:

ParameterBeschrijving
objectType

Het type object dat u wilt verkennen. Stel deze waarde in op:

  • folder: een specifieke map verkennen
  • root : verken de hoofdmap.
objectDeze parameter is alleen vereist wanneer een specifieke map wordt weergegeven. Zijn waarde vertegenwoordigt de weg van de folder u wenst te onderzoeken.

API formaat

GET /connections/{BASE_CONNECTION_ID}/explore?objectType=root
GET /connections/{BASE_CONNECTION_ID}/explore?objectType=folder&object={PATH}
ParameterBeschrijving
{BASE_CONNECTION_ID}De basis verbindings-id van de bron voor cloudopslag.
{PATH}Het pad van een map.

Verzoek

curl -X GET \
  'http://platform.adobe.io/data/foundation/flowservice/connections/dc3c0646-5e30-47be-a1ce-d162cb8f1f07/explore?objectType=folder&object=root' \
  -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}'

Reactie

Een succesvol antwoord retourneert een array met bestanden en mappen die in de gevraagde map zijn gevonden. Let op de eigenschap path van het bestand dat u wilt uploaden, aangezien u dit in de volgende stap moet opgeven om de structuur te controleren.

[
    {
        "type": "file",
        "name": "account.csv",
        "path": "/test-connectors/testFolder-fileIngestion/account.csv",
        "canPreview": true,
        "canFetchSchema": true
    },
    {
        "type": "file",
        "name": "profileData.json",
        "path": "/test-connectors/testFolder-fileIngestion/profileData.json",
        "canPreview": true,
        "canFetchSchema": true
    },
    {
        "type": "file",
        "name": "sampleprofile--3.parquet",
        "path": "/test-connectors/testFolder-fileIngestion/sampleprofile--3.parquet",
        "canPreview": true,
        "canFetchSchema": true
    }
]

De structuur van een bestand controleren

Als u de structuur van gegevensbestanden vanuit de cloudopslag wilt inspecteren, voert u een GET-aanvraag uit terwijl u het pad van het bestand opgeeft en typt u het als een queryparameter.

U kunt de structuur van een gegevensbestand vanuit de bron van de cloudopslag inspecteren door een GET-aanvraag uit te voeren en het pad en type van het bestand op te geven. U kunt ook verschillende bestandstypen inspecteren, zoals CSV, TSV of gecomprimeerde JSON en gescheiden bestanden door de bestandstypen op te geven als onderdeel van de queryparameters.

API formaat

GET /connections/{BASE_CONNECTION_ID}/explore?objectType=file&object={FILE_PATH}&fileType={FILE_TYPE}&{QUERY_PARAMS}&preview=true
GET /connections/{BASE_CONNECTION_ID}/explore?objectType=file&object={FILE_PATH}&preview=true&fileType=delimited&columnDelimiter=\t
GET /connections/{BASE_CONNECTION_ID}/explore?objectType=file&object={FILE_PATH}&preview=true&fileType=delimited&compressionType=gzip;
GET /connections/{BASE_CONNECTION_ID}/explore?objectType=FILE&object={FILE_PATH}&preview=true&fileType=delimited&encoding=ISO-8859-1;
ParameterBeschrijving
{BASE_CONNECTION_ID}De verbindings-id van de bronaansluiting voor de cloud.
{FILE_PATH}Het pad naar het bestand dat u wilt inspecteren.
{FILE_TYPE}

Het type bestand. Tot de ondersteunde bestandstypen behoren:

  • DELIMITED: door scheidingstekens gescheiden waarde. DSV-bestanden moeten door komma's van elkaar worden gescheiden.
  • JSON: JavaScript Object Notation. JSON-bestanden moeten XDM-compatibel zijn
  • PARQUET: Apache Parquet. Parketbestanden moeten XDM-compatibel zijn.
{QUERY_PARAMS}Optionele queryparameters die kunnen worden gebruikt om resultaten te filteren. Zie de sectie over vraagparametersvoor meer informatie.

Verzoek

curl -X GET \
    'http://platform.adobe.io/data/foundation/flowservice/connections/{BASE_CONNECTION_ID}/explore?objectType=file&object=/aep-bootcamp/Adobe%20Pets%20Customer%2020190801%20EXP.json&fileType=json&preview=true' \
    -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}'

Reactie

Een succesvol antwoord geeft de structuur van het gevraagde dossier met inbegrip van lijstnamen en gegevenstypes terug.

[
    {
        "name": "Id",
        "type": "String"
    },
    {
        "name": "FirstName",
        "type": "String"
    },
    {
        "name": "LastName",
        "type": "String"
    },
    {
        "name": "Email",
        "type": "String"
    },
    {
        "name": "Phone",
        "type": "String"
    }
]