Utente Instagram

Rappresenta un account business di Instagram o un account creator di Instagram.

Nella nostra documentazione usiamo "Utente Instagram" e "Account Instagram" in modo intercambiabile. Entrambi indicano l'account Instagram per professionisti dell'utente della tua app.

Requirements

	Instagram API with Instagram Login	Instagram API with Facebook Login
Access Tokens	Instagram User user access token	Facebook 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_basic` `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` If you are requesting the `shopping_product_tag_eligibility` field for product tagging, you will also need: `catalog_management` `instagram_shopping_tag_products`
Business Roles	Not applicable.	If you are requesting the `shopping_product_tag_eligibility` field for product tagging, the app user must have an admin role on the Business Manager that owns the IG User's Instagram Shop.
Instagram Shop	Not applicable.	If you are requesting the `shopping_product_tag_eligibility` field for product tagging, the IG User must have an approved Instagram Shop with a product catalog containing products.

Creazione

Questa operazione non è supportata.

Lettura

GET /<IG_USER_ID>

Consente di ottenere campi e segmenti su un account business o creator di Instagram.

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

Sintassi della richiesta

GET https://graph.facebook.com/<API_VERSION>/<IG_USER_ID>
  ?fields=<LIST_OF_FIELDS>
  &access_token=<ACCESS_TOKEN>

Parametri del percorso

Segnaposto	Valore
`<API_VERSION>`	Versione dell'API.
`<IG_USER_ID>`	Obbligatorio. ID utente di IG.

Parametri della stringa della query

Chiave	Segnaposto	Valore
`access_token`	`<ACCESS_TOKEN>`	Obbligatorio. Token d'accesso dell'utente dell'utente dell'app.
`fields`	`<LIST_OF_FIELDS>`	Lista separata da virgole dei campi dell'utente Instagram che desideri vengano restituiti nell'insieme dei risultati per ciascun utente Instagram.

Campi

I campi pubblici possono essere restituiti da un segmento usando l'espansione dei campi. Solo alcuni campi saranno disponibili per accedere ad account Instagram collegati a una Pagina.

Nome del campo	Descrizione
`alt_text` Pubblico	Testo descrittivo per le immagini, per l'accessibilità.
`biography` Pubblico	Testo della biografia del profilo.
`followers_count` Pubblico	Numero totale di utenti Instagram che seguono l'utente.
`follows_count`	Numero totale di utenti Instagram seguiti dall'utente.
`has_profile_pic`	Indica se l'account Instagram per professionisti dell'utente della tua app ha un'immagine del profilo.
`id` Pubblico	ID utente per singola app. Disponibile per gli account Instagram collegati a una Pagina.
`is_published`	Indica se l'account Instagram dell'utente della tua app è stato pubblicato. Disponibile per gli account Instagram collegati a una Pagina.
`legacy_instagram_user_id`	ID Instagram dell'utente della tua app creato per gli endpoint dell'API Marketing per la versione 21.0 e precedenti. Disponibile per gli account Instagram collegati a una Pagina.
`media_count` Pubblico	Numero totale di contenuti multimediali di Instagram pubblicati sull'account dell'utente della tua app.
`name`	Nome del profilo Instagram dell'utente della tua app.
`profile_picture_url`	URL dell'immagine del profilo Instagram dell'utente della tua app.
`collaborative_media_search`	Cerca un contenuto multimediale collaborativo specifico per ID. Accesso tramite l'espansione dei campi. Disponibile solo per l'API Instagram con Facebook Login.
`shopping_product_tag_eligibility`	Restituisce `true` se l'utente della tua app ha configurato uno Shop di Instagram ed è quindi idoneo per il tag del prodotto, altrimenti restituisce `false`.
`username` Pubblico	Nome utente del profilo Instagram dell'utente della tua app.
`website` Pubblico	URL del sito web dell'utente della tua app.

Segmenti

Segmento	Descrizione
`agencies`	Una lista di aziende che possono fare pubblicità per questo account Instagram per professionisti.
`authorized_adaccounts`	Account pubblicitari che possono fare pubblicità per questo account Instagram per professionisti.
`business_discovery`	Consente di ottenere dati su altri utenti Instagram creator o business di Instagram.
`connected_threads_user`	Rappresenta un account Threads collegato a un account Instagram.
`content_publishing_limit`	Rappresenta l'utilizzo attuale della pubblicazione dei contenuti di un utente Instagram.
`insights`	Rappresenta le metriche delle interazioni social su un utente di IG.
`instagram_backed_threads_user`	Rappresenta un account Threads basato su un account Instagram.
`live_media`	Rappresenta una raccolta di contenuti multimediali di Instagram di tipo video in diretta su un utente Instagram.
`media`	Rappresenta una raccolta di contenuti multimediali di Instagram su un utente Instagram.
`media_publish`	Pubblica un contenitore di Instagram su un utente Instagram business.
`mentions`	Crea un commento di Instagram su un commento di Instagram o contenuti multimediali di Instagram con didascalia in cui un utente Instagram è stato @menzionato da un altro utente Instagram.
`mentioned_comment`	Consente di ottenere dati su un commento di Instagram in cui un utente Instagram è stato @menzionato da un altro utente Instagram.
`mentioned_media`	Consente di ottenere dati su un contenuto multimediale di Instagram in cui un utente Instagram è stato @menzionato in una didascalia da un altro utente Instagram.
`recently_searched_hashtags`	Consente di ottenere gli hashtag di Instagram che un utente Instagram ha cercato negli ultimi 7 giorni.
`stories`	Rappresenta una raccolta di oggetti di tipo contenuto multimediale di Instagram in una storia su un utente Instagram.
`tags`	Rappresenta una raccolta di contenuti multimediali di IG in cui un utente di IG è stato taggato da un altro utente Instagram.
`upcoming_events`	Una lista di eventi che questo account Instagram per professionisti sta organizzando.
`collaboration_invites`	Rappresenta una raccolta di attributi dell'oggetto `IG Media` (media_id, media_owner_username, caption, media_url) per i quali l'utente di IG è stato invitato a collaborare.
`collaborative_media`	Rappresenta una raccolta di Contenuti multimediali di IG dei quali l'utente di IG è un collaboratore accettato. Non include i contenuti multimediali di proprietà dell'utente. Disponibile solo per l'API Instagram con Facebook Login.

Risposta

Un oggetto JSON contenente campi e segmenti predefiniti e obbligatori.

{
  "<FIELD>":"<VALUE>",
  ...
}

Esempio di cURL

Richiesta

curl -X GET \
  'https://graph.facebook.com/v25.0/17841405822304914?fields=biography%2Cid%2Cusername%2Cwebsite&access_token=EAACwX...'

Risposta

{
  "biography": "Dino data crunching app",
  "id": "17841405822304914",
  "username": "metricsaurus",
  "website": "http://www.metricsaurus.com/"
}

Aggiornamento

Questa operazione non è supportata.

Eliminazione

Questa operazione non è supportata.