Modifica in programma alla disattivazione della versione dell'API Marketing per abilitare l'upgrade automatico della versione

16 aprile 2024DiMengxuan Zhang

Attiva iscrizione a Novità per gli sviluppatori

Allo scopo di migliorare l'esperienza API complessiva rendendola più intuitiva ed efficiente, siamo entusiasti di annunciare il lancio previsto della funzione di upgrade automatico della versione MAPI. A partire da maggio 2024, abiliteremo la funzione di upgrade di versione automatico per gli endpoint dell'API Marketing non interessati tra una versione e l'altra. Questo significa che tra una versione da disattivare e la successiva versione disponibile, se un endpoint non è interessato, la piattaforma effettuerà automaticamente l'upgrade della chiamata alla successiva versione disponibile piuttosto che respingere direttamente la richiesta.

Il controllo delle versioni di un'API è un modo comune di gestire le modifiche all'API, utilizzato principalmente per il rilascio di modifiche sostanziali. Con il rilascio di nuove versioni, quelle precedenti vengono disattivate. In fase di disattivazione dell'API, se un'app effettua una chiamata a una versione API obsoleta, riceverà l'errore "(#2635) You are calling a deprecated version of the Ads API. Please update to the latest version: vXXX" (Stai chiamando una versione obsoleta dell'API Ads. Aggiornala alla versione più recente: vXXX).

La v17.0 diventerà obsoleta il 14 maggio 2024. Secondo il registro delle modifiche della v18.0, saranno interessati i seguenti endpoint:

POST /act_{ad-account-id}/reachfrequencypredictions
GET /act_{ad-account-id}/reachestimate
GET /act_{ad-account-id}/delivery_estimate
POST /act_{ad-account-id}/adsets
POST /{adset-id}
POST /act_{ad-account-id}/saved_audiences
POST /{saved-audience-id}
POST /act_{ad-account-id}/credit_cards

Se la tua app effettua una chiamata POST /{adset-id} con la v17.0 dopo la disattivazione del 14 maggio 2024, la richiesta API non andrà a buon fine in quanto l'upgrade automatico non si applica agli endpoint interessati dalla successiva versione disponibile v18.0.

Se la tua app effettua una chiamata GET /{ad-account-id}/insights con la v17.0 dopo la disattivazione, la piattaforma effettuerà l'upgrade della chiamata alla successiva versione disponibile v18.0.

Se la tua app ha già iniziato a effettuare chiamate con versioni successive alla v17.0, non ci saranno cambiamenti alla data di disattivazione della versione.

Per disattivare la funzione di upgrade automatico della versione, seleziona Settings (Impostazioni) > Ads API Version Settings (Impostazioni versione API Ads) nella scheda dei prodotti nell'app dell'API Marketing.

Per controllare se è stato eseguito l'upgrade automatico di una chiamata, controlla l'intestazione della risposta API per maggiori dettagli.

Esempio di intestazione di notifica: "X-Ad-Api-Version-Warning: The call has been auto-upgraded to v17.0 as v16.0 has been deprecate" (Avviso versione API Ad X: è stato eseguito l'upgrade automatico della chiamata alla v17.0 perché la v16.0 è diventata obsoleta).

Per maggiori informazioni su questo comportamento, fai riferimento al documento Gestione delle versioni dell'API Marketing.

Per controllare gli endpoint interessati per ogni versione, consulta il Registro modifiche.

Endpoint interessati