DocumentazioneExperience PlatformGuida al servizio di segmentazione

Endpoint Schedules

Ultimo aggiornamento: 23 settembre 2026

Creato per:

  • Sviluppatore

Le pianificazioni sono uno strumento che può essere utilizzato per eseguire automaticamente processi di segmentazione batch una volta al giorno. È possibile utilizzare l’endpoint /config/schedules per recuperare un elenco di pianificazioni, creare una nuova pianificazione, recuperare i dettagli di una pianificazione specifica, aggiornare una pianificazione specifica o eliminare una pianificazione specifica.

Introduzione

Gli endpoint utilizzati in questa guida fanno parte dell’API Adobe Experience Platform Segmentation Service. Prima di continuare, consulta la guida introduttiva per informazioni importanti che devi conoscere per effettuare correttamente chiamate all’API, incluse le intestazioni richieste e la lettura delle chiamate API di esempio.

Recuperare un elenco di pianificazioni retrieve-list

Per recuperare un elenco di tutte le pianificazioni per l’organizzazione, eseguire una richiesta GET all’endpoint /config/schedules.

Formato API

L’endpoint /config/schedules supporta diversi parametri di query per filtrare i risultati. Anche se questi parametri sono facoltativi, si consiglia vivamente di utilizzarli per ridurre i costi generali. Effettuando una chiamata a questo endpoint senza parametri, verranno recuperate tutte le pianificazioni disponibili per la tua organizzazione. È possibile includere più parametri, separati da e commerciali (&).

GET /config/schedules
GET /config/schedules?{QUERY_PARAMETERS}

Parametri query

Elenco dei parametri di query disponibili.
table 0-row-3 1-row-3 2-row-3
Parametro Descrizione Esempio
start Specifica da quale pagina inizierà l’offset. Per impostazione predefinita, questo valore è 0. start=5
limit Specifica il numero di pianificazioni restituite. Per impostazione predefinita, questo valore è 100. limit=20

Richiesta

La seguente richiesta recupererà le ultime dieci pianificazioni registrate nella tua organizzazione.

Richiesta di esempio per recuperare un elenco di pianificazioni.
code language-shell 
curl -X GET https://platform.adobe.io/data/core/ups/config/schedules?limit=10 \
 -H 'Authorization: Bearer {ACCESS_TOKEN}' \
 -H 'x-gw-ims-org-id: {ORG_ID}' \
 -H 'x-api-key: {API_KEY}' \
 -H 'x-sandbox-name: {SANDBOX_NAME}'

Risposta

In caso di esito positivo, la risposta restituisce lo stato HTTP 200 con un elenco di pianificazioni per l’organizzazione specificata come JSON.

