Questo documento è stato aggiornato.
La traduzione in Italiano non è ancora completa.

Aggiornamento inglese: 14 giu 2021

Utente

Rappresenta un profilo utente di Instagram.

Gli ID utente per singola app (ASID) sono stati introdotti con la versione API 11.0. Puoi continuare a interrogare gli utenti in base ai loro ID utente raw o ai loro ASID equivalenti; tuttavia, le chiamate della versione 11.0 e successive riceveranno in risposta ASID.

Gli ASID sostituiranno gli ID utente raw tra circa due anni, quando la versione 10.0 sarà dichiarata obsoleta, quindi ti consigliamo di iniziare a mappare gli utenti dell'app ai loro ASID equivalenti.

Creazione

Questa operazione non è supportata.

Lettura

GET /{user-id}

Ottieni campi e segmenti di un utente.

Limitazioni

Gli ID utente dell'API Instagram Legacy non sono supportati.

Requisiti

Tipo	Requisito
Token d'accesso	Utente Instagram
Autorizzazioni	`instagram_graph_user_profile`. Il campo`media_count` ha bisogno anche di `instagram_graph_user_media`.

Sintassi della richiesta

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

Parametri del percorso

Placeholder	Valore
`{api-version}` Stringa	Versione API.
`{user-id}` Obbligatoria Stringa	ID utente per singola app dell'utente dell'app (versione 11.0 e successive) o ID utente raw (tutte le versioni).

Parametri della stringa della query

Includono i seguenti parametri della stringa della query per potenziare la richiesta.

Codice	Valore
`access_token` Stringa obbligatoria	Il token d'accesso dell'utente Instagram dell'utente dell'app.
`fields` Lista separata da virgole	Una lista separata da virgole di campi e segmenti che desideri vengano restituiti. Se omessa, vengono restituiti i campi predefiniti.

Campi

Puoi usare il parametro della stringa della query fields per richiedere i seguenti campi di un utente.

Nome del campo	Descrizione
`account_type`	Il tipo di account di un utente. Può essere `BUSINESS`, `MEDIA_CREATOR` o `PERSONAL`.
`id`	L'ID per singola app dell'utente dell'app (versione 11.0 e successive) o l'ID utente raw (versione 10.0 e precedenti).
`media_count`	Il numero di contenuti multimediali dell'utente. Questo campo ha bisogno dell'autorizzazione `instagram_graph_user_media`.
`username`	Il nome utente dell'utente.

Segmenti

Puoi richiedere i seguenti segmenti come parametri del percorso o utilizzando il parametro della stringa della query fields.

Segmento	Descrizione
`media`	Ottieni una lista di contenuti multimediali dell'utente.

Risposta

Un oggetto in formato JSON contenente campi e segmenti predefiniti e richiesti.

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

Esempio di cURL

Richiesta

curl -X GET \
  'https://graph.instagram.com/v19.0/10218560180051171?fields=id,username&access_token=IGQVJ...'

Risposta

{
  "id": "17841405793187218",
  "username": "jayposiris"
}

Aggiornamento

Questa operazione non è supportata.

Eliminazione

Questa operazione non è supportata.