Introducing Facebook Graph API v10.0 and Marketing API v10.0

Oggi pubblichiamo l'API Graph API v10.0 e l'API Marketing v10.0 di Facebook.

Questa release contiene molti annunci, aggiornamenti, deprecazioni e annullamenti di deprecazioni che possono influire sul modo in cui le tue applicazioni si integrano con la nostra piattaforma. Questo post descrive questi aggiornamenti e i passaggi necessari che gli sviluppatori devono intraprendere per evitare interruzioni ove applicabile.

Di seguito vengono fornite informazioni dettagliate su tutte le modifiche. Per le specifiche tecniche, consulta il nostro registro modifiche v10.0.

Visita l'hub Iniziative della piattaforma per maggiori informazioni sulla nostra Piattaforma per sviluppatori.

Annunci e aggiornamenti

Certificazione Controllo sull'uso dei dati

Per evitare di perdere l'accesso all'API della Piattaforma Facebook, completa il Controllo sull'uso dei dati (DUC, Data Use Checkup) entro 60 giorni dalla registrazione. Puoi completare il DUC andando alla pagina "Le mie app" nella Dashboard gestione app.

Lo scorso autunno, Facebook ha lanciato il Controllo sull'uso dei dati (DUC), un nuovo requisito annuale per gli sviluppatori che ha lo scopo di certificare che il loro accesso alle API e l'utilizzo dei dati sia conforme alle Condizioni della Piattaforma e alle Normative per gli sviluppatori.

Nell'ambito della nostra graduale implementazione in tutte le app, riceverai una data di scadenza e ulteriori istruzioni tramite un avviso per sviluppatori, insieme a un'e-mail all'indirizzo di contatto registrato e una notifica nell'elenco Azioni richieste sulla Dashboard gestione app.

Per istruzioni dettagliate sul completamento del DUC, consulta la documentazione per gli sviluppatori. Maggiori informazioni sul DUC sono disponibili inoltre nella sezione delle FAQ.

Livelli di accesso ai dati per 90 giorni e limiti dei dati dell'API Groups:

A partire dal 24 maggio 2021, quando si utilizzerà l'API di Groups, la finestra di accesso ai dati disponibile per le applicazioni sarà limitata a 90 giorni.

Stiamo inoltre introducendo l'accesso all'API Groups multilivello per le applicazioni consumer in base alla loro modalità (sviluppo o pubblicata). Le autorizzazioni dell'API Groups ora si comporteranno in modo simile all'Accesso Standard e Avanzato per le app Business.

Oggi le app in modalità Sviluppo possono accedere a tutti i contenuti di Gruppi pubblici e Gruppi privati in cui lo sviluppatore è un amministratore. Dopo aver completato l'Analisi dell'app, queste app possono accedere a tutti i contenuti dai gruppi che hanno installato l'app.

Dal 24 maggio 2021, le app in modalità Sviluppo potranno accedere ai propri contenuti solo in Gruppi pubblici e Gruppi privati ​​in cui lo sviluppatore è un amministratore. Ciò significa che l'app non avrà accesso ai contenuti che altri utenti dei Gruppi (senza ruoli nell'app) hanno pubblicato, come post e commenti.

Maggiori informazioni sono disponibili nel registro modifiche v10.0

Livelli di accesso per autorizzazioni public_profile ed email per le app Business

Nell'ambito delle nostre iniziative continue volte a salvaguardare e proteggere i dati degli utenti, abbiamo aggiunto le autorizzazioni public_profile (ovvero, i campi predefiniti del profilo pubblico) ed email al modello dei livelli di accesso annunciato con Graph v8.0 per le app Business nuove ed esistenti.

Le app Business di nuova creazione ora iniziano con l'accesso Standard per le autorizzazioni public_profile ed email. Quando un'app dispone dell'accesso Standard a public_profile, solo gli utenti con un ruolo nell'app o nell'azienda che ha rivendicato l'app possono cercare o accedere all'app. Se hai bisogno che utenti esterni accedano alla tua app, gli amministratori dell'app possono richiedere l'accesso Avanzato nella Dashboard gestione app. Questo accesso verrà concesso automaticamente.

Maggiori informazioni sono disponibili nel registro modifiche v10.0

Promemoria della richieste di eliminazione dei dati

Come annunciato il 10 novembre 2020, le app di tipo Consumer e Gaming inviate per l'Analisi dell'app o per passare dalla modalità Sviluppo alla modalità Pubblicata, dovranno fornire un callback della richiesta di eliminazione dei dati o un URL con istruzioni specifiche destinate agli utenti su come richiedere l'eliminazione dei loro dati. Abbiamo in programma di rendere obbligatorio questo requisito entro il 10 novembre 2022 e lo ricorderemo agli sviluppatori di app 60 giorni prima della sua applicazione.

