Versione 8.0

API Graph

Data di rilascio 4 agosto 2020 | Disponibile fino al 1 novembre 2022 | Post sul blog

Token d'accesso

Endpoint obsoleti

Diventati obsoleti a partire dalla versione 8.0. Diventeranno obsoleti in tutte le versioni a partire dal 2 novembre 2020.

• GET /token_deprecation_check

Album

Endpoint ripristinati

Si applica a tutte le versioni.

• GET /{album-id}/likes

Configurazione di app

Tipi di app

Questa modifica si applica a tutte le versioni.

Le app di nuova creazione possono ora scegliere un tipo di app: business, gaming o nessuno. Questo semplifica l'interfaccia di Analisi dell'app rimuovendo autorizzazioni e funzioni non appropriate sulla base del tipo scelto. Inoltre, le app business utilizzano un nuovo meccanismo di autorizzazione, non più le modalità, e hanno accesso a una nuova funzione. Fai riferimento alla voce del registro modifiche relativa alle app aziendali per maggiori dettagli.

App business

Le app di tipo business utilizzano un nuovo meccanismo di autorizzazione denominato Livelli di accesso. I Livelli di accesso sostituiscono la funzionalità fornita dalle modalità sviluppo e live, le quali sono state rimosse per le app business, rendendo il processo di analisi dell'app ancora più semplice e intuitivo. Inoltre, è stata rilasciata una nuova funzione di accesso ai profili degli utenti delle risorse aziendali, che consente alle app business di leggere alcuni campi utente pubblici. Queste modifiche sono descritte in dettaglio di seguito.

Livelli di accesso

Si applica a tutte le versioni.

I Livelli di accesso sono un nuovo meccanismo di autorizzazione dell'API Graph per le app business che si applica ad autorizzazioni e funzioni su base individuale. L'Accesso standard consente l'accesso esclusivamente ai dati di proprietà di utenti che hanno un ruolo nell'app o nell'azienda che ha rivendicato l'app. L'Accesso avanzato consente di accedere ai dati di proprietà di qualsiasi utente dell'app, ma richiede l'analisi dell'app. Per le app business viene automaticamente approvato l'Accesso standard per tutte le autorizzazioni e le funzioni disponibili per il loro tipo.

Rimozione delle modalità sviluppo e live

Si applica a tutte le versioni.

La modalità sviluppo e la modalità live sono state rimosse per le app di tipo business. Queste modalità sono state sostituite dai Livelli di accesso, che forniscono la stessa funzionalità con maggiore versatilità; poiché le app business dispongono dell'Accesso standard per tutte le autorizzazioni e le funzioni disponibili, qualsiasi utente con un ruolo nell'app o nell'azienda che ha rivendicato l'app può concedere all'app qualsiasi autorizzazione disponibile in quel momento. In questo momento non sarà necessario eseguire l'analisi dell'app o alternare le modalità durante lo sviluppo.

Nuova funzione Accesso al profilo utente della risorsa business

Si applica a tutte le versioni.

La nuova funzione Accesso al profilo utente della risorsa business consente alle app business di leggere alcuni campi utente pubblici di un utente, purché questo abbia interagito con risorse di proprietà di un'azienda che ha rivendicato l'app. Consulta il riferimento per l'accesso al profilo utente della risorsa business per una lista di campi utente leggibili.

Commenti

Endpoint ripristinati

Si applica a tutte le versioni.

• GET /{comment-id}/likes

Dispositivi

Endpoint obsoleti

Diventati obsoleti a partire dalla versione 8.0. Diventeranno obsoleti in tutte le versioni a partire dal 2 novembre 2020.

• POST /device/share

Gruppi

Endpoint obsoleti

Diventati obsoleti a partire dalla versione 8.0.

• GET /{group-id}/posts

Diventati obsoleti a partire dalla versione 8.0. Diventeranno obsoleti in tutte le versioni a partire dal 2 novembre 2020.

• GET /{group-post-id}/likes

Instagram

Nuovo endpoint oEmbed di Instagram

Si applica a tutte le versioni.

È stato introdotto un nuovo endpoint GET /instagram_oembed che fornisce la stessa funzionalità degli endpoint oEmbed Legacy di Instagram, i quali diventeranno obsoleti il 24 ottobre 2020. Il nuovo endpoint richiede un token d'accesso, quindi avrai bisogno di un account sviluppatore di Facebook e di un'app registrata per accedere. Consulta il documento oEmbed Instagram per le istruzioni per l'uso e ulteriori dettagli.

Avvenimenti importanti

Endpoint obsoleti

Diventati obsoleti a partire dalla versione 8.0.

• GET /{life-event-id}
• GET /{life-events-id}/photos

Link

Endpoint obsoleti

Diventati obsoleti a partire dalla versione 8.0.

• GET /{link-id}/reactions

