本文へスキップ
すべてのツール

m365_create_contact

Microsoft 365 · macOS · Windows

効果: 書き込み. 状態: 条件付き提供.

「条件付き提供」は、バージョン、プラットフォーム、権限、アカウント、設定に依存する可能性を示し、すべての環境で有効という意味ではありません。

macOS

目的

ユーザーが Microsoft 365 / Outlook の連絡先に新しい連絡先を追加したいときに使います。少なくとも名前またはメールアドレスを指定してください。scopes_for: ["contacts"] で接続したアカウントが必要です。

必須入力

このプラットフォームのスキーマには必須入力が宣言されていません。任意の選択項目や実行要件が存在する場合があります。

権限と確認

スキーマには明示的な確認パラメータがあります。プレビューを確認し、プラットフォーム契約に従って実操作を承認してください。

英語の正規技術スキーマ — macOS
{
  "properties": {
    "account": {
      "description": "Which connected Microsoft 365 account to use: its email (UPN), its id from list_m365_accounts, or its display name when unique. Leave it out to use the default account.",
      "type": "string"
    },
    "company": {
      "description": "Company.",
      "type": "string"
    },
    "confirm": {
      "description": "Ignored; kept for older clients.",
      "type": "boolean"
    },
    "emails": {
      "description": "Up to 3 e-mail addresses.",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "given_name": {
      "description": "First name.",
      "type": "string"
    },
    "mobile": {
      "description": "Mobile phone.",
      "type": "string"
    },
    "name": {
      "description": "The name shown for the contact (default: first and last name).",
      "type": "string"
    },
    "notes": {
      "description": "Notes.",
      "type": "string"
    },
    "phones": {
      "description": "Up to 2 business phones.",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "surname": {
      "description": "Last name.",
      "type": "string"
    },
    "title": {
      "description": "Job title.",
      "type": "string"
    }
  },
  "required": [],
  "type": "object"
}

ドキュメント例

m365_create_contact のドキュメント例です。この例は実行しないでください。表示される引数は架空のデータセットに属します。実際に呼び出す前に実在する識別子を確認し、承認を得てください。

{
  "company": "Example Co",
  "confirm": false,
  "emails": [
    "alex@example.com"
  ],
  "given_name": "Alex",
  "surname": "Rivera"
}

Windows

目的

Microsoft 365 アカウントの連絡先(Outlook)に連絡先を作成します。名前、メールアドレス、電話番号、会社名、役職、メモのうち、少なくとも 1 つの項目が必要です。アカウントが連絡先へのアクセスを許可している必要があります(方法は、scopes_for ["contacts"] を伴う consent_required が示します)。

必須入力

このプラットフォームのスキーマには必須入力が宣言されていません。任意の選択項目や実行要件が存在する場合があります。

権限と確認

スキーマには明示的な確認パラメータがあります。プレビューを確認し、プラットフォーム契約に従って実操作を承認してください。

英語の正規技術スキーマ — Windows
{
  "properties": {
    "account": {
      "description": "Which connected Microsoft 365 account to use: its email (UPN), its id from list_m365_accounts, or its display name when unique. Leave it out to use the default account.",
      "type": "string"
    },
    "company": {
      "description": "Company",
      "type": "string"
    },
    "confirm": {
      "description": "Ignored; kept for older clients.",
      "type": "boolean"
    },
    "emails": {
      "description": "Email addresses (at most 3)",
      "items": {
        "type": "string"
      },
      "maxItems": 3,
      "type": "array"
    },
    "given_name": {
      "description": "First name",
      "type": "string"
    },
    "mobile": {
      "description": "Mobile phone",
      "type": "string"
    },
    "notes": {
      "description": "Notes",
      "type": "string"
    },
    "phones": {
      "description": "Business phones",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "surname": {
      "description": "Last name",
      "type": "string"
    },
    "title": {
      "description": "Job title",
      "type": "string"
    }
  },
  "required": [],
  "type": "object"
}

ドキュメント例

m365_create_contact のドキュメント例です。この例は実行しないでください。表示される引数は架空のデータセットに属します。実際に呼び出す前に実在する識別子を確認し、承認を得てください。

{
  "company": "Example Co",
  "confirm": false,
  "emails": [
    "alex@example.com"
  ],
  "given_name": "Alex",
  "surname": "Rivera"
}