Presentazione dell'API Graph v26.0 e dell'API Marketing v26.0

L'API Graph v26.0 e l'API Marketing v26.0 includono nuove funzionalità, obsolescenze e modifiche sostanziali. Consulta le informazioni salienti di seguito e visita il registro modifiche V26.0 per l'elenco completo delle modifiche e dei dettagli.

Date e modifiche importanti

• API Graph - Gestione degli ordini di vendita: le chiamate agli endpoint interessati sulla versione 26.0 e successive saranno bloccate a partire dal 29 luglio 2026. Gli endpoint saranno rimossi da tutte le versioni dell'API Graph rimanenti il 27 ottobre 2026, dopo tale data le chiamate restituiranno errori. Non è disponibile un'API sostitutiva.
• API Graph - Campi del titolare di Rights Manager: a partire dalla v26.0 del 29 luglio 2026, saranno disponibili campi sostitutivi che restituiscono il tipo RightsHolderOwner e i campi del titolare obsoleti non saranno più restituiti. I campi obsoleti rimarranno disponibili nella versione 25.0 e nelle precedenti per due anni dal lancio della versione 26.0.
• API Graph - Funzioni del protocollo legacy: cinque comportamenti legacy saranno rimossi dalle chiamate v26.0 a partire dal 29 luglio 2026. Lo stesso comportamento si applica a tutte le versioni dell'API Graph rimanenti a partire dal 27 ottobre 2026.
• API Marketing - Inserzioni nello stato di WhatsApp: la versione 26.0 aggiunge funzionalità ampliate di identità, targetizzazione, ottimizzazione e creatività a partire dal 29 luglio 2026.
• API Marketing - Pubblico Advantage+ per campagne relative ad alloggi, impiego e prodotti e servizi finanziari: a partire dalla versione 26.0 del 29 luglio 2026, i gruppi di inserzioni nuovi o copiati con targetizzazione con restrizioni dovranno esplicitamente impostare advantage_audience su 1 o 0. Le configurazioni predefinite o flessibili continueranno ad avere questo valore impostato su 1 per impostazione predefinita. Gli aggiornamenti dei gruppi di inserzioni esistenti non saranno coinvolti.
• API Marketing - Feed di Esplora di Instagram: il posizionamento non è più disponibile a partire dalla versione 26.0 del 29 luglio 2026. Gli sviluppatori devono rimuovere Esplora dalle loro configurazioni dei posizionamenti.
• API Marketing - Destinazione solo web per campagne web e app: a partire dalla v26.0 del 29 luglio 2026, un'inserzione non potrà usare una creatività con applink_treatment impostato su web_only quando la campagna usa i luoghi di conversione del sito web e dell'app. La restrizione si applica a tutte le versioni dell'API Marketing a partire dal 27 ottobre 2026.
• API Marketing - Messenger Stories: a partire dalle chiamate con versione v26.0 del 29 luglio 2026, il valore story verrà rimosso senza avviso da messenger_positions quando si creano o si aggiornano gruppi di inserzioni. L'obsolescenza si applica a tutte le versioni dell'API Marketing, comprese le chiamate senza versione, il 27 ottobre 2026.
• API Marketing - Creazione di inserzioni con sondaggio: a partire dalla versione 26.0 del 29 luglio 2026, le richieste che creano creatività con sondaggio o modificano un'inserzione per usarne una saranno rifiutate. Gli aggiornamenti delle inserzioni esistenti che non modificano le creatività continuano a essere supportati. L'obsolescenza si applica a tutte le versioni dell'API Marketing a partire dal 27 ottobre 2026.
• API Graph e API Marketing - Campi di stima di pubblicazione: i campi di risposta daily_outcomes_curve, budget_guardrail, e estimate_dau saranno rimossi dalle chiamate v26.0 a partire dal 29 luglio 2026, e da tutte le versioni supportate rimanenti il 27 ottobre 2026. Non è disponibile un'API sostitutiva.
• Ritiri delle versioni dell'API Graph: l'API Graph v20.0 è obsoleta e verrà rimossa il 24 settembre 2026. L'API Graph v21.0 è stata dichiarata obsoleta e sarà rimossa il 21 gennaio 2027.

Aggiornamenti generali

API Marketing: supporto ampliato per le inserzioni nello stato di WhatsApp

A partire dall'API Marketing v26.0 del 29 luglio 2026, le inserzioni nello stato di WhatsApp supportano funzionalità aggiuntive relative a identità, targetizzazione, ottimizzazione e creatività.