Video in diretta

Endpoint obsoleti

Diventati obsoleti a partire dalla versione 8.0.

• GET /{live-video-id}/likes

Usa l'endpoint GET /{live-video-id}/reactions per ottenere i Mi piace a un video in diretta.

Parametro save_vod

Si applica a partire dalla versione 8.0. Si applicherà a tutte le versioni a partire dal 2 novembre 2020.

Il parametro save_vod è stato dichiarato obsoleto per i seguenti segmenti:

• POST /{user_id}/live_videos
• POST /{group_id}/live_videos
• POST /{page_id}/live_videos
• POST /{event_id}/live_videos

Piattaforma Messenger

Endpoint obsoleti

Diventati obsoleti a partire dalla versione 8.0.

• GET /{page-id}/thread_settings
• POST /{page-id}/thread_settings
• DELETE /{page-id}/thread_settings

Analisi dell'app

Si applica a tutte le versioni.

Analisi dell'app per Messenger è stata spostata da Prodotti > Messenger > Impostazioni ad Analisi dell'app nella Dashboard gestione app. Per richiedere autorizzazioni specifiche per Messenger, pages_messaging, pages_user_gender, pages_user_locale e pages_user_timezone, vai ad Analisi dell'app > Autorizzazioni e funzioni. Consulta la documentazione relativa all'analisi dell'app di Messenger per maggiori dettagli.

Segmento profilo Messenger

Si applica a partire dalla versione 8.0.

Il tipo di menu always-on nidificato è stato dichiarato obsoleto per POST /{page-id}/messenger_profile.

Nuova funzione: Messenger per Shops

Si applica a partire dalla versione 8.0.

Supporto per l'invio e la ricezione di prodotti su Messenger per Shops. Questo include il template di prodotto che può essere impiegato per inviare prodotti nei messaggi, Webhooks per i messaggi con template di prodotto e messaggi dalla Pagina dei dettagli di un prodotto di Facebook Shops e Webhooks echo per i messaggi con prodotti.

• GET /{message_id}/access_requests
• POST {page_id}/message
• Webhook message_echo
• Webhook messages

Offerte native

Endpoint obsoleti

Diventati obsoleti a partire dalla versione 8.0.

• GET /{native-offer-id}/nativeofferviews?photos

Open Graph

Endpoint obsoleti

Diventati obsoleti a partire dalla versione 8.0. Diventeranno obsoleti in tutte le versioni a partire dal 2 novembre 2020.

• GET /{open-graph-action-id}/comments
• POST /{open-graph-action-id}/comments

Pagine

Endpoint obsoleti

Diventati obsoleti a partire dalla versione 8.0.

• DELETE /{page-id}/tabs
• GET /{group-id}/posts
• GET /{page-id}/place_topics
• GET /{page-about-story-id}
• POST /{page-about-story-id}
• POST /{page-id}/page_about_story

Post della Pagina

Obsoleti in tutte le versioni.

Il formato ID dei commenti sul post della Pagina, {page-id}_{post_id}_{comment-id}, è diventato obsoleto. Usa il formato {pagepost-id}_{comment-id} al suo posto.

Foto

Endpoint obsoleti

Obsoleti in tutte le versioni.

• GET /{photo-id}/sharedposts

Luoghi

Endpoint obsoleti

Diventati obsoleti a partire dalla versione 8.0.

• GET /{place-information-id} (consulta Correzioni)

Post

Endpoint obsoleti

Diventati obsoleti a partire dalla versione 8.0. Diventeranno obsoleti in tutte le versioni a partire dal 2 novembre 2020.

• GET /{post-id}/likes

Usa l'endpoint GET /post/reactions per ottenere i Mi piace a un post.

Ricerca

Endpoint obsoleti

Diventati obsoleti a partire dalla versione 8.0. Diventeranno obsoleti in tutte le versioni a partire dal 2 novembre 2020.

• GET /search?type=place
• GET /search?type=audience_interest

Impostazioni di sicurezza

Campi dichiarati obsoleti

Diventati obsoleti a partire dalla versione 8.0. Diventeranno obsoleti in tutte le versioni a partire da novembre 2020.

• secure_browsing

Plug-in social

Endpoint oEmbed Facebook

Questa modifica si applicherà a tutte le versioni a partire dal 24 ottobre 2020.

Gli endpoint oEmbed di Facebook, che consentono alle app di ottenere l'HTML di incorporamento per i post e i video pubblici di Facebook, diventeranno obsoleti il 24 ottobre 2020. Sono stati introdotti tre nuovi endpoint che forniscono la stessa funzionalità di quelli precedenti che vanno a sostituire:

• GET /oembed_page
• GET /oembed_post
• GET /oembed_video