NOTE
La seguente risposta è stata troncata per motivi di spazio e mostra solo la prima pianificazione restituita.
Una risposta di esempio durante il recupero di un elenco di pianificazioni.
code language-json 
{
    "_page": {
        "totalCount": 10,
        "pageSize": 1
    },
    "children": [
        {
            "id": "4e538382-dbd8-449e-988a-4ac639ebe72b",
            "imsOrgId": "{ORG_ID}",
            "sandbox": {
                "sandboxId": "28e74200-e3de-11e9-8f5d-7f27416c5f0d",
                "sandboxName": "prod",
                "type": "production",
                "default": true
            },
            "name": "Batch Segmentation",
            "state": "active",
            "type": "batch_segmentation",
            "schedule": "0 0 1 * * ?",
            "frequency": "daily",
            "properties": {
                "segments": ["sampleSegmentDefinitionId"]
            },
            "owner": "user",
            "createEpoch": 1573158851,
            "updateEpoch": 1574365202
        }
    ],
    "_links": {
        "next": {}
    }
}
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 9-row-2 10-row-2 11-row-2 12-row-2 13-row-2 14-row-2 15-row-2
Proprietà Descrizione
_page.totalCount Numero totale di pianificazioni restituite.
_page.pageSize Dimensione della pagina delle pianificazioni.
children.id ID della pianificazione.
children.imsOrgId ID organizzazione della pianificazione.
children.sandbox Oggetto contenente le informazioni della sandbox per la pianificazione.
children.name Nome della pianificazione sotto forma di stringa.
children.state Stringa contenente lo stato della pianificazione. I due stati supportati sono “active” e “inactive”. Per impostazione predefinita, lo stato è impostato su “inattivo”.
children.type Tipo di processo come stringa. I due tipi supportati sono batch_segmentation e export.
children.schedule Stringa contenente la pianificazione del processo. È possibile programmare l’esecuzione dei job solo una volta al giorno, pertanto non è possibile programmare l’esecuzione di un job più di una volta in un periodo di 24 ore. Per ulteriori informazioni sulle pianificazioni cron, leggere l’appendice nel formato di espressione cron 🔗. In questo esempio, “0 0 1 * *” significa che questa pianificazione verrà eseguita ogni giorno all’1.
children.frequency La frequenza di esecuzione della pianificazione. I valori possibili sono daily, weekly, monthly e yearly.
children.properties Oggetto contenente proprietà aggiuntive correlate alla pianificazione.
children.properties.segments Gli ID delle definizioni dei segmenti che appartengono alla pianificazione.
children.owner Proprietario della pianificazione. I valori possibili includono user se la pianificazione è creata dall’utente e system se è creata dal sistema.
children.createEpoch Il tempo di creazione dell’epoca per la pianificazione in secondi.
children.updateEpoch L’ora dell’ultimo aggiornamento della pianificazione, in secondi.

Crea una nuova pianificazione create

È possibile creare una nuova pianificazione effettuando una richiesta POST all’endpoint /config/schedules.

Formato API

POST /config/schedules

Richiesta

Richiesta di esempio per creare una pianificazione.
code language-shell 
curl -X POST https://platform.adobe.io/data/core/ups/config/schedules \
 -H 'Authorization: Bearer {ACCESS_TOKEN}' \
 -H 'Content-Type: application/json' \
 -H 'x-gw-ims-org-id: {ORG_ID}' \
 -H 'x-api-key: {API_KEY}' \
 -H 'x-sandbox-name: {SANDBOX_NAME}'
 -d '
{
    "name": "profile-default",
    "type": "batch_segmentation",
    "properties": {
        "segments": [
            "sampleSegmentDefinitionId"
        ]
    },
    "schedule": "0 0 1 * * ?",
    "state": "inactive"
}'
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2
Proprietà Descrizione
name Obbligatorio. Nome della pianificazione sotto forma di stringa.
type Obbligatorio. Tipo di processo come stringa. I due tipi supportati sono batch_segmentation e export.
properties Obbligatorio. Oggetto contenente proprietà aggiuntive correlate alla pianificazione.
properties.segments Obbligatorio se type è uguale a “batch_segmentation”. Gli ID delle definizioni dei segmenti che desideri includere nella pianificazione.
schedule Obbligatorio. Stringa contenente la pianificazione del processo. È possibile programmare l’esecuzione dei job solo una volta al giorno, pertanto non è possibile programmare l’esecuzione di un job più di una volta in un periodo di 24 ore. La pianificazione del job determina la frequenza della pianificazione. Per ulteriori informazioni sulle pianificazioni cron, leggere l’appendice nel formato di espressione cron 🔗. In questo esempio, “0 0 1 * *” significa che questa pianificazione verrà eseguita ogni giorno all’1.
state Facoltativo. Stringa contenente lo stato della pianificazione. I due stati supportati sono active e inactive. Per impostazione predefinita, lo stato è impostato su inactive.

Risposta

In caso di esito positivo, la risposta restituisce lo stato HTTP 200 con i dettagli della pianificazione appena creata.

