Piattaforma Instagram

Commento di IG

Rappresenta un commento su un contenuto multimediale di IG.

Creazione

Questa operazione non è supportata.

Lettura

GET /{ig-comment-id}?fields={fields}

Consente di ottenere campi e segmenti su un commento di IG.

Limitazioni

  • Le richieste non possono essere eseguite su commenti individuati tramite l'API Mentions, a meno che la richiesta non sia effettuata da chi ha creato il commento. In questi casi, usa invece il nodo Mentioned Comment.
  • I commenti sui contenuti con restrizioni in base all'età non vengono restituiti.
  • I commenti creati da utenti Instagram a cui l'utente dell'app ha applicato restrizioni non verranno restituiti, a meno che tali restrizioni non vengano rimosse e i commenti approvati.
  • I commenti su contenuti multimediali di IG di tipo video in diretta possono essere letti solo durante la trasmissione del contenuto su cui è stato creato il commento.

Requisiti

TipoRequisito

Token d'accesso

Utente

Autorizzazioni

instagram_basic
pages_read_engagement
pages_show_list


Se all'utente dell'app è stato concesso un ruolo tramite Business Manager sulla Pagina collegata all'utente Instagram specifico, sarà necessaria anche una delle seguenti autorizzazioni:


ads_management
business_management

Sintassi della richiesta

GET https://graph.facebook.com/{api-version}/{ig-comment-id}
  ?fields={fields}
  &access_token={access-token}

Parametri del percorso

SegnapostoValore

{api-version}

Versione dell'API.

{ig-comment-id}

Obbligatorio. ID del commento di IG.

Parametri della stringa della query

CodiceSegnapostoValore

access_token

{access-token}

Obbligatorio. Token d'accesso utente dell'utente dell'app.

fields

{fields}

Lista separata da virgole dei campi che desideri vengano restituiti nell'insieme dei risultati per ogni commento di IG.

Campi

Nome del campoDescrizione

from

Un oggetto contenente:


  • id: IGSID dell'utente Instagram che ha creato il commento di IG.
  • username: nome utente dell'utente Instagram che ha creato il commento di IG.

hidden

Indica se il commento è stato nascosto (true) o meno (false).

id

ID del commento di IG.

like_count

Numero di "Mi piace" sul commento di IG.

media

Un oggetto contenente:


parent_id

ID del commento di IG principale, se questo commento è stato creato su un altro commento di IG (cioè si stratta di una risposta a un altro commento).

replies

Un elenco di risposte (commenti di IG) aggiunte al commento di IG.

text

Testo del commento di IG.

timestamp

Indicazione temporale in formato ISO 8601 di quando è stato creato il commento di IG.


Esempio: 2017-05-19T23:27:28+0000.

user

ID dell'utente Instagram che ha creato il commento di IG. Restituito solo se il commento di IG è stato creato dall'utente dell'app; in caso contrario, verrà restituito username.

username

Nome utente dell'utente di Instagram che ha creato il commento di IG.

Segmenti

SegmentoDescrizione

replies

Consente di ottenere una lista di commenti di IG sul commento di IG. Consente di aggiungere un commento di IG a un commento di IG.

Risposta

Un oggetto JSON contenente campi e segmenti predefiniti e obbligatori.

{
  "{field}":"{value}",
  ...
}

Esempio di cURL

Richiesta

curl -i -X GET \
 "https://graph.facebook.com/v19.0/17881770991003328?fields=hidden%2Cmedia%2Ctimestamp&access_token=EAAOc..."

Risposta

{
  "hidden": false,
  "media": {
    "id": "17856134461174448"
  },
  "timestamp": "2017-05-19T23:27:28+0000",
  "id": "17881770991003328"
}

Aggiornamento

Nascondere/mostrare un commento

POST /{ig-comment-id}?hide={hide}

Parametri della stringa della query

  • {hide} (obbligatorio): impostalo su true per nascondere il commento o su false per mostrarlo.

Limitazioni

  • I commenti pubblicati dai creatori di oggetti di tipo Media sui propri oggetti saranno sempre visualizzati, anche se i commenti sono stati impostati su hide=true.
  • I commenti sui contenuti multimediali di IG di tipo video in diretta non sono supportati.

Autorizzazioni

Un token d'accesso utente dell'utente Facebook che ha creato il commento, con le seguenti autorizzazioni:

  • instagram_basic
  • instagram_manage_comments
  • pages_show_list
  • pages_read_engagement

Se il token proviene da un utente il cui ruolo nella Pagina è stato concesso tramite il Business Manager, è richiesta anche una delle seguenti autorizzazioni:

  • ads_management
  • pages_read_engagement
  • business_management

Esempio di richiesta

Nascondere un commento

POST graph.facebook.com
  /17873440459141021?hide=true

Esempio di risposta

{
  "success": true
}

Eliminazione

Eliminare un commento

DELETE /{ig-comment-id}

Autorizzazioni

Un token d'accesso utente dall'utente che ha creato il commento, con le seguenti autorizzazioni:

  • instagram_basic
  • instagram_manage_comments

Se il token proviene da un utente il cui ruolo nella Pagina è stato concesso tramite il Business Manager, è richiesta anche una delle seguenti autorizzazioni:

  • ads_management
  • pages_read_engagement
  • business_management

Limitazioni

  • Un commento può essere eliminato solo dal creatore dell'oggetto su cui è stato creato, anche se l'utente che tenta di eliminare il commento ne è l'autore.
  • I commenti sui contenuti multimediali di IG di tipo video in diretta non sono supportati.

Esempio di richiesta

DELETE graph.facebook.com
  /17873440459141021

Esempio di risposta

{
  "success": true
}