Feed della Pagina

Usa questo endpoint per accedere a una Pagina e pubblicare contenuti. Il feed della Pagina comprende tutte le interazioni con una Pagina Facebook, tra cui: post e link pubblicati da questa Pagina, ospiti su questa Pagina e post pubblici in cui la Pagina è stata taggata.

Altri contenuti da consultare

• L'endpoint /{page-post-id} ti consente di aggiornare uno specifico post della Pagina.
• L'endpoint /{page-id}/taggedper recuperare solo i post pubblici in cui la Pagina è stata taggata.

Lettura

I post di una Pagina Facebook.

Nuova esperienza della Pagina

Questa API è supportata per la nuova esperienza della Pagina.

Requisiti

La persona che richiede il token d'accesso deve poter eseguire una delle seguenti attività sulla Pagina:

• CREATE_CONTENT: pubblicare contenuto come Pagina sulla Pagina
• MANAGE: assegnare e gestire attività della Pagina
• MODERATE

  • Rispondere a commenti sui post della Pagina come Pagina
  • Eliminare commenti ai post della Pagina
  • Se alla Pagina è collegato un account Instagram, pubblicare contenuti su Instagram da Facebook, rispondere ed eliminare commenti, inviare direct, sincronizzare le informazioni di contatto dell'azienda e creare inserzioni.

E aver concesso all'app le seguenti autorizzazioni necessarie:

• Autorizzazione pages_read_engagement
• Autorizzazione pages_read_user_content

Se non possiedi o gestisci la Pagina, avrai bisogno di:

• Funzione di accesso ai contenuti pubblici della Pagina

Esempio di richiesta

GET /v19.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
}];

Esempio di risposta 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..."
  }
}

Limitazioni

• Post scaduti: se un post è scaduto, non potrai più visualizzarne il contenuto usando l'API Graph.
• Numero massimo di post

  • L'API restituirà circa 600 post pubblicati e classificati all'anno.
  • Con il campo limit, puoi leggere solo un massimo di 100 post del feed. Se tenti di leggerne un numero maggiore, verrà visualizzato un messaggio di errore che indica di non superare i 100 post.
