m365_update_contact

Microsoft 365 · macOS · Windows

Effect: schrijven. Status: voorwaardelijk beschikbaar.

‘Voorwaardelijke beschikbaarheid’ betekent dat het hulpmiddel kan afhangen van versie, platform, machtigingen, account of configuratie. Het is niet in elke installatie actief.

macOS

Doel

Gebruik dit wanneer de gebruiker een contact in zijn Microsoft 365 / Outlook-contacten wil wijzigen: alleen de opgegeven velden veranderen (e-mailadressen en telefoonnummers vervangen de hele lijst). Haal de id uit m365_list_contacts of m365_search_contacts. Vereist dat het account is gekoppeld met scopes_for: ["contacts"].

Vereiste invoer

id

De namen blijven exact zoals het hulpmiddel ze vereist. De canonieke technische definities in het Engels staan in het uitklapbare schema hieronder.

Machtigingen en bevestiging

Het schema bevat een expliciete bevestigingsparameter. Controleer het voorbeeld en autoriseer de echte bewerking volgens het platformcontract.

Gebruik uitsluitend de apps, accounts en bronnen waarvoor de gebruiker op dit platform toestemming heeft gegeven. Raadpleeg de platformspecifieke beschrijving van deze tool voor de verbindings- en toestemmingsvereisten; deze catalogus veronderstelt geen aanvullende OAuth-bereiken of OS-rechten.

Canoniek technisch schema in het Engels — 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"
}

Documentatievoorbeeld

Documentatievoorbeeld voor m365_update_contact. Voer dit voorbeeld niet uit. De getoonde argumenten verwijzen naar fictieve gegevens; zoek vóór een echte aanroep de werkelijke identificatoren op en vraag toestemming.

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

Windows