Piattaforma Instagram

Commento di Instagram (IG)

Rappresenta un commento su un oggetto media di Instagram.

If you are migrating from Marketing API Instagram Ads endpoints to Instagram Platform endpoints, be aware that some field names are different.

Presentazione dei seguenti campi:

  • legacy_instagram_comment_id

Non sono supportati i campi seguenti:

  • comment_type
  • mentioned_instagram_users

Requirements

Instagram API with Instagram LoginInstagram API with Facebook Login

Access Tokens

  • Instagram User access token

Host URL

graph.instagram.com

graph.facebook.com

Login Type

Business Login for Instagram

Facebook Login for Business

Permissions
  • instagram_business_basic
  • instagram_business_manage_comments
  • instagram_basic
  • instagram_manage_comments
  • pages_read_engagement

If the app user was granted a role via the Business Manager on the Page connected to the targeted IG User, you will also need one of:

  • ads_management
  • ads_read

Creazione

Questa operazione non è supportata.

Lettura

GET <HOST_URL>/<IG_COMMENT_ID>?fields=<LIST_OF_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. 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.

Sintassi della richiesta

GET https://<HOST_URL>/<API_VERSION>/<IG_COMMENT_ID>
  ?fields=<LIST_OF_FIELDS>
  &access_token=<ACCESS_TOKEN>

Parametri del percorso

SegnapostoValore

<API_VERSION>

Versione dell'API.

<HOST_URL>

Versione dell'API.

<IG_COMMENT_ID>

Obbligatorio. ID del commento di IG.

Parametri della stringa della query

ChiaveSegnapostoValore

access_token

<ACCESS_TOKEN>

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

fields

<LIST_OF_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: ID per Instagram (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.

legacy_instagram_comment_id

L'ID del commento di Instagram creato per gli endpoint dell'API Marketing per la versione 21.0 e quelle precedenti.

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.

A partire dal 27 agosto 2024, saranno necessarie le autorizzazioni instagram_manage_comments (se la tua app usa Facebook Login) e instagram_business_manage_comments (se la tua app usa Instagram Login) per accedere al campo username di un utente di Instagram che ha commentato i contenuti multimediali dell'account Instagram per professionisti di un utente dell'app.

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.instagram.com/v25.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 <HOST_URL>/<IG_COMMENT_ID>?hide=<BOOLEAN>

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.

Token d'accesso

Un token d'accesso dell'utente proprietario dell'oggetto multimediale che è stato commentato.

Esempio di richiesta

Nascondere un commento

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

Esempio di risposta

{
  "success": true
}

Eliminazione

Eliminare un commento

DELETE <HOST_URL>/<IG_COMMENT_ID>

Token d'accesso

Un token d'accesso utente dall'utente che ha creato il commento.

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.instagram.com
  /17873440459141021

Esempio di risposta

{
  "success": true
}