URL /?id={url}
Representa um URL compartilhado em um post ou em um comentário no post.
Consulte a documentação da API de Indexação da Aba Notícias para ver mais informações.
Leitura
Obtenha informações sobre um URL compartilhado em um post ou em um comentário no post.
Requisitos
| Tipo | Descrição |
|---|---|
| Tokens de acesso | Qualquer token de acesso pode ser usado para fazer essa solicitação. |
| Recursos | Não aplicável. |
| Tarefas da Página | Não aplicável. |
| Permissões | Não aplicável. |
Limitações
- Os valores de engajamento retornados não são precisos, mas refletem o engajamento do usuário com a URL.
- Há um limite de 10 solicitações GET por URL, app ou hora.
Parâmetros
Inclua os parâmetros da string de consulta a seguir para ampliar a solicitação.
| Parâmetro | Descrição |
|---|---|
Obrigatório. string | Um token de acesso. |
string | Uma lista separada por vírgulas com os campos que você quer solicitar. |
string | A URL que será compartilhada. |
string | Uma lista de escopos separada por vírgulas. |
Campos
| Nome da propriedade | Descrição | Tipo |
|---|---|---|
app_links | Dados de AppLinks associados à URL, quando disponíveis. | AppLinks |
| A própria URL. |
|
| As contagens das diferentes maneiras com que as pessoas interagiram com a URL. Os valores de engajamento não são precisos de propósito, mas refletem com confiabilidade o engajamento de usuários com uma URL. |
|
| O objeto do Open Graph que está canonicamente associado à URL. |
|
Exemplos
Para obter informações do URL em um post ou um comentário, envie uma solicitação GET para https://graph.facebook.com com o parâmetro id definido como o URL, os campos relacionados e um token de acesso solicitado do usuário ou da Página que postou o conteúdo.
O exemplo a seguir mostra o engajamento da URL https://www.facebook.com compartilhada pelo usuário representado por um token de acesso.
Texto formatado para facilitar a leitura.curl -i -X GET \
"https://graph.facebook.com/{latest-graph-api-version}/
?id=https://www.facebook.com
&fields=engagement
&access_token={user-access-token}"Se a solicitação for bem-sucedida, o app receberá estas contagens de engajamento para a URL compartilhada:
{
"engagement": {
"reaction_count": 514919172,
"comment_count": 68687082,
"share_count": 975739682,
"comment_plugin_count": 1641
},
"id": "https://www.facebook.com"
}Criação
Não é possível executar essa operação no ponto de extremidade.
Atualização
Atualize uma URL.
Requisitos
| Tipo | Descrição |
|---|---|
| Tokens de acesso | Qualquer token de acesso pode ser usado para fazer essa solicitação. |
| Recursos | Não aplicável. |
| Tarefas da Página | Não aplicável. |
| Permissões | Não aplicável. |
Exemplos
Para atualizar as informações do URL em um post ou comentário, envie uma solicitação POST para https://graph.facebook.com com o parâmetro id definido como o URL, scrape definido como true, os fields relacionados e um token de acesso solicitado do usuário ou da Página que postou o conteúdo.
O exemplo a seguir atualiza a URL https://www.facebook.com/my-update compartilhada pelo usuário representado pelo token de acesso.
Texto formatado para facilitar a leitura.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}"Se a solicitação for bem-sucedida, o app receberá estas contagens de engajamento para a URL compartilhada:
{
"success": true
} Parâmetros da string de consulta
Inclua os parâmetros da string de consulta a seguir para ampliar a solicitação.
| Parâmetro | Descrição |
|---|---|
Obrigatório. string | Um token de acesso. |
string | Uma lista separada por vírgulas com os campos que você quer solicitar. |
Obrigatório. string | A URL que será atualizada. Ela deve ser codificada para que não interfira no parâmetro |
Obrigatório. booliano | O valor deve ser |
Exemplo de solicitação
POST /{version}/?id={url}&scrape=true
Host: graph.facebook.comExemplo de resposta
{
"success": true
}Exclusão
Não é possível executar essa operação no ponto de extremidade.