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 publicações públicas nas quais a Página foi marcada.

Veja também

• O ponto de extremidade /{page-post-id} permite atualizar uma publicação específica da Página.
• O ponto de extremidade /{page-id}/tagged recupera apenas publicações públicas nas quais a Página foi marcada.

Leitura

As publicações 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 publicações em nome da Página
  • Exclua comentários em publicações 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 /v21.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

• Publicações expiradas – Se uma publicação expirar, não será mais possível ver seu conteúdo usando a Graph API.
• Máximo de publicações

  • A API retornará aproximadamente 600 publicações classificadas e publicadas por ano.
  • É 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 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.
• Publicações feitas – As publicações feitas e não feitas serão retornadas ao consultar o ponto de extremidade "/{page-id}/feed". Use o campo "is_published" para receber somente as publicações feitas.
• 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 usuário de agente específico.
• Publicações de vídeo – Para obter uma lista de publicações 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: todas as publicações (feitas ou não) serão extraídas no ponto de extremidade do feed. A única diferença é que o conteúdo não publicado 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 a publicação listada foi feita 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

As publicações serão exibidas 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 a publicação.

POST /v21.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 /v21.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
}];

Publicações sem exibição na Página

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

As publicações sem exibição na Página são tratadas da mesma maneira que as publicações exibidas, mas não aparecem no /feed.

Para ver uma lista de publicações 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 uma publicação no Facebook.com, acesse https://www.facebook.com/{post-id} para a maioria dos tipos de publicação. Você também pode recuperar o campo actions, que contém a URL a ser usado pelo usuário para curtir ou comentar a publicação.

call_to_action para publicação da Página

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

Imagem de publicação da Página de link personalizada

Publique 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á publicando.

Limitações

• O parâmetro thumbnail só está disponível para publicações 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.

Publicar o link para uma Página

Publique um link para uma Página enviando uma solicitação POST à borda /page/feed. Para realizar a publicação imediatamente, defina o parâmetro publish como 1. Defina o parâmetro como 0 se quiser criar uma publicação sem exibição que será mostrada 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}"}

Publicação 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 da publicação 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}"}

Publicação 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>"}

Publicação da Página de foto

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

Publicação da Página de vídeo

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

Insights sobre a publicação da Página

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

Atualização

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

Exclusão

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