Una risposta di esempio durante la creazione di una pianificazione.
code language-json 
{
    "id": "4e538382-dbd8-449e-988a-4ac639ebe72b",
    "imsOrgId": "{ORG_ID}",
    "sandbox": {
        "sandboxId": "e7e17720-c5bb-11e9-aafb-87c71c35cac8",
        "sandboxName": "prod",
        "type": "production",
        "default": true
    },
    "name": "{SCHEDULE_NAME}",
    "state": "inactive",
    "type": "batch_segmentation",
    "schedule": "0 0 1 * * ?",
    "frequency": "daily",
    "properties": {
        "segments": [
            "sampleSegmentDefinitionId"
        ]
    },
    "owner": "user",
    "createEpoch": 1568267948,
    "updateEpoch": 1568267948
}
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 9-row-2 10-row-2 11-row-2 12-row-2 13-row-2 14-row-2 15-row-2 16-row-2
Proprietà Descrizione
id ID della pianificazione appena creata.
imsOrgId ID organizzazione dell’utente che ha creato la pianificazione.
sandbox Oggetto contenente le informazioni sandbox per la pianificazione. Per ulteriori informazioni sulle sandbox, leggere la panoramica sulle sandbox.
sandbox.sandboxId ID della sandbox che contiene la pianificazione.
sandbox.sandboxName Il nome della sandbox che contiene la pianificazione.
sandbox.type Tipo di sandbox. I valori possibili includono production e development.
sandbox.default Valore booleano che indica se la sandbox è la sandbox predefinita o meno.
name Il nome che hai dato alla pianificazione.
state Stato della pianificazione. I valori possibili includono active e inactive. Se non l’hai impostato come parte del corpo della richiesta, lo stato sarà impostato su inactive.
type Tipo di processo per la pianificazione. I valori possibili includono batch_segmentation e export.
schedule Espressione cron che rappresenta quando viene eseguita la pianificazione. Per ulteriori informazioni sulla creazione di espressioni cron, leggere la sezione cron expression format.
frequency La frequenza con cui viene eseguita la pianificazione. Questo dipende direttamente dall’espressione cron della pianificazione. I valori possibili sono daily, weekly, monthly e yearly.
properties Oggetto contenente gli ID di definizione del segmento per la pianificazione, se la pianificazione è di tipo batch_segmentation.
owner Tipo di entità a cui appartiene la programmazione. Da quando hai creato la pianificazione, questo valore è user.
createEpoch Il tempo di creazione dell’epoca per la pianificazione in secondi.
updateEpoch L’ora dell’ultimo aggiornamento della pianificazione, in secondi.

Recuperare una pianificazione specifica get

Per recuperare informazioni dettagliate su una pianificazione specifica, eseguire una richiesta GET all’endpoint /config/schedules e fornire l’ID della pianificazione da recuperare nel percorso della richiesta.

Formato API

GET /config/schedules/{SCHEDULE_ID}
Parametro
Descrizione
{SCHEDULE_ID}
Il valore id della pianificazione da recuperare.

Richiesta

Richiesta di esempio per recuperare una pianificazione.
code language-shell 
curl -X GET https://platform.adobe.io/data/core/ups/config/schedules/4e538382-dbd8-449e-988a-4ac639ebe72b
 -H 'Authorization: Bearer {ACCESS_TOKEN}' \
 -H 'x-gw-ims-org-id: {ORG_ID}' \
 -H 'x-api-key: {API_KEY}' \
 -H 'x-sandbox-name: {SANDBOX_NAME}'

Risposta

In caso di esito positivo, la risposta restituisce lo stato HTTP 200 con informazioni dettagliate sulla pianificazione specificata.

