Änderungsanträge für Musik verwalten

Hinweis: Die YouTube Content ID API ist für die Verwendung durch YouTube-Inhaltspartner vorgesehen und nicht für alle Entwickler oder YouTube-Nutzer zugänglich. Wenn die YouTube Content ID API nicht als einer der in der Google API Console aufgeführten Dienste angezeigt wird, findest du in der YouTube-Hilfe weitere Informationen zum YouTube-Partnerprogramm.

Hinweis: Die Informationen in diesem Leitfaden gelten speziell für Kompositionsinhalte.

In YouTube Studio kannst du Änderungen an deinen eigenen Musik-Assets beantragen. Du kannst die Content ID API auch für Folgendes verwenden:

  • Änderungsanfragen erstellen
  • Status von Änderungsanfragen auflisten

Auf dieser Seite erhältst du einen Überblick über die MusicChangeRequest-Methoden in der Content ID API. Sie enthält auch Beispiele dafür, wie Änderungsanfragen erstellt und aufgelistet werden.

Voraussetzungen

Sie müssen Anmeldedaten für die Autorisierung abrufen, um diese API verwenden zu können. Sie verwenden Ihr Autorisierungstoken in Ihren Anfragen.

Wenn Sie cURL verwenden, müssen Sie eine AUTH_TOKEN-Variable zur Verwendung in diesen Befehlen erstellen:

export AUTH_TOKEN="[YOUR_AUTH_TOKEN]"

Anfrage zur Musikänderung stellen

Releases oder Tracks ändern Sie mit der Methode musicChangeRequests.create. Ihre Anfrage muss eine Änderungsanfrageressource enthalten, die die Art der Änderung angibt, die Sie vornehmen möchten. Anschließend können Sie die Änderungsanfragen auflisten, um ihren Status zu prüfen.

Arten von Änderungsanfragen

Gültige Anfragetypen sind:

  • misreconciledArtist: Anfrage zur Änderung des Künstlers für eine Veröffentlichung oder einen Titel Benötigt eine DesiredArtist-Ressource. Verwende diese Option, wenn sie nicht mit dem gewünschten Hauptinterpret oder mitwirkenden Künstler verknüpft ist.
  • undesiredDiscography: Anfrage zur Änderung des mit einer Veröffentlichung verknüpften Künstlerkanals Verwende diese Option, wenn die Veröffentlichung eines anderen Künstlers fälschlicherweise auf dem Kanal eines Künstlers angezeigt wird.
  • incorrectPlayability: Anfrage zum Ändern der Spielbarkeit eines Release oder Tracks Verwenden Sie diese Option, wenn das Video nicht wie gewünscht im Produkt abgespielt werden kann oder nicht wie gewünscht angezeigt wird.
  • incorrectMusicVideo: Anfrage zur Änderung des Musikvideos eines Titels Benötigt eine DesiredMusicVideo-Ressource. Verwende diese Option, wenn sie nicht mit dem gewünschten Musikvideo verknüpft ist.
  • incorrectMetadata: Anfrage zum Ändern der Rechtschreibung, Formatierung oder Übersetzung eines Release oder Tracks.

Beispiel: Die Veröffentlichung ist nicht mit dem gewünschten Hauptinterpret oder mitwirkenden Künstler verknüpft.

Angenommen, du hast eine Veröffentlichung bei YouTube Music eingereicht, aber der Veröffentlichung ist ein falscher Künstler zugeordnet. So beantragen Sie diese Änderung:

  1. Suche in YouTube Studio nach dem betroffenen Release. Kopiere die ID-Nummer (z. B. den UPC) von der YouTube Studio-Seite.

  2. Erstellen Sie eine Anfrage, die die folgende JSON-Anweisung enthält:

    '{
  "release": "releases/0012345678901", 
  "misreconciledArtist": {
    "channelId": "UCP8W_Atlibtp488XGcRkPnQ", 
    "newArtist": "false", 
    "supplementalInfo": "Comment about the change"
  }
}'
    • release ist die ID des Release, die du in YouTube Studio findest.
    • misreconciledArtist verwendet eine desiredArtist-Ressource, die Folgendes enthält:
      • channelId: Kanal-ID des Künstlers, zu dem du die Veröffentlichung verschieben möchtest. Du erhältst die Kanal-ID, indem du den Kanal des Künstlers auf YouTube aufrufst und die ID aus der URL kopierst. Falls der Interpret nicht vorhanden und ein neuer Interpret ist, lassen Sie channelId leer und markieren Sie newArtist: true.
      • newArtist: Wenn der Künstler noch nicht auf YouTube Music ist, markiere dieses Feld als true. Falls Sie eine Kanal-ID angegeben haben, markieren Sie dieses Feld als false.
      • supplementalInfo: Optionale Kommentare zur Anfrage.

  3. Verwenden Sie die Methode musicChangeRequests.create, um die Anfrage zu stellen. Fügen Sie die JSON-Datei mit der Anfrage hinzu. Der folgende Befehl zeigt beispielsweise, wie Sie diese Anfrage mit cURL stellen würden:

    curl -v -H "Authorization: Bearer $AUTH_TOKEN" --json '{"release": "releases/0012345678901", "misreconciledArtist": {"channelId": "UCP8W_Atlibtp488XGcRkPnQ", "newArtist": "false", "supplementalInfo": "Comment about the change"}}' https://www.googleapis.com/youtube/partner/v1/music/changeRequests

Änderungsanfragen auflisten

Mit der Methode musicChangeRequests.list können Sie eine Liste der gemeldeten Musikänderungsanfragen abrufen. Die Methode antwortet mit einer Liste von Änderungsanfragen, die nach Rechteinhaber gefiltert sind. Du kannst die Ergebnisse auch nach Release oder Track und nach Rechteinhaber filtern.

Beispiel: Änderungsanfragen für einen bestimmten Release auflisten

Angenommen, du musst die Änderungsanfragen für einen bestimmten Release von einem anderen Rechteinhaber anfordern. Der folgende Befehl ist ein Beispiel dafür, wie Sie diese Anfrage mit cURL stellen:

curl -v -H "Authorization: Bearer $AUTH_TOKEN" https://www.googleapis.com/youtube/partner/v1/music/changeRequests?onBehalfOfContentOwner=91U_FgOL8S7d52aNESfMaw&filter.parent=releases/0999999999999

Dabei gilt:

  • onBehalfOfContentOwner ist die Kanal-ID des Rechteinhabers, dem die Veröffentlichung oder der Track gehört.
  • filter gibt einen release/[RELEASE_ID_NUMBER] oder track/[TRACK_ID_NUMBER] an.