music_add_to_playlist

macOS

Propósito

Agrega canciones de la biblioteca a una lista de reproducción de la app Música, en el orden indicado. Si se llama sin confirm, devuelve una vista previa y no agrega nada; pasa confirm=true para agregar. `playlist` es un nombre o un id; cuando ninguna lista tiene ese nombre, create=true la crea, y sin él no se agrega nada. Se rechazan las listas inteligentes, las carpetas y las listas que administra la propia app Música. Cuando algún id de canción no está en la biblioteca, no se agrega nada. Una canción que ya está en la lista se agrega de nuevo. Abre la app Música cuando está cerrada.

Entradas obligatorias

• playlist
• track_ids

Los nombres se conservan exactamente como los exige la herramienta. Las definiciones técnicas canónicas, en inglés, están en el esquema expandible de abajo.

Permisos y confirmación

El esquema declara un parámetro explícito de confirmación. Revisa la vista previa y autoriza la operación real según el contrato de esta plataforma.

• Utilice únicamente las aplicaciones, cuentas y recursos autorizados por el usuario en esta plataforma. Consulte la descripción específica de la plataforma de esta herramienta para conocer sus requisitos de conexión y permisos. Este catálogo no afirma alcances OAuth adicionales ni derechos de sistema operativo.

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

Ejemplo documental

Ejemplo de documentación para music_add_to_playlist. No ejecutes este ejemplo. Los argumentos mostrados pertenecen a un conjunto de datos ficticio; resuelve identificadores reales y obtén autorización antes de una llamada real.

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