Feed da Página

Use o ponto de extremidade para acessar e publicar em uma Página. O Feed da Página abrange todas as interações com uma Página do Facebook. Isso inclui conteúdo e links publicados por esta Página, visitantes da Página e posts públicos nas quais a Página foi marcada.

Veja também

• O ponto de extremidade /{page-post-id} permite atualizar um post específico da Página.
• O ponto de extremidade /{page-id}/tagged recupera apenas posts públicos nos quais a Página foi marcada.

Leitura

Os posts de uma Página do Facebook.

Nova experiência de Página

Esta API é compatível com a nova experiência de Página.

Requisitos

A pessoa que solicita o token de acesso deve ser capaz de realizar uma das seguintes tarefas na Página:

• CREATE_CONTENT – Publicar conteúdo em nome da Página
• MANAGE – Atribuir e gerenciar tarefas na Página
• MODERATE

  • Responder a comentários em posts em nome da Página
  • Exclua comentários em posts da Página
  • Se uma conta do Instagram estiver conectada à Página, será possível publicar conteúdo no Instagram a partir do Facebook, responder e excluir comentários, enviar mensagens diretas, sincronizar dados de contatos comerciais e criar anúncios.

Também é preciso conceder ao app as seguintes permissões necessárias:

• A permissão pages_read_engagement
• A permissão pages_read_user_content

Caso você não seja o proprietário nem o gerenciador da Página, será preciso o seguinte:

• O recurso Acesso ao Conteúdo Público da Página

Exemplo de solicitação

GET /v25.0/{page-id}/feed 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}/feed',
    '{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}/feed",
    function (response) {
      if (response && !response.error) {
        /* handle the result */
      }
    }
);

/* make the API call */
new GraphRequest(
    AccessToken.getCurrentAccessToken(),
    "/{page-id}/feed",
    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}/feed"
                                      parameters:params
                                      HTTPMethod:@"GET"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
                                      id result,
                                      NSError *error) {
    // Handle the result
}];

Exemplo de resposta JSON

{
  "data": [
    {
      "created_time": "2019-05-17T16:24:04+0000",
      "message": "Become a Facebook developer!",
      "id": "{page-id}_2191966997525824"
    },
    {
      "created_time": "2019-02-26T21:35:42+0000",
      "message": "Hello world!",
      "id": "{page-id}_2072371269485398"
    },
...
    {
      "created_time": "2018-01-26T20:57:22+0000",
      "message": "Friday Funday!",
      "id": "{page-id}_1569752556413941"
    }
  ],
  "paging": {
    "cursors": {
      "before": "Q2c4U1pXNT...",
      "after": "Q2c4U1pXNT..."
    },
    "next": "https://graph.facebook.com/vX.X/{page-id}/feed?access_token={your-page-access-token}&pretty=0&limit=25&after=Q2c4U1pXNT..."
  }
}

Limitações

• Posts expirados – Se um post expirar, não será mais possível ver seu conteúdo usando a Graph API.
• Máximo de posts

  • A API retornará aproximadamente 600 posts classificados e publicados por ano.
  • É possível ler no máximo 100 posts 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 os posts com CTAs de mensagem usando o token de acesso de outra Página, já que as Páginas não podem enviar mensagens a outras.
• 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.
• Posts feitos – Os posts feitos e não feitos serão retornados ao consultar o ponto de extremidade "/{page-id}/feed". Use o campo "is_published" para receber somente os posts feitos.
• Posts compartilhados – Um post da Página que compartilha um post de outra Página ou pessoa poderá não ficar visível se o post original não estiver visível com o token de acesso usado.
• Posts marcados – Ao usar /{page-id}/tagged para exibir posts que marcaram a Página, os resultados incluirão posts 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 usuário de agente específico.
• Posts de vídeo – Para obter uma lista de posts de vídeo, a pessoa que faz a solicitação deve ser um administrador da Página.
• Reels – Para obter uma lista de reels publicados na sua Página, use a borda Page VideoReels.