Una risposta di esempio durante il recupero di una pianificazione.
code language-json 
{
    "id": "4e538382-dbd8-449e-988a-4ac639ebe72b",
    "imsOrgId": "{ORG_ID}",
    "sandbox": {
        "sandboxId": "e7e17720-c5bb-11e9-aafb-87c71c35cac8",
        "sandboxName": "prod",
        "type": "production",
        "default": true
    },
    "name": "{SCHEDULE_NAME}",
    "state": "inactive",
    "type": "batch_segmentation",
    "schedule": "0 0 1 * * ?",
    "frequency": "daily",
    "properties": {
        "segments": [
            "sampleSegmentDefinitionId"
        ]
    },
    "owner": "user",
    "createEpoch": 1568267948,
    "updateEpoch": 1568267948
}
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 9-row-2 10-row-2 11-row-2 12-row-2 13-row-2 14-row-2 15-row-2 16-row-2 17-row-2
Proprietà Descrizione
id ID della pianificazione.
imsOrgId ID dell’organizzazione a cui appartiene la pianificazione.
sandbox Oggetto contenente le informazioni sandbox per la pianificazione. Per ulteriori informazioni sulle sandbox, leggere la panoramica sulle sandbox.
sandbox.sandboxId ID della sandbox che contiene la pianificazione.
sandbox.sandboxName Il nome della sandbox che contiene la pianificazione.
sandbox.type Tipo di sandbox. I valori possibili includono production e development.
sandbox.default Valore booleano che indica se la sandbox è la sandbox predefinita o meno.
name Nome della pianificazione sotto forma di stringa.
state Stringa contenente lo stato della pianificazione. I due stati supportati sono active e inactive. Per impostazione predefinita, lo stato è impostato su inactive.
type Tipo di processo come stringa. I due tipi supportati sono batch_segmentation e export.
schedule Stringa contenente la pianificazione del processo. È possibile programmare l’esecuzione dei job solo una volta al giorno, pertanto non è possibile programmare l’esecuzione di un job più di una volta in un periodo di 24 ore. Per ulteriori informazioni sulle pianificazioni cron, leggere l’appendice nel formato di espressione cron 🔗. In questo esempio, “0 0 1 * *” significa che questa pianificazione verrà eseguita ogni giorno all’1.
frequency La frequenza di esecuzione della pianificazione. Questo valore dipende direttamente dall’espressione cron della pianificazione. I valori possibili sono daily, weekly, monthly e yearly.
properties Oggetto contenente proprietà aggiuntive correlate alla pianificazione.
properties.segments L’elenco degli ID di definizione del segmento che fanno parte della pianificazione.
owner Tipo di entità a cui appartiene la programmazione. Se un utente ha creato la pianificazione, il valore è user. Se la pianificazione è una pianificazione creata dal sistema, il valore è system.
createEpoch Il tempo di creazione dell’epoca per la pianificazione in secondi.
updateEpoch L’ora dell’ultimo aggiornamento della pianificazione, in secondi.

Aggiorna i dettagli per una pianificazione specifica update

È possibile aggiornare una pianificazione specifica effettuando una richiesta PATCH all’endpoint /config/schedules e fornendo l’ID della pianificazione che si sta tentando di aggiornare nel percorso della richiesta.

La richiesta PATCH ti consente di aggiornare state o la cron schedule per una singola pianificazione.

Formato API

PATCH /config/schedules/{SCHEDULE_ID}
Parametro
Descrizione
{SCHEDULE_ID}
Il valore id della pianificazione da aggiornare.
Aggiorna stato pianificazione

È possibile utilizzare un’operazione Patch JSON per aggiornare lo stato della pianificazione. Per aggiornare lo stato, dichiarare la proprietà path come /state e impostare value su active o inactive. Per ulteriori informazioni sulla patch JSON, leggere la documentazione della patch JSON.

Richiesta

accordion
Richiesta di esempio per aggiornare lo stato della pianificazione.
code language-shell 
curl -X PATCH https://platform.adobe.io/data/core/ups/config/schedules/4e538382-dbd8-449e-988a-4ac639ebe72b \
 -H 'Authorization: Bearer {ACCESS_TOKEN}' \
 -H 'x-gw-ims-org-id: {ORG_ID}' \
 -H 'x-api-key: {API_KEY}' \
 -H 'x-sandbox-name: {SANDBOX_NAME}'
 -d '
[
    {
        "op": "add",
        "path": "/state",
        "value": "active"
    }
]'
table 0-row-2 1-row-2 2-row-2
Proprietà Descrizione
path Percorso del valore a cui applicare la patch. In questo caso, poiché si sta aggiornando lo stato della pianificazione, è necessario impostare il valore di path su “/state”.
value Il valore aggiornato dello stato della pianificazione. Questo valore può essere impostato come “attivo” o “inattivo” per attivare o disattivare la pianificazione. impossibile disabilitare una pianificazione se l’organizzazione è stata abilitata per lo streaming.

