Zarządzanie prośbami o zmianę muzyki

Uwaga: interfejs YouTube Content ID API jest przeznaczony dla dostawców treści w YouTube i nie jest dostępny dla wszystkich deweloperów ani użytkowników YouTube. Jeśli nie widzisz interfejsu YouTube Content ID API na liście usług wymienionych w Konsoli interfejsów API Google, odwiedź Centrum pomocy YouTube, aby dowiedzieć się więcej o programie partnerskim YouTube.

Uwaga: informacje w tym przewodniku dotyczą tylko zasobów kompozycji.

W YouTube Studio możesz poprosić o zmianę zasobów muzycznych, które do Ciebie należą. Interfejsu Content ID API możesz też używać, aby:

  • Utwórz prośby o zmianę
  • Wyświetlenie listy stanu próśb o zmianę

Na tej stronie znajdziesz omówienie metod MusicChangeRequest w interfejsie Content ID API. Znajdziesz w nim również przykłady tworzenia i wyświetlania próśb o zmianę.

Wymagania

Aby używać tego interfejsu API, musisz uzyskać dane autoryzacji. W żądaniach będzie używany token autoryzacji.

Jeśli używasz cURL, pamiętaj, aby utworzyć zmienną AUTH_TOKEN do użycia w tych poleceniach:

export AUTH_TOKEN="[YOUR_AUTH_TOKEN]"

Utwórz prośbę o zmianę muzyki

Za pomocą metody musicChangeRequests.create możesz zmienić wersję lub ścieżkę. Prośba musi zawierać zasób żądania zmiany określający typ zmiany, jaką chcesz wprowadzić. Następnie możesz wyświetlić listę próśb o zmianę, aby sprawdzić ich stan.

Rodzaje próśb o zmianę

Prawidłowe typy żądań obejmują:

  • misreconciledArtist: prośba o zmianę wykonawcy utworu lub utworu. Przyjmuje zasób DesiredArtist. Użyj tej opcji, jeśli nie jest ona powiązana z oczekiwanym wykonawcą głównym lub gościnnym.
  • undesiredDiscography: prośba o zmianę kanału wykonawcy powiązanego z wydaniem. Użyj tej opcji, jeśli wydanie innego wykonawcy wyświetla się nieprawidłowo na jego kanale.
  • incorrectPlayability: prośba o zmianę możliwości odtwarzania wersji lub ścieżki audio. Użyj tej opcji, jeśli nie można jej odtworzyć lub obejrzeć w usłudze w oczekiwanej formie.
  • incorrectMusicVideo: prośba o zmianę teledysku do utworu. Przyjmuje zasób DesiredMusicVideo. Użyj tej opcji, jeśli nie jest ona powiązana z oczekiwanym teledyskiem.
  • incorrectMetadata: prośba o zmianę pisowni, formatowania lub tłumaczenia wersji bądź ścieżki.

Przykład: wersja nie jest powiązana z oczekiwanym głównym lub gościnnym wykonawcą

Załóżmy, że wersja została przesłana do YouTube Music, ale jest ona powiązana z nieprawidłowym wykonawcą. Aby poprosić o wprowadzenie tej zmiany:

  1. Znajdź w YouTube Studio wersję, której dotyczy problem. Skopiuj numer identyfikacyjny (np. UPC) ze strony YouTube Studio.

  2. Utwórz żądanie, które zawiera tę instrukcję JSON:

    '{
  "release": "releases/0012345678901", 
  "misreconciledArtist": {
    "channelId": "UCP8W_Atlibtp488XGcRkPnQ", 
    "newArtist": "false", 
    "supplementalInfo": "Comment about the change"
  }
}'
    • release to numer identyfikacyjny wydania, który znajdziesz w YouTube Studio.
    • misreconciledArtist pobiera zasób desiredArtist złożony z tych elementów:
      • channelId: identyfikator kanału wykonawcy, do którego chcesz przenieść wydanie. Aby uzyskać identyfikator kanału, odwiedź kanał wykonawcy w YouTube i skopiuj identyfikator z adresu URL. Jeśli wykonawca nie istnieje, a jest nowym wykonawcą, pozostaw pole channelId puste i zaznacz newArtist: true.
      • newArtist: jeśli wykonawcy nie ma obecnie w YouTube Music, oznacz to pole true. W przeciwnym razie, jeśli podasz identyfikator kanału, oznacz to pole jako false.
      • supplementalInfo: opcjonalne komentarze do prośby.

  3. Wyślij żądanie za pomocą metody musicChangeRequests.create. Dołącz plik JSON z żądaniem. Na przykład to polecenie pokazuje, jak można je przesłać przy użyciu cURL:

    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

Wyświetlenie listy próśb o zmianę

Aby pobrać listę zgłoszonych próśb o zmianę muzyki, użyj metody musicChangeRequests.list. W odpowiedzi przesyła listę próśb o zmianę przefiltrowaną według właściciela treści. Możesz też filtrować wyniki według wersji lub ścieżki oraz właściciela treści.

Przykład: wyświetlanie listy żądań zmian dotyczących określonej wersji

Załóżmy, że chcesz uzyskać prośby o zmianę konkretnej wersji do innego właściciela treści. Oto przykład, jak wysyłasz żądanie za pomocą cURL:

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

gdzie:

  • onBehalfOfContentOwner to identyfikator kanału właściciela treści, który jest właścicielem wersji lub ścieżki audio.
  • filter określa wartość release/[RELEASE_ID_NUMBER] lub track/[TRACK_ID_NUMBER].