Limitação: todos os posts (feitos ou não) serão extraídos no ponto de extremidade do feed. A única diferença é que o conteúdo não postado não aparecerá no feed físico. No entanto, há um campo "is_published" que pode ser adicionado ao ponto de extremidade "/feed" para que os desenvolvedores saibam se o post listado foi feito ou não

Campos

curl -i -X GET \
 "https://graph.facebook.com/{your-page-id}/feed
    ?fields=is_eligible_for_promotion,promotable_id
        &access_token={your-page-access-token}"

GraphRequest request = GraphRequest.newGraphPathRequest(
  accessToken,
  "/{your-page-id}/feed",
  new GraphRequest.Callback() {
    @Override
    public void onCompleted(GraphResponse response) {
      // Insert your code here
    }
});

Bundle parameters = new Bundle();
parameters.putString("fields", "is_eligible_for_promotion,promotable_id");
request.setParameters(parameters);
request.executeAsync();

FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
    initWithGraphPath:@"/{your-page-id}/feed"
           parameters:@{ @"fields": @"is_eligible_for_promotion,promotable_id",}
           HTTPMethod:@"GET"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection, id result, NSError *error) {
    // Insert your code here
}];

FB.api(
  '/{your-page-id}/feed',
  'GET',
  {"fields":"is_eligible_for_promotion,promotable_id"},
  function(response) {
      // Insert your code here
  }
);

try {
  // Returns a `FacebookFacebookResponse` object
  $response = $fb->get(
    '/{your-page-id}/feed?fields=is_eligible_for_promotion,promotable_id',
    '{access-token}'
  );
} catch(FacebookExceptionsFacebookResponseException $e) {
  echo 'Graph returned an error: ' . $e->getMessage();
  exit;
} catch(FacebookExceptionsFacebookSDKException $e) {
  echo 'Facebook SDK returned an error: ' . $e->getMessage();
  exit;
}
$graphNode = $response->getGraphNode();

