Gérer les contacts pour les notifications

De nombreux services Google Cloud, tels que Cloud Billing, envoient des notifications pour partager des informations importantes avec les utilisateurs de Google Cloud. Par défaut, ces notifications sont envoyées aux membres disposant de certains rôles IAM (Identity and Access Management). Avec les contacts essentiels, vous pouvez personnaliser les contacts qui reçoivent des notifications en fournissant votre propre liste de contacts.

Avant de commencer

Activez Essential Contacts API.

Activer l'API

Autorisations requises

Les autorisations dont vous avez besoin pour utiliser les contacts essentiels varient en fonction de ce que vous souhaitez faire.

Autorisations d'affichage des contacts

Pour afficher les contacts, vous devez disposer d'un rôle comprenant les autorisations suivantes :

  • essentialcontacts.contacts.get
  • essentialcontacts.contacts.list

Pour obtenir ces autorisations tout en suivant le principe du moindre privilège, demandez à votre administrateur de vous accorder le rôle de lecteur des contacts essentiels (roles/essentialContacts.viewer).

Votre administrateur peut également vous attribuer un autre rôle qui inclut les autorisations requises, par exemple un rôle personnalisé ou un rôle prédéfini moins restrictif.

Assurez-vous d'attribuer ces rôles sur le projet, le dossier ou l'organisation auquel le contact est attribué.

Autorisations de gestion des contacts

Pour modifier, supprimer et créer des contacts, vous devez disposer d'un rôle comprenant les autorisations suivantes :

  • essentialcontacts.contacts.get
  • essentialcontacts.contacts.list
  • essentialcontacts.contacts.create
  • essentialcontacts.contacts.delete
  • essentialcontacts.contacts.update

Pour obtenir ces autorisations tout en suivant le principe du moindre privilège, demandez à votre administrateur de vous accorder le rôle d'administrateur des contacts essentiels (roles/essentialContacts.admin).

Votre administrateur peut également vous attribuer un autre rôle qui inclut les autorisations requises, par exemple un rôle personnalisé ou un rôle prédéfini moins restrictif.

Assurez-vous d'attribuer ces rôles sur le projet, le dossier ou l'organisation auquel le contact est attribué.

Catégories de notifications

Vous pouvez attribuer des contacts à différentes catégories de notifications. Si vous n'ajoutez pas de contact à une catégorie, les notifications de cette catégorie sont transmises au contact par défaut, qui est sélectionné en fonction des rôles IAM de vos membres. Nous vous recommandons d'ajouter des contacts personnalisés, et non de compter sur les contacts par défaut, afin de vous assurer que les bonnes personnes reçoivent les notifications de votre projet, votre dossier ou votre organisation.

Vous pouvez ajouter des personnes et des groupes Google en tant que contacts. Pour réduire l'impact des modifications du personnel, nous vous recommandons d'ajouter des groupes Google en tant que contacts et de gérer l'appartenance à ces groupes pour déterminer qui reçoit les notifications. Cela permet de s'assurer que les notifications sont toujours transmises aux employés actifs.

Le tableau suivant vous permet d'en savoir plus sur les catégories de notifications, le contact par défaut et le contact recommandé. Utilisez ces informations pour sélectionner les contacts appropriés pour chaque catégorie.

Catégorie Description Contact par défaut Contact recommandé
Tous Toutes les notifications associées à la ressource Aucun Personnes ou systèmes automatisés chargés des notifications de routage ou de journalisation
Facturation Notifications concernant la facturation et les paiements, modifications tarifaires, erreurs, crédits Administrateur de compte de facturation (roles/billing.admin) Le service financier et les personnes qui gèrent votre relation financière avec Google, y compris celles qui gèrent les budgets, la planification et les comptes liés à l'utilisation de Google Cloud
Juridique Mesures d'application, conformité réglementaire, notifications administratives Administrateur de compte de facturation (roles/billing.admin) Conseiller juridique, responsables de la conformité, spécialistes des relations gouvernementales et autres professionnels semblables
Actualités sur les produits Nouvelles versions, mises à jour des conditions des produits et abandons Propriétaire du projet (roles/owner) Chefs de produits, architectes et ingénieurs qui peuvent bénéficier d'informations en temps réel sur les modifications apportées aux produits et services Google
Sécurité Problèmes, notifications et failles concernant la sécurité et la confidentialité Administrateur de l'organisation (roles/resourcemanager.organizationAdmin) Personnel des services de sécurité informatique et sécurité des opérations, et autres personnes dont la tâche consiste à protéger les données de votre entreprise et de vos clients, et à assurer la continuité des opérations
Suspension Notifications liées à la suspension immédiate du compte Propriétaire du projet (roles/owner) Les utilisateurs immédiatement responsables du fonctionnement et de la maintenance de votre infrastructure informatique et de vos applications professionnelles.
Technique Interruptions, erreurs, bugs et autres problèmes techniques Propriétaire du projet (roles/owner) Professionnels de l'informatique, ingénieurs en fiabilité, administrateurs, personnel d'astreinte et autres personnes ayant besoin de connaître les problèmes techniques et les événements à venir ainsi que ceux qui sont susceptibles d'entraîner le dysfonctionnement de vos éléments informatiques

