Questa pagina è stata tradotta dall'API Cloud Translation.

Implementazione: abbonamenti

Gli esempi seguenti mostrano come utilizzare l'API YouTube Data (v3) per eseguire funzioni relative agli abbonamenti.

Recuperare le iscrizioni di un canale

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

Per recuperare gli abbonamenti 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 del canale in questione. 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 iscrizioni e la richiesta non è autorizzata dal proprietario del canale.

Per esempi di codice, consulta la documentazione del metodo subscriptions.list.

aggiungi una sottoscrizione

Chiama il metodo subscriptions.insert per aggiungere un abbonamento a un 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 si sta effettuando l'iscrizione. 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 richiesta API riportata di seguito 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 esempi di codice, 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 gli abbonamenti del canale dell'utente autenticato

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

L'applicazione che chiama l'API potrebbe elaborare la risposta dell'API per visualizzare un elenco di 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. Utilizzerai questo valore 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 abbonamento dell'abbonamento che vuoi rimuovere. Questa richiesta deve essere autorizzata utilizzando OAuth 2.0.

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

Per esempi di codice, 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 sono iscritti 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