{
  "data": [
    {
      "is_eligible_for_promotion": true,
      "promotable_id": "1353269864728879_1943344825721377",
      "id": "1353269864728879_1943344825721377"
    },
    {
      "is_eligible_for_promotion": true,
      "promotable_id": "1353269864728879_1943313139057879",
      "id": "1353269864728879_1943378089051384"
    },
    {
      "is_eligible_for_promotion": false,
      "promotable_id": "1353269864728879_1942095249179668",
      "id": "1353269864728879_1942095249179668"
    },
...

Publicação

Você pode publicar nas Páginas usando esta borda. É necessário fornecer o link ou a message.

Nova experiência de Página

Esta API é compatível com a nova experiência de Página.

Requisitos

Se você puder executar a tarefa CREATE_CONTENT, será necessário o seguinte:

• Um token de acesso à Página
• A permissão pages_manage_posts
• A permissão pages_read_engagement
• A permissão pages_show_list

Os posts serão exibidos com a voz da Página.

Permissões

• Um token de acesso à Página solicitado pela pessoa que pode realizar a

  tarefa CREATE_CONTENT

  na Página consultada.

• A permissão pages_manage_posts

Observação: se o visualizador ou o app não puderem ver a URL do link, não será possível fazer o post.

POST /v25.0/{page-id}/feed HTTP/1.1
Host: graph.facebook.com

message=This+is+a+test+message

/* PHP SDK v5.0.0 */
/* make the API call */
try {
  // Returns a `Facebook\FacebookResponse` object
  $response = $fb->post(
    '/{page-id}/feed',
    array (
      'message' => 'This is a test message',
    ),
    '{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}/feed",
    "POST",
    {
        "message": "This is a test message"
    },
    function (response) {
      if (response && !response.error) {
        /* handle the result */
      }
    }
);

Bundle params = new Bundle();
params.putString("message", "This is a test message");
/* make the API call */
new GraphRequest(
    AccessToken.getCurrentAccessToken(),
    "/{page-id}/feed",
    params,
    HttpMethod.POST,
    new GraphRequest.Callback() {
        public void onCompleted(GraphResponse response) {
            /* handle the result */
        }
    }
).executeAsync();

NSDictionary *params = @{
  @"message": @"This is a test message",
};
/* make the API call */
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
                               initWithGraphPath:@"/{page-id}/feed"
                                      parameters:params
                                      HTTPMethod:@"POST"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
                                      id result,
                                      NSError *error) {
    // Handle the result
}];

Resposta

{"id":"post-id"}

Esse ponto de extremidade aceita leitura após gravação e pode exibir imediatamente todos os campos retornados por operações de leitura.

Exemplo da ferramenta Explorador da Graph

Faça um teste na ferramenta Graph Explorer usando POST {page-id}/feed:

Campos

POST /v25.0/page-id/feed HTTP/1.1
Host: graph.facebook.com

message=This+is+a+test+activity&og_action_type_id=383634835006146&og_object_id=136050896551329&og_icon_id=609297155780549

/* PHP SDK v5.0.0 */
/* make the API call */
try {
  // Returns a `Facebook\FacebookResponse` object
  $response = $fb->post(
    '/page-id/feed',
    array (
      'message' => 'This is a test activity',
      'og_action_type_id' => '383634835006146',
      'og_object_id' => '136050896551329',
      'og_icon_id' => '609297155780549',
    ),
    '{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/feed",
    "POST",
    {
        "message": "This is a test activity",
        "og_action_type_id": "383634835006146",
        "og_object_id": "136050896551329",
        "og_icon_id": "609297155780549"
    },
    function (response) {
      if (response && !response.error) {
        /* handle the result */
      }
    }
);

Bundle params = new Bundle();
params.putString("message", "This is a test activity");
params.putString("og_action_type_id", "383634835006146");
params.putString("og_object_id", "136050896551329");
params.putString("og_icon_id", "609297155780549");
/* make the API call */
new GraphRequest(
    AccessToken.getCurrentAccessToken(),
    "/page-id/feed",
    params,
    HttpMethod.POST,
    new GraphRequest.Callback() {
        public void onCompleted(GraphResponse response) {
            /* handle the result */
        }
    }
).executeAsync();

NSDictionary *params = @{
  @"message": @"This is a test activity",
  @"og_action_type_id": @"383634835006146",
  @"og_object_id": @"136050896551329",
  @"og_icon_id": @"609297155780549",
};
/* make the API call */
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
                               initWithGraphPath:@"/page-id/feed"
                                      parameters:params
                                      HTTPMethod:@"POST"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
                                      id result,
                                      NSError *error) {
    // Handle the result
}];

Posts sem exibição na Página

Oferecemos suporte aos seguintes tipos de posts sem exibição na Página:

Os posts sem exibição na Página são tratados da mesma maneira que os posts exibidos, mas não aparecem no /feed.

Para ver uma lista de posts sem exibição na Página, consulte o campo is_published.

curl -i -X GET \
 "https://graph.facebook.com/{page-id}/feed
 ?fields=is_published
 &access_token={your-page-access-token}"

GraphRequest request = GraphRequest.newGraphPathRequest(
  accessToken,
  "/{page-id}/feed",
  new GraphRequest.Callback() {
    @Override
    public void onCompleted(GraphResponse response) {
      // Insert your code here
    }
});

Bundle parameters = new Bundle();
parameters.putString("fields", "is_published");
request.setParameters(parameters);
request.executeAsync();

FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
    initWithGraphPath:@"/{page-id}/feed"
           parameters:@{ @"fields": @"is_published",}
           HTTPMethod:@"GET"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection, id result, NSError *error) {
    // Insert your code here
}];

FB.api(
  '/{page-id}/feed',
  'GET',
  {"fields":"is_published"},
  function(response) {
      // Insert your code here
  }
);

try {
  // Returns a `FacebookFacebookResponse` object
  $response = $fb->get(
    '/{page-id}/feed?fields=is_published',
    '{access-token}'
  );
} catch(FacebookExceptionsFacebookResponseException $e) {
  echo 'Graph returned an error: ' . $e->getMessage();
  exit;
} catch(FacebookExceptionsFacebookSDKException $e) {
  echo 'Facebook SDK returned an error: ' . $e->getMessage();
  exit;
}
$graphNode = $response->getGraphNode();

