activities.list
gibt noch keine Kanalbulletins zurück und die Methode activities.insert
wird nicht mehr unterstützt. Weitere Informationen findest du in der YouTube-Hilfe.
Gibt eine Liste der Kanalaktivitätsereignisse zurück, die den Anfragekriterien entsprechen. So können Sie beispielsweise Ereignisse abrufen, die mit einem bestimmten Kanal oder mit dem eigenen Kanal des Nutzers verknüpft sind.
Kontingentauswirkung: Ein Aufruf dieser Methode hat Kontingentkosten von 1 Einheit.
Gängige Anwendungsfälle
Anfragen
HTTP-Anfrage
GET https://www.googleapis.com/youtube/v3/activities
Parameter
In der folgenden Tabelle sind die Parameter aufgeführt, die von dieser Abfrage unterstützt werden. Alle aufgeführten Parameter sind Abfrageparameter.
Parameter | ||
---|---|---|
Erforderliche Parameter | ||
part |
string Mit dem Parameter part wird eine durch Kommas getrennte Liste mit einem oder mehreren activity -Ressourcenattributen angegeben, die in der API-Antwort enthalten sein werden.Bezeichnet der Parameter eine Property, die untergeordnete Properties enthält, werden die untergeordneten Attribute in die Antwort aufgenommen. Beispielsweise enthält die snippet -Eigenschaft in einer activity -Ressource andere Eigenschaften, die die Art der Aktivität angeben, einen Anzeigetitel für die Aktivität usw. Wenn Sie part=snippet festlegen, enthält die API-Antwort auch alle diese verschachtelten Properties.Die folgende Liste enthält die part -Namen, die Sie in den Parameterwert aufnehmen können:
|
|
Filter (geben Sie genau einen der folgenden Parameter an) | ||
channelId |
string Der Parameter channelId gibt eine eindeutige YouTube-Kanal-ID an. Die API gibt dann eine Liste der Aktivitäten dieses Kanals zurück. |
|
home |
boolean Hinweis:Dieser Parameter wurde eingestellt. Bei Anfragen mit diesem Parameter enthält die API-Antwort ähnliche Elemente wie die auf der YouTube-Startseite eines abgemeldeten Nutzers. Dieser Parameter kann nur in einer ordnungsgemäß autorisierten Anfrage verwendet werden. |
|
mine |
boolean Dieser Parameter kann nur in einer ordnungsgemäß autorisierten Anfrage verwendet werden. Legen Sie den Wert dieses Parameters auf true fest, um einen Feed mit den Aktivitäten des authentifizierten Nutzers abzurufen. |
|
Optionale Parameter | ||
maxResults |
unsigned integer Der Parameter maxResults gibt die maximale Anzahl von Elementen an, die in der Ergebnismenge zurückgegeben werden sollen. Zulässige Werte sind 0 bis 50 (einschließlich). Der Standardwert ist 5 . |
|
pageToken |
string Der pageToken -Parameter gibt eine bestimmte Seite in der Ergebnismenge an, die zurückgegeben werden soll. In einer API-Antwort identifizieren die Attribute nextPageToken und prevPageToken andere Seiten, die abgerufen werden könnten. |
|
publishedAfter |
datetime Der Parameter publishedAfter gibt das Datum und die Uhrzeit an, zu dem bzw. der frühestens eine Aktivität hätte auftreten können, um in die API-Antwort aufgenommen zu werden. Gibt der Parameterwert einen Tag, aber keine Uhrzeit an, werden alle Aktivitäten, die an diesem Tag stattgefunden haben, in die Ergebnismenge einbezogen. Der Wert wird im Format ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ ) angegeben. |
|
publishedBefore |
datetime Der Parameter publishedBefore gibt Datum und Uhrzeit an, vor denen eine Aktivität stattgefunden haben muss, damit diese Aktivität in die API-Antwort aufgenommen wird. Gibt der Parameterwert einen Tag, aber keine Uhrzeit an, werden alle Aktivitäten, die an diesem Tag stattgefunden haben, aus der Ergebnismenge ausgeschlossen. Der Wert wird im Format ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ ) angegeben. |
|
regionCode |
string Mit dem Parameter regionCode wird die API angewiesen, Ergebnisse für das angegebene Land zurückzugeben. Der Parameterwert ist ein ISO 3166-1 alpha-2-Ländercode. YouTube verwendet diesen Wert, wenn die bisherigen Aktivitäten des autorisierten Nutzers auf YouTube nicht genügend Informationen zum Generieren des Aktivitätsfeeds liefern. |
Anfragetext
Geben Sie beim Aufrufen dieser Methode keinen Anfragetext an.
Antwort
Bei Erfolg gibt diese Methode einen Antworttext mit der folgenden Struktur zurück:
{ "kind": "youtube#activityListResponse", "etag": etag, "nextPageToken": string, "prevPageToken": string, "pageInfo": { "totalResults": integer, "resultsPerPage": integer }, "items": [ activity Resource ] }
Attribute
In der folgenden Tabelle werden die Attribute definiert, die in dieser Ressource angezeigt werden:
Attribute | |
---|---|
kind |
string Identifiziert den Typ der API-Ressource. Der Wert ist youtube#activityListResponse . |
etag |
etag Das ETag dieser Ressource. |
nextPageToken |
string Das Token, das als Wert des Parameters pageToken verwendet werden kann, um die nächste Seite in der Ergebnismenge abzurufen. |
prevPageToken |
string Das Token, das als Wert des Parameters pageToken verwendet werden kann, um die vorherige Seite in der Ergebnismenge abzurufen. |
pageInfo |
object Das Objekt pageInfo enthält Seiteninformationen für den Ergebnissatz. |
pageInfo.totalResults |
integer Die Gesamtzahl der Ergebnisse im Ergebnissatz. |
pageInfo.resultsPerPage |
integer Die Anzahl der Ergebnisse, die in der API-Antwort enthalten sind. |
items[] |
list Eine Liste der Aktivitäten oder Ereignisse, die den Anfragekriterien entsprechen. |
Fehler
In der folgenden Tabelle finden Sie Fehlermeldungen, die die API als Antwort auf einen Aufruf dieser Methode zurückgeben könnte. Weitere Informationen finden Sie in der Dokumentation zu Fehlermeldungen.
Fehlertyp | Fehlerdetails | Beschreibung |
---|---|---|
forbidden (403) |
forbidden |
Die Anfrage ist nicht ordnungsgemäß autorisiert. |
forbidden (403) |
homeParameterDeprecated |
Die Aktivitätsdaten des Nutzers auf der Startseite sind über diese API nicht verfügbar. Dieser Fehler kann auftreten, wenn Sie den Parameter home in einer nicht autorisierten Anfrage auf true gesetzt haben. |
notFound (404) |
channelNotFound |
Die durch den Parameter channelId der Anfrage identifizierte Kanal-ID wurde nicht gefunden. |
notFound (404) |
homeChannelNotFound |
Für den derzeit authentifizierten Nutzer wurde kein Feed auf der YouTube-Startseite gefunden. |
unauthorized (401) |
authorizationRequired |
Die Anfrage verwendet den Parameter home , ist aber nicht korrekt autorisiert. |
Jetzt testen
Verwenden Sie APIs Explorer, um diese API aufzurufen und die API-Anfrage und -Antwort anzusehen.