Questa pagina è stata tradotta dall'API Cloud Translation.

Implementazione: abbonamenti

I seguenti esempi mostrano come utilizzare la YouTube Data API (v3) per eseguire funzioni correlate alle iscrizioni.

Recuperare le iscrizioni a un canale

Chiama il metodo subscriptions.list per recuperare le iscrizioni per un determinato canale. Esistono due modi per identificare il canale:

Per recuperare le sottoscrizioni dell'utente attualmente autenticato, imposta il valore del parametro mine su true. Tieni presente che una richiesta che utilizza il parametro mine deve essere autorizzata utilizzando OAuth 2.0.
```
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.subscriptions.list?
        part=snippet,contentDetails
        &mine=true
```
Per recuperare le iscrizioni di qualsiasi altro canale, imposta il valore del parametro channelId sull'ID canale YouTube univoco di quel canale. L'esempio riportato di seguito recupera un elenco dei canali a cui è iscritto il canale TED su YouTube.
```
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.subscriptions.list?
        part=snippet,contentDetails
        &channelId=UCAuUUnT6oDeKwE6v1NGQxug
```
Nota: l'API restituisce un codice di risposta HTTP 403 (Forbidden) se il canale specificato non espone pubblicamente le sue iscrizioni e la richiesta non è autorizzata dal proprietario del canale.

Per un esempio dei codici, consulta la documentazione del metodo subscriptions.list.

Aggiungi una sottoscrizione

Chiama il metodo subscriptions.insert per aggiungere un abbonamento al canale. Questa richiesta deve essere autorizzata utilizzando OAuth 2.0. Il corpo della richiesta è una risorsa subscription che imposta i seguenti valori:

snippet.resourceId.kind contiene il valore youtube#channel.
La proprietà snippet.resourceId.channelId identifica il canale a cui è iscritto. Il valore della proprietà è un ID canale YouTube univoco. L'ID canale può essere ottenuto in diversi modi, ad esempio chiamando il metodo channels.list o recuperando i risultati di ricerca per i canali.

La seguente richiesta API ti iscrive al canale TED su YouTube:

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.subscriptions.insert?
        part=snippet

Il corpo della richiesta è:

{
  "snippet": {
    "resourceId": {
      "kind": "youtube#channel",
      "videoId": "UCAuUUnT6oDeKwE6v1NGQxug"
    }
  }
}

Per un esempio dei codici, consulta la documentazione del metodo subscriptions.insert.

Eliminare un abbonamento

Questo esempio elimina una sottoscrizione. Questa richiesta deve essere autorizzata utilizzando OAuth 2.0. Questo esempio prevede due passaggi:

Passaggio 1: recupera le iscrizioni per il canale dell'utente autenticato

Chiama il metodo subscriptions.list per recuperare l'elenco degli abbonamenti. L'esempio precedente per il recupero delle iscrizioni di un canale spiega come presentare questa richiesta.

L'applicazione che chiama l'API potrebbe elaborare la risposta dell'API per visualizzare un elenco degli abbonamenti, utilizzando l'ID di ogni abbonamento come chiave. Nella risposta, la proprietà id di ogni elemento identifica l'ID abbonamento che identifica in modo univoco l'abbonamento corrispondente. Questo valore verrà utilizzato per rimuovere un elemento dall'elenco nel passaggio successivo.
Passaggio 2: elimina un abbonamento

Chiama il metodo subscriptions.delete per eliminare un abbonamento. Imposta il parametro id della richiesta sull'ID dell'abbonamento che vuoi rimuovere. Questa richiesta deve essere autorizzata utilizzando OAuth 2.0.

Per completare la richiesta in Explorer API, devi impostare il valore della proprietà id.
```
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.subscriptions.delete?
        id=SUBSCRIPTION_ID
```

Per un esempio dei codici, consulta la documentazione del metodo subscriptions.delete.

Recuperare un elenco di iscritti al canale dell'utente autorizzato

Per recuperare un elenco dei canali che si iscrivono al canale dell'utente attualmente autenticato, chiama il metodo subscriptions.list e imposta il valore del parametro mySubscribers su true. La richiesta deve essere autorizzata utilizzando OAuth 2.0.

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.subscriptions.list?
        part=snippet,contentDetails
        &mySubscribers=true