I nuovi endpoint richiedono un token d'accesso e le richieste saranno soggette a rate limiting. Consulta la documentazione relativa ai nuovi endpoint oEmbed per i dettagli sulla modalità di utilizzo e ulteriori informazioni.

Utenti

Endpoint obsoleti

Diventati obsoleti a partire dalla versione 8.0.

• GET /{user-id}/taggable_friends

Campi dichiarati obsoleti

Diventati obsoleti a partire dalla versione 8.0. Diventeranno obsoleti in tutte le versioni a partire da novembre 2020.

• security_settings
• test_group
• viewer_can_send_gift
• is_shared_login

Obsoleti in tutte le versioni.

• can_review_measurement_request
• is_famedeeplinkinguser

Riautorizzazione

Questa modifica si applica a tutte le versioni.

A partire dal 24 ottobre 2020, i seguenti campi richiederanno la riautorizzazione per l'accesso ai dati trascorsi 90 giorni di inattività:

• is_eligible_promo
• payment_mobile_pricepoint
• payment_pricepoints

Immagine dell'utente

Si applica a tutte le versione a partire dal 24 ottobre 2020.

A partire dal 24 ottobre 2020, l'endpointGET /{user-id}/picture (GET /{user-id}?fields=picture) richiederà un ID utente per singola app (ASID) per le richieste senza token. Se esegui una query su un utente con un ID non ASID, devi includere il token d'accesso di un'app, un client o un utente nella richiesta. Consulta il riferimento Immagine dell'utente per i dettagli.

Domande sui video

Endpoint obsoleti

Diventati obsoleti a partire dalla versione 8.0.

• GET /{question-id}
• GET /{question-id}/options
• GET /{question-id}/votes
• GET /{question-option-id}

Workplace

Endpoint obsoleti

Diventati obsoleti a partire dalla versione 8.0. Diventeranno obsoleti in tutte le versioni a partire dal 2 novembre 2020.

• GET /{company-id}/access_requests
• GET /access_requests

API Marketing

Data di rilascio 4 agosto 2020 | Disponibile fino al 4 maggio 2021 | Post sul blog

Account pubblicitari

Endpoint obsoleti

Diventati obsoleti a partire dalla versione 8.0.

• GET /AdReportSchedule
• DELETE act_{ad-account-id}/adsets

Autorizzazioni

Si applica a partire dalla versione 8.0. Si applicherà a tutte le versioni a partire dal 2 novembre 2020.

Le app hanno bisogno di autorizzazioni granulari per accedere ai campi business di un account pubblicitario. Le autorizzazioni devono essere concesse per uno specifico oggetto business.

Regole di personalizzazione delle risorse

Convalida

Si applica a partire dalla versione 8.0.

Tutte le inserzioni che utilizzano asset_feed_spec devono contenere almeno due regole di personalizzazione della targetizzazione. Se la tua creatività usa asset_feed_spece include meno di due regole, non sarai in grado di creare l'inserzione.

Questa modifica influisce su personalizzazione delle risorse per il posizionamento, inserzioni multilingua e personalizzazione delle risorse del segmento.

Personalizzazione delle risorse del segmento

Si applica a partire dalla versione 8.0. Si applicherà a tutte le versioni a partire dal 2 novembre 2020.

Tutti i casi d'uso non correlati alla geolocalizzazione sono stati dichiarati obsoleti per gli utenti Personalizzazione delle risorse del segmento. Con questa modifica, tutte le regole di targetizzazione devono contenere informazioni sulla geolocalizzazione all'interno della rispettiva specifica di personalizzazione. Esiste un'eccezione alla regola predefinita, che non deve includere la geolocalizzazione.

Offerte

Strategia di offerta con costo desiderato

Si applica a partire dalla versione 8.0.

La strategia di offerta TARGET_COST è obsoleta. Per poter continuare a controllare i costi, consigliamo di usare le offerte con limite di costo. Consulta tutte le strategie di offerta disponibili.

Business Manager

Endpoint obsoleti

Diventati obsoleti a partire dalla versione 8.0.

• GET{system-user-id}/updated_by

Reintrodotti gli endpoint degli accordi di condivisione

Si applica a tutte le versioni

I seguenti endpoint sono stati reintrodotti:

• /{business-id}/received_sharing_agreements
• /{business-id}/initiated_sharing_agreements

Entrambi gli endpoint erano stati in precedenza dichiarati obsoleti con il lancio dell'API Graph V6.0.

Canvas

Endpoint obsoleti

• /{canvas-id}/collection_hero_image
• /{canvas-id}/collection_hero_video
• /{canvas-id}/collection_thumbnails

API Catalog

Autorizzazioni

Si applica a partire dalla versione 8.0. Si applicherà a tutte le versioni a partire dal 31 gennaio 2021.