Para ver um post no Facebook.com, acesse https://www.facebook.com/{post-id} para a maioria dos tipos de post. Você também pode recuperar o campo actions, que contém o URL a ser usado pelo usuário para curtir ou comentar o post.

call_to_action para post da Página

Você pode aprimorar seus posts da Página de link com botões de chamada para ação. O campo call_to_action a seguir pode ser adicionado a novos posts de Página de link.

Imagem de post da Página de link personalizado

Poste um link para uma Página com uma imagem personalizada. O anexo da história renderiza uma imagem recuperada do link. No momento, é possível substituir essa imagem fornecendo um parâmetro picture opcional com a URL de uma nova imagem. O parâmetro thumbnail oferece uma funcionalidade semelhante. A principal diferença é que o parâmetro aceita um arquivo de imagem local carregado no Facebook na chamada de API.

Permissões

• Um token de acesso à Página é obrigatório.
• O link deve pertencer à Página que está postando.

Limitações

• O parâmetro thumbnail só está disponível para posts de links em Páginas do Facebook.
• O parâmetro thumbnail tem prioridade mais alta em relação a picture. Se os dois forem fornecidos, o parâmetro picture não será usado.
• O parâmetro thumbnail aceita imagens com a extensão .jpg.jpeg.gif ou .png.
• O parâmetro thumbnail não é compatível com solicitações em lote.

Postar o link para uma Página

Poste um link para uma Página enviando uma solicitação POST à borda /page/feed. Para realizar o post imediatamente, defina o parâmetro publish como 1. Defina o parâmetro como 0 se quiser criar um post sem exibição que será mostrado posteriormente.

Exemplo de solicitação

curl -i -X POST "https://graph.facebook.com/{your-page-id}/feed
  ?message=Become%20a%20Facebook%20developer!
  &link=https%3A%2F%2Fdevelopers.facebook.com
  &published=1
  &access_token={your-page-access-token}"

GraphRequest request = GraphRequest.newPostRequest(
  accessToken,
  "/{your-page-id}/feed",
  new JSONObject("{\"message\":\"Become a Facebook developer!\",\"link\":\"https://developers.facebook.com\",\"published\":\"1\"}"),
  new GraphRequest.Callback() {
    @Override
    public void onCompleted(GraphResponse response) {
      // Insert your code here
    }
});
request.executeAsync();

FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
    initWithGraphPath:@"/{your-page-id}/feed"
           parameters:@{ @"message": @"Become a Facebook developer!",@"link": @"https://developers.facebook.com",@"published": @"1",}
           HTTPMethod:@"POST"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection, id result, NSError *error) {
    // Insert your code here
}];

FB.api(
  '/{your-page-id}/feed',
  'POST',
  {"message":"Become a Facebook developer!","link":"https://developers.facebook.com","published":"1"},
  function(response) {
      // Insert your code here
  }
);

try {
  // Returns a `FacebookFacebookResponse` object
  $response = $fb->post(
    '/{your-page-id}/feed',
    array (
      'message' => 'Become a Facebook developer!',
      'link' => 'https://developers.facebook.com',
      'published' => '1'
    ),
    '{access-token}'
  );
} catch(FacebookExceptionsFacebookResponseException $e) {
  echo 'Graph returned an error: ' . $e->getMessage();
  exit;
} catch(FacebookExceptionsFacebookSDKException $e) {
  echo 'Facebook SDK returned an error: ' . $e->getMessage();
  exit;
}
$graphNode = $response->getGraphNode();

Exemplo de resposta

{"id":"{post-id}"}

Post da Página de link com chamada para ação

