API Graph

Versione 3.1

Rilasciata giovedì 26 luglio 2018 | Disponibile fino a martedì 27 ottobre 2020 | Post sul blog

Generale

Queste modifiche si applicano alla versione 3.1 e versioni successive e, a partire dal 24 ottobre 2018, a tutte le versioni.

Tutti gli endpoint dell'API Graph ora restituiscono tutte le strutture vuote come {} e tutte le liste vuote come [].

Live API

Queste modifiche si applicano alla versione 3.1 e versioni successive e, a partire dal 24 ottobre 2018, a tutte le versioni.

Il parametro type è stato rimosso per i seguenti segmenti. È stato sostituito con un nuovo parametro, source.

  • /event/live_videos
  • /group/live_videos
  • /official_events/live_videos
  • /page/live_videos
  • /user/live_videos

Il nuovo parametro source può accettare uno dei due possibili valori: target e owner. L'interrogazione del segmento /live_videos di un nodo con source=target restituisce video in diretta trasmessi su quel nodo, mentre l'interrogazione per source=owner restituisce video in diretta trasmessi da quel nodo.

I nodi Event e Group supportano solo query target e alcune query target potrebbero non riuscire se non disponi dell'autorizzazione per visualizzare il nodo di destinazione.

API Marketing

Rilasciata 26 luglio 2018 | Disponibile fino a 14 maggio 2019 | Post sul blog

Ads Management

  • Categorie di targetizzazione basate sul comportamento: abbiamo dichiarato obsolete alcune opzioni di targetizzazione basate sul comportamento utilizzate in behaviors. Se cerchi di creare inserzioni con una di queste categorie, verrà visualizzato l'errore The category you selected is no longer available. Per verificare le categorie valide disponibili per la targetizzazione, utilizza Ricerca targetizzazione.

  • RimossoPAGE_ENGAGEMENTcomeoptimization_goal: abbiamo rimosso PAGE_ENGAGEMENT come optimization_goal per le campagne pubblicitarie. A partire dalla versione 3.1 non puoi più creare, aggiornare o duplicare campagne pubblicitarie con optimization_goal impostato su PAGE_ENGAGEMENT. Se hai già creato campagne pubblicitarie precedenti alla v3.1, puoi ancora eseguire queste campagne con questa impostazione. Inoltre, puoi ancora usare PAGE_ENGAGEMENT per i dettagli dell'API Insights e per consultare i dati sulle campagne pubblicitarie esistenti che utilizzano questo optimization_goal.

  • Inserzioni per i "Mi piace" sulla Pagina a immagine singola rimosse: a partire dalla versione 3.1, non è più possibile creare inserzioni per i "Mi piace" sulla Pagina a immagine singola senza un post della Pagina. Devi creare invece un'inserzione per "Mi piace" sulla Pagina con un post; vedi Creatività, posizionamento e anteprima, creazione di inserzioni per "Mi piace" sulla Pagina.

  • Nessun recupero di inserzioni per acquisizione contatti tramite Webhooks per Dev Tier: non verranno più inviati i dati raccolti nei moduli delle inserzioni per acquisizione contatti tramite Webhooks alle app in Modalità sviluppo. Questa modifica entrerà in vigore il 1 febbraio 2019.

    • Se chiedi di ricevere gli aggiornamenti nella versione 3.1, non ne invieremo a meno che la tua app non sia in produzione e in Modalità pubblicata.

    • Se crei una nuova app dopo la pubblicazione della versione 3.1, non invieremo nessun aggiornamento a meno che la tua app non sia in produzione e in Modalità pubblicata.

    • Se hai un'app esistente, dovrà essere in Modalità pubblicata entro il 1 febbraio 2019. Fino a quella data, continuerai a ricevere aggiornamenti in Modalità sviluppo.

    Per ulteriori informazioni sui livelli di accesso dell'API Marketing e sulle modalità dell'app, vedi Nuova struttura per l'accesso all'API Marketing e API Marketing, accesso e autenticazione.

