shortcuts_run

macOS

Amaç

Kullanıcının macOS Kısayollarından birini ad veya tanımlayıcıyla çalıştırır: Mac kullanıcılarının HomeKit’i, odak modlarını ve kataloğun kapsamadığı üçüncü taraf uygulama eylemlerini zaten otomatikleştirdiği yol. Yalıtılmış bir alt küme değil, kısayolun KENDİ eylemlerini kısayolun kendi izinleriyle çalıştırır: Kısayollar uygulamasında Çalıştır’a tıklamakla aynıdır. Bu bir yazma işlemidir: ilk çağrı (confirm=false) hiçbir şey çalıştırmadan kısayolun adını, tanımlayıcısını ve klasörünü gösteren bir önizleme döndürür; gerçekten çalıştırmak için confirm=true ayarlayın. Birden fazla kısayolla eşleşen bir ad, iki tanımlayıcıyla birlikte reddedilir: bunlardan biriyle yeniden çağırın, asla tahmin etmeyin. Bir iletişim kutusunu bekleyen veya uzun süren bir kısayol, bu çağrıyı askıda bırakmak yerine sınırlı bir zaman aşımından sonra açık bir iletiyle durdurulur.

Zorunlu girdiler

• name_or_identifier

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 bildirir. Önizlemeyi inceleyin ve gerçek işlemi platform sözleşmesine göre yetkilendirin.

• 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": {
    "confirm": {
      "description": "Must be true to actually run the shortcut. Without it, returns a preview.",
      "type": "boolean"
    },
    "input_text": {
      "description": "Optional text input for the shortcut, passed via a temp file — omit if the shortcut takes no input.",
      "type": "string"
    },
    "name_or_identifier": {
      "description": "Shortcut name or identifier, from shortcuts_list. An ambiguous name is refused — pass the identifier instead.",
      "type": "string"
    }
  },
  "required": [
    "name_or_identifier"
  ],
  "type": "object"
}

Belge örneği

shortcuts_run 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.

{
  "confirm": false,
  "name_or_identifier": "Demo morning brief"
}