본문으로 건너뛰기
모든 도구

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)에 연락처를 만듭니다. 이름, 이메일, 전화번호, 회사, 직함, 메모 중 적어도 하나의 필드가 필요합니다. 계정에 연락처 권한이 부여되어 있어야 합니다(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"
}