shortcuts_run

macOS

목적

사용자의 macOS 단축어 중 하나를 이름 또는 식별자로 실행합니다. Mac 사용자가 이미 HomeKit, 집중 모드, 카탈로그가 다루지 않는 서드파티 앱 동작을 자동화하는 방식입니다. 샌드박스된 일부가 아니라 단축어 자체의 동작을 그 단축어 자체의 권한으로 실행합니다. 단축어 앱에서 실행을 누르는 것과 같습니다. 이것은 쓰기 작업입니다. 첫 호출(confirm=false)은 아무것도 실행하지 않고 단축어 이름, 식별자, 폴더를 알려 주는 미리 보기를 반환하며, 실제로 실행하려면 confirm=true를 설정하세요. 이름이 둘 이상의 단축어와 일치하면 두 식별자와 함께 거부됩니다. 그중 하나로 다시 호출하고 절대 추측하지 마세요. 대화 상자를 기다리거나 오래 실행되는 단축어는 이 호출이 멈추는 대신 제한된 시간 초과 후 명확한 메시지와 함께 중지됩니다.

필수 입력

• name_or_identifier

입력 이름은 도구가 요구하는 정확한 형태로 유지됩니다. 영문 정식 기술 정의는 아래 펼칠 수 있는 스키마에 있습니다.

권한 및 확인

스키마에 명시적 확인 매개변수가 있습니다. 미리보기를 검토하고 플랫폼 계약에 따라 실제 작업을 승인하세요.

• 이 플랫폼에서는 사용자가 승인한 앱, 계정 및 리소스만 사용하세요. 연결 및 권한 요구 사항은 이 도구의 플랫폼별 설명을 참조하세요. 이 카탈로그는 추가 OAuth 범위나 OS 권한이 있다고 주장하지 않습니다.

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

문서 예시

shortcuts_run 문서 예시입니다. 이 예시를 실행하지 마세요. 표시된 인수는 가상 데이터 세트에 속합니다. 실제 호출 전에 실제 식별자를 확인하고 승인을 받으세요.

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