Anleitung zum Erstellen und Verwenden eines YouTube-API-Schlüssels

Eine Schritt-für-Schritt-Anleitung zum Erstellen eines Google Cloud-Projekts und eines YouTube-API-Schlüssels, die für Feed-Typen wie „Playlist“ und „Search“ erforderlich sind.

Möchten Sie den YouTube-API-Schlüssel einrichten, den YouTube Feed benötigt, um Ihre Feeds auf dem neuesten Stand zu halten?

In dieser Anleitung führen wir Sie Schritt für Schritt durch die Erstellung eines Google Cloud-Projekts und die Aktivierung der YouTube Data API v3. Anschließend erstellen wir den Schlüssel und fügen ihn dem Plugin hinzu. Außerdem erklären wir Ihnen, wie das tägliche Kontingent von Google funktioniert.

Bevor Sie loslegen, stellen Sie bitte sicher, dass „YouTube Feed“ auf Ihrer Website installiert und aktiviert ist und dass Sie über ein Google-Konto verfügen.

Das sind die Themen, die wir behandeln werden:

Hinweis: Die folgenden Schritte für Google Cloud entsprechen dem Erscheinungsbild der Google-Konsole zum Zeitpunkt der Erstveröffentlichung dieser Anleitung. Google passt das Erscheinungsbild seiner Oberflächen von Zeit zu Zeit an. Es kann daher vorkommen, dass sich die Position einer Schaltfläche geringfügig ändert. Die einzelnen Schritte bleiben jedoch unverändert.

Ein Google Cloud-Projekt und einen API-Schlüssel erstellen

Zunächst richten wir ein Projekt in der Entwicklerkonsole von Google ein.

Für die Feeds „Playlist“, „Suche“, „Shorts“, „Live-Streams“ und „Einzelvideos“ benötigen Sie einen eigenen YouTube-API-Schlüssel. Für einen Kanal-Feed kann stattdessen ein verbundenes YouTube-Konto verwendet werden. Ein API-Schlüssel ist die bessere Wahl (siehe die FAQ am Ende).

Hinweis: Wenn Sie bereits einen API-Schlüssel erstellt haben ...

Sie müssen über diese URL ein neues Projekt erstellen: https://console.developers.google.com/projectcreate. Anschließend können Sie mit Schritt 3 fortfahren.

Das von Ihnen erstellte neue Projekt muss in der Dropdown-Liste oben auf der Seite ausgewählt sein.

Der Google Cloud-Projekt-Selektor ist geöffnet, wobei das neu erstellte Projekt in der Liste der zuletzt verwendeten Projekte markiert ist.

1) Rufen Sie die Seite console.developers.google.com/apis auf. Wenn Sie die Google-API-Website zum ersten Mal nutzen, werden Sie aufgefordert, den Nutzungsbedingungen zuzustimmen.

Das Google Cloud-Begrüßungsfenster mit dem Kontrollkästchen für die Nutzungsbedingungen und der Schaltfläche „Zustimmen und fortfahren“

2) Erstellen Sie ein Projekt, indem Sie auf die Schaltfläche „PROJEKT ERSTELLEN“ klicken.

Die Seite „Google Cloud-APIs und -Dienste“ mit der Schaltfläche „Projekt erstellen“

3) Nachdem Sie Ihrem Projekt einen Namen gegeben haben, klicken Sie auf die Schaltfläche „ERSTELLEN “.

Das Formular „Neues Projekt“ in Google Cloud mit einem eingegebenen Projektnamen und der Schaltfläche „Erstellen“

4) Aktivieren Sie als Nächstes die YouTube Data API v3 für Ihr Projekt. Öffnen Sie dazu die Seite „YouTube Data API v3 “ und klicken Sie auf „AKTIVIEREN“. Ohne diesen Schritt lehnt YouTube den Schlüssel ab.

Die Produktseite zur YouTube Data API v3 in Google Cloud mit der Schaltfläche „Aktivieren“

5) Rufen Sie die Seite „Anmeldedaten“ auf und klicken Sie auf „ANMELDEDATEN ERSTELLEN“. Dieses Plugin benötigt einen API-Schlüssel. Wählen Sie als Nächstes diese Option aus.

Das Menü „Anmeldedaten erstellen“ auf der Seite „Google Cloud-Anmeldedaten“, wobei der API-Schlüssel hervorgehoben ist

6) Kopieren Sie den Schlüssel aus dem Popup-Fenster. Sie benötigen ihn im nächsten Abschnitt.

Das Fenster „API-Schlüssel erstellt“ in Google Cloud, wobei der Schlüssel unkenntlich gemacht wurde

Da Sie nun Ihren Schlüssel haben, können Sie ihn zu YouTube Feed hinzufügen.

Hinzufügen des API-Schlüssels zum YouTube-Feed

Sobald Sie von Google einen Schlüssel erhalten haben, fügen Sie diesen auf der Einstellungsseite des Plugins hinzu.

7) Gehen Sie in der WordPress-Admin-Seitenleiste zu „YouTube Feed“ » „Einstellungen“. Öffnen Sie dann die Registerkarte „Allgemein “. Fügen Sie anschließend den Schlüssel in das Feld „API-Schlüssel “ ein. Klicken Sie dann auf „Hinzufügen“.

Die Seite „YouTube-Feed-Einstellungen“, Registerkarte „Allgemein“, mit einem Pfeil auf der Schaltfläche „Hinzufügen“ neben dem Feld „API-Schlüssel“

Das Plugin überprüft den Schlüssel bei YouTube und speichert ihn. Wenn YouTube den Schlüssel akzeptiert, wird im Feld ein grünes Häkchen angezeigt. Falls YouTube den Schlüssel nicht akzeptiert, wird im Feld ein Fehlersymbol sowie eine Meldung mit einem Link zurück zu dieser Anleitung angezeigt.

Hinweis: Es kann bis zu 15 Minuten dauern, bis ein neuer Schlüssel aktiv wird. Sollte ein Feed danach immer noch eine Fehlermeldung bezüglich Ihres Schlüssels anzeigen, finden Sie in unserer Übersicht zu Fehlermeldungen Erläuterungen zu den einzelnen Meldungen.

Sobald ein Schlüssel gespeichert wurde, erscheint auf derselben Schaltfläche die Aufschrift „Aktualisieren“. Um einen Schlüssel zu ersetzen, fügen Sie den neuen über den alten ein. Klicken Sie anschließend auf „Aktualisieren“.

Das Feld „API-Schlüssel“ mit einem gespeicherten Schlüssel (unscharf dargestellt) und einem Pfeil auf die Schaltfläche „Aktualisieren“

Hinzufügen des Schlüssels beim Erstellen eines Feeds

Sie können den Schlüssel auch beim Erstellen eines Feeds hinzufügen. Wenn kein Schlüssel gespeichert ist, öffnet der Feed-Generator für jeden Feed-Typ – mit Ausnahme von „Channel“ und „Social Wall“ – ein Fenster mit der Meld ung „API-Schlüssel erforderlich “. Bei einem „Channel“-Feed öffnet sich dasselbe Fenster auch dann, wenn kein Konto verbunden ist.

Bei einem Kanal-Feed werden im Fenster zunächst ein API-Schlüssel oder ein verknüpftes YouTube-Konto angeboten. Der API-Schlüssel ist die bessere Wahl. Ein verknüpftes Konto zeigt auch private, unveröffentlichte und als Entwurf gespeicherte Videos an und lässt möglicherweise keine Likes und Kommentare zu. Wenn das Fenster diese Optionen anzeigt, klicken Sie auf „API-Schlüssel hinzufügen“ (empfohlen).

Das Fenster „API-Schlüssel erforderlich“ im Feed-Builder mit einem Pfeil auf der Schaltfläche „API-Schlüssel hinzufügen (empfohlen)“

Fügen Sie anschließend Ihren Schlüssel in das Feld ein. Klicken Sie dann auf „Hinzufügen“. Das Plugin speichert den Schlüssel. Anschließend können Sie mit der Erstellung Ihres Feeds fortfahren.

Das Fenster „API-Schlüssel erforderlich“ mit dem Feld für den Schlüssel und einem Pfeil auf der Schaltfläche „Hinzufügen“

Ihr Schlüssel ist nun gespeichert. Als Nächstes erfahren Sie, wie sich das tägliche Kontingent von Google darauf auswirkt.

Wie funktioniert die Tagesquote?

Google weist jedem Google Cloud-Projekt ein tägliches Kontingent an Anfragen zu. Jede Anfrage, die YouTube Feed unter Verwendung Ihres Schlüssels an YouTube sendet, verbraucht einen Teil dieses Kontingents. Alle Websites und Apps, die einen Schlüssel aus diesem Projekt verwenden, teilen sich dieses Kontingent.

Wenn das Kontingent aufgebraucht ist, werden Feeds, die diesen Schlüssel verwenden, nicht mehr aktualisiert, bis das Kontingent zurückgesetzt wird. Google setzt die täglichen Kontingente um Mitternacht (Pacific Time) zurück. Auf der Kontingentseite von Google sind das aktuelle Kontingent sowie die Kosten für die einzelnen Anfragetypen aufgeführt.

YouTube Feed speichert jeden Feed in seinem Cache. Bei den meisten Seitenaufrufen wird YouTube gar nicht aufgerufen. Eine längere Cache-Dauer bedeutet weniger Anfragen. In unserer Übersicht zu Fehlermeldungen wird erläutert, wie man diese verlängern kann. Dort wird auch gezeigt, wie die Meldung zum täglichen Limit aussieht.

Wenn Sie ein verbundenes Konto entfernt haben und ein Feed dennoch weiterhin hängen geblieben zu sein scheint, erfahren Sie im nächsten Abschnitt, wie Sie das Problem beheben können.

Behebung eines Feed-Störungszustands nach einer Kontoänderung

YouTube Feed aktualisiert Feeds im Hintergrund anhand der Einstellungen, die im Cache des jeweiligen Feeds gespeichert wurden. Ein Feed kann zwischengespeichert werden, während ein verbundenes YouTube-Konto genutzt wird. Wird dieses Konto später entfernt, können diese gespeicherten Einstellungen dazu führen, dass der Feed leer bleibt oder weiterhin alte Videos anzeigt. Dies kann auch dann noch der Fall sein, wenn Sie einen gültigen Schlüssel hinzufügen.

Gehen Sie anschließend zu „YouTube-Feed“ » „Einstellungen“. Öffnen Sie dann die Registerkarte „Feeds “. Klicken Sie abschließend auf „Alle Caches löschen“. Jeder Feed wird daraufhin anhand der aktuellen Einstellungen neu erstellt. Die nächste Hintergrundaktualisierung wird wie gewohnt gespeichert.

Das Kontrollkästchen „Caching“ auf der Registerkarte „Feeds“ mit einem Pfeil auf der Schaltfläche „Alle Caches löschen“

Das war’s! Sie haben nun einen YouTube-API-Schlüssel in YouTube Feed gespeichert.

Lesen Sie als Nächstes unsere Übersicht zu Fehlermeldungen im YouTube-Feed, falls in einem Feed anstelle Ihrer Videos eine Meldung angezeigt wird.

Häufig gestellte Fragen

Im Folgenden haben wir einige der häufigsten Fragen zu YouTube-API-Schlüsseln beantwortet.

Hinweis: Wenn Sie den API-Schlüssel einschränken möchten ...

Um Ihren Google-API-Schlüssel einzuschränken, nutzen Sie die Website-Einschränkung. YouTube Feed übermittelt bei jeder Anfrage die Adresse Ihrer Website, weshalb diese Einschränkung funktioniert. Fügen Sie in das Feld nacheinander diese beiden Einträge hinzu.

  • Die URL Ihrer Website einschließlich des Präfixes, zum Beispiel https://example.com
  • www.googleapis.com

Sie können auch eine API-Einschränkung festlegen. Wählen Sie in diesem Fall die YouTube Data API v3 aus.

Wo kann ich meinen API-Schlüssel hinzufügen oder ersetzen?

Um einen Schlüssel hinzuzufügen, gehen Sie zu „YouTube-Feed“ » „Einstellungen“ » „Allgemein“. Fügen Sie dann den Schlüssel in das Feld „API-Schlüssel“ ein und klicken Sie auf „Hinzufügen“ oder, falls bereits ein Schlüssel gespeichert ist, auf „Aktualisieren “. Der Feed-Builder fordert Sie ebenfalls zur Eingabe eines Schlüssels auf, wenn Sie einen Feed erstellen, für den ein Schlüssel erforderlich ist.

Benötige ich für jeden Feed-Typ einen API-Schlüssel?

Der Feed-Builder fordert für jeden Feed-Typ mit Ausnahme von „Channel“ und „Social Wall“ einen Schlüssel an. Ein „Channel“-Feed kann entweder über ein verbundenes YouTube-Konto oder über einen Schlüssel ausgeführt werden.

Warum sollte ich einen Schlüssel verwenden, anstatt ein YouTube-Konto zu verknüpfen?

Durch die Verknüpfung eines YouTube-Kontos werden auch private, unveröffentlichte und als Entwurf gespeicherte Videos angezeigt. Möglicherweise ist der Zugriff auf Funktionen wie das Anzeigen von Likes und Kommentaren nicht möglich. Das Plugin empfiehlt die Verwendung eines Schlüssels, um beides zu vermeiden.

Fallen für die Erstellung eines API-Schlüssels Kosten an?

Im Fenster „API-Schlüssel erforderlich“ des Plugins heißt es, dass die Erstellung eines Schlüssels kostenlos ist und nur wenige Minuten dauert. Google legt die Kontingente und etwaige Beschränkungen auf seiner Seite fest. Die aktuellen Bedingungen finden Sie auf der Kontingent-Seite von Google.

Unterstützung

Konnten Sie die Antwort nicht in den Dokumenten finden?

Kontakt zum Support