O campo call_to_action especifica a ação adequada e o link relevante. O link deve ser o mesmo do parâmetro link do post da Página. Nesta chamada, os parâmetros title, description, caption e picture são opcionais e, quando não forem informados, o Facebook lerá as propriedades equivalentes a partir dos metadados do Open Graph do link. Se a página da web vinculada não tiver metadados do Open Graph, o Facebook tentará adivinhar as propriedades extraindo o conteúdo da página da web.

Exemplo de solicitação

curl -i -X POST "https://graph.facebook.com/{your-page-id}/feed
  ?message=Become a Facebook developer!
  &link=https://developers.facebook.com
  &call_to_action={"type":"SIGN_UP","value":{"link":"https://developers.facebook.com"}}
  &published=1
  &access_token={your-page-access-token}"

GraphRequest request = GraphRequest.newPostRequest(
  accessToken,
  "/{your-page-id}/feed",
  new JSONObject("{\"message\":\"Become a Facebook developer!\",\"link\":\"https://developers.facebook.com\",\"published\":\"1\",\"call_to_action\":\"{\\\"type\\\":\\\"SIGN_UP\\\",\\\"value\\\":{\\\"link\\\":\\\"https://developers.facebook.com\\\"}}\"}"),
  new GraphRequest.Callback() {
    @Override
    public void onCompleted(GraphResponse response) {
      // Insert your code here
    }
});
request.executeAsync();

FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
    initWithGraphPath:@"/{your-page-id}/feed"
           parameters:@{ @"message": @"Become a Facebook developer!",@"link": @"https://developers.facebook.com",@"published": @"1",@"call_to_action": @"{"type":"SIGN_UP","value":{"link":"https://developers.facebook.com"}}",}
           HTTPMethod:@"POST"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection, id result, NSError *error) {
    // Insert your code here
}];

FB.api(
  '/{your-page-id}/feed',
  'POST',
  {"message":"Become a Facebook developer!","link":"https://developers.facebook.com","published":"1","call_to_action":"{\"type\":\"SIGN_UP\",\"value\":{\"link\":\"https://developers.facebook.com\"}}"},
  function(response) {
      // Insert your code here
  }
);

try {
  // Returns a `FacebookFacebookResponse` object
  $response = $fb->post(
    '/{your-page-id}/feed',
    array (
      'message' => 'Become a Facebook developer!',
      'link' => 'https://developers.facebook.com',
      'published' => '1',
      'call_to_action' => '{"type":"SIGN_UP","value":{"link":"https://developers.facebook.com"}}'
    ),
    '{access-token}'
  );
} catch(FacebookExceptionsFacebookResponseException $e) {
  echo 'Graph returned an error: ' . $e->getMessage();
  exit;
} catch(FacebookExceptionsFacebookSDKException $e) {
  echo 'Facebook SDK returned an error: ' . $e->getMessage();
  exit;
}
$graphNode = $response->getGraphNode();

Exemplo de resposta

{"id":"{post-id}"}

Posts de link com imagem personalizada carregada

Como usar um arquivo local:

curl -F 'link=http://www.example.com' \
     -F 'thumbnail=@/local/path/to/file/on/hard/drive/image.jpg' \
     -F 'access_token=page-access-token'\
  https://graph.facebook.com/v2.11/page-id/feed

Valor de retorno

{"id":"post-id"}

Como usar uma imagem via URL:

curl -F 'link=http://www.example.com' \
     -F 'picture=https://www.example.com/path/to/image.jpg' \
     -F 'access_token=page-access-token'\
  https://graph.facebook.com/v2.11/page-id/feed

Valor de retorno

{"id":"post-id>"}

Post da Página de foto

Para saber mais, acesse nosso conteúdo de referência do nó de foto.

Posts da Página de vídeo

Para saber mais, acesse nosso conteúdo de referência do vídeo da Página.

Insights sobre o post da Página

Para saber mais, acesse nosso conteúdo de referência de insights sobre o post da Página.

Atualização

Não é possível usar esta borda para fazer atualizações, mas você pode atualizar posts usando o nó /{post-id}.

Exclusão

Não é possível usar esta borda para excluir posts, mas você pode fazer exclusões usando o nó /{post-id}.