Langages acceptés

Dans les contacts essentiels, chaque contact a un paramètre de langue préférée. Les créateurs de notifications peuvent référencer ce paramètre lorsqu'ils envoient des notifications.

Lorsque vous ajoutez un contact dans Cloud Console, Cloud Console configure automatiquement la langue préférée du contact en fonction des paramètres de langue préférée du créateur du contact. Lorsque vous ajoutez un contact à l'aide de l'API, vous configurez manuellement sa langue préférée à l'aide d'un code de langue. Ce code de langue peut faire référence à n'importe laquelle des langues acceptées par les contacts essentiels.

Choisir où attribuer les contacts

Vous pouvez attribuer des contacts au niveau du projet, du dossier ou de l'organisation.

Les contacts sont hérités via la hiérarchie des ressources Google Cloud. Par conséquent, si vous ajoutez un contact au niveau de l'organisation, il reçoit des notifications pour l'organisation, ainsi que pour tous les dossiers et projets de l'organisation. De même, si vous ajoutez un contact au niveau du dossier, il reçoit des notifications pour le dossier et pour tous les projets du dossier.

Le choix de l'emplacement où attribuer des contacts dépend de la structure de votre organisation. Toutefois, nous recommandons généralement d'attribuer les contacts dans les niveaux suivants, en fonction de leur catégorie de notifications :

Niveau recommandé Catégorie de notifications
Niveau Organisation :
  • Facturation
  • Juridique
  • Sécurité1
Niveau dossier/projet
  • Tous
  • Actualités sur les produits
  • Sécurité1
  • Suspension
  • Technique

1 Le niveau auquel vous devez attribuer des contacts de sécurité dépend des pratiques de sécurité spécifiques à votre organisation. Par exemple, si des propriétaires de projet individuels sont responsables de la sécurité pour leurs propres projets, vous devez attribuer vos contacts de sécurité au niveau du projet. Toutefois, si un groupe à l'échelle de l'organisation gère la sécurité de tous les projets, il faut attribuer vos contacts de sécurité au niveau de l'organisation.

Répertorier les contacts

Pour répertorier tous les contacts de votre projet, dossier ou organisation, procédez comme suit :

Console

  1. Dans Cloud Console, accédez à la page Contacts essentiels.

    Accéder à la page "Contacts essentiels"

  2. Assurez-vous que le nom de votre projet, dossier ou organisation apparaisse dans le sélecteur de projet en haut de la page. Le sélecteur de projet vous indique le projet, le dossier ou l'organisation pour lesquels vous gérez actuellement des contacts.

  3. Pour répertorier les contacts par catégorie, sélectionnez Catégorie. Pour répertorier les contacts par ordre alphabétique, sélectionnez Contacts.

REST

Répertorier les contacts

Pour afficher les contacts définis sur un projet, un dossier ou une organisation spécifique, utilisez la méthode contacts.list de l'API Contacts essentiels.

Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :

  • RESOURCE_TYPE : type de ressource pour lequel vous souhaitez répertorier les contacts. Utilisez la valeur projects, folders ou organizations.
  • RESOURCE_ID : ID du projet, de l'organisation ou du dossier Google Cloud.
  • PAGE_SIZE : facultatif. Nombre de contacts à inclure dans la réponse. La valeur par défaut est 50 et la valeur maximale est 100. Si le nombre de contacts est supérieur à la taille de la page, la réponse contient un jeton de pagination qui vous permet de récupérer la page de résultats suivante.
  • NEXT_PAGE_TOKEN : facultatif. Jeton de pagination renvoyé dans une réponse précédente de cette méthode. Si spécifié, la liste des contacts commence à la fin de la réponse précédente.

