DocumentazioneAudience ManagerGuida utente di Audience Manager

Metodi API per la gestione dei domini domain-management-api-methods

Last update: Sat Jul 20 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Argomenti:
  • API

Metodi di gestione dei domini che consentono di creare e gestire i domini a cui si desidera inviare i dati (solo per le destinazioni dei cookie).

Crea un nuovo dominio create-new-domain

Metodo POST che consente di creare un nuovo dominio per (solo destinazioni cookie).

Richiesta

POST https://api.demdex.com/v1/partner-sites/

Richiesta di esempio

{
   "url":"example1.com"
}

Risposta

In caso di esito positivo, la risposta restituisce 201 created e il sito partner, incluso il relativo ID univoco.

{
    "pid": 1111,
    "siteId": 111,
    "url": "example1.com"
}

Eliminare un dominio delete-domain

Metodo DELETE che consente di rimuovere un dominio (solo per le destinazioni dei cookie).

Richiesta

DELETE https://api.demdex.com/v1/partner-sites/<site-Id>

Risposta

In caso di esito positivo, la risposta restituisce 204 no content. Restituisce 404 not found se il sito partner non è stato trovato.

Restituire le proprietà di un dominio return-props-domain

Metodo GET che restituisce i dettagli del dominio specificato (solo per le destinazioni dei cookie).

Richiesta

GET https://api.demdex.com/v1/partner-sites/<siteId>

Risposta

In caso di esito positivo, la risposta restituisce 200 OK e i dati come mostrato nell'esempio seguente. Restituisce 404 Not found se l'ID sito o il partner non è stato trovato.

{
    "pid": 1111,
    "siteId": 111,
    "url": "example1.com"
}

Proprietà restituite per tutti i domini return-props-all-domains

Un metodo GET che restituisce informazioni su tutti i tuoi domini (solo per destinazioni cookie).

Richiesta

GET https://api.demdex.com/v1/partner-sites/

Parametri di query facoltativi

È possibile utilizzare questi parametri facoltativi con i metodi API che restituiscono tutte le proprietà di un oggetto. Impostare queste opzioni nella stringa di richiesta quando si trasmette la query a API. Vedi Parametri facoltativi.

Parametro
Descrizione
page
Restituisce i risultati per numero di pagina. La numerazione inizia da 0.
pageSize
Imposta il numero di risultati di risposta restituiti dalla richiesta (10 è il valore predefinito).
sortBy
Ordina e restituisce i risultati in base alla proprietà JSON specificata.
descending
Ordina e restituisce i risultati in ordine decrescente. L'impostazione predefinita è Crescente.
search

Restituisce risultati in base alla stringa specificata che si desidera utilizzare come parametro di ricerca. Ad esempio, supponiamo che si desideri trovare i risultati per tutti i modelli che hanno la parola "Test" in uno qualsiasi dei campi di valore per quell'elemento. La richiesta di esempio potrebbe essere simile alla seguente:

`GET` `https://api.demdex.com/v1/models/?search=Test`.

Puoi eseguire ricerche su qualsiasi valore restituito da un metodo "get all".

Risposta

In caso di esito positivo, la risposta restituisce 200 OK e i dati in un array, come illustrato nell'esempio seguente. Restituisce 404 Not found se l'ID sito o il partner non è stato trovato.

[
    {
        "pid": 1111,
        "siteId": 111,
        "url": "example1.com"
    },
    {
        "pid": 2222,
        "siteId": 222,
        "url": "example2.com"
    },
    {
        "pid": 3333,
        "siteId": 333,
        "url": "example3.com"
    }
]
recommendation-more-help
de293fbf-b489-49b0-8daa-51ed303af695