music_search_library

macOS

Amaç

Kullanıcının Music kitaplığındaki parçalarda arar. `field` aramayı title, artist veya album ile sınırlar; varsayılan olan any, Music uygulamasının kendi aramasının yaptığı gibi her metin alanında arar. Her parçanın kimliğini, başlığını, sanatçısını, albümünü ve uzunluğunu döndürür; kimlik, music_playback ve music_add_to_playlist araçlarının aldığı değerdir. Yalnızca kitaplıkta aranır, Apple Music kataloğunda değil. Kapalıysa Music uygulamasını açar.

Zorunlu girdiler

• query

Girdi adları aracın istediği biçimde aynen korunur. İngilizce kanonik teknik tanımlar aşağıdaki açılır şemadadır.

İzinler ve onay

Şema açık bir onay parametresi bildirmez. Bu, izinsiz işlem yapma yetkisi vermez; etkiyi inceleyin ve yetki alın.

• Yalnızca kullanıcının bu platformda yetkilendirdiği uygulamaları, hesapları ve kaynakları kullanın. Bağlantı ve izin gereksinimleri için bu aracın platforma özgü açıklamasına bakın; bu katalog ek OAuth kapsamları veya OS yetkileri bulunduğunu ileri sürmez.

{
  "properties": {
    "field": {
      "description": "Where to look (default any).",
      "enum": [
        "any",
        "title",
        "artist",
        "album"
      ],
      "type": "string"
    },
    "limit": {
      "description": "Tracks to return (default 25, max 100).",
      "maximum": 100,
      "minimum": 1,
      "type": "integer"
    },
    "query": {
      "description": "Text to look for.",
      "type": "string"
    }
  },
  "required": [
    "query"
  ],
  "type": "object"
}

Belge örneği

music_search_library için örnek belge. Bu örneği çalıştırmayın. Gösterilen bağımsız değişkenler kurgusal bir veri kümesine aittir; gerçek bir çağrıdan önce gerçek tanıtıcıları bulun ve izin alın.

{
  "field": "title",
  "limit": 10,
  "query": "Moonlight Sonata"
}