Elle Dataset Service API vous permet d’appliquer et de modifier des étiquettes d’utilisation pour les jeux de données. Il fait partie des fonctionnalités de catalogue de données Adobe Experience Platform, mais est distinct de l’ Catalog Service API qui gère les métadonnées des jeux de données.
Ce document explique comment gérer les étiquettes des jeux de données et des champs à l’aide du Dataset Service API. Pour savoir comment gérer les libellés d’utilisation des données eux-mêmes à l’aide d’appels d’API, consultez le guide des points de terminaison d’étiquettes pour le Policy Service API.
Avant de lire ce guide, suivez les étapes décrites dans la section Prise en main du guide du développeur de catalogue afin de rassembler les informations d’identification requises pour appeler Platform les API.
Pour invoquer les points de terminaison décrits dans ce document, vous devez disposer de la id
valeur unique d'un jeu de données spécifique. Si vous ne disposez pas de cette valeur, consultez le guide de la liste des objets Catalog pour trouver les ID de vos jeux de données existants.
Vous pouvez rechercher les étiquettes d’utilisation des données qui ont été appliquées à un jeu de données existant en adressant une demande de GET à l’ Dataset Service API.
Format d’API
GET /datasets/{DATASET_ID}/labels
Paramètre | Description |
---|---|
{DATASET_ID} |
Valeur unique id du jeu de données dont vous souhaitez rechercher les étiquettes. |
Requête
curl -X GET \
'https://platform.adobe.io/data/foundation/dataset/datasets/5abd49645591445e1ba04f87/labels' \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-gw-ims-org-id: {IMS_ORG}' \
-H 'x-sandbox-name: {SANDBOX_NAME}'
Réponse
Une réponse positive renvoie les étiquettes d’utilisation des données qui ont été appliquées au jeu de données.
{
"AEP:dataset:5abd49645591445e1ba04f87": {
"imsOrg": "{IMS_ORG}",
"labels": [ "C1", "C2", "C3", "I1", "I2" ],
"optionalLabels": [
{
"option": {
"id": "https://ns.adobe.com/{TENANT_ID}/schemas/c6b1b09bc3f2ad2627c1ecc719826836",
"contentType": "application/vnd.adobe.xed-full+json;version=1",
"schemaPath": "/properties/repositoryCreatedBy"
},
"labels": [ "S1", "S2" ]
}
]
}
}
Propriété | Description |
---|---|
labels |
Liste des étiquettes d’utilisation des données qui ont été appliquées au jeu de données. |
optionalLabels |
Liste de champs individuels au sein du jeu de données auxquels des étiquettes d’utilisation de données sont appliquées. |
Vous pouvez créer un ensemble de libellés pour un jeu de données en les fournissant dans la charge utile d’une requête de POST ou de PUT à l’ Dataset Service API. L’utilisation de l’une ou l’autre de ces méthodes remplace les étiquettes existantes et les remplace par celles fournies dans la charge utile.
Format d’API
POST /datasets/{DATASET_ID}/labels
PUT /datasets/{DATASET_ID}/labels
Paramètre | Description |
---|---|
{DATASET_ID} |
Valeur unique id du jeu de données pour lequel vous créez des étiquettes. |
Requête
La demande de PUT suivante met à jour les étiquettes existantes pour un jeu de données, ainsi qu’un champ spécifique dans ce jeu de données. Les champs fournis dans la charge utile sont identiques à ceux requis pour une demande de POST.
Un If-Match
en-tête valide doit être fourni lors de l’envoi de requêtes PUT au /datasets/{DATASET_ID}/labels
point de terminaison. Pour plus d’informations sur l’utilisation de l’en-tête requis, voir la section de l’ annexe.
curl -X PUT \
'https://platform.adobe.io/data/foundation/dataset/datasets/5abd49645591445e1ba04f87/labels' \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-gw-ims-org-id: {IMS_ORG}' \
-H 'x-sandbox-name: {SANDBOX_NAME}' \
-H 'Content-Type: application/json' \
-H 'If-Match: 8f00d38e-0000-0200-0000-5ef4fc6d0000' \
-d '{
"labels": [ "C1", "C2", "C3", "I1", "I2" ],
"optionalLabels": [
{
"option": {
"id": "https://ns.adobe.com/{TENANT_ID}/schemas/c6b1b09bc3f2ad2627c1ecc719826836",
"contentType": "application/vnd.adobe.xed-full+json;version=1",
"schemaPath": "/properties/repositoryCreatedBy"
},
"labels": [ "S1", "S2" ]
}
]
}'
Réponse
Une réponse réussie renvoie les étiquettes qui ont été ajoutées au jeu de données.
{
"labels": [ "C1", "C2", "C3", "I1", "I2" ],
"optionalLabels": [
{
"option": {
"id": "https://ns.adobe.com/{TENANT_ID}/schemas/c6b1b09bc3f2ad2627c1ecc719826836",
"contentType": "application/vnd.adobe.xed-full+json;version=1",
"schemaPath": "/properties/repositoryCreatedBy"
},
"labels": [ "S1", "S2" ]
}
]
}
Vous pouvez supprimer les étiquettes appliquées à un jeu de données en adressant une requête de DELETE à l’ Dataset Service API.
Format d’API
DELETE /datasets/{DATASET_ID}/labels
Paramètre | Description |
---|---|
{DATASET_ID} |
Valeur unique id du jeu de données dont vous souhaitez supprimer les étiquettes. |
Requête
La demande suivante supprime les étiquettes du jeu de données spécifié dans le chemin d’accès.
Un If-Match
en-tête valide doit être fourni lors de l’envoi de requêtes DELETE au /datasets/{DATASET_ID}/labels
point de terminaison. Pour plus d’informations sur l’utilisation de l’en-tête requis, voir la section de l’ annexe.
curl -X DELETE \
'https://platform.adobe.io/data/foundation/dataset/datasets/5abd49645591445e1ba04f87/labels' \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-gw-ims-org-id: {IMS_ORG}' \
-H 'x-sandbox-name: {SANDBOX_NAME}' \
-H 'If-Match: 8f00d38e-0000-0200-0000-5ef4fc6d0000'
Réponse
Réponse réussie : état HTTP 200 (OK), indiquant que les étiquettes ont été supprimées. Vous pouvez rechercher les étiquettes existantes pour le jeu de données dans un appel distinct pour le confirmer.
En lisant ce document, vous avez appris à gérer les étiquettes d’utilisation des données pour les jeux de données et les champs à l’aide de l’ Dataset Service API.
Once you have added data usage labels at the dataset- and field-level, you can begin to ingest data into Experience Platform. Pour en savoir plus, commencez par lire la documentation sur l’ingestion de données.
Désormais, vous pouvez également définir des stratégies d’utilisation des données en fonction des libellés que vous avez appliqués. Pour plus d’informations, consultez la présentation des stratégies d’utilisation des données.
Pour plus d'informations sur la gestion des jeux de données dans Experience Platform, consultez l'aperçu des jeux dedonnées.
La section suivante contient des informations supplémentaires sur l’utilisation des étiquettes à l’aide de l’API Service de dataset.
Lors d’appels d’API qui mettent à jour les étiquettes existantes d’un jeu de données (PUT et DELETE), un If-Match
en-tête qui indique la version actuelle de l’entité d’étiquette de jeu de données dans le service de jeux de données doit être inclus. Afin d’éviter les collisions de données, le service ne mettra à jour l’entité de jeu de données que si la chaîne incluse correspond à la dernière balise de version générée par le système pour ce jeu de données. If-Match
S’il n’existe actuellement aucune étiquette pour le jeu de données en question, les nouvelles étiquettes ne peuvent être ajoutées que par le biais d’une demande de POST, qui ne nécessite pas d’ If-Match
en-tête. Une fois que des étiquettes ont été ajoutées à un jeu de données, une etag
valeur est attribuée qui peut être utilisée pour mettre à jour ou supprimer les étiquettes ultérieurement.
Pour récupérer la version la plus récente de l'entité de type DataSet-label, envoyez une demande de GET au point de /datasets/{DATASET_ID}/labels
terminaison. La valeur actuelle est renvoyée dans la réponse sous un etag
en-tête. Lors de la mise à jour des libellés de jeux de données existants, il est recommandé d’effectuer d’abord une requête de recherche pour le jeu de données afin de récupérer sa dernière etag
valeur avant d’utiliser cette valeur dans l’ If-Match
en-tête de votre demande de PUT ou de DELETE ultérieure.