recipe_publish

macOS

Amaç

Kayıtlı tariflerinizden/skill’lerinizden birini Dario’nun incelemesi için topluluk moderasyon kuyruğuna gönderir; bu onu YAYIMLAMAZ. confirm=true olmadan, gönderilecek başlığın, kategorinin, uygulamaların ve iş akışı açıklamasının ÖNİZLEMESİNİ gösterir (bu Mac’ten hiçbir şey gönderilmez); confirm=true ile gönderir ve {status:"submitted", pending:true} döndürür. Onaylandıktan sonra /community/skills sayfasında görünür ve herkes onu recipe_install ile kurabilir. `workflow` herkese açık açıklamadır: tarifin kendi `description` alanı en az 15 karakterse varsayılan olarak o kullanılır; aksi halde açıkça belirtin.

Zorunlu girdiler

• name

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": {
    "apps": {
      "description": "Free-text apps the recipe touches (e.g. \"Mail, Calendar\"), shown in the moderation queue.",
      "type": "string"
    },
    "category": {
      "description": "Free-text category shown in the moderation queue and, once approved, on /community/skills.",
      "type": "string"
    },
    "confirm": {
      "description": "Must be true to actually submit. Without it, returns a preview — nothing is sent.",
      "type": "boolean"
    },
    "name": {
      "description": "Name of the saved recipe/skill to publish (see recipe_list).",
      "type": "string"
    },
    "title": {
      "description": "Shown once approved on /community/skills. Defaults to the recipe's own name.",
      "type": "string"
    },
    "workflow": {
      "description": "The public write-up of what the recipe does. Defaults to the recipe's own `description` if it's at least 15 characters; required otherwise.",
      "type": "string"
    }
  },
  "required": [
    "name"
  ],
  "type": "object"
}

Belge örneği

recipe_publish 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": "Demo morning brief"
}