create_referral_invites

Diagnostic et système · macOS · Windows

Effet: écriture. État: disponibilité conditionnelle.

«Disponibilité conditionnelle» signifie que l’outil peut dépendre de la version, de la plateforme, des autorisations, du compte ou de la configuration. Il n’est pas forcément actif partout.

macOS

Objectif

Enregistre des invitations de parrainage pour les collègues que l’utilisateur a choisi d’inviter et renvoie un lien de parrainage unique par personne, afin que l’utilisateur puisse voir plus tard qui a installé ou activé LMCP. Il n’envoie rien lui-même — chaque lien renvoyé peut être inclus dans un e-mail ou un message à cette personne. `lang` enregistre la langue dans laquelle l’invitation est rédigée (p. ex. "es", "en"). Le premier appel affiche un aperçu ; confirm: true enregistre les invitations.

Entrées requises

recipients

Les noms restent exactement ceux exigés par l’outil. Les définitions techniques canoniques en anglais figurent dans le schéma dépliable ci-dessous.

Autorisations et confirmation

Le schéma déclare un paramètre de confirmation explicite. Vérifiez l’aperçu et autorisez l’opération réelle conformément au contrat de la plateforme.

Utilisez uniquement les applications, comptes et ressources autorisés par l'utilisateur sur cette plateforme. Consultez la description spécifique à la plate-forme de cet outil pour connaître ses exigences de connexion et d'autorisation ; ce catalogue ne revendique pas d'étendues OAuth ou de droits d'exploitation supplémentaires pour le système d'exploitation.

Schéma technique canonique en anglais — macOS

{
  "properties": {
    "confirm": {
      "description": "Must be true to record the invites. Without it the call returns a preview and records nothing.",
      "type": "boolean"
    },
    "lang": {
      "description": "ISO language of the invite you're writing (the user's conversation language, e.g. 'es', 'en'). Defaults to the Mac's language.",
      "type": "string"
    },
    "recipients": {
      "description": "The picked recipients.",
      "items": {
        "properties": {
          "email": {
            "description": "Recipient's email",
            "type": "string"
          },
          "name": {
            "description": "Recipient's name",
            "type": "string"
          }
        },
        "type": "object"
      },
      "type": "array"
    }
  },
  "required": [
    "recipients"
  ],
  "type": "object"
}

Exemple documentaire

Exemple de documentation pour create_referral_invites. N’exécutez pas cet exemple. Les arguments présentés appartiennent à un jeu de données fictif ; résolvez les identifiants réels et obtenez une autorisation avant tout appel réel.

{
  "confirm": false,
  "recipients": [
    {
      "email": "alex@example.com",
      "name": "Alex Rivera"
    }
  ]
}

Windows

Objectif

Enregistre des invitations de parrainage pour les collègues que l’utilisateur a choisi d’inviter et renvoie un lien de parrainage unique par personne, afin que l’utilisateur puisse voir plus tard qui a installé ou activé LMCP. Il n’envoie rien lui-même — chaque lien renvoyé peut être inclus dans un e-mail ou un message à cette personne. `lang` enregistre la langue dans laquelle l’invitation est rédigée (p. ex. "es", "en"). Le premier appel renvoie un aperçu indiquant les destinataires et n’enregistre rien ; confirm=true les enregistre.

Entrées requises

recipients

Les noms restent exactement ceux exigés par l’outil. Les définitions techniques canoniques en anglais figurent dans le schéma dépliable ci-dessous.

Autorisations et confirmation

Le schéma déclare un paramètre de confirmation explicite. Vérifiez l’aperçu et autorisez l’opération réelle conformément au contrat de la plateforme.

Utilisez uniquement les applications, comptes et ressources autorisés par l'utilisateur sur cette plateforme. Consultez la description spécifique à la plate-forme de cet outil pour connaître ses exigences de connexion et d'autorisation ; ce catalogue ne revendique pas d'étendues OAuth ou de droits d'exploitation supplémentaires pour le système d'exploitation.

Schéma technique canonique en anglais — Windows

{
  "properties": {
    "confirm": {
      "description": "Must be true to record the invites. Without it, returns a preview.",
      "type": "boolean"
    },
    "lang": {
      "description": "ISO language of the invite you're writing (the user's conversation language, e.g. 'es', 'en').",
      "type": "string"
    },
    "recipients": {
      "description": "The picked recipients.",
      "items": {
        "properties": {
          "email": {
            "description": "Recipient's email",
            "type": "string"
          },
          "name": {
            "description": "Recipient's name",
            "type": "string"
          }
        },
        "type": "object"
      },
      "type": "array"
    }
  },
  "required": [
    "recipients"
  ],
  "type": "object"
}

Exemple documentaire

{
  "confirm": false,
  "recipients": [
    {
      "email": "alex@example.com",
      "name": "Alex Rivera"
    }
  ]
}