Activities: list

YouTube hat die Funktion für Kanalbulletins eingestellt. Die Methode 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:
  • contentDetails
  • id
  • snippet
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.