Aggiornare un qualificatore di raccolta

Puoi modificare o aggiornare un qualificatore di raccolta (precedentemente noto come "tag") nel contenitore effettuando una richiesta PATCH al Offer Library API.

Per ulteriori informazioni sulla patch JSON, comprese le operazioni disponibili, consulta la sezione Documentazione delle patch JSON.

Intestazioni Accept e Content-Type

La tabella seguente mostra i valori validi che compongono Content-Type e Accetta campi nell’intestazione della richiesta:

Nome intestazione Valore
Accept application/vnd.adobe.platform.xcore.xdm.receipt+json; version=1
Content-Type application/vnd.adobe.platform.xcore.patch.hal+json; version=1; schema="https://ns.adobe.com/experience/offer-management/tag;version=0.1"

Formato API

PATCH /{ENDPOINT_PATH}/{CONTAINER_ID}/instances/{INSTANCE_ID}
Parametro Descrizione Esempio
{ENDPOINT_PATH} Percorso dell’endpoint per le API dell’archivio. https://platform.adobe.io/data/core/xcore/
{CONTAINER_ID} Contenitore in cui si trovano i tag. e0bd8463-0913-4ca1-bd84-6309134ca1f6
{INSTANCE_ID} ID istanza del tag che desideri aggiornare. d48fd160-13dc-11eb-bc55-c11be7252432

Richiesta

curl -X PATCH \
  'https://platform.adobe.io/data/core/xcore/e0bd8463-0913-4ca1-bd84-6309134ca1f6/instances/d48fd160-13dc-11eb-bc55-c11be7252432' \
  -H 'Accept: application/vnd.adobe.platform.xcore.xdm.receipt+json; version=1' \
  -H 'Content-Type: application/vnd.adobe.platform.xcore.patch.hal+json; version=1; schema="https://ns.adobe.com/experience/offer-management/tag;version=0.1"' \
  -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}'\
  -d '[
        {
          "op": "replace",
          "path": "/_instance/xdm:name",
          "value": "Sales and promotions for the holidays"
        }
    ]'
Parametro Descrizione
op Chiamata di operazione utilizzata per definire l'azione necessaria per aggiornare la connessione. Le operazioni includono: add, replace, e remove.
path Percorso del parametro da aggiornare.
value Il nuovo valore con cui desideri aggiornare il parametro.

Risposta

In caso di esito positivo, la risposta restituisce i dettagli aggiornati del qualificatore di raccolta, inclusi l’ID istanza univoco e il qualificatore di raccolta @id.

{
    "instanceId": "d48fd160-13dc-11eb-bc55-c11be7252432",
    "@id": "xcore:tag:124e147572cd7866",
    "repo:etag": 2,
    "repo:createdDate": "2020-10-21T20:34:34.486296Z",
    "repo:lastModifiedDate": "2020-10-21T20:36:31.782607Z",
    "repo:createdBy": "{CREATED_BY}",
    "repo:lastModifiedBy": "{MODIFIED_BY}",
    "repo:createdByClientId": "{CREATED_CLIENT_ID}",
    "repo:lastModifiedByClientId": "{MODIFIED_CLIENT_ID}"
}

In questa pagina