music_add_to_playlist

macOS

Objectif

Ajoute des morceaux de la bibliothèque à une liste de lecture de l’app Musique, dans l’ordre donné. Appelé sans confirm, il renvoie un aperçu et n’ajoute rien ; passez confirm=true pour ajouter. `playlist` est un nom ou un id ; lorsqu’aucune liste de lecture ne porte ce nom, create=true la crée, et sans lui rien n’est ajouté. Les listes intelligentes, les dossiers et les listes de lecture gérées par l’app Musique sont refusés. Lorsqu’un id de morceau ne figure pas dans la bibliothèque, rien n’est ajouté. Un morceau déjà présent dans la liste de lecture est ajouté de nouveau. Ouvre l’app Musique lorsqu’elle est fermée.

Entrées requises

• playlist
• track_ids

Les noms restent exactement ceux exigés par l’outil. Les définitions techniques canoniques en anglais figurent dans le schéma dépliable ci-dessous.

Autorisations et confirmation

Le schéma déclare un paramètre de confirmation explicite. Vérifiez l’aperçu et autorisez l’opération réelle conformément au contrat de la plateforme.

• Utilisez uniquement les applications, comptes et ressources autorisés par l'utilisateur sur cette plateforme. Consultez la description spécifique à la plate-forme de cet outil pour connaître ses exigences de connexion et d'autorisation ; ce catalogue ne revendique pas d'étendues OAuth ou de droits d'exploitation supplémentaires pour le système d'exploitation.

{
  "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"
}

Exemple documentaire

Exemple de documentation pour music_add_to_playlist. N’exécutez pas cet exemple. Les arguments présentés appartiennent à un jeu de données fictif ; résolvez les identifiants réels et obtenez une autorisation avant tout appel réel.

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