Activities: list

YouTube hat die Funktion „Kanal-Bulletin“ eingestellt. Die activities.list Methode gibt keine Kanal-Bulletins mehr zurück und die activities.insert Methode wird ni cht länger unterstützt. Weitere Informationen finden Sie in der YouTube-Hilfe.

Gibt eine Liste von Kanalaktivitätsereignissen zurück, die den Kriterien der Anfrage entsprechen. Sie können beispielsweise Ereignisse abrufen, die mit einem bestimmten Kanal oder mit dem eigenen Kanal des Nutzers verknüpft sind.

Auswirkungen auf das Kontingent:Ein Aufruf dieser Methode kostet 1 Kontingenteinheit.

Gängige Anwendungsfälle

Anfrage

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
Der Parameter part gibt eine durch Kommas getrennte Liste mit einer oder mehreren Eigenschaften der Ressource activity an, die in der API-Antwort enthalten sein sollen.

Wenn der Parameter eine Eigenschaft identifiziert, die untergeordnete Eigenschaften enthält, werden diese untergeordneten Eigenschaften in die Antwort aufgenommen. In einer activity-Ressource enthält die Eigenschaft snippet beispielsweise andere Eigenschaften, die den Aktivitätstyp, einen Anzeigetitel für die Aktivität usw. identifizieren. Wenn Sie part=snippet festlegen, enthält die API-Antwort auch alle diese verschachtelten Eigenschaften.

Die folgende Liste enthält die part Namen, die Sie in den Parameterwert aufnehmen können:
  • contentDetails
  • id
  • snippet
Filter (genau einen der folgenden Parameter angeben)
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, bei denen dieser Parameter festgelegt ist, enthält die API-Antwort Elemente, die denen ähneln, die ein nicht angemeldeter Nutzer auf der YouTube-Startseite sieht. Dieser Parameter kann nur in einer ordnungsgemäß autorisierten Anfrage verwendet werden.
mine boolean
Dieser Parameter kann nur in einer ordnungsgemäß autorisierten Anfrage verwendet werden. Setzen Sie den Wert dieses Parameters auf true, um einen Feed der Aktivitäten des authentifizierten Nutzers abzurufen.
Optionale Parameter
maxResults unsigned integer
Der Parameter maxResults gibt die maximale Anzahl der Elemente an, die im Ergebnissatz 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 im Ergebnissatz an, die zurückgegeben werden soll. In einer API-Antwort identifizieren die Eigenschaften nextPageToken und prevPageToken andere Seiten, die abgerufen werden können.
publishedAfter datetime
Der Parameter publishedAfter gibt das früheste Datum und die früheste Uhrzeit an, zu der eine Aktivität stattgefunden haben kann, damit sie in die API-Antwort aufgenommen wird. Wenn der Parameterwert einen Tag, aber keine Uhrzeit angibt, werden alle Aktivitäten, die an diesem Tag stattgefunden haben, in den Ergebnissatz aufgenommen. Der Wert wird im ISO 8601-Format (YYYY-MM-DDThh:mm:ss.sZ) angegeben.
publishedBefore datetime
Der Parameter publishedBefore gibt das Datum und die Uhrzeit an, vor denen eine Aktivität stattgefunden haben muss, damit sie in die API-Antwort aufgenommen wird. Wenn der Parameterwert einen Tag, aber keine Uhrzeit angibt, werden alle Aktivitäten, die an diesem Tag stattgefunden haben, aus dem Ergebnissatz ausgeschlossen. Der Wert wird im ISO 8601-Format (YYYY-MM-DDThh:mm:ss.sZ) angegeben.
regionCode string
Der Parameter regionCode weist die API an, 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 bisherige Aktivität des autorisierten Nutzers auf YouTube nicht genügend Informationen liefert, um den Aktivitätsfeed zu generieren.

Anfragetext

Geben Sie beim Aufruf 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 sind die Attribute definiert, die in dieser Ressource enthalten sind:

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 im Ergebnissatz abzurufen.
prevPageToken string
Das Token, das als Wert des Parameters pageToken verwendet werden kann, um die vorherige Seite im Ergebnissatz abzurufen.
pageInfo object
Das Objekt pageInfo enthält Paging-Informationen 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 von Aktivitäten oder Ereignissen, die den Kriterien der Anfrage entsprechen.

Fehler

In der folgenden Tabelle sind die Fehlermeldungen aufgeführt, die die API als Antwort auf einen Aufruf dieser Methode zurückgeben kann. 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 der Startseite des Nutzers sind über diese API nicht verfügbar. Dieser Fehler kann auftreten, wenn Sie den Parameter home in einer nicht autorisierten Anfrage auf true setzen.
notFound (404) channelNotFound Die Kanal-ID, die durch den Parameter channelId der Anfrage identifiziert wird, wurde nicht gefunden.
notFound (404) homeChannelNotFound Für den aktuell authentifizierten Nutzer wurde kein YouTube-Startseitenfeed gefunden.
unauthorized (401) authorizationRequired Die Anfrage verwendet den Parameter home, ist aber nicht ordnungsgemäß autorisiert.

Testen!

Mit dem APIs Explorer können Sie diese API aufrufen und die API-Anfrage und -Antwort ansehen.