Dokumente    YouTube    Erste Schritte

Anleitung zum Erstellen einer benutzerdefinierten Suche

Sie können eine vollständig benutzerdefinierte Suchabfrage erstellen, indem Sie das Eingabefeld für die benutzerdefinierte Suche und die unten aufgeführten Parameter verwenden.

So formatieren Sie eine benutzerdefinierte Suche
Beginnen Sie für jeden hinzugefügten Parameter mit einem Und-Zeichen "&", dann den Parameterschlüssel (z. B. "order"), dann ein Gleichheitszeichen "=" und dann einen akzeptierten Wert (z. B. "date"). Fügen Sie keine URL-Kodierung hinzu, da das Plugin die endgültige Suchanfrage richtig kodiert.

Beispiele
&q=Funny Cat Videos&order=viewCount
&channelId=UClwg08ECyHnm_RzY1wnZC1A&publishedAfter=2019-06-30T00:00:00Z&publishedBefore=2020-01-30T00:00:00Z
&q=Gooseberry Falls&videoDuration=short

Parameter Taste Akzeptierte Werte
relatedToVideoId string
Die relatedToVideoId ruft eine Liste von Videos ab, die mit dem Video, das der Parameterwert identifiziert, in Beziehung stehen. Der Parameterwert muss auf eine YouTube-Video-ID gesetzt werden.Anmerkung: Wenn der Parameter relatedToVideoId gesetzt ist, sind die einzigen anderen unterstützten Parameter regionCode, relevanceLanguage, safeSearchund fields.
channelId string
Die channelId gibt an, dass die API-Antwort nur vom Kanal erstellte Ressourcen enthalten soll.
eventType string
Die eventType schränkt die Suche auf Broadcast-Ereignisse ein.
Akzeptable Werte sind:

  • completed - Nur abgeschlossene Sendungen einbeziehen.
  • live - Nur aktive Sendungen einbeziehen.
  • upcoming - Nur kommende Sendungen einbeziehen.
location string
Die location in Verbindung mit dem Parameter locationRadius definiert einen kreisförmigen geografischen Bereich und schränkt die Suche auf Videos ein, die in ihren Metadaten einen geografischen Standort angeben, der in diesen Bereich fällt. Der Parameterwert ist eine Zeichenkette, die die Koordinaten von Breiten- und Längengrad angibt, z. B. (37.42307,-122.08427).

  • Die location Der Parameterwert identifiziert den Punkt in der Mitte des Bereichs.
  • Die locationRadius gibt die maximale Entfernung an, die der mit einem Video verknüpfte Ort von diesem Punkt entfernt sein darf, damit das Video noch in den Suchergebnissen enthalten ist.

Die API gibt einen Fehler zurück, wenn Ihre Anfrage einen Wert für die Option location aber nicht auch einen Wert für den Parameter locationRadius Parameter.
locationRadius string
Die locationRadius in Verbindung mit dem Parameter location Der Parameterwert muss eine Fließkommazahl sein, gefolgt von einer Maßeinheit. Gültige Maßeinheiten sind m, km, ftund mi. Gültige Parameterwerte sind zum Beispiel 1500m, 5km, 10000ftund 0.75mi. Die API unterstützt nicht locationRadius Parameterwerte größer als 1000 Kilometer.Anmerkung: Siehe die Definition des location Parameter für weitere Informationen.
order string
Die order gibt die Methode an, die zum Ordnen von Ressourcen in der API-Antwort verwendet werden soll. Der Standardwert ist relevanceAkzeptable Werte sind:

  • date - Die Ressourcen sind in umgekehrter chronologischer Reihenfolge nach dem Datum ihrer Erstellung sortiert.
  • rating - Die Ressourcen sind von der höchsten zur niedrigsten Bewertung sortiert.
  • relevance - Die Ressourcen werden auf der Grundlage ihrer Relevanz für die Suchanfrage sortiert. Dies ist der Standardwert für diesen Parameter.
  • title - Die Ressourcen sind alphabetisch nach Titel sortiert.
  • viewCount - Die Ressourcen werden von der höchsten bis zur niedrigsten Anzahl der Aufrufe sortiert. Bei Live-Übertragungen werden die Videos nach der Anzahl der gleichzeitigen Betrachter sortiert, während die Übertragungen laufen.