Opzioni di modifica all'API Graph AdsInsight per il progetto di riduzione dei tempi di mantenimento dei dati

L'interfaccia utente di Gestione inserzioni non supporterà più la creazione di report sui dati delle metriche di insight sulle inserzioni più vecchi di 37 mesi. L'API restituirà un errore quando la richiesta contiene intervalli di date oltre il periodo di mantenimento di 37 mesi. "date_preset = lifetime" verrà disabilitato e sostituito con "date_preset = maximum".

Le modifiche nell'API Graph v10.0 ad AdsInsight, ad eccezione di "date_preset = lifetime", verranno applicate a tutte le altre versioni dell'API Graph dopo 90 giorni. Il campo specifico chiamato non deve essere modificato. Ci sarà una funzionalità preimpostata e tutte le chiamate "Lifetime" avranno come impostazione predefinita un periodo di mantenimento massimo di 37 mesi.

Questa modifica non avrà alcun impatto sui dati relativi alle creatività dell'inserzione, ai segmenti di pubblico, alle impostazioni di pubblicazione o ai nomi degli oggetti pubblicitari e non verranno apportate modifiche al calcolo delle metriche esistenti. Questa modifica verrà applicata a tutte le piattaforme di reporting sulle inserzioni, tra cui Gestione inserzioni, Report pubblicitari e LAX (Lightweight Ad Experiences).

• Giorno del rilascio 23/02/2021:
  • Versione 10.0
    • Abilitazione "date_preset = maximum"
    • Disabilitazione "date_preset = lifetime"
    • Restituzione di un errore quando la richiesta contiene intervalli di date espliciti che sono oltre il periodo di mantenimento di 37 mesi
  • Versioni 9.0 e precedenti
    • Nessuna modifica alla funzionalità attuale
• 90 giorni post-rilascio - 24/05/2021:
  • Versioni 9.0 e precedenti
    • Abilitazione "date_preset = maximum" (come nella nuova versione)
    • Restituzione di un errore quando la richiesta contiene intervalli di date espliciti che sono oltre il periodo di mantenimento di 37 mesi (come nella nuova versione)
    • "date_preset = lifetime" può ancora funzionare, ma restituirà solo dati nei 37 mesi precedenti, ovvero questo valore sarà considerato il valore massimo

Maggiori informazioni sono disponibili nel registro modifiche v10.0

Nuovo criterio di eliminazione per dati di proprietà esterna su ThreatExchange

A partire dal 24 maggio 2021, quando i partner imposteranno un "expire_time" per i dati che caricano su ThreatExchange, i dati verranno cancellati definitivamente ("hard delete") all'ora di scadenza indicata. Se desideri indicare che i dati non sono più validi, imposta il campo "expired_on" per eliminarli automaticamente.

In precedenza, con l'eliminazione temporanea ("soft delete") i contenuti scaduti venivano etichettati come scaduti. Non supportiamo più le eliminazioni temporanee e, alla scadenza del contenuto, questo verrà eliminato definitivamente e non sarà più visibile in ThreatExchange.

Inoltre, tutti i ThreatDescriptor non Facebook in ThreatExchange verranno eliminati definitivamente una volta scaduti. L'ora di scadenza continuerà a essere impostata dal creatore del ThreatDescriptor. L'eliminazione inizierà quindi su tutti i ThreatDescriptor scaduti non creati da Facebook. Se la tua applicazione ha attualmente ThreatDescriptor scaduti che non desideri eliminare quando questo criterio entrerà in vigore, devi rinviare la data di scadenza o impostarla su "0" per assicurarti che i dati non scadano mai.

Fai clic qui per maggiori informazioni sulle modifiche

Modifiche alla targetizzazione nella nuova API

Dal 24 maggio 2021, non chiederemo più i parametri location_spec e country durante la creazione di un pubblico personalizzato simile in tutte le versioni dell'API.

Quando si crea un pubblico simile, l'utente seleziona l'origine simile e il rapporto desiderato. La posizione per il pubblico simile verrà definita dalla posizione del Paese nelle specifiche di targetizzazione della campagna. Questa modifica non influirà in alcun modo sulle campagne esistenti, ma solo sulle campagne nuove e su quelle che sono state modificate.

Lancio della nuova pagina Stato in diretta della Piattaforma

La nuova pagina Stato azienda di Facebook aumenterà la trasparenza e la comunicazione proattiva con gli sviluppatori esterni che utilizzano i prodotti della Piattaforma Facebook. Questa pagina fornirà un luogo centralizzato per controllare lo stato della piattaforma dei prodotti aziendali di Facebook (inserzioni, API WhatsApp Business, Piattaforma per sviluppatori Facebook, ecc.). La pagina è attualmente attiva per Gestione inserzioni e API Whatsapp Business ed entro maggio 2021 verranno aggiunti ulteriori prodotti aziendali.

Deprecazioni