Dati statistici e misurazione delle inserzioni

  • Abbiamo rinominato cost_per_store_visit e store_visits per l'API Insights in cost_per_store_visit_actions e store_visit_actions. Tale modifica influisce su:

    • GET {adaccount-id}/insights,

    • GET {campaign-id}/insights,

    • GET {adset-id}/insights,

    • GET {ad-id}/insights,

    • POST {adaccount-id}/insights,

    • POST {campaign-id}/insights,

    • POST {adset-id}/insights e

    • POST {ad-id}/insights.

    Per informazioni sulle metriche appena nominate, vedi Visite al punto vendita, misurazione. L'API Store Visits e la relativa documentazione sono disponibili su base limitata. Contatta il tuo rappresentante di Facebook per l'accesso.

API Business Manager

Nella versione 3.1 viene introdotto il nuovo concetto di autorizzazioni basate su attività per sostituire l'attuale autorizzazione basata sui ruoli. Ciò influisce sull'accesso agli account pubblicitari gestiti dall'API Business Manager e dalle Pagine. L'accesso basato sui ruoli agli account pubblicitari e alle Pagine è ancora disponibile, ma sarà rimosso in futuro. Ciò influisce sui ruoli seguenti e fornisce le attività equivalenti per gli account pubblicitari:

Ruolo Attività Descrizione

ADMIN

['MANAGE', 'ADVERTISE', 'ANALYZE']

Gestire tutti gli aspetti di campagne pubblicitarie, report, fatturazione e autorizzazioni per l'account pubblicitario.

GENERAL_USER

['ADVERTISE', 'ANALYZE']

Creare inserzioni utilizzando la fonte di finanziamento associata all'account pubblicitario. Eseguire i report.

GENERAL_USER

['ANALYZE']

Eseguire i report.

Sostituisce i seguenti ruoli nell'API Business Manager con queste attività:

Ruolo Attività

MANAGER

['MANAGE', 'CREATE_CONTENT', 'MODERATE', 'ADVERTISE', 'ANALYZE']

CONTENT_CREATOR

['CREATE_CONTENT', 'MODERATE', 'ADVERTISE', 'ANALYZE']

MODERATOR

['MODERATE', 'ADVERTISE', 'ANALYZE']

ADVERTISER

['ADVERTISE', 'ANALYZE']

INSIGHTS_ANALYST

['ANALYZE']

Per la gestione del pixel di Facebook, influisce su questi ruoli e introduce nuove attività:

Ruolo Attività

PIXEL_EDITOR

['EDIT', 'ANALYZE']

PIXEL_ANALYST

['ANALYZE']

Nell'ambito di questa modifica, i seguenti campi dell'API Business Management verranno rimossi e sostituiti con quanto segue:

Area Elementi obsoleti Nuovo campo

GET {adaccount-id}/users

permissions, role

tasks

POST {adaccount-id}/users

role, uidRoles, emailRoles

tasks

GET {user-id}/adaccounts

permissions, role

tasks

GET {user-id}/assigned_ad_accounts

role, permitted_role

tasks, permitted_tasks

GET {user-id}/assigned_pages

role, permitted_role

tasks, permitted_tasks

GET {adaccount-id}/assigned_users

role, permitted_role

tasks, permitted_tasks

POST {adaccount-id}/assigned_users

role

tasks

GET {page-id}/assigned_users

role, permitted_role

tasks, permitted_tasks

POST {page-id}/assigned_users

role

tasks

GET {fb-pixel-id}/assigned_users

role, permitted_role

tasks, permitted_tasks

GET {adaccount-id}/userpermissions

role

tasks

POST {adaccount-id}/userpermissions

role

tasks

GET {page-id}/userpermissions

role

tasks

POST {page-id}/userpermissions

role

tasks

GET {business-id}/client_ad_accounts

permitted_role

permitted_tasks

POST {business-id}/client_ad_accounts

permitted_role

permitted_tasks

GET {business-id}/client_pages

permitted_role

permitted_tasks

POST {business-id}/client_pages

permitted_role

permitted_tasks

GET {business-id}/client_pixels

permitted_role

permitted_tasks

GET {adaccount-id}/agencies

permitted_role

permitted_tasks

POST {adaccount-id}/agencies

permitted_role

permitted_tasks

