Versão Graph API

URL `/?id={url}`

Representa uma URL compartilhada em uma publicação ou em um comentário na publicação.

Consulte a documentação da API de Indexação da Aba Notícias para ver mais informações.

Leitura

Obtenha informações sobre uma URL compartilhada em uma publicação ou em um comentário na publicação.

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
`access_token` Obrigatório. string	Um token de acesso.
`fields` string	Uma lista separada por vírgulas com os campos que você quer solicitar.
`id` string	A URL que será compartilhada.
`scopes` 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`
`id`	A própria URL.	`string`
`engagement`	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.	`object`
`comment_count`	O número de comentários na URL.	`int`
`comment_plugin_count`	O número de comentários no plugin reunidos com o plugin de comentários no site.	`int`
`reaction_count`	O número de reações à URL.	`int`
`share_count`	O número de vezes em que a URL foi compartilhada.	`int`
`og_object`	O objeto do Open Graph que está canonicamente associado à URL.	`OGObject`
`id`	A identificação do objeto.	`string`
`description`	A descrição do objeto, se estiver disponível.	`string`
`title`	O título do objeto, se estiver disponível.	`string`
`type`	O tipo do objeto.	`og:type`
`updated_time`	O momento da última atualização do objeto.	`datetime`

Exemplos

Para obter informações da URL em uma publicação ou um comentário, envie uma solicitação GET para https://graph.facebook.com com o parâmetro id definido como a URL, os campos relacionados e um token de acesso solicitado do usuário ou da Página que publicou 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 da URL em uma publicação ou comentário, envie uma solicitação POST para https://graph.facebook.com com o parâmetro id definido como a URL, scrape definido como true, os fields relacionados e um token de acesso solicitado do usuário ou da Página que publicou 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
`access_token` Obrigatório. string	Um token de acesso.
`fields` string	Uma lista separada por vírgulas com os campos que você quer solicitar.
`id` Obrigatório. string	A URL que será atualizada. Ela deve ser codificada para que não interfira no parâmetro `scrape`.
`scrape` Obrigatório. booliano	O valor deve ser `true`.

Exemplo de solicitação

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

Exemplo de resposta

{
  "success": true
}

Exclusão

Não é possível executar essa operação no ponto de extremidade.

URL /?id={url}

Leitura

Requisitos

Limitações

Parâmetros

Campos

Exemplos

Criação

Atualização

Requisitos

Exemplos

Parâmetros da string de consulta

Exemplo de solicitação

Exemplo de resposta

Exclusão

URL `/?id={url}`