Non hai più bisogno dell'autorizzazione ads_management per accedere agli endpoint del catalogo prodotti. In futuro, avrai bisogno dell'autorizzazione catalog_management per chiamare questi endpoint. Gli sviluppatori che hanno avuto accesso agli endpoint del catalogo tramite ads_management negli ultimi 90 giorni saranno automaticamente migrati alle autorizzazioni catalog_management entro il 14 agosto 2020.

Da questo momento fino al 28 febbraio 2021, gli sviluppatori che utilizzano le versioni precedenti dell'API saranno ancora in grado di chiamare gli endpoint del catalogo prodotti con l'autorizzazione ads_management. Se utilizzi la versione 8.0, devi avere l'autorizzazione catalog_management.

Dopo la scadenza di febbraio, l'autorizzazione catalog_management non sarà più associata a ads_management, pertanto gli utenti dovranno concedere esplicitamente l'autorizzazione catalog_management per la tua app.

Autenticazione

Si applica a partire dalla versione 8.0. Si applicherà a tutte le versioni a partire dal 2 novembre 2020.

[AGGIORNATO] I seguenti endpoint dell'API Catalog si attengono ora alle impostazioni business dell'autenticazione a due fattori. Qualsiasi app esegua una chiamata a questo endpoint riceverà un errore nel caso in cui il Business Manager che possiede il catalogo richieda l'autenticazione a due fattori per l'utente dell'app corrente e l'utente dell'app non abbia effettuato l'autenticazione a due fattori.

Se l'utente dell'app corrente ha accesso al catalogo tramite un'azienda partner, noi ci atteniamo ai requisiti di autenticazione del Business Manager del partner. Gli utenti di sistema non sono tenuti a effettuare l'autenticazione a due fattori.

• POST /{business-id}/owned_product_catalogs
• POST /{destination-id}
• POST /{home-listing-id}
• DELETE /{home-listing-id}
• POST /{hotel-id}
• DELETE /{hotel-id}
• POST /{hotel-id}/hotel_rooms
• POST /{hotel-room-id}
• DELETE /{hotel-room-id}
• POST /{page-id}/product_catalogs
• POST /{product-catalog-id}
• DELETE /{product-catalog-id}
• POST /{product-catalog-id}/agencies
• DELETE /{product-catalog-id}/agencies
• POST /{product-catalog-id}/assigned_users
• DELETE /{product-catalog-id}/assigned_users
• POST /{product-catalog-id}/batch
• POST /{product-catalog-id}/categories
• POST /{product-catalog-id}/destinations
• POST /{product-catalog-id}/external_event_sources
• DELETE /{product-catalog-id}/external_event_sources
• POST /{product-catalog-id}/flights
• POST /{product-catalog-id}/home_listings
• POST /{product-catalog-id}/hotel_rooms_batch
• POST /{product-catalog-id}/hotels
• POST /{product-catalog-id}/items_batch
• /{product-catalog-id}/pricing_variables_batch
• POST /{product-catalog-id}/product_groups
• POST /{product-catalog-id}/product_feeds
• POST /{product-catalog-id}/product_sets
• POST /{product-catalog-id}/products
• POST /{product-catalog-id}/vehicles
• POST /{product-feed-rule-id}
• DELETE /{product-feed-rule-id}
• POST /{product-feed-id}
• DELETE /{product-feed-id}
• POST /{product-feed-id}/rules
• POST /{product-feed-id}/uploads
• POST /{product-feed-id}/upload_schedules
• POST /{product-feed-schedule-id}
• DELETE /{product-feed-schedule-id}
• POST /{product-feed-upload-id}/error_report
• POST /{product-group-id}
• DELETE /{product-group-id}
• POST /{product-group-id}/products
• POST /{product-item-id}
• DELETE /{product-item-id}
• POST /{product-set-id}
• DELETE /{product-set-id}
• POST /{vehicle-id}

Creazione di report

Obsolescenze

Si applica a partire dalla versione 8.0.

• GET /{ad-study-id}?fields=split_test_config
• GET /{ad-study-id}?fields=iterative_split_test_config

Targetizzazione

Obsolescenza

Si applica a partire dalla versione 8.0.

• GET /search?type=adzipcode

Correzioni

• 28 settembre 2020: aggiornata la voce di autenticazione API Catalog per maggiore chiarezza.
• 23 ottobre 2020: aggiornata la voce API Catalog:

  • Abbiamo prorogato la scadenza, pertanto gli sviluppatori che utilizzano le versioni precedenti dell'API sono ancora in grado di chiamare gli endpoint del catalogo prodotti con l'autorizzazione ads_management. La nuova scadenza è il 28 febbraio 2021.
  • Abbiamo chiarito le informazioni relative all'autenticazione dell'utente di sistema.
• 17 maggio 2021: modificato l'endpoint dichiarato obsoleto da GET /{place-id} a GET /{place-information-id}. GET /{place-id} non è stato dichiarato obsoleto.