Requête :

GET essentialcontacts.googleapis.com/v1alpha1/RESOURCE_TYPE/RESOURCE_ID/contacts?pageSize=PAGE_SIZE&pageToken=NEXT_PAGE_TOKEN

Pour envoyer votre requête, développez l'une des options suivantes :

Vous devriez recevoir une réponse JSON de ce type :

{
  "contacts": [
    {
      "name": "projects/my-projects/contacts/1",
      "email": "my-contact-1@my-domain.com",
      "notificationCategorySubscriptions": [
        "ALL"
      ],
      "languageTag": "en-US"
    },
    {
      "name": "projects/my-projects/contacts/2",
      "email": "my-contact-2@my-domain.com",
      "notificationCategorySubscriptions": [
        "BILLING"
      ],
      "languageTag": "en-US"
    }
  ]
}

Répertorier les contacts et les contacts hérités

Les ressources enfants (dossiers et projets) héritent des contacts de leurs ancêtres (organisations et autres dossiers). Si vous souhaitez répertorier tous les contacts et les contacts hérités d'une ressource, utilisez la méthode contacts.compute de l'API Contacts essentiels.

Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :

  • RESOURCE_TYPE : type de ressource pour lequel vous souhaitez répertorier les contacts. Utilisez la valeur projects, folders ou organizations.
  • RESOURCE_ID : ID du projet, de l'organisation ou du dossier Google Cloud.
  • NOTIFICATION_CATEGORY : catégories de notifications pour lesquelles vous souhaitez calculer les contacts. Vous pouvez répéter ce champ pour répertorier les contacts de plusieurs catégories de notifications. NOTIFICATION_CATEGORY peut être n'importe laquelle des valeurs suivantes : ALL, BILLING, LEGAL, PRODUCT_UPDATES, SECURITY, SUSPENSION, TECHNICAL et NOTIFICATION_CATEGORY_UNSPECIFIED. La valeur ALL répertorie les contacts de toutes les catégories.
  • PAGE_SIZE : facultatif. Nombre de contacts à inclure dans la réponse. La valeur par défaut est 50 et la valeur maximale est 100. Si le nombre de contacts est supérieur à la taille de la page, la réponse contient un jeton de pagination qui vous permet de récupérer la page de résultats suivante.
  • NEXT_PAGE_TOKEN : facultatif. Jeton de pagination renvoyé dans une réponse précédente de cette méthode. Si spécifié, la liste des contacts commence à la fin de la réponse précédente.

Requête :

GET essentialcontacts.googleapis.com/v1alpha1/RESOURCE_TYPE/RESOURCE_ID/contacts:compute?notificationCategories=NOTIFICATION_CATEGORY&pageSize=PAGE_SIZE&pageToken=NEXT_PAGE_TOKEN

Pour envoyer votre requête, développez l'une des options suivantes :

La réponse répertorie tous les contacts et les contacts hérités de la ressource :

{
  "contacts": [
    {
      "name": "projects/my-projects/contacts/1",
      "email": "my-project-contact-1@my-domain.com",
      "notificationCategorySubscriptions": [
        "ALL"
      ],
      "languageTag": "en-US"
    },
    {
      "name": "projects/my-projects/contacts/2",
      "email": "my-project-contact-2@my-domain.com",
      "notificationCategorySubscriptions": [
        "BILLING"
      ],
      "languageTag": "en-US"
    },
    {
      "name": "organizations/my-organization/contacts/1",
      "email": "my-organization-contact@my-domain.com",
      "notificationCategorySubscriptions": [
        "ALL"
      ],
      "languageTag": "en-US"
    }
  ]
}

Gérer les contacts individuels

Vous pouvez gérer les contacts individuels sur la page Contacts essentiels dans Cloud Console ou via l'API REST.

Ajouter un contact

Pour ajouter un contact, procédez comme suit :