Risposta

In caso di esito positivo, la risposta restituisce lo stato HTTP 204 (nessun contenuto).

Aggiorna pianificazione cron
È possibile utilizzare un’operazione Patch JSON per aggiornare la pianificazione cron. Per aggiornare la pianificazione, dichiarare la proprietà path come /schedule e impostare value su una pianificazione cron valida. Per ulteriori informazioni sulla patch JSON, leggere la documentazione della patch JSON. Per ulteriori informazioni sulle pianificazioni cron, leggere l’appendice nel formato di espressione cron 🔗.

Richiesta

Richiesta di esempio per aggiornare la pianificazione.
code language-shell 
curl -X PATCH https://platform.adobe.io/data/core/ups/config/schedules/4e538382-dbd8-449e-988a-4ac639ebe72b \
 -H 'Authorization: Bearer {ACCESS_TOKEN}' \
 -H 'x-gw-ims-org-id: {ORG_ID}' \
 -H 'x-api-key: {API_KEY}' \
 -H 'x-sandbox-name: {SANDBOX_NAME}'
 -d '
[
    {
        "op":"add",
        "path":"/schedule",
        "value":"0 0 2 * * ?"
    }
]'
table 0-row-2 1-row-2 2-row-2
Proprietà Descrizione
path Percorso del valore da aggiornare. In questo caso, poiché si sta aggiornando la pianificazione cron, è necessario impostare il valore di path su /schedule.
value Il valore aggiornato della pianificazione cron. Questo valore deve essere sotto forma di una pianificazione cron. In questo esempio, la pianificazione verrà eseguita il secondo di ogni mese.

Risposta

In caso di esito positivo, la risposta restituisce lo stato HTTP 204 (nessun contenuto).

Eliminare una pianificazione specifica

È possibile richiedere l’eliminazione di una pianificazione specifica effettuando una richiesta DELETE all’endpoint /config/schedules e fornendo l’ID della pianificazione da eliminare nel percorso della richiesta.

Formato API

DELETE /config/schedules/{SCHEDULE_ID}
Parametro
Descrizione
{SCHEDULE_ID}
Il valore id della pianificazione da eliminare.

Richiesta

Richiesta di esempio per eliminare una pianificazione.
code language-shell 
curl -X DELETE https://platform.adobe.io/data/core/ups/config/schedules/4e538382-dbd8-449e-988a-4ac639ebe72b \
 -H 'Authorization: Bearer {ACCESS_TOKEN}' \
 -H 'x-gw-ims-org-id: {ORG_ID}' \
 -H 'x-api-key: {API_KEY}' \
 -H 'x-sandbox-name: {SANDBOX_NAME}'

Risposta

In caso di esito positivo, la risposta restituisce lo stato HTTP 204 (nessun contenuto).

Aggiungi tipi di pubblico alla pianificazione add-audiences

È possibile aggiungere tipi di pubblico a una pianificazione specifica effettuando una richiesta POST all’endpoint /config/schedules/add-audiences.

Formato API

POST /config/schedules/add-audiences

Richiesta

Una richiesta di esempio per aggiungere tipi di pubblico alla pianificazione.
code language-shell 
curl -X POST https://platform.adobe.io/data/core/ups/config/schedules/add-audiences/
 -H 'Authorization: Bearer {ACCESS_TOKEN}' \
 -H 'x-gw-ims-org-id: {ORG_ID}' \
 -H 'x-api-key: {API_KEY}' \
 -H 'x-sandbox-name: {SANDBOX_NAME}'
 -d '
 {
    "id": "4e538382-dbd8-449e-988a-4ac639ebe72b",
    "segments": [
        "sampleSegmentDefinitionId"
    ]
 }
 '
Proprietà
Descrizione
id
ID della pianificazione a cui desideri aggiungere i tipi di pubblico.
segments
Array degli ID di definizione del segmento che desideri aggiungere alla pianificazione designata.

Risposta

In caso di esito positivo, la risposta restituisce lo stato HTTP 200 con informazioni dettagliate sull’operazione.

