LiveChatModerators: list

Elenca i moderatori di una chat live. La richiesta deve essere autorizzata dal proprietario del canale della chat live.

Casi d'uso comuni

Richiesta

Richiesta HTTP

GET https://www.googleapis.com/youtube/v3/liveChat/moderators

Parametri

La tabella seguente elenca i parametri supportati da questa query. Tutti i parametri elencati sono parametri di query.

Parametri
Parametri obbligatori
liveChatId string
Il parametro liveChatId specifica la chat live di YouTube per la quale l'API deve restituire i moderatori. L'ID della chat live associato a una trasmissione viene restituito nella proprietà snippet.liveChatId della risorsa liveBroadcast.
part string
Il parametro part specifica le parti della risorsa liveChatModerator che verranno incluse nella risposta dell'API. I valori supportati sono id e snippet.
Parametri facoltativi
maxResults unsigned integer
Il parametro maxResults specifica il numero massimo di elementi da restituire nel set di risultati. I valori accettabili sono compresi tra 0 e 50 inclusi. Il valore predefinito è 5.
pageToken string
Il parametro pageToken identifica una pagina specifica del set di risultati da restituire. In una risposta dell'API, le proprietà nextPageToken e prevPageToken identificano altre pagine che potrebbero essere recuperate.

Corpo della richiesta

Non fornire un corpo della richiesta quando chiami questo metodo.

Risposta

In caso di esito positivo, questo metodo restituisce un corpo della risposta con la seguente struttura:

{
  "kind": "youtube#liveChatModeratorListResponse",
  "etag": etag,
  "prevPageToken": string,
  "nextPageToken": string,
  "pageInfo": {
    "totalResults": integer,
    "resultsPerPage": integer
  },
  "items": [
    liveChatModerator Resource
  ]
}

Proprietà

La tabella seguente definisce le proprietà che appaiono in questa risorsa:

Proprietà
kind string
Identifica il tipo di risorsa API. Il valore sarà youtube#liveChatModeratorListResponse.
etag etag
L'ETag di questa risorsa.
prevPageToken string
Il token che può essere utilizzato come valore del parametro pageToken per recuperare la pagina precedente nel set di risultati.
nextPageToken string
Il token che può essere utilizzato come valore del parametro pageToken per recuperare la pagina successiva nel set di risultati.
pageInfo object
L'oggetto pageInfo incapsula le informazioni di paginazione per il set di risultati.
pageInfo.totalResults integer
Il numero totale di risultati nel set di risultati.
pageInfo.resultsPerPage integer
Il numero di risultati inclusi nella risposta dell'API.
items[] list
Un elenco di moderatori che corrispondono ai criteri della richiesta.

Errori

L'API non definisce messaggi di errore univoci per questo metodo API. Tuttavia, questo metodo potrebbe comunque restituire errori API generali elencati nella documentazione dei messaggi di errore.

Prova

Utilizza APIs Explorer per chiamare questa API e visualizzare la richiesta API e la risposta.