• Identità WhatsApp: i chiamanti API Marketing terzi devono includere esplicitamente wamo_whatsapp_identity_spec nelle creatività delle inserzioni destinate alla pubblicazione nello stato di WhatsApp. L'identità di WhatsApp non è impostata automaticamente per questi mittenti.
• Targetizzazione basata su età sconosciuta: quando il posizionamento Stato di WhatsApp è selezionato e user_age_unknown non è impostato, il campo è impostato automaticamente su true, il che significa che la campagna può raggiungere persone su WhatsApp di cui non si conosce l'età.
• Ottimizzazione: l'ottimizzazione delle conversioni per le conversioni fuori dal sito è supportata per gli obiettivi Vendite, Contatti e Interazioni. È supportata anche l'ottimizzazione delle visualizzazioni della pagina di destinazione.
• Formato creativo: le inserzioni carosello supportano fino a 10 unità.

Per maggiori dettagli, consulta la documentazione sulla targetizzazione dei posizionamenti e sulla targetizzazione di base.

Obsolescenze e modifiche sostanziali

API Graph e API Marketing: rimozione del campo Stima di pubblicazione

I campi daily_outcomes_curve, budget_guardrail e estimate_dau verranno rimossi dalla risposta dell'endpoint Stima di pubblicazione perché il servizio che fornisce questi valori non è più supportato. A partire dall'API Graph v26.0 e dall'API Marketing v26.0 del 29 luglio 2026, questi campi non saranno più restituiti. La modifica verrà applicata a tutte le versioni supportate dell'API Graph e dell'API Marketing rimanenti il 27 ottobre 2026. Non è disponibile un'API sostitutiva.

Gli sviluppatori devono rimuovere qualsiasi utilizzo di questi campi o i riferimenti a essi prima della data di rimozione applicabile.

Gli endpoint interessati includono:

• GET /{ad-account-id}/delivery_estimate - Stime di pubblicazione dell'account pubblicitario
• GET /{adset-id}/delivery_estimate - Stime di pubblicazione del gruppo di inserzioni

La lista completa dei campi e degli endpoint sarà disponibile nel registro modifiche V26.0.

API Graph: obsolescenza dell'API per la gestione degli ordini di vendita

Le app che chiamano questi endpoint sull'API Graph v26.0 e versioni successive saranno bloccate a partire dal 29 luglio 2026. Gli endpoint saranno rimossi per tutte le versioni dell'API Graph rimanenti il 27 ottobre 2026, dopo tale data le chiamate restituiranno errori.

L'esperienza di acquisto direttamente su Facebook e Instagram per Shops è stata completamente disattivata. L'API Commerce Order Management consentiva alle piattaforme di terzi di elencare gli ordini, visualizzare i dettagli degli ordini, gestire le spedizioni, elaborare gli annullamenti, gestire i rimborsi e monitorare i resi per quell'esperienza di acquisto. Poiché l'infrastruttura sottostante degli ordini di vendita sta per essere ritirata, questi endpoint non saranno più disponibili.

Gli sviluppatori dovrebbero interrompere le chiamate a questi endpoint e rimuovere la dipendenza. Non è disponibile un'API sostitutiva.

Gli endpoint interessati includono:

• GET /{commerce-order-id} - Dettagli dell'ordine
• GET /{commerce-order-id}/items - Articoli dell'ordine
• GET /{commerce-order-id}/payments - Order payments
• GET /{commerce-order-id}/payment_transaction_details - Dettagli della transazione di pagamento
• GET /{commerce-order-id}/refunds - Rimborsi degli ordini
• GET /{commerce-order-id}/shipments - Spedizioni degli ordini
• GET /{commerce-order-shipment-id}/items - Shipment line items
• GET /{commerce-return-id} - Dettagli del reso
• GET /{commerce-order-cancellation-id}/items - Cancellation line items
• GET /{page-id}/commerce_orders - Elenco degli ordini per Pagina
• GET /{commerce-merchant-settings-id}/commerce_orders - Elenco degli ordini per impostazioni del venditore
• GET /{commerce-merchant-settings-id}/commerce_returns - Elenco dei resi per impostazioni del venditore
• GET /{commerce-merchant-settings-id}/tax_settings - Tax settings

L'elenco completo dei 47 endpoint interessati sarà disponibile nel registro modifiche dell'API Graph v26.0.

API Graph: i campi del titolare di Rights Manager sono stati spostati in RightsHolderOwner

