Finestra di dialogo delle Notizie

Puoi aggiungere la finestra di dialogo delle Notizie alla tua app per consentire agli utenti di pubblicare sul proprio diario singole notizie con relativi commenti.

La condivisione delle notizie tramite questa finestra di dialogo non richiede alcuna autorizzazione estesa.

Integrazione

Questa finestra di dialogo può essere utilizzata con gli SDK di Facebook per JavaScript, iOS e Android ed eseguendo un reindirizzamento completo a un URL. Ecco alcuni snippet di codice di esempio che puoi usare per attivare questa finestra di dialogo.

JavaScript

Per attivare una finestra di dialogo delle Notizie, chiama la funzione FB.ui e usa il valore feed per il parametro method.

FB.ui({
  method: 'feed',
  link: 'https://developers.facebook.com/docs/'
}, function(response){});

iOS

Leggi la guida alla finestra di condivisione di iOS, che consente di pubblicare anche notizie Open Graph.

Android

Leggi le informazioni relative alla finestra di condivisione per Android, che consente di pubblicare anche notizie Open Graph.

Reindirizzamento URL

https://www.facebook.com/dialog/feed?
  app_id=145634995501895
  &display=popup
  &link=https%3A%2F%2Fdevelopers.facebook.com%2Fdocs%2F
  &redirect_uri=https://developers.facebook.com/tools/explorer

Nota

Se un utente ha l'opzione "Chi può scrivere sul tuo diario?" impostata su "Solo io" e un altro utente tenta di pubblicare un post sul diario del primo utente utilizzando la finestra di dialogo delle Notizie, viene visualizzato l'errore "Pubblicazione impossibile".

Parametri

Nota: se l'app condivide link agli store di iTunes o Google Play o a un profilo o una Pagina Facebook, non pubblicheremo immagini o descrizioni da te specificate nella condivisione con i parametri seguenti, ma informazioni relative all'app estratte direttamente dallo store o dalla Pagina Facebook tramite il Webcrawler. Potrebbero non essere incluse immagini. Per l'anteprima della condivisione di un link a iTunes o Google Play, inserisci l'URL nel debugger di condivisione.

Parametro	Descrizione
`app_id`	L'identificativo unico della tua app. Obbligatorio.
`redirect_uri`	L'URL a cui viene reindirizzata la persona dopo aver cliccato su un pulsante della finestra di dialogo. Obbligatorio per il reindirizzamento dell'URL.
`display`	Determina come sarà visualizzata la finestra di dialogo. Se usi una finestra di dialogo con reindirizzamento dell'URL, sarà una visualizzazione a pagina intera su Facebook.com. Questo tipo di visualizzazione è denominato `page`. Se usi l'SDK di Facebook per iOS o Android per richiamare la finestra di dialogo, il parametro viene specificato automaticamente in base al tipo di visualizzazione più adatto al dispositivo. Se usi il Facebook SDK for Javascript, per impostazione predefinita viene scelto un `iframe` di tipo modale per le persone che hanno effettuato l'accesso alla tua app, `async` nei giochi su Facebook.com e una finestra `popup` negli altri casi. Se necessario, puoi anche forzare i tipi `popup` o `page` quando usi il Facebook SDK for Javascript. Per impostazione predefinita, le app web mobili usano sempre una visualizzazione di tipo `touch`.
`from`	L'ID della persona che pubblica il messaggio. Se non è specificato, per impostazione predefinita è l'utente attuale. Se è specificato, deve essere l'ID dell'utente o di una Pagina di cui l'utente è amministratore.
`to`	L'ID del profilo sui cui verrà pubblicata la notizia. Se non è specificato, per impostazione predefinita è il valore del parametro `from`. L'ID deve essere quello di un amico che usa l'app.
`link`	Il link allegato al post.
`source`	L'URL di un file multimediale (SWF o MP3) allegato al post. Se SWF, devi specificare anche `picture` per fornire una miniatura per il video.
`ref`	Questo argomento è una lista separata da virgole, composta al massimo da 5 elementi distinti, ciascuno di lunghezza minima di 1 carattere e massima di 15 caratteri, estratti dall'insieme '0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz_'. Ogni categoria viene usata negli Insights di Facebook per aiutarti a misurare le prestazioni dei vari tipi di post.

Parametri obsoleti

Parametro	Descrizione
`post_id`	L'ID della notizia pubblicata, se la persona ha scelto di pubblicarla sul proprio diario.
`properties`	Un oggetto JSON di coppie chiave/valore che apparirà nell'allegato dello stream sotto la descrizione, una proprietà per riga. Le chiavi devono essere stringhe e i valori possono essere stringhe o oggetti JSON con le chiavi `text` e `href`.
`actions`	Un array JSON contenente un singolo oggetto che descrive il link di azione che apparirà accanto al link "Commenta" e "Mi piace" sotto i post. L'oggetto contenuto deve avere le chiavi `name` e `link`.
`picture`	L'URL di un'immagine allegata al post. L'immagine deve essere di almeno 200 pixel per 200 pixel. Per maggiori informazioni sulle dimensioni, consulta la nostra documentazione sulle best practice per la condivisione.
`name`	Il nome del link allegato.
`caption`	La didascalia del link (visualizzata sotto il nome del link). Se non è specificata, questo campo riporta automaticamente l'URL del link.
`description`	La descrizione del link (visualizzata sotto la didascalia del link). Se non è specificata, nel campo vengono inserite automaticamente le informazioni estratte dal link, di solito il titolo della pagina.
`thumbnail`	Il file di immagine locale caricato (`.jpg`, `.jpeg`, `.gif` o `.png`).