Console

  1. Dans Cloud Console, accédez à la page Contacts essentiels.

    Accéder à la page "Contacts essentiels"

  2. Assurez-vous que le nom de votre projet, dossier ou organisation apparaisse dans le sélecteur de projet en haut de la page. Le sélecteur de projet vous indique le projet, le dossier ou l'organisation pour lesquels vous gérez actuellement des contacts.

  3. Cliquez sur Ajouter un contact.

  4. Dans les champs Adresse e-mail et Confirmer l'adresse e-mail, saisissez l'adresse e-mail du contact.

  5. Dans le menu déroulant Catégories de notifications, sélectionnez les catégories de notifications pour lesquelles vous souhaitez que le contact reçoive des communications. Pour obtenir la liste des catégories de notifications et des contacts recommandés, consultez la section Identifier des contacts sur cette page.

  6. Cliquez sur Enregistrer.

REST

Pour ajouter un contact, utilisez la méthode contacts.create de l'API Contacts essentiels.

Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :

  • RESOURCE_TYPE : type de ressource pour lequel vous souhaitez répertorier les contacts. Utilisez la valeur projects, folders ou organizations.
  • RESOURCE_ID : ID du projet, de l'organisation ou du dossier Google Cloud.
  • EMAIL : adresse e-mail de votre contact. Vous ne pouvez pas modifier ce champ après avoir créé le contact.
  • NOTIFICATION_CATEGORY_1 et NOTIFICATION_CATEGORY_2 : les catégories de notifications pour lesquelles vous souhaitez que le contact reçoive les communications. Cette valeur peut être l'une des suivantes : ALL, BILLING, LEGAL, PRODUCT_UPDATES, SECURITY, SUSPENSION, TECHNICAL.

    Pour obtenir la liste des contacts recommandés pour chaque catégorie, consultez la section Identifier des contacts sur cette page.

  • LANGUAGE : code de langue de la langue préférée de notification du contact. Vous pouvez inclure le code de langue de n'importe laquelle des langues acceptées.

Requête :

POST essentialcontacts.googleapis.com/v1alpha1/RESOURCE_TYPE/RESOURCE_ID/contacts

Corps de la requête :

{
  "email": "EMAIL",
  "notificationCategorySubscriptions": [
    "NOTIFICATION_CATEGORY_1",
    "NOTIFICATION_CATEGORY_2"
  ],
  "languageTag": "LANGUAGE"
}

Pour envoyer votre requête, développez l'une des options suivantes :

Vous devriez recevoir une réponse JSON de ce type :

{
  "name": "projects/my-project/contacts/3",
  "email": "my-new-contact@my-domain.com",
  "notificationCategorySubscriptions": [
    "SUSPENSION",
    "TECHNICAL"
  ],
  "languageTag": "en"
}

Modifier un contact

Pour modifier les catégories auxquelles un contact est attribué, procédez comme suit :

Console

  1. Dans Cloud Console, accédez à la page Contacts essentiels.

    Accéder à la page "Contacts essentiels"

  2. Assurez-vous que le nom de votre projet, dossier ou organisation apparaisse dans le sélecteur de projet en haut de la page. Le sélecteur de projet vous indique le projet, le dossier ou l'organisation pour lesquels vous gérez actuellement des contacts.

  3. À côté de View by (Afficher par), sélectionnez Contact.

  4. Cliquez sur à côté du contact dont vous souhaitez modifier la catégorie.

  5. Sélectionnez les catégories de notifications de votre choix dans le menu déroulant Catégories de notifications, puis cliquez sur Enregistrer.

REST

Pour modifier les abonnements de notifications ou la langue préférée d'un contact existant, utilisez la méthode contacts.patch de l'API Contacts essentiels.

Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :

  • RESOURCE_TYPE : type de ressource pour lequel vous souhaitez répertorier les contacts. Utilisez la valeur projects, folders ou organizations.
  • RESOURCE_ID : ID du projet, de l'organisation ou du dossier Google Cloud.
  • CONTACT_ID : ID numérique de votre contact. Pour afficher les ID de tous les contacts de votre projet, dossier ou organisation, répertoriez vos contacts.
  • UPDATE_MASK : facultatif. Masque décrivant les champs du contact que vous avez modifiés. Le format du masque est une liste de noms de champs complets séparés par une virgule, par exemple : notificationCategorySubscriptions,languageTag.
  • EMAIL : adresse e-mail de votre contact. Ce champ doit correspondre à l'adresse e-mail associée à l'élément CONTACT_ID que vous incluez dans la requête.
  • NOTIFICATION_CATEGORY_1 et NOTIFICATION_CATEGORY_2 : facultatifs. Les catégories de notifications mises à jour pour lesquelles vous souhaitez que le contact reçoive les communications. Cette valeur peut être l'une des suivantes : ALL, BILLING, LEGAL, PRODUCT_UPDATES, SECURITY, SUSPENSION, TECHNICAL.

    Pour obtenir la liste des contacts recommandés pour chaque catégorie, consultez la section Identifier des contacts sur cette page.

  • LANGUAGE : code de langue de la langue préférée de notification du contact. Vous pouvez inclure le code de langue de n'importe laquelle des langues acceptées.

