API Graph
Versione API Graph

URL /?id={url}

Rappresenta un URL condiviso in un post o in un commento su un post.

Per ulteriori informazioni, consulta la documentazione sull'API News Tab Indexing.

Lettura

Ottieni informazioni su un URL condiviso in un post o in un commento su un post.

Requisiti

TipoDescrizione
Token d'accesso

Per effettuare questa richiesta, è possibile utilizzare qualsiasi token d'accesso.

Funzioni

Non applicabile.

Attività della Pagina

Non applicabile.

Autorizzazioni

Non applicabile.

Limitazioni

  • I valori di interazione restituiti non sono precisi, ma riflettono l'interazione degli utenti con un URL.
  • Non puoi superare 10 richieste GET per URL, per app e per ora.

Parametri

Includi i seguenti parametri della stringa di query per potenziare la richiesta.

ParametroDescrizione

access_token

Obbligatorio

stringa

Un token d'accesso.

fields

stringa

Una lista separata da virgole di campi che desideri richiedere.

id

stringa

L'URL da condividere.

scopes

stringa

Una lista di ambiti separata da virgole.

Campi

Nome della proprietà Descrizione Tipo
app_links

Dati App Links associati a questo URL, se disponibili.

AppLinks

id

L'URL stesso.

string

engagement

Conteggi dei vari modi in cui le persone hanno interagito con l'URL. I valori delle interazioni non sono precisi e ciò è intenzionale, ma ti assicuriamo che riflettono accuratamente l'interazione degli utenti con un URL.

object

comment_count

Numero di commenti sull'URL.

int

comment_plugin_count

Numero di commenti sul plug-in raccolti utilizzando il plug-in dei commenti sul tuo sito.

int

reaction_count

Numero di reazioni all'URL.

int

share_count

Numero di condivisioni dell'URL.

int

og_object

L'oggetto Open Graph canonicamente associato a questo URL.

OGObject

id

ID dell'oggetto.

string

description

La descrizione dell'oggetto, se disponibile.

string

title

Il titolo dell'oggetto, se disponibile.

string

type

Il tipo di oggetto.

og:type

updated_time

La data dell'ultimo aggiornamento dell'oggetto.

datetime

Esempi

Per ottenere informazioni su un URL pubblicato in un post o in un commento, invia una richiesta GET a https://graph.facebook.com con il parametro id impostato sull'URL, qualsiasi campo relativo all'URL e un token d'accesso richiesto dall'utente o dalla Pagina che ha pubblicato il post o il commento.

L'esempio seguente mostra l'interazione per l'URL, https://www.facebook.com, che è stato condiviso dall'utente rappresentato dal token d'accesso dell'utente.

Formattato per una maggiore leggibilità.
curl -i -X GET \
 "https://graph.facebook.com/{latest-graph-api-version}/
    ?id=https://www.facebook.com
    &fields=engagement
    &access_token={user-access-token}"

Effettuato l'invio, la tua app riceve i seguenti valori dell'interazione per l'URL condiviso:

{
  "engagement": {
    "reaction_count": 514919172,
    "comment_count": 68687082,
    "share_count": 975739682,
    "comment_plugin_count": 1641
  },
  "id": "https://www.facebook.com"
}

Creazione

Non puoi eseguire questa operazione su questo endpoint.

Aggiornamento

Aggiorna un URL.

Requisiti

TipoDescrizione
Token d'accesso

Per effettuare questa richiesta, è possibile utilizzare qualsiasi token d'accesso.

Funzioni

Non applicabile.

Attività della Pagina

Non applicabile.

Autorizzazioni

Non applicabile.

Esempi

Per aggiornare le informazioni su un URL pubblicato in un post o in un commento, invia una richiesta POST a https://graph.facebook.com con il parametro id impostato sull'URL, il parametro scrape impostato su true, qualsiasi fields relativo all'URL e un token d'accesso richiesto dall'utente o dalla Pagina che ha pubblicato il post o il commento.

L'esempio seguente aggiorna l'URL, https://www.facebook.com/my-update, che è stato condiviso dall'utente rappresentato dal token d'accesso dell'utente.

Formattato per una maggiore leggibilità.
curl -i -X POST \
 "https://graph.facebook.com/{latest-graph-api-version}/
    ?id=https://www.facebook.com/my-update
    &scrape=true
    &access_token={user-access-token}"

Effettuato l'invio, la tua app riceve i seguenti valori dell'interazione per l'URL condiviso:

{
  "success": true
}

Parametri della stringa della query

Includi i seguenti parametri della stringa di query per potenziare la richiesta.

ParametroDescrizione

access_token

Obbligatorio

stringa

Un token d'accesso.

fields

stringa

Una lista separata da virgole di campi che desideri richiedere.

id

Obbligatorio

stringa

L'URL da aggiornare. L'URL deve essere codificato in modo che non interferisca con il parametro scrape.

scrape

Obbligatorio

booleano

Il valore deve essere true.

Esempio di richiesta

POST /{version}/?id={url}&scrape=true
Host: graph.facebook.com

Esempio di risposta

{
  "success": true
}

Eliminazione

Non puoi eseguire questa operazione su questo endpoint.