Una risposta di esempio quando si aggiungono tipi di pubblico alla pianificazione.
code language-json 
{
    "added:" [
        "sampleSegmentDefinitionId"
    ],
    "existing": [],
    "invalid": [],
    "segmentCount": {
        "previous": 0,
        "current": 1,
        "diff": 1
    }
}
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2
Proprietà Descrizione
added Array contenente gli ID delle definizioni dei segmenti aggiunti alla pianificazione.
existing Array contenente gli ID delle definizioni dei segmenti già presenti nella pianificazione.
invalid Matrice contenente ID di definizione del segmento non validi che facevano parte del corpo della richiesta.
segmentCount Oggetto contenente il numero di definizioni di segmenti che in precedenza facevano parte della pianificazione (previous), il numero di definizioni di segmenti che ora fanno parte della pianificazione (current) e la differenza tra questi due valori (diff).

Rimuovi tipi di pubblico dalla pianificazione remove-audiences

Per rimuovere un pubblico da una pianificazione specifica, devi eseguire una richiesta POST all’endpoint /config/schedules/remove-audiences.

Formato API

POST /config/schedules/remove-audiences

Richiesta

Una richiesta di esempio per rimuovere i tipi di pubblico dalla pianificazione.
code language-shell 
curl -X POST https://platform.adobe.io/data/core/ups/config/schedules/remove-audiences/
 -H 'Authorization: Bearer {ACCESS_TOKEN}' \
 -H 'x-gw-ims-org-id: {ORG_ID}' \
 -H 'x-api-key: {API_KEY}' \
 -H 'x-sandbox-name: {SANDBOX_NAME}'
 -d '
 {
    "id": "4e538382-dbd8-449e-988a-4ac639ebe72b",
    "segments": [
        "sampleSegmentDefinitionId"
    ]
 }
 '
Proprietà
Descrizione
id
ID della pianificazione da cui desideri rimuovere i tipi di pubblico.
segments
Array degli ID di definizione del segmento che desideri rimuovere dalla pianificazione designata.

Risposta

In caso di esito positivo, la risposta restituisce lo stato HTTP 200 con informazioni dettagliate sull’operazione.

Una risposta di esempio durante la rimozione di tipi di pubblico dalla pianificazione.
code language-json 
{
    "removed": [
        "sampleSegmentDefinitionId"
    ],
    "notFound": [],
    "segmentCount": {
        "previous": 2,
        "current": 1,
        "diff": -1
    }
}
table 0-row-2 1-row-2 2-row-2 3-row-2
Proprietà Descrizione
removed Array contenente gli ID delle definizioni dei segmenti rimossi dalla pianificazione.
notFound Array contenente gli ID delle definizioni dei segmenti che non sono stati trovati all’interno della pianificazione.
segmentCount Oggetto contenente il numero di definizioni di segmenti che in precedenza facevano parte della pianificazione (previous), il numero di definizioni di segmenti che ora fanno parte della pianificazione (current) e la differenza tra questi due valori (diff).

Ottieni mappa pubblico get-audience-map

Per ottenere la mappa del pubblico dei tuoi tipi di pubblico, effettua una richiesta POST all’endpoint /config/schedules/audience-map. La mappa del pubblico rappresenta una mappatura tra gli ID di definizione del segmento e i programmi a cui appartengono tali ID.

Formato API

POST /config/schedules/audience-map

Richiesta

Una richiesta di esempio per ottenere la mappa del pubblico per gli ID di definizione del segmento corrispondenti.
code language-shell 
curl -X POST https://platform.adobe.io/data/core/ups/config/schedules/audience-map/
 -H 'Authorization: Bearer {ACCESS_TOKEN}' \
 -H 'x-gw-ims-org-id: {ORG_ID}' \
 -H 'x-api-key: {API_KEY}' \
 -H 'x-sandbox-name: {SANDBOX_NAME}'
 -d '
 {
    "segments": [
        "sampleSegmentDefinitionId",
        "sampleSegmentDefinition2",
        "sampleSegmentDefinition3"
    ]
 }
 '