publishedAfter datetime
Die publishedAfter gibt an, dass die API-Antwort nur Ressourcen enthalten soll, die zum oder nach dem angegebenen Zeitpunkt erstellt wurden. Der Wert ist ein nach RFC 3339 formatierter Datum-Zeit-Wert (1970-01-01T00:00:00Z).
publishedBefore datetime
Die publishedBefore gibt an, dass die API-Antwort nur Ressourcen enthalten soll, die vor oder zu dem angegebenen Zeitpunkt erstellt wurden. Der Wert ist ein nach RFC 3339 formatierter Datum-Zeit-Wert (1970-01-01T00:00:00Z).
q string
Die q Parameter gibt den Suchbegriff an, nach dem gesucht werden soll, und die Anfrage kann auch den booleschen NOT (-) und OR (|), um Videos auszuschließen oder um Videos zu finden, die mit einem von mehreren Suchbegriffen verbunden sind. Um zum Beispiel nach Videos zu suchen, die entweder "Bootfahren" oder "Segeln" enthalten, setzen Sie den q Parameterwert auf boating|sailing. Um nach Videos zu suchen, die entweder "Bootfahren" oder "Segeln", aber nicht "Angeln" enthalten, setzen Sie die q Parameterwert auf boating|sailing -fishing.
regionCode string
Die regionCode weist die API an, Suchergebnisse für Videos zurückzugeben, die in dem angegebenen Land angesehen werden können. Der Parameterwert ist ein ISO 3166-1 alpha-2 Landesvorwahl.
relevanceLanguage string
Die relevanceLanguage weist die API an, Suchergebnisse zurückzugeben, die für die angegebene Sprache am relevantesten sind. Der Parameterwert ist normalerweise ein ISO 639-1 Zweibuchstaben-Sprachcode. Sie sollten jedoch die Werte verwenden zh-Hans für vereinfachtes Chinesisch und zh-Hant für traditionelles Chinesisch. Bitte beachten Sie, dass auch Ergebnisse in anderen Sprachen angezeigt werden, wenn sie für den Begriff der Suchanfrage sehr relevant sind.
safeSearch string
Die safeSearch gibt an, ob die Suchergebnisse neben den Standardinhalten auch eingeschränkte Inhalte enthalten sollen:

  • moderate - YouTube wird einige Inhalte aus den Suchergebnissen herausfiltern und zumindest die Inhalte filtern, die in Ihrem Land eingeschränkt sind. Je nach Inhalt können die Suchergebnisse aus den Suchergebnissen entfernt oder in den Suchergebnissen zurückgestuft werden. Dies ist der Standardparameterwert.
  • none - YouTube filtert die Suchergebnismenge nicht.
  • strict - YouTube wird versuchen, alle eingeschränkten Inhalte aus den Suchergebnissen auszuschließen. Je nach Inhalt können Suchergebnisse aus den Suchergebnissen entfernt oder in den Suchergebnissen zurückgestuft werden.
topicId string
Die topicId gibt an, dass die API-Antwort nur Ressourcen enthalten soll, die mit dem angegebenen Thema verbunden sind. Der Wert identifiziert eine Freebase-Themen-ID.Das ist wichtig: Aufgrund der Abschaffung von Freebase und der Freebase-API wird die topicId Parameter funktioniert seit dem 27. Februar 2017 anders. Zu diesem Zeitpunkt begann YouTube mit der Unterstützung einer kleinen Gruppe von kuratierten Themen-IDs, und Sie können nur diese kleinere Gruppe von IDs als Werte für diesen Parameter verwenden.

Themen
Musik-Themen
/m/04rlf Musik (übergeordnetes Thema)
/m/02mscn Christliche Musik
/m/0ggq0m Klassische Musik
/m/01lyv Land
/m/02lkt Elektronische Musik
/m/0glt670 Hip-Hop-Musik
/m/05rwpb Unabhängige Musik
/m/03_d0 Jazz
/m/028sqc Musik aus Asien
/m/0g293 Musik aus Lateinamerika
/m/064t9 Popmusik
/m/06cqb Reggae
/m/06j6l Rhythmus und Blues
/m/06by7 Rockmusik
/m/0gywn Soul-Musik
Spiele-Themen
/m/0bzvm2 Spiele (übergeordnetes Thema)
/m/025zzc Action-Spiel
/m/02ntfj Action-Adventure-Spiel
/m/0b1vjn Gelegenheitsspiel
/m/02hygl Musik-Videospiel
/m/04q1x3q Puzzle-Videospiel
/m/01sjng Renn-Videospiel
/m/0403l3g Rollenspiel-Videospiel
/m/021bp2 Simulation Videospiel
/m/022dc6 Sportspiel
/m/03hf_rm Strategie-Videospiel
Sportliche Themen
/m/06ntj Sport (übergeordnetes Thema)
/m/0jm_ American Football
/m/018jz Baseball
/m/018w8 Basketball
/m/01cgz Boxen
/m/09xp_ Kricket
/m/02vx4 Fußball
/m/037hz Golf
/m/03tmr Eishockey
/m/01h7lh Gemischte Kampfsportarten
/m/0410tth Motorsport
/m/07bs0 Tennis
/m/07_53 Volleyball
Unterhaltungsthemen
/m/02jjt Unterhaltung (übergeordnetes Thema)
/m/09kqc Humor
/m/02vxn Filme
/m/05qjc Darstellende Künste
/m/066wd Professionelles Wrestling
/m/0f2f9 TV-Sendungen
Lifestyle-Themen
/m/019_rr Lebensstil (übergeordnetes Thema)
/m/032tl Mode
/m/027x7n Fitness
/m/02wbm Lebensmittel
/m/03glg Hobby
/m/068hy Haustiere
/m/041xxh Körperliche Attraktivität [Schönheit]
/m/07c1v Technologie
/m/07bxq Tourismus
/m/07yv9 Fahrzeuge
Gesellschaftliche Themen
/m/098wr Gesellschaft (übergeordnetes Thema)
/m/09s1f Business
/m/0kt51 Gesundheit
/m/01h6rj Militär
/m/05qt0 Politik
/m/06bvp Religion
Andere Themen
/m/01k8wb Wissen

 
videoCaption string
Die videoCaption gibt an, ob die API die Videosuchergebnisse danach filtern soll, ob sie Untertitel haben. zulässige Werte sind:

  • any - Filtern Sie die Ergebnisse nicht nach der Verfügbarkeit von Untertiteln.
  • closedCaption - Nehmen Sie nur Videos auf, die Untertitel haben.
  • none - Nehmen Sie nur Videos auf, die keine Untertitel haben.