Requête :

PATCH essentialcontacts.googleapis.com/v1alpha1/RESOURCE_TYPE/RESOURCE_ID/contacts/CONTACT_ID?updateMask="UPDATE_MASK"

Corps de la requête :

{
  "name": "RESOURCE_TYPE/RESOURCE_ID/contact/CONTACT_ID",
  "email": "EMAIL",
  "notificationCategorySubscriptions": [
    "NOTIFICATION_CATEGORY_1",
    "NOTIFICATION_CATEGORY_2"
  ],
  "languageTag": "LANGUAGE"
}

Pour envoyer votre requête, développez l'une des options suivantes :

Vous devriez recevoir une réponse JSON de ce type :

{
  "name": "projects/my-project/contacts/2",
  "email": "my-new-contact@my-domain.com",
  "notificationCategorySubscriptions": [
    "ALL"
  ],
  "languageTag": "en"
}

Supprimer un contact

Pour supprimer un contact, procédez comme suit :

Console

  1. Dans Cloud Console, accédez à la page Contacts essentiels.

    Accéder à la page "Contacts essentiels"

  2. Assurez-vous que le nom de votre projet, dossier ou organisation apparaisse dans le sélecteur de projet en haut de la page. Le sélecteur de projet vous indique le projet, le dossier ou l'organisation pour lesquels vous gérez actuellement des contacts.

  3. À côté de View by (Afficher par), sélectionnez Contact.

  4. Cliquez sur à côté de l'adresse e-mail du contact que vous souhaitez supprimer. Dans la boîte de dialogue, confirmez que vous souhaitez supprimer le contact.

REST

Pour supprimer un contact, utilisez la méthode contacts.delete de l'API Contacts essentiels.

Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :

  • RESOURCE_TYPE : type de ressource pour lequel vous souhaitez répertorier les contacts. Utilisez la valeur projects, folders ou organizations.
  • RESOURCE_ID : ID du projet, de l'organisation ou du dossier Google Cloud.
  • CONTACT_ID : ID numérique de votre contact. Pour afficher les ID de tous les contacts de votre projet, dossier ou organisation, répertoriez vos contacts.

Requête :

DELETE essentialcontacts.googleapis.com/v1alpha1/RESOURCE_TYPE/RESOURCE_ID/contacts/CONTACT_ID

Pour envoyer votre requête, développez l'une des options suivantes :

Si la requête aboutit, le corps de la réponse est vide.

Gérer les contacts par catégorie

Dans Cloud Console, vous pouvez également gérer les contacts par catégorie en accédant à l'onglet Catégorie de la page Contacts essentiels.

Pour ajouter, modifier ou supprimer des contacts attribués à une seule catégorie, procédez comme suit :

  1. Dans Cloud Console, accédez à la page Contacts essentiels.

    Accéder à la page "Contacts essentiels"

  2. Assurez-vous que le nom de votre projet, dossier ou organisation apparaisse dans le sélecteur de projet en haut de la page. Le sélecteur de projet vous indique le projet, le dossier ou l'organisation pour lesquels vous gérez actuellement des contacts.

  3. À côté de View by (Afficher par), sélectionnez Category (Catégorie).

  4. Cliquez sur sur la même ligne que la catégorie dont vous souhaitez gérer les contacts.

  5. Gérez les contacts affectés à la catégorie :

    • Pour ajouter un contact, cliquez sur Ajouter un contact, puis suivez la procédure permettant d'ajouter un contact décrite sur cette page.
    • Pour modifier la catégorie à laquelle un contact est attribué, cliquez sur à côté du contact dont vous souhaitez modifier la catégorie. Puis, sélectionnez les catégories de notifications de votre choix dans le menu déroulant Catégories de notifications, puis cliquez sur Enregistrer.

    • Pour supprimer un contact, cliquez sur à côté de son adresse e-mail.

Étape suivante