Deprecazione di Go Live Dialog

Il 24 maggio 2021 elimineremo l'SDK Go Live Dialog (GLD). Questa deprecazione di uno strumento di produzione live legacy si verificherà in tutte le versioni dell'API. Questa modifica avrà effetto solo sulle trasmissioni in diretta su Facebook. Incoraggiamo gli sviluppatori a usare il Live Producer e l'API Live per tutte le soluzioni di produzione live personalizzate.

Soluzioni per il go live dopo l'eliminazione dell'SDK GLD:

• Accedi a Live Producer direttamente tramite facebook.com/live/producer (o altri punti di accesso su Facebook come il pulsante "Video in diretta" su una Pagina o un profilo)
• Integra soluzioni personalizzate con l'API Live

Maggiori informazioni sono disponibili nel registro modifiche v10.0

Deprecazione della targetizzazione in base alle connessioni

Il 24 maggio 2021, la targetizzazione in base alle connessioni non sarà più supportata durante la creazione/modifica di un gruppo di inserzioni. Questo requisito avrà effetto solo sulle campagne nuove e modificate e non ci sarà alcun impatto sulle campagne esistenti.

Maggiori informazioni sono disponibili nel registro modifiche v10.0

Deprecazioni annullate

Deprecazione endpoint gr:delete:Page/tabs annullata

Al lancio dell'API Graph v8.0, avevamo eliminato l'endpoint gr:delete:Page/tabs per le tab delle Pagine. Abbiamo deciso di annullare immediatamente la deprecazione di questo endpoint per l'API Graph v10.0 e ripristineremo il suo accesso il 24 maggio 2021 in tutte le altre versioni di Graph.

Maggiori informazioni sono disponibili nel registro modifiche v10.0

Deprecazione endpoint gr:post:Business/business_users, gr:post:Business/system_users e gr:post:User/access_tokens annullata

Al lancio dell'API Graph v9.0, avevamo limitato l'accesso a tre endpoint business:

• gr:post:Business/business_users
• gr:post:Business/system_users
• gr:post:User/access_tokens

Al lancio di Graph v10.0, riapriremo questi endpoint alle chiamate API quando le app soddisfano una di queste due condizioni:

• L'azienda di destinazione è l'attività proprietaria dell'app chiamante
• L'azienda di destinazione è un'attività secondaria (in un modello Business a 2 livelli) dell'azienda proprietaria dell'app chiamante

Maggiori informazioni sono disponibili nel registro modifiche v10.0

Calendario action item

Deprecazioni versioni API Marketing:

Nell'ambito del nostro programma di gestione delle versioni dell'API Marketing, di seguito sono riportate le prossime deprecazioni delle versioni dell'API Marketing:

• 3 marzo 2021: l'API Marketing v7.0 sarà rimossa dalla piattaforma
• 4 maggio 2021: l'API Marketing v8.0 sarà rimossa dalla piattaforma
• 25 agosto 2021: l'API Marketing v9.0 sarà rimossa dalla piattaforma

Per evitare interruzioni della tua attività, ti consigliamo di migrare tutte le chiamate all'ultima versione dell'API Marketing lanciata oggi. (Visita il registro modifiche per maggiori dettagli).

Deprecazioni versioni API Graph:

Nell'ambito del nostro programma di gestione delle versioni dell'API Graph, di seguito sono riportate le prossime deprecazioni delle versioni dell'API Graph:

• 4 maggio 2021: l'API Graph v3.2 sarà rimossa dalla piattaforma
• 3 agosto 2021: l'API Graph v3.3 sarà rimossa dalla piattaforma

Deprecazioni generali

• 24 maggio 2021:
  • La Go Live Dialog sarà dichiarato obsoleto e rimosso dalla piattaforma
  • La targetizzazione in base alle connessioni sarà dichiarata obsoleta e rimossa dalla piattaforma

Azione dello sviluppatore richiesta

• Iscrizione a rotazione: certificazione Controllo sull'uso dei dati
  • Dopo l'iscrizione, il completamento deve essere completato entro 60 giorni
  • Sezione delle FAQ dedicata al DUC.
• 23 febbraio 2021: lancio delle modifiche all'API Graph AdsInsight solo per Graph v10.0
• 24 maggio 2021:
  • lancio delle modifiche all'API Graph AdsInsight per Graph v9.0 e versioni precedenti
  • Entrata in vigore delle modifiche ai livelli di accesso in base all'Analisi dell'app
    • Accesso ai dati API Groups limitato a 90 giorni
    • Implementazione dei livelli multipli per i dati dell'API Groups
    • Entrata in vigore delle autorizzazioni public_profile ed email per le app Business
  • Implementazione del nuovo criterio di cancellazione definitiva ("hard delete") dei dati su ThreatExchange
• 10 novembre 2022: scadenza per le richieste di eliminazione dei dati