music_add_to_playlist

macOS

Zweck

Fügt Bibliothekstitel in der angegebenen Reihenfolge zu einer Playlist der Musik-App hinzu. Ohne confirm gibt es eine Vorschau zurück und fügt nichts hinzu; übergeben Sie confirm=true, um hinzuzufügen. `playlist` ist ein Name oder eine ID; gibt es keine Playlist mit diesem Namen, legt create=true sie an, und ohne es wird nichts hinzugefügt. Intelligente Playlists, Ordner und von der Musik-App verwaltete Playlists werden abgelehnt. Ist eine Titel-ID nicht in der Bibliothek, wird nichts hinzugefügt. Ein Titel, der bereits in der Playlist ist, wird erneut hinzugefügt. Öffnet die Musik-App, wenn sie geschlossen ist.

Erforderliche Eingaben

• playlist
• track_ids

Die Namen bleiben exakt so erhalten, wie das Werkzeug sie verlangt. Die kanonischen technischen Definitionen auf Englisch stehen im ausklappbaren Schema unten.

Berechtigungen und Bestätigung

Das Schema deklariert einen ausdrücklichen Bestätigungsparameter. Prüfen Sie die Vorschau und autorisieren Sie den echten Vorgang gemäß Plattformvertrag.

• Verwenden Sie auf dieser Plattform nur die vom Benutzer autorisierten Apps, Konten und Ressourcen. Informationen zu den Verbindungs- und Berechtigungsanforderungen finden Sie in der plattformspezifischen Beschreibung dieses Tools. Dieser Katalog beansprucht keine zusätzlichen OAuth-Bereiche oder Betriebssystemberechtigungen.

{
  "properties": {
    "confirm": {
      "description": "Must be true to act. Without it, returns a preview and changes nothing.",
      "type": "boolean"
    },
    "create": {
      "description": "Create the playlist when none has that name (default false).",
      "type": "boolean"
    },
    "playlist": {
      "description": "Playlist name or id from music_list_playlists.",
      "type": "string"
    },
    "track_ids": {
      "description": "Track ids from music_search_library (at most 100).",
      "items": {
        "type": "string"
      },
      "type": "array"
    }
  },
  "required": [
    "playlist",
    "track_ids"
  ],
  "type": "object"
}

Dokumentationsbeispiel

Dokumentationsbeispiel für music_add_to_playlist. Führen Sie dieses Beispiel nicht aus. Die gezeigten Argumente gehören zu einem fiktiven Datensatz; ermitteln Sie reale Kennungen und holen Sie vor einem echten Aufruf die Genehmigung ein.

{
  "confirm": false,
  "create": true,
  "playlist": "Demo Focus",
  "track_ids": [
    "demo-track-001",
    "demo-track-002"
  ]
}