Versão Graph API

Page Published Posts

Leitura

All published posts by the page.

New Page Experience

This endpoint is supported for New Page Experience.

Feature Permissions

NomeDescrição
Acesso ao Conteúdo Público da PáginaThis feature permission may be required.

Exemplo

Graph API Explorer
GET /v21.0/{page-id}/published_posts HTTP/1.1
Host: graph.facebook.com
/* PHP SDK v5.0.0 */
/* make the API call */
try {
  // Returns a `Facebook\FacebookResponse` object
  $response = $fb->get(
    '/{page-id}/published_posts',
    '{access-token}'
  );
} catch(Facebook\Exceptions\FacebookResponseException $e) {
  echo 'Graph returned an error: ' . $e->getMessage();
  exit;
} catch(Facebook\Exceptions\FacebookSDKException $e) {
  echo 'Facebook SDK returned an error: ' . $e->getMessage();
  exit;
}
$graphNode = $response->getGraphNode();
/* handle the result */
/* make the API call */
FB.api(
    "/{page-id}/published_posts",
    function (response) {
      if (response && !response.error) {
        /* handle the result */
      }
    }
);
/* make the API call */
new GraphRequest(
    AccessToken.getCurrentAccessToken(),
    "/{page-id}/published_posts",
    null,
    HttpMethod.GET,
    new GraphRequest.Callback() {
        public void onCompleted(GraphResponse response) {
            /* handle the result */
        }
    }
).executeAsync();
/* make the API call */
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
                               initWithGraphPath:@"/{page-id}/published_posts"
                                      parameters:params
                                      HTTPMethod:@"GET"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
                                      id result,
                                      NSError *error) {
    // Handle the result
}];
Se quiser saber como usar a Graph API, leia nosso guia sobre Como usar a Graph API.

Limitações

  • Máximo de publicações
    • A API retornará aproximadamente 600 publicações classificadas e publicadas por ano.
    • Só é possível ler no máximo 100 publicações do feed com o campo limit. Se tentar ler mais do que isso, você receberá uma mensagem de erro dizendo que não é possível exceder o limite de 100.
  • CTA de mensagem – Não é possível acessar as publicações com CTAs de mensagem usando o token de acesso de outra Página, já que Páginas não podem enviar mensagens a outras Páginas.
  • Informações identificáveis publicamente – As informações do usuário não serão incluídas nas respostas, a menos que você faça a solicitação com um token de acesso à Página.
  • Publicações compartilhadas – Uma publicação da Página que compartilha uma publicação de outra Página ou pessoa poderá não ficar visível se a publicação original não estiver visível com o token de acesso usado.
  • Publicações marcadas – Ao usar /{page-id}/tagged para exibir publicações que marcaram a Página, os resultados incluirão publicações de outras Páginas somente se elas forem autênticas.
  • Agentes de usuário – Os agentes de usuário disponíveis permitidos para essas chamadas da Graph API estão sujeitos a alterações sem aviso. Se estiver enfrentando problemas, você pode optar por mudar para uma versão mais nova do seu agente de usuário específico.
  • Publicações de vídeo – O campo source em /page/feed e /page/posts só é retornado para vídeos de propriedade da Página quando o usuário que faz a solicitação for um administrador da Página proprietária.

Parâmetros

Este ponto de extremidade não tem nenhum parâmetro.

Campos

A leitura desta borda retornará um resultado formatado em JSON:

{ "data": [], "paging": {}, "summary": {} }

data

Uma lista de nós PagePost.

paging

Para saber mais detalhes sobre paginação, consulte o Guia da Graph API.

summary

Informações agregadas sobre a borda, como contagens. Especifique os campos a serem buscados no parâmetro de resumo (como summary=total_count).

CampoDescrição
total_count
unsigned int32

The approximate total number of published posts within the specified time window, requires since parameter to be specified

Error Codes

ErroDescrição
80001There have been too many calls to this Page account. Wait a bit and try again. For more info, please refer to https://developers.facebook.com/docs/graph-api/overview/rate-limiting.
200Permissions error
100Invalid parameter
190Invalid OAuth 2.0 Access Token
210User not visible
283That action requires the extended permission pages_read_engagement and/or pages_read_user_content and/or pages_manage_ads and/or pages_manage_metadata
104Incorrect signature
3001Invalid query
2500Error parsing graph query

Criando

Não é possível executar esta operação neste ponto de extremidade.

Atualizando

Não é possível executar esta operação neste ponto de extremidade.

Excluindo

Não é possível executar esta operação neste ponto de extremidade.