• CTA messaggio: non è possibile accedere ai post con i CTA dei messaggi utilizzando il token d'accesso di un'altra Pagina, poiché le Pagine non possono inviare messaggi ad altre Pagine.
• Informazioni di identificazione personale: le informazioni sull'utente non saranno incluse nelle risposte a meno che non si effettui la richiesta con un token d'accesso della Pagina.
• Post pubblicati: post pubblicati e non pubblicati saranno restituiti quando si esegue una query dell'endpoint `/{page-id}/feed`. Usa il campo 'is_published` per restituire solo i post pubblicati.
• Post condivisi: un post della Pagina che condivide un post di un'altra Pagina o persona può non essere visibile se, a sua volta, il post originale non lo è con il token d'accesso utilizzato.
• Post taggati: quando usi /{page-id}/tagged per mostrare i post che hanno taggato questa Pagina, i risultati includono post di altre Pagine solo se queste sono autentiche.
• Agenti utente: gli agenti utente disponibili consentiti per queste chiamate API Graph sono soggetti a modifiche senza preavviso. Se si verificano problemi, ti consigliamo di passare a una versione più recente dell'agente utente.
• Post con video: per ottenere una lista di post con video, la persona che effettua la richiesta deve essere un amministratore della Pagina.
• Reel: per ottenere una lista di reel pubblicati sulla tua Pagina, usa il segmento VideoReels della Pagina.

Limitazione: tutti i post (pubblicati e non pubblicati) saranno inclusi nell'endpoint del feed. L'unica differenza è che i post non pubblicati non saranno elencati nel feed fisico. Tuttavia, puoi aggiungere il campo is_published all'endpoint /feed per informare gli sviluppatori dello stato pubblicato o non pubblicato del post incluso nell'endpoint /feed.

Campi

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"
    },
...

Pubblicazione

Puoi pubblicare sulle Pagine usando questo segmento. Devi fornire link o message.

Nuova esperienza della Pagina

Questa API è supportata per la nuova esperienza della Pagina.

Requisiti

Se puoi eseguire l'attività CREATE_CONTENT, avrai bisogno di:

• Un token d'accesso della Pagina
• L'autorizzazione pages_manage_posts
• L'autorizzazione pages_read_engagement
• L'autorizzazione pages_show_list

I post verranno visualizzati come pubblicati dalla Pagina.

Autorizzazioni

• Un token d'accesso della Pagina richiesto da un utente che può eseguire l'attività della Pagina

  CREATE_CONTENT

  sulla Pagina interrogata

• Autorizzazione pages_manage_posts

Nota: se l'utente che visualizza o l'app non sono in grado di vedere l'URL di link, il post non avrà esito positivo.

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

Risposta

{"id":"post-id"}

Questo endpoint supporta la modalità RAW e può restituire immediatamente tutti i campi restituiti dalle operazioni di lettura.

Esempio dello strumento di esplorazione per Graph

Effettua un test nello strumento di esplorazione per Graph usando POST {page-id}/feed:

Campi

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

Post della Pagina non pubblicati

Supportiamo i seguenti tipi di post della Pagina non pubblicati:

I post della Pagina non pubblicati sono trattati come i post della Pagina pubblicati, tranne per il fatto che non vengono visualizzati in /feed.

Per vedere una lista di post della Pagina non pubblicati, effettua una query al 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();

Per visualizzare un post su Facebook.com, puoi accedere a https://www.facebook.com/{post-id} per la maggior parte dei tipi di post o recuperare il campo actions del post, che contiene l'URL a cui un utente può mettere Mi piace o aggiungere un commento al post.

call_to_action per il post della Pagina

Puoi migliorare i post della Pagina con link con pulsanti di call to action. A nuovi post della Pagina con link è possibile aggiungere il seguente campo call_to_action.

Immagine post della Pagina con link personalizzato

Pubblica un link su una Pagina con un'immagine con link personalizzato. L'allegato della storia mostra un'immagine recuperata dal link. Attualmente è possibile sovrascrivere tale immagine fornendo un parametro picture facoltativo con un URL a una nuova immagine. Il parametro thumbnail offre funzionalità simili, con la differenza fondamentale che il parametro accetta un file di immagine locale che viene caricato su Facebook nella chiamata API.

Autorizzazioni

• È necessario un token d'accesso della Pagina.
• Il link deve appartenere alla Pagina che pubblica.

Limitazioni

• Il parametro thumbnail è disponibile solo per i post con link sulle Pagine Facebook.
• Il parametro thumbnail ha una precedenza maggiore rispetto al parametro picture. Se sono forniti entrambi, il parametro picture non viene usato.
• Il parametro thumbnail accetta immagini con estensione .jpg.jpeg.gif o .png.
• Il parametro thumbnail non è supportato nelle richieste batch.

Pubblicazione di un link su una Pagina

Pubblica un link su una Pagina inviando una richiesta POST al segmento /page/feed. Imposta il parametro publish su 1 per pubblicare il post immediatamente o su 0 per creare un post non pubblicato da pubblicare in un secondo momento.

Esempio di richiesta

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();

Esempio di risposta

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

Post della Pagina con link con call to action

Il campo call_to_action specifica l'azione appropriata e il link pertinente. Questo link deve essere lo stesso del parametro link del post della Pagina. In questa chiamata, title, description, caption e picture sono facoltativi e, se non vengono forniti, Facebook leggerà le proprietà equivalenti dai metadati Open Graph del link. Se la pagina web di cui viene inserito il link non ha metadati Open Graph, Facebook cercherà di individuare queste proprietà estraendo il contenuto della pagina web.

Esempio di richiesta

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();

Esempio di risposta

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

Post con link con immagine caricata personalizzata

Utilizzando un file locale:

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

Valore restituito

{"id":"post-id"}

Utilizzando un'immagine tramite 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

Valore restituito

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

Post della Pagina con foto

Consulta il nostro riferimento per i nodi delle foto per ulteriori informazioni.

Post della Pagina con video

Consulta il nostro riferimento per i video della Pagina per ulteriori informazioni.

Insight sui post della Pagina

Consulta il nostro riferimento per gli insight sui post della Pagina per ulteriori informazioni.

Aggiornamento

Non puoi aggiornare utilizzando questo segmento, tuttavia puoi aggiornare i post utilizzando il nodo /{post-id}.

Eliminazione

Non puoi eliminare utilizzando questo segmento, tuttavia puoi eliminare i post utilizzando il nodo /{post-id}.