Method: assetSearch.list

Sucht anhand von Asset-Metadaten nach Assets. Mit der Methode können alle Inhalte oder nur die Inhalte abgerufen werden, die dem Rechteinhaber gehören. Diese Methode ahmt die Funktionen der erweiterten Suche auf der Seite Assets im CMS nach.

HTTP-Anfrage

GET https://youtubepartner.googleapis.com/youtube/partner/v1/assetSearch

Die URL verwendet die Syntax der gRPC-Transcodierung.

Abfrageparameter

Parameter
createdAfter

string

Der Parameter createdAfter beschränkt die Anzahl der zurückgegebenen Assets auf diejenigen, die ursprünglich am oder nach dem angegebenen Datum/Uhrzeit erstellt wurden. Beispiel: 2015-01-29T23:00:00Z
createdBefore

string

Der Parameter createdBefore beschränkt die Anzahl der zurückgegebenen Assets auf diejenigen, die ursprünglich am oder vor dem angegebenen Datum/Uhrzeit erstellt wurden. Beispiel: 2015-01-29T23:00:00Z
hasConflicts

boolean

Mit dem Parameter hasConflicts kannst du nur Assets abrufen, bei denen eigentumsrechtliche Konflikte bestehen. Der einzige gültige Wert ist true. Das Festlegen des Parameterwerts auf false hat keine Auswirkungen auf die Ergebnisse.
includeAnyProvidedlabel

boolean

Wenn der includeAnyProvidedlabel-Parameter auf „true“ gesetzt ist, wird nach Inhalten gesucht, die eines der angegebenen Labels enthalten. Andernfalls wird nach Inhalten gesucht, die alle angegebenen Labels enthalten.
isrcs

string

Eine durch Kommas getrennte Liste von bis zu 50 ISRCs. Wenn Sie einen Wert für diesen Parameter angeben, ignoriert der API-Server alle Werte, die für die folgenden Parameter festgelegt wurden: q, includeAnyProvidedLabel, hasConflicts, labels, metadataSearchFields, sort und type.
labels

string

Der labels-Parameter gibt die Assets mit bestimmten Asset-Labels an, die du abrufen möchtest. Der Parameterwert ist eine durch Kommas getrennte Liste von Asset-Labels.
metadataSearchFields

string

Der Parameter metadataSearchField gibt an, nach welchen Metadatenfeldern gesucht werden soll. Es handelt sich um eine durch Kommas getrennte Liste von Paaren aus Metadatenfeldern und -werten, die durch einen Doppelpunkt(:) verbunden sind. Beispiel: customId:my_custom_id,artist:Dandexx
onBehalfOfContentOwner

string

Der Parameter onBehalfOfContentOwner gibt den Rechteinhaber an, in dessen Namen der Nutzer handelt. Dieser Parameter unterstützt Nutzer, deren Konten mit mehreren Rechteinhabern verknüpft sind.
ownershipRestriction

enum (OwnershipRestriction)

Der Parameter ownershipRestriction gibt die Filteroption für die Inhaberschaft bei der Suche an. Standardmäßig wird die Suche nur in den Assets durchgeführt, die dem aktuell authentifizierten Nutzer gehören.
pageToken

string

Der Parameter pageToken gibt ein Token an, das eine bestimmte Ergebnisseite angibt, die zurückgegeben werden soll. Setze diesen Parameter auf den Wert des nextPageToken-Werts aus der vorherigen API-Antwort, um die nächste Seite mit Suchergebnissen abzurufen.
q

string

YouTube-Suchanfragen in den Feldern id, type und customId für alle Assets sowie in zahlreichen anderen Metadatenfeldern wie actor, album, director, isrc und tmsId, die je nach Asset-Typ (Filme, Musikvideos usw.) variieren.
sort

enum (Sort)

Der Parameter sort gibt an, wie die Suchergebnisse sortiert werden sollen. Die Ergebnisse werden immer in absteigender Reihenfolge sortiert.
type

string

Der Parameter type gibt die Asset-Typen an, die du abrufen möchtest. Der Parameterwert ist eine durch Kommas getrennte Liste von Asset-Typen.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Diese Antwort zeigt eine Liste der YouTube-Assets, die mit einer Suchanfrage übereinstimmen. Jedes Element in der Liste enthält die Metadaten eines Assets.

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung 
{
  "kind": string,
  "pageInfo": {
    object (PageInfo)
  },
  "items": [
    {
      object (AssetSnippet)
    }
  ],
  "nextPageToken": string
}
Felder
kind

string

Der Typ der API-Antwort. Für diesen Vorgang ist der Wert youtubePartner#assetSnippetList.
pageInfo

object (PageInfo)

Das Objekt pageInfo enthält Seiteninformationen für den Ergebnissatz.
items[]

object (AssetSnippet)

Eine Liste der Asset-Ressourcen, die den Anfragekriterien entsprechen.
nextPageToken

string

Das Token, das als Wert des Parameters pageToken verwendet werden kann, um die nächste Ergebnisseite abzurufen.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/youtubepartner

Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.

OwnershipRestriction

Aufzählung der Einschränkung der Inhaberschaft.

Enums
OWNERSHIP_RESTRICTION_UNSPECIFIED Standardwert.
MINE Assets suchen, die dem aktuellen Nutzer gehören und mit der Suchanfrage übereinstimmen. Das ist das Standardverhalten.
NONE Findet alle Inhalte, die der Suchanfrage entsprechen, unabhängig vom Rechteinhaber.

Sortieren

Aufzählung der unterstützten Sortierreihenfolgen in einer Asset-Suchlistenanfrage

Enums
SORT_UNSPECIFIED Standardwert.
CLAIMS Sortiere nach der Anzahl der Ansprüche für jeden Inhalt.
TIME Sortieren Sie nach dem Änderungszeitpunkt der einzelnen Assets. „Immer“ ist der Standardwert.
VIEWS Sortieren Sie nach den ungefähren täglichen Aufrufen der einzelnen Assets.