Proprietà
Descrizione
segments
Array degli ID di definizione del segmento per cui desideri recuperare le informazioni sulla pianificazione.

Risposta

In caso di esito positivo, la risposta restituisce lo stato HTTP 200 con informazioni dettagliate sul pubblico e sulla mappatura della pianificazione.

Una risposta di esempio durante il recupero della mappa del pubblico.
code language-json 
{
    "audienceMap": {
        "sampleSegmentDefinitionId": [
            "4e538382-dbd8-449e-988a-4ac639ebe72b"
        ],
        "sampleSegmentDefinition2": [],
        "sampleSegmentDefinition3": []
    },
    "schedules": {
        "4e538382-dbd8-449e-988a-4ac639ebe72b": {
            "name": "Sample schedule",
            "schedule": "0 0 18 * * ?",
            "frequency": "daily"
        }
    }
}
table 0-row-2 1-row-2 2-row-2
Proprietà Descrizione
audienceMap Mappatura degli ID di definizione dei segmenti con le pianificazioni a cui appartengono.
schedules Oggetto contenente informazioni sulle pianificazioni elencate nella mappa del pubblico.

Attiva processo di pianificazione trigger

È possibile attivare manualmente una pianificazione effettuando una richiesta POST all’endpoint /config/schedules/trigger.

Formato API

POST /config/schedules/trigger

Richiesta

Richiesta di esempio per attivare una pianificazione per l'attivazione.
code language-shell 
curl -X POST https://platform.adobe.io/data/core/ups/config/schedules/trigger/
 -H 'Authorization: Bearer {ACCESS_TOKEN}' \
 -H 'x-gw-ims-org-id: {ORG_ID}' \
 -H 'x-api-key: {API_KEY}' \
 -H 'x-sandbox-name: {SANDBOX_NAME}'
 -d '
 {
    "id": "4e538382-dbd8-449e-988a-4ac639ebe72b"
 }
 '
Proprietà
Descrizione
id
ID della pianificazione da attivare. devi attivare le pianificazioni una alla volta.

Risposta

In caso di esito positivo, la risposta restituisce lo stato HTTP 200 senza contenuto.

Passaggi successivi

Dopo aver letto questa guida, ora hai una migliore comprensione di come funzionano le pianificazioni.

Appendice appendix

Nell’appendice seguente viene illustrato il formato delle espressioni cron utilizzate nelle pianificazioni.

Formato

Un’espressione cron è una stringa composta da 6 o 7 campi. L’espressione sarà simile alla seguente:

0 0 12 * * ?

In una stringa di espressione cron, il primo campo rappresenta i secondi, il secondo campo rappresenta i minuti, il terzo campo rappresenta le ore, il quarto campo rappresenta il giorno del mese, il quinto campo rappresenta il mese e il sesto campo rappresenta il giorno della settimana. Facoltativamente, è anche possibile includere un settimo campo, che rappresenta l’anno.

Nome campo
Obbligatorio
Valori possibili
Caratteri speciali consentiti
Seconds
Sì
0-59
, - * /
Minutes
Sì
0-59
, - * /
Ore
Sì
0-23
, - * /
Giorno del mese
Sì
1-31
, - * ? / L W
Month
Sì
1-12 GEN-DIC
, - * /
Giorno della settimana
Sì
1-7, SUN-SAT
, - * ? / L #
Year
No
Vuoto, 1970-2099
, - * /
NOTE
I nomi dei mesi e dei giorni della settimana sono senza distinzione tra maiuscole e minuscole. Pertanto, SUN equivale a utilizzare sun.

I caratteri speciali consentiti rappresentano i seguenti significati:

