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

m365_update_contact

Microsoft 365 · macOS · Windows

효과: 쓰기. 상태: 조건부 제공.

‘조건부 제공’은 도구가 버전, 플랫폼, 권한, 계정 또는 설정에 따라 달라질 수 있음을 뜻하며 모든 설치에서 활성화되었다는 의미는 아닙니다.

macOS

목적

사용자가 Microsoft 365 / Outlook 연락처의 연락처를 변경하려고 할 때 사용합니다. 지정한 필드만 변경됩니다(이메일과 전화번호는 목록 전체를 대체합니다). id는 m365_list_contacts 또는 m365_search_contacts에서 가져오세요. 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; replaces the contact's list.",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "given_name": {
      "description": "First name.",
      "type": "string"
    },
    "id": {
      "description": "Contact ID from m365_list_contacts or m365_search_contacts",
      "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; replaces the contact's list.",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "surname": {
      "description": "Last name.",
      "type": "string"
    },
    "title": {
      "description": "Job title.",
      "type": "string"
    }
  },
  "required": [
    "id"
  ],
  "type": "object"
}

문서 예시

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

{
  "confirm": false,
  "id": "AAMkAGdemo-contact-1",
  "title": "Project lead"
}

Windows

목적

Microsoft 365 연락처의 필드를 변경합니다. 지정한 필드만 변경되고 나머지는 그대로 유지됩니다. `id`는 m365_list_contacts 또는 m365_search_contacts에서 가져옵니다. 응답의 previous에는 변경된 필드의 이전 값이 담겨 있어 되돌릴 수 있습니다.

필수 입력

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

권한 및 확인

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

영문 정식 기술 스키마 — 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"
    },
    "id": {
      "description": "Contact ID from m365_list_contacts or m365_search_contacts",
      "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": [
    "id"
  ],
  "type": "object"
}

문서 예시

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

{
  "confirm": false,
  "id": "AAMkAGdemo-contact-1",
  "title": "Project lead"
}