music_add_to_playlist
Musica · macOS
Effetto: scrittura. Stato: disponibilità condizionata.
«Disponibilità condizionata» indica che lo strumento può dipendere da versione, piattaforma, autorizzazioni, account o configurazione. Non è necessariamente attivo ovunque.
macOS
Scopo
Aggiunge brani della libreria a una playlist dell'app Music, nell'ordine indicato. Chiamato senza confirm restituisce un'anteprima e non aggiunge nulla; passa confirm=true per aggiungere. `playlist` è un nome o un id; quando nessuna playlist ha quel nome, create=true la crea, e senza di esso non viene aggiunto nulla. Le playlist smart, le cartelle e le playlist gestite dall'app Music vengono rifiutate. Quando un id di brano non è nella libreria, non viene aggiunto nulla. Un brano già presente nella playlist viene aggiunto di nuovo. Apre l'app Music quando è chiusa.
Input obbligatori
playlisttrack_ids
I nomi restano esattamente quelli richiesti dallo strumento. Le definizioni tecniche canoniche in inglese sono nello schema espandibile qui sotto.
Autorizzazioni e conferma
Lo schema dichiara un parametro di conferma esplicito. Controlla l’anteprima e autorizza l’operazione reale secondo il contratto della piattaforma.
- Utilizza solo le app, gli account e le risorse autorizzate dall'utente su questa piattaforma. Consulta la descrizione specifica della piattaforma di questo strumento per i suoi requisiti di connessione e autorizzazione; questo catalogo non afferma ambiti OAuth aggiuntivi o diritti del sistema operativo.
Schema tecnico canonico in inglese — macOS
{
"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"
}Esempio documentale
Esempio di documentazione per music_add_to_playlist. Non eseguire questo esempio. Gli argomenti mostrati appartengono a un set di dati fittizio; individua gli identificatori reali e ottieni l’autorizzazione prima di una chiamata reale.
{
"confirm": false,
"create": true,
"playlist": "Demo Focus",
"track_ids": [
"demo-track-001",
"demo-track-002"
]
}