Carattere speciale
Descrizione
*
Questo valore viene utilizzato per selezionare tutti valori in un campo. Ad esempio, inserire * nel campo ore significherebbe ogni ora.
?
Questo valore significa che non è richiesto alcun valore specifico. Questo generalmente viene utilizzato per specificare qualcosa in un campo in cui il carattere è consentito, ma non specificarlo nell’altro. Ad esempio, se desideri che un evento venga attivato ogni 3 del mese, ma non importa di quale giorno della settimana si tratti, inserisci 3 nel campo del giorno del mese e ? nel campo del giorno della settimana.
-
Questo valore viene utilizzato per specificare inclusivo intervalli per il campo. Ad esempio, se inserisci 9-15 nel campo ore, significa che le ore includerebbero 9, 10, 11, 12, 13, 14 e 15.
,
Questo valore viene utilizzato per specificare valori aggiuntivi. Se ad esempio si inserisce MON, FRI, SAT nel campo del giorno della settimana, i giorni della settimana includeranno lunedì, venerdì e sabato.
/
Questo valore viene utilizzato per specificare gli incrementi. Il valore posizionato prima di / determina da dove viene incrementato, mentre il valore posizionato dopo / determina di quanto viene incrementato. Se ad esempio si inserisce 1/7 nel campo minuti, i minuti includeranno 1, 8, 15, 22, 29, 36, 43, 50 e 57.
L
Questo valore viene utilizzato per specificare Last e ha un significato diverso a seconda del campo da cui viene utilizzato. Se viene utilizzato con il campo del giorno del mese, rappresenta l’ultimo giorno del mese. Se viene utilizzato con il campo del giorno della settimana, rappresenta l’ultimo giorno della settimana, ovvero il sabato (SAT). Se viene utilizzato insieme al campo giorno della settimana e a un altro valore, rappresenta l’ultimo giorno di quel tipo per il mese. Se ad esempio si inserisce 5L nel campo del giorno della settimana, solo includerebbe l’ultimo venerdì del mese.
W
Questo valore viene utilizzato per specificare il giorno feriale più vicino al giorno specificato. Ad esempio, se si inserisce 18W nel campo del giorno del mese e il 18 di quel mese è un sabato, l’attivazione avverrà venerdì 17, che è il giorno feriale più vicino. Se il 18 di quel mese fosse una domenica, sarebbe attivato lunedì 19, che è il giorno feriale più vicino. Tieni presente che se inserisci 1W nel campo del giorno del mese e il giorno feriale più vicino è nel mese precedente, l’evento verrà comunque attivato nel giorno feriale più vicino del mese corrente.

Inoltre, puoi combinare L e W per creare LW, che specificherebbe l’ultimo giorno feriale del mese.
#
Questo valore viene utilizzato per specificare l’ennesimo giorno della settimana in un mese. Il valore inserito prima del # rappresenta il giorno della settimana, mentre il valore inserito dopo il # rappresenta l’occorrenza nel mese in cui si trova. Se ad esempio si inserisce 1#3, l’evento verrà attivato la terza domenica del mese. Tieni presente che se inserisci X#5 e non si verifica un quinto evento di quel giorno della settimana in quel mese, l’evento non verrà attivato. Ad esempio, se inserisci 1#5 e non c’è una quinta domenica in quel mese, l’evento non verrà attivato.

Esempi

La tabella seguente mostra alcune stringhe di espressioni cron di esempio e ne spiega il significato.

Espressione
Spiegazione
0 0 13 * * ?
L’evento si attiva ogni giorno alle 13.
0 30 9 * * ? 2022
L’evento si attiva ogni giorno alle 9:30 del 2022.
0 * 18 * * ?
L’evento si attiva ogni minuto, dalle 18:00 alle 18:59, tutti i giorni.
0 0/10 17 * * ?
L’evento si attiva ogni 10 minuti, dalle 17:00 alle 18:00, in qualsiasi giornata.
0 13,38 5 ? 6 WED
L’evento si attiverà alle 5:13 del mattino e alle 5:38 di ogni mercoledì di giugno.
0 30 12 ? * 4#3
L’evento si attiva alle 12:30 del terzo mercoledì di ogni mese.
0 30 12 ? * 6L
L’evento verrà attivato alle 12:30 dell’ultimo venerdì di ogni mese.
0 45 11 ? * MON-THU
L’evento si attiva alle 11:45 di ogni lunedì, martedì, mercoledì e giovedì.
recommendation-more-help
experience-platform-help-segmentation