GET {page-id}/agencies

permitted_role

permitted_tasks

POST {page-id}/agencies

permitted_role

permitted_tasks

GET {business-id}/pending_client_pages

permitted_role

permitted_tasks

GET {business-id}/pending_client_ad_accounts

permitted_role

permitted_tasks

Questo nuovo design influisce anche sull'API Pages, vedi API Graph 3.1, API Pages, Modifiche sostanziali. Per la documentazione dell'API Business Manager, consultare:

Piattaforma Messenger

Per le app create prima del 26 luglio 2018, queste modifiche entreranno in vigore l'8 gennaio 2019. Per le app create dopo il 26 luglio 2018, queste modifiche entrano in vigore immediatamente.

L'API User Profile ora restituisce solo i campi first_name, last_name e profile_pic per impostazione predefinita. Campi aggiuntivi ora richiedono che il prodotto venga sottoposto ad analisi, che può essere richiesta tramite la tab Piattaforma Messenger della dashboard gestione app.

I campi last_ad_referral e is_payment_enabled sono stati dichiarati obsoleti e verranno rimossi dall'API il 30 ottobre 2018.

API Mutual Friends

Queste modifiche si applicano alla versione 3.1 e versioni successive e, a partire dal 24 ottobre 2018, a tutte le versioni.

L'API Mutual Friends è stata ritirata il 4 aprile 2018 e gli endpoint di seguito hanno iniziato a restituire insiemi di dati vuoti. Ora gli endpoint sono stati completamente rimossi e restituiranno un errore.

  • /user-context/all_mutual_friends
  • /user-context/mutual_friends
  • /user-context/three_degree_mutual_friends

API Pages

Autorizzazioni

Le modifiche seguenti si applicano alla versione 3.1 e versioni successive e, a partire dal 1 febbraio 2019, a tutte le versioni.

L'autorizzazione pages_manage_cta ora richiede l'analisi dell'app per tutte le richieste POST e DELETE. Le app create prima del 26 luglio 2018 possono continuare a utilizzare questa autorizzazione, ma devono essere sottoposte ad analisi prima del 1 febbraio 2019 per continuare a utilizzare pages_manage_cta.

Ruoli della Pagina

Le seguenti modifiche si applicano alla versione 3.1+.

I ruoli della Pagina presto diventeranno obsoleti e verranno sostituiti con le attività della Pagina. Invece di assegnare a un utente un ruolo in una Pagina, ora devi assegnare l'equivalente nelle attività.

RuoloAttività equivalenti

Admin

ADVERTISE, ANALYZE, CREATE_CONTENT, MANAGE, MODERATE

Advertiser

ADVERTISE, ANALYZE

Analyst

ANALYZE

Editor

ADVERTISE, ANALYZE, CREATE_CONTENT, MODERATE

Moderator

ADVERTISE, ANALYZE, MODERATE

Fino a quando le autorizzazioni basate sui ruoli non saranno completamente sostituite da autorizzazioni basate sulle attività, quando si assegnano le attività tramite /page/roles, è necessario assegnare tutte le attività equivalenti di un ruolo; in caso contrario, l'operazione POST non andrà a buon fine.

Per supportare queste modifiche, i campi perms e role sono stati dichiarati obsoleti e sostituiti con un nuovo campo tasks. Ciò riguarda i seguenti segmenti:

  • /me/accounts
  • /page/roles
  • /user/accounts

Consulta il registro modifiche dell'API Marketing per vedere come queste modifiche influiscono sull'API Marketing e sull'API Business Manager.

Webhooks

Queste modifiche si applicano alla versione 3.1 e versioni successive e, a partire dal 24 ottobre 2018, a tutte le versioni.

I seguenti campi del Webhook utente sono stati dichiarati obsoleti:

  • pic_big_with_logo
  • pic_small_with_logo
  • pic_square_with_logo
  • pic_with_logo

I seguenti campi del Webhook utente ora utilizzano URL HTTPS anziché HTTP.

  • pic
  • pic_big
  • pic_small
  • pic_square
  • picture

Inoltre, gli URL per questi campi scadranno; questo influirà immediatamente su tutte le versioni dell'API.