I campi reference_owner e matched_reference_owner su AudioVisualReferenceMatch e ImageReferenceMatch, insieme ai campi sending_rights_holder e receiving_rights_holder su CopyrightOwnershipTransfer, non saranno più disponibili. A partire dall'API Graph v26.0, i campi sostitutivi che restituiscono il tipo RightsHolderOwner dedicato sono disponibili per rappresentare meglio il modello di proprietà usato da Rights Manager. I campi obsoleti non vengono più restituiti nelle risposte della versione 26.0 e successive.

I campi obsoleti continueranno a funzionare sulla versione 25.0 e sulle precedenti per due anni dopo il lancio della versione 26.0, dopodiché saranno rimossi. Gli sviluppatori dovrebbero eseguire la migrazione ai campi sostitutivi durante questo intervallo di tempo.

Usa i seguenti campi sostitutivi:

• Usa reference_owner_rh_owner invece di reference_owner.
• Usa matched_reference_owner_rh_owner invece di matched_reference_owner.
• Usa sending_rights_holder_owner invece di sending_rights_holder.
• Usa receiving_rights_holder_owner invece di receiving_rights_holder.

Gli endpoint interessati includono:

• GET /{audio-visual-reference-match-id} - Dettagli della corrispondenza di riferimento
• GET /{image-reference-match-id} - Dettagli della corrispondenza dell'immagine di riferimento
• GET /{copyright-ownership-transfer-id} - Dettagli sul trasferimento della proprietà

La lista completa dei campi sarà disponibile nel registro modifiche dell'API Graph v26.0.

API Graph: funzioni del protocollo legacy obsolete

A partire dal 29 luglio 2026, l'API Graph v26.0 e successive non supporterà più cinque comportamenti del protocollo legacy: pretty, debug, date_format, richieste root GET /?ids=... e gestione legacy If-None-Match/ETag.

Questi comportamenti vengono ritirati per semplificare le risposte dell'API Graph e rendere più coerente la gestione delle richieste.

Per l'API Graph v26.0 e successive:

• pretty viene ignorato e le risposte JSON usano la formattazione compatta. Formatta JSON negli strumenti client o nel codice.
• debug viene ignorato e non viene aggiunta nessuna struttura di risposta di debug. Usa gli strumenti di debug standard. L'endpoint debug_token non è interessato dalla modifica.
• Le richieste che contengono date_format restituiscono un errore di parametro. Usa il formato di data predefinito e converti i valori localmente se necessario.
• Le richieste root con GET /?ids=... restituiscono un errore di parametro. Usa le richieste per ogni oggetto o il batch supportato.
• If-None-Match viene ignorato. Le intestazioni della risposta legacy ETag e il comportamento 304 Not Modified sono stati rimossi e le richieste restituiscono risposte complete.

A partire dal 27 ottobre 2026, queste modifiche verranno applicate a tutte le versioni supportate rimanenti dell'API Graph. Controlla i registri delle richieste di runtime e il registro modifiche dell'API Graph v26.0 per i dettagli sulla migrazione.

Obsolescenza dei campi della Pagina legacy per la nuova esperienza delle Pagine (API Graph v26.0)

Bozza di post sul blog degli sviluppatori. Versione target: API Graph v26.0. Tipo di modifica: obsolescenza (90 giorni).

Riepilogo

Per le Pagine che utilizzano l'esperienza delle nuove Pagine, cinque campi legacy Page-node (current_location, genre, network, parking, start_info) e l'impostazione della Pagina auto_publish_page_info_updates non saranno più supportati a partire dalla versione 26.0 dell'API Graph. Questi campi non sono più supportati e non devono essere usati per la nuova esperienza delle Pagine.

Tempistiche

• 29 luglio 2026: i campi vengono bloccati e l'impostazione viene rimossa nella versione 26.0 e successive per le Pagine che usano l'esperienza delle nuove Pagine.
• Circa 90 giorni dopo il lancio: la stessa modifica si applica a tutte le versioni rimanenti. La data esatta di fine ottobre 2026 è da confermare.

Cosa cambia

A partire dalla versione 26.0, richiedere uno di questi cinque campi in una pagina che usa l'esperienza delle nuove Pagine restituisce un errore di versione e l'impostazione auto_publish_page_info_updates non compare più nella risposta delle impostazioni della Pagina. Nelle versioni precedenti, il comportamento è invariato fino alla chiusura della finestra di migrazione di 90 giorni, dopo la quale si applica lo stesso comportamento a tutte le versioni.

Endpoint interessati:

• GET /{page-id}?fields=current_location
• GET /{page-id}?fields=genre
• GET /{page-id}?fields=network
• GET /{page-id}?fields=parking
• GET /{page-id}?fields=start_info
• GET /{page-id}?fields=settings - l'impostazione auto_publish_page_info_updates è stata rimossa dall'elenco delle impostazioni restituito

Cosa devono fare gli sviluppatori

• Rimuovi questi campi e l'impostazione auto_publish_page_info_updates dalle richieste della tua Pagina.
• Controlla i registri delle richieste, le integrazioni dei clienti e le dashboard per l'uso di questi campi nelle pagine della nuova esperienza delle Pagine.
• Consulta il registro modifiche dell'API Graph v26.0 per una lista completa e aggiornata.

Riferimento

• Riferimento per i nodi della Pagina

API Marketing: requisiti del pubblico Advantage+ per le campagne relative ad alloggio, impiego e prodotti e servizi finanziari

A partire dal 29 luglio 2026, con l'API Marketing v26.0, il parametro advantage_audience all'interno di targeting_automation sarà automaticamente impostato su 1 per le configurazioni del pubblico completamente predefinite o rilassate. Per le configurazioni del pubblico con restrizioni, gli sviluppatori devono esplicitamente impostare advantage_audience su 1 o 0 per le campagne nelle categorie speciali di inserzioni relative ad abitazioni, impiego o prodotti e servizi finanziari.

Questo comportamento si applica solo quando crei un nuovo gruppo di inserzioni. L'aggiornamento di un gruppo di inserzioni esistente non mostrerà questo comportamento in nessuna versione dell'API.

Si tratta dello stesso comportamento introdotto per le campagne che non rientrano nelle categorie speciali di inserzioni nell'API Marketing v23.0. Consulta la documentazione sulla risoluzione dei problemi del pubblico Advantage+ per maggiori dettagli.

I seguenti endpoint API sono interessati:

• POST /{ad-account-id}/adsets
• POST /{adset-id}
• POST /{adset-id}/copies

API Marketing: il posizionamento pubblicitario Esplora non è più disponibile

A partire dall'API Marketing v26.0 del 29 luglio 2026, il posizionamento Feed di Esplora di Instagram non sarà più disponibile. La pubblicazione su Esplora sarà interrotta e la spesa della campagna sarà spostata automaticamente su altri posizionamenti idonei.

Il tentativo di creare o aggiornare un gruppo di inserzioni che specifica il posizionamento Esplora restituirà un errore. Gli sviluppatori devono rimuovere Esplora dalle configurazioni dei posizionamenti e usare altri posizionamenti idonei.

I seguenti endpoint sono interessati:

• POST /act_{ad-account-id}/adsets
• POST /{ad-set-id}

API Marketing: obsolescenza della destinazione solo web per le campagne web e app

A partire dal 29 luglio 2026, con l'API Marketing v26.0, gli sviluppatori non potranno più allegare una creatività dell'inserzione con applink_treatment impostato su web_only a un'inserzione in una campagna che utilizza i luoghi della conversione del sito web e dell'app. Questo influisce sulla creazione e sugli aggiornamenti delle inserzioni tramite POST /act_{ad-account-id}/ads e POST /{ad-id}.

L'endpoint delle creatività dell'inserzione non cambia, ma il valore applink_treatment è configurato nel POST /act_{ad-account-id}/adcreatives. Gli sviluppatori dovrebbero controllare le loro integrazioni per applink_treatment=web_only e usare la selezione della destinazione automatica o un'altra destinazione manuale compatibile per le campagne per sito web e app.

Il 27 ottobre 2026, 90 giorni dopo il rilascio della versione 26.0, questa restrizione si applicherà a tutte le versioni dell'API Marketing. Per maggiori informazioni, consulta la documentazione Inserzione e Creatività dell'inserzione.

API Marketing: posizionamento Messenger Stories obsoleto

A partire dall'API Marketing v26.0 del 29 luglio 2026, il valore story in messenger_positions non sarà più disponibile quando si creano o si aggiornano gruppi di inserzioni attraverso chiamate con versione v26.0 o successive.

Per queste chiamate, story verrà rimosso senza avviso dalle specifiche di targetizzazione e non sarà più visualizzato nei posizionamenti effettivi per gruppi di inserzioni nuovi o esistenti. I dati storici di targetizzazione potrebbero continuare a includere story quando richiesto tramite GET /{ad_set-id}?fields=targeting. Non saranno restituiti errori dedicati, ma potrebbero essere applicati errori di convalida del posizionamento standard se la rimozione di story lascia una configurazione di posizionamento non valida.

I seguenti endpoint sono interessati:

• POST /act_{ad-account-id}/adsets
• POST /{ad_set-id}

Gli sviluppatori che usano i posizionamenti manuali devono rimuovere story da messenger_positions. Se è l'unico valore, rimuovi l'intero campo messenger_positions e prendi in considerazione di rimuovere messenger da publisher_platforms quando non viene usato nessun altro posizionamento di Messenger, come marketing_messages. Non è richiesta alcuna azione per i posizionamenti Advantage+.

Questa modifica solo API non interessa Gestione inserzioni. Le chiamate senza riferimenti alla versione e le chiamate a versioni precedenti alla v26.0 non sono inizialmente interessate. Il 27 ottobre 2026, 90 giorni dopo il rilascio della v26.0, l'obsolescenza si applicherà a tutte le versioni dell'API Marketing, comprese le chiamate senza riferimenti alla versione.

API Marketing: creazione delle inserzioni con sondaggio non più disponibile

A partire dall'API Marketing v26.0 del 29 luglio 2026, i componenti dei sondaggi non saranno più supportati durante la creazione o l'aggiornamento di inserzioni e creatività dell'inserzione. Il campo poll_spec e il valore "poll" del campo type non saranno più disponibili in interactive_components_spec.

Le richieste che creano una creatività del sondaggio o modificano un'inserzione per usarne una saranno rifiutate. Gli aggiornamenti di un'inserzione esistente che non ne modificano le creatività, come stato, budget o programmazione, possono continuare.

I seguenti endpoint sono interessati:

• POST /{ad_account_id}/adcreatives
• POST /{ad_account_id}/ads
• POST /{ad_id}
• GET /{ad_account_id}/generatepreviews

Gli sviluppatori devono rimuovere i campi relativi al sondaggio dalle specifiche della creatività e usare una creatività senza componenti del sondaggio. Le chiamate a versioni precedenti alla v26.0 e le chiamate senza riferimenti alla versione non sono inizialmente interessate.

Il 27 ottobre 2026, 90 giorni dopo il rilascio della v26.0, questa obsolescenza si applicherà a tutte le versioni dell'API Marketing.

Rilascio degli SDK di Meta Business v26

Il rilascio dell'SDK v26 di Meta Business avverrà poco dopo quello dell'API Graph v26. Questa versione includerà aggiornamenti delle dipendenze, integrazione dello strumento di creazione dei parametri dell'API Conversions, nuove funzioni dell'API e obsolescenza dell'API Commerce Order Management e di diverse funzioni del protocollo legacy.

L'SDK Business è ora integrato con lo Strumento di creazione dei parametri dell'API Conversions open source. Puoi sfruttare questa nuova integrazione per migliorare la qualità dell'integrazione dell'API Conversions. Funzioni principali: genera automaticamente (in base alla preferenza impostata dagli inserzionisti) e migliora i parametri fbc, fbp, event_source_url, referrer_url, client_ip_address e la normalizzazione/hashing automatica delle IIP per le lingue supportate. Scopri di più qui. L'API Commerce Order Management (47 endpoint) è completamente obsoleta e non può essere sostituita. Il posizionamento pubblicitario del feed di Esplora di Instagram è stato rimosso e restituisce errori se specificato. Il posizionamento Messenger Stories è stato rimosso senza preavviso da messenger_positions. Le inserzioni nello stato di WhatsApp ottengono nuove funzionalità, tra cui specifica dell'identità, carosello con un massimo di 10 unità e ottimizzazione delle conversioni fuori dal sito.

Nell'ambito del nostro programma di obsolescenza a 2 anni per gli SDK della piattaforma, ti ricordiamo le obsolescenze e le disattivazioni in programma:

• Sett, 2026: l'SDK della piattaforma Facebook v20.0 sarà reso obsoleto
• 1° gennaio 2027: l'SDK della piattaforma Facebook v21.0 sarà reso obsoleto

Obsolescenze delle versioni dell'API

Nell'ambito del programma di gestione delle versioni di Facebook per l'API Graph, tieni presente le obsolescenze in programma:

API Graph

• 24 settembre 2026: l'API Graph v20.0 verrà dichiarata obsoleta e rimossa dalla piattaforma.
• 21 gennaio 2027: l'API Graph v21.0 verrà dichiarata obsoleta e rimossa dalla piattaforma.

Per evitare disservizi, effettua la migrazione di tutte le chiamate all'ultima versione dell'API.