videoCategoryId string
Die videoCategoryId Parameter filtert Videosuchergebnisse auf der Grundlage ihrer Kategorie.
videoDefinition string
Die videoDefinition können Sie die Suche auf hochauflösende (HD) oder standardauflösende (SD) Videos beschränken. HD-Videos sind für die Wiedergabe in mindestens 720p verfügbar, obwohl auch höhere Auflösungen, wie 1080p, verfügbar sein können.akzeptable Werte sind:

  • any - Geben Sie alle Videos zurück, unabhängig von ihrer Auflösung.
  • high - Nur HD-Videos abrufen.
  • standard - Rufen Sie nur Videos in Standardauflösung ab.
videoDimension string
Die videoDimension können Sie eine Suche auf 2D- oder 3D-Videos einschränken, wobei folgende Werte zulässig sind

  • 2d - Schränken Sie die Suchergebnisse ein, um 3D-Videos auszuschließen.
  • 3d - Schränken Sie die Suchergebnisse nur auf 3D-Videos ein.
  • any - Schließt sowohl 3D- als auch Nicht-3D-Videos in die zurückgegebenen Ergebnisse ein. Dies ist der Standardwert.
videoDuration string
Die videoDuration filtert die Videosuchergebnisse auf der Grundlage ihrer Dauer, wobei die folgenden Werte zulässig sind:

  • any - Filtern Sie die Videosuchergebnisse nicht nach ihrer Dauer. Dies ist der Standardwert.
  • long - Nehmen Sie nur Videos auf, die länger als 20 Minuten sind.
  • medium - Nehmen Sie nur Videos auf, die zwischen vier und 20 Minuten lang sind (einschließlich).
  • short - Nehmen Sie nur Videos auf, die weniger als vier Minuten lang sind.
videoEmbeddable string
Die videoEmbeddable ermöglicht es Ihnen, die Suche auf Videos zu beschränken, die in eine Webseite eingebettet werden können:

  • any - Gibt alle Videos zurück, ob sie eingebettet werden können oder nicht.
  • true - Nur einbettbare Videos abrufen.
videoLicense string
Die videoLicense filtert die Suchergebnisse so, dass nur Videos mit einer bestimmten Lizenz angezeigt werden. Bei YouTube können Video-Uploader wählen, ob sie jedem ihrer Videos die Creative-Commons-Lizenz oder die Standard-YouTube-Lizenz beifügen möchten.Akzeptierte Werte sind:

  • any - Gibt alle Videos zurück, die den Abfrageparametern entsprechen, unabhängig davon, welche Lizenz sie haben.
  • creativeCommon - Geben Sie nur Videos zurück, die eine Creative Commons-Lizenz haben. Benutzer können Videos mit dieser Lizenz in anderen Videos, die sie erstellen, wiederverwenden. Mehr erfahren.
  • youtube - Es werden nur Videos zurückgegeben, die die Standardlizenz von YouTube haben.
videoSyndicated string
Die videoSyndicated können Sie die Suche auf Videos einschränken, die außerhalb von youtube.com abgespielt werden können:

  • any - Alle Videos, ob syndiziert oder nicht, zurückgeben.
  • true - Nur syndizierte Videos abrufen.
videoType string
Die videoType können Sie die Suche auf einen bestimmten Videotyp einschränken, wobei folgende Werte zulässig sind

  • any - Alle Videos zurückgeben.
  • episode - Nur Episoden von Sendungen abrufen.
  • movie - Nur Filme abrufen.
Unterstützung

Konnten Sie die Antwort nicht in den Dokumenten finden?

Kontakt zum Support

War dieser Artikel hilfreich?

Kategorien