Administración de contactos para las notificaciones

Muchos servicios de Google Cloud, como la Facturación de Cloud, envían notificaciones para compartir información importante con los usuarios de Google Cloud. Según la configuración predeterminada, estas notificaciones se envían a los miembros con determinadas funciones de administración de identidades y accesos (IAM). Con los contactos esenciales, puedes personalizar quién recibe notificaciones si proporcionas tu propia lista de contactos.

Antes de comenzar

Habilita las Essential Contacts API.

Habilita la API

Permisos necesarios

Los permisos que necesitas para usar contactos esenciales varían según lo que desees hacer.

Permisos para ver contactos

Para ver los contactos, necesitas una función que incluya los siguientes permisos:

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

Para obtener estos permisos y seguir el principio de privilegio mínimo, pídele a tu administrador que te otorgue la función de Visualizador de contactos esenciales (roles/essentialContacts.viewer).

Como alternativa, el administrador puede otorgarte una función diferente con los permisos necesarios, como una función personalizada o una función predefinida con más permisos.

Asegúrate de otorgar estas funciones en el proyecto, la carpeta o la organización a la que se asigna el contacto.

Permisos para administrar contactos

Para editar, borrar y crear contactos, necesitas una función que incluya los siguientes permisos:

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

Para obtener estos permisos y seguir el principio de privilegio mínimo, pídele a tu administrador que te otorgue la función de Administrador de contactos esenciales (roles/essentialContacts.admin).

Como alternativa, el administrador puede otorgarte una función diferente con los permisos necesarios, como una función personalizada o una función predefinida con más permisos.

Asegúrate de otorgar estas funciones en el proyecto, la carpeta o la organización a la que se asigna el contacto.

Categorías de notificación

Existen varias categorías diferentes de notificaciones para las que puedes asignar contactos. Si no agregas un contacto para una categoría, las notificaciones en esa categoría van al contacto predeterminado, que se selecciona según las funciones de IAM de tus miembros. Recomendamos agregar contactos personalizados y no depender de los contactos predeterminados, a fin de garantizar que las personas correctas reciban notificaciones para tu proyecto, organización o carpeta.

Puedes agregar personas y grupos de Google como contactos. Para reducir el impacto de los cambios del personal, recomendamos agregar Grupos de Google como contactos y, luego, administrar la membresía de esos grupos para determinar quién recibe notificaciones. Esta práctica ayuda a garantizar que las notificaciones siempre vayan a empleados activos.

Revisa la siguiente tabla para obtener información sobre las categorías de notificaciones, el contacto predeterminado y el contacto recomendado. Usa esta información a fin de seleccionar los contactos adecuados para cada categoría.

Categoría Descripción Contacto predeterminado Contacto recomendado
Todos Todas las notificaciones relacionadas con el recurso Ninguna Personas o sistemas automáticos responsables de enrutamientos o notificaciones de registros
Facturación Notificaciones de facturación y pagos, actualizaciones de precios, errores, créditos Administrador de cuentas de facturación (roles/billing.admin) Personal del departamento de finanzas y personas que administran tu relación financiera con Google, como personas que administran presupuestos, planes y cuentas relacionadas con el uso de Google Cloud
Legal Acciones de aplicaciones forzosas, cumplimiento de las normativas, avisos gubernamentales Administrador de cuentas de facturación (roles/billing.admin) Asesor legal, administradores de cumplimiento, especialistas en relaciones gubernamentales y otros profesionales relacionados
Actualizaciones de producto Versiones nuevas, actualizaciones de las condiciones de los productos y bajas Propietario del proyecto (roles/owner) Administradores de productos, arquitectos y ingenieros que pueden beneficiarse de la información oportuna sobre cambios en los productos y servicios de Google
Seguridad Problemas de privacidad y seguridad, notificaciones y vulnerabilidades Administrador de la organización (roles/resourcemanager.organizationAdmin) Seguridad de TI, seguridad de operaciones y otras personas cuyo trabajo es proteger la empresa y los datos de tus clientes, y garantizar la continuidad del negocio
Suspensión Notificaciones relacionadas con la suspensión inmediata de la cuenta Propietario del proyecto (roles/owner) Personas directamente responsables de mantener en funcionamiento la infraestructura de TI y las aplicaciones empresariales
Técnico Interrupciones, errores, fallas y otros problemas técnicos Propietario del proyecto (roles/owner) Los profesionales de TI, los ingenieros de confiabilidad, los administradores, las listas de turnos y otras personas que necesitan conocer los problemas técnicos actuales y futuros y los eventos que pueden hacer que tus recursos de TI funcionen de forma incorrecta

Idiomas admitidos

En contactos esenciales, cada contacto tiene una configuración de idioma preferida. Los creadores de notificaciones pueden hacer referencia a esta configuración cuando envían notificaciones.

Cuando agregas un contacto en Cloud Console, se configura automáticamente el idioma preferido del contacto según la configuración de idioma preferida del creador de contactos. Cuando agregas un contacto con la API, configuras manualmente el idioma preferido del contacto mediante un código de idioma. Este código de idioma puede referirse a cualquiera de los idiomas que admiten los contactos esenciales.

Decide a dónde asignar contactos

Puedes asignar contactos a nivel de proyecto, organización o carpeta.

Los contactos se heredan a través de la jerarquía de recursos de Google Cloud. Como resultado, si agregas un contacto a nivel de la organización, estos recibirán notificaciones para la organización y para todas las carpetas y proyectos de la organización. Del mismo modo, si agregas un contacto a nivel de la carpeta, recibirán las notificaciones de la carpeta y de todos los proyectos que contiene.

La decisión de asignar contactos depende de la estructura de tu organización. Sin embargo, generalmente recomendamos asignar contactos a los siguientes niveles, según su categoría de notificación:

Nivel recomendado Categoría de notificaciones
Nivel de organización.
  • Facturación
  • Legal
  • Seguridad1
Nivel de carpeta o proyecto
  • Todos
  • Actualizaciones de producto
  • Seguridad1
  • Suspensión
  • Técnico

1 El nivel en el que debes asignar los contactos de seguridad depende de las prácticas de seguridad específicas de tu organización. Por ejemplo, si los propietarios de proyectos individuales están a cargo de la seguridad de sus propios proyectos, debes asignar tus contactos de seguridad a nivel del proyecto. Sin embargo, si un grupo de toda la organización administra la seguridad de todos los proyectos, tendrías que asignarles contactos de seguridad a nivel de la organización.

Enumera contactos

Para mostrar una lista de todos los contactos de tu proyecto, organización o carpeta, haz lo siguiente:

Console

  1. En Cloud Console, ve a la página Contactos esenciales.

    Ir a la página Contactos esenciales

  2. Asegúrate de que el nombre de tu proyecto, organización o carpeta aparezca en el selector de proyectos en la parte superior de la página. El selector de proyectos te indica para qué proyecto, organización o carpeta administras los contactos.

  3. Para ver una lista de contactos por categoría, selecciona Categoría. Para enumerar los contactos de forma alfabética, selecciona Contactos.

REST

Enumera contactos

Para ver los contactos que se configuraron en un proyecto, organización o carpeta, usa el método contacts.list de la API de contactos esenciales.

Antes de usar cualquiera de los datos de solicitud que aparecen a continuación, realiza los siguientes reemplazos:

  • RESOURCE_TYPE: El tipo de recurso para el que deseas generar una lista de contactos. Usa el valor projects, folders o organizations.
  • RESOURCE_ID: El proyecto ID de la carpeta, la organización o el proyecto de Google Cloud.
  • PAGE_SIZE: Opcional Es la cantidad de contactos que se deben incluir en la respuesta. El valor predeterminado es 50 y el valor máximo es 100. Si la cantidad de contactos es mayor que el tamaño de la página, la respuesta contiene un token de paginación que puedes usar para consultar la siguiente página de resultados.
  • NEXT_PAGE_TOKEN: Opcional Es el token de paginación que se mostró en una respuesta anterior de este método. Si se especifica, la lista de contactos comenzará donde termina la respuesta anterior.

Solicitud:

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

Para enviar tu solicitud, expande una de estas opciones:

Deberías recibir una respuesta JSON similar a la que se muestra a continuación:

{
  "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"
    }
  ]
}

Enumerar contactos y contactos heredados

Los recursos secundarios (carpetas y proyectos) heredan los contactos de sus principales (organizaciones y otras carpetas). Si deseas enumerar todos los contactos y contactos heredados de un recurso, usa el método contacts.compute de la API de contactos esenciales.

Antes de usar cualquiera de los datos de solicitud que aparecen a continuación, realiza los siguientes reemplazos:

  • RESOURCE_TYPE: El tipo de recurso para el que quieres calcular los contactos. Usa el valor projects, folders o organizations.
  • RESOURCE_ID: El proyecto ID de la carpeta, la organización o el proyecto de Google Cloud.
  • NOTIFICATION_CATEGORY: Las categorías de notificaciones para las que quieres calcular contactos. Puedes repetir este campo para enumerar los contactos de varias categorías de notificación. La NOTIFICATION_CATEGORY Puede ser cualquiera de los siguientes valores:ALL, BILLING, LEGAL, PRODUCT_UPDATES, SECURITY, SUSPENSION, TECHNICAL y NOTIFICATION_CATEGORY_UNSPECIFIED. Si eliges un valor de ALL, se mostrarán los contactos de todas las categorías.
  • PAGE_SIZE: Opcional Es la cantidad de contactos que se deben incluir en la respuesta. El valor predeterminado es 50 y el valor máximo es 100. Si la cantidad de contactos es mayor que el tamaño de la página, la respuesta contiene un token de paginación que puedes usar para consultar la siguiente página de resultados.
  • NEXT_PAGE_TOKEN: Opcional Es el token de paginación que se mostró en una respuesta anterior de este método. Si se especifica, la lista de contactos comenzará donde termina la respuesta anterior.

Solicitud:

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

Para enviar tu solicitud, expande una de estas opciones:

En la respuesta, se enumeran todos los contactos y contactos heredados del recurso:

{
  "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"
    }
  ]
}

Administración de contactos individuales

Puedes administrar los contactos individuales en la página Contactos esenciales de Cloud Console o mediante la API de REST.

Agrega un contacto

Para agregar un contacto, haz lo siguiente:

Console

  1. En Cloud Console, ve a la página Contactos esenciales.

    Ir a la página Contactos esenciales

  2. Asegúrate de que el nombre de tu proyecto, organización o carpeta aparezca en el selector de proyectos en la parte superior de la página. El selector de proyectos te indica para qué proyecto, organización o carpeta administras los contactos.

  3. Haz clic en Agregar contacto.

  4. En los campos Correo electrónico y Confirmar correo electrónico, ingresa la dirección de correo electrónico del contacto.

  5. En el menú desplegable Categorías de notificaciones, selecciona las categorías de notificación con las que deseas que el contacto reciba comunicaciones. Para obtener una lista de categorías de notificaciones y contactos recomendados, consulta Identifica contactos en esta página.

  6. Haga clic en Save.

REST

Para agregar un contacto nuevo, usa el método contacts.create de la API de contactos esenciales.

Antes de usar cualquiera de los datos de solicitud que aparecen a continuación, realiza los siguientes reemplazos:

  • RESOURCE_TYPE: El tipo de recurso para el que deseas generar una lista de contactos. Usa el valor projects, folders o organizations.
  • RESOURCE_ID: El proyecto ID de la carpeta, la organización o el proyecto de Google Cloud.
  • EMAIL: La dirección de correo electrónico de tu contacto. No puedes cambiar este campo después de crear tu contacto.
  • NOTIFICATION_CATEGORY_1 y NOTIFICATION_CATEGORY_2: Las categorías de notificaciones para las que deseas que el contacto reciba comunicaciones. Este valor puede ser cualquiera de las siguientes opciones: ALL, BILLING, LEGAL, PRODUCT_UPDATES, SECURITY, SUSPENSION y TECHNICAL.

    Para obtener una lista de contactos recomendados de cada categoría, consulta Identifica contactos en esta página.

  • LANGUAGE: El código de idioma de notificación preferido de tu contacto. Puedes incluir el código de idioma de cualquiera de los idiomas compatibles.

Solicitud:

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

Cuerpo de la solicitud:

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

Para enviar tu solicitud, expande una de estas opciones:

Deberías recibir una respuesta JSON similar a la que se muestra a continuación:

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

Cambia un contacto

Para cambiar las categorías a las que se asigna un contacto, haz lo siguiente:

Console

  1. En Cloud Console, ve a la página Contactos esenciales.

    Ir a la página Contactos esenciales

  2. Asegúrate de que el nombre de tu proyecto, organización o carpeta aparezca en el selector de proyectos en la parte superior de la página. El selector de proyectos te indica para qué proyecto, organización o carpeta administras los contactos.

  3. Junto a Ver por, selecciona Contacto.

  4. Haz clic en junto al contacto cuya categoría deseas cambiar.

  5. Selecciona las categorías de notificaciones que quieras en el menú desplegable Categorías de notificación y haz clic en Guardar.

REST

Para cambiar las suscripciones de notificación o el idioma preferido de un contacto existente, usa el método contacts.patch de la API de contactos esenciales.

Antes de usar cualquiera de los datos de solicitud que aparecen a continuación, realiza los siguientes reemplazos:

  • RESOURCE_TYPE: El tipo de recurso para el que deseas generar una lista de contactos. Usa el valor projects, folders o organizations.
  • RESOURCE_ID: El proyecto ID de la carpeta, la organización o el proyecto de Google Cloud.
  • CONTACT_ID: El ID numérico de tu contacto. Para ver los ID de todos los contactos de tu proyecto, organización o carpeta, Enumera tus contactos.
  • UPDATE_MASK: Opcional Una máscara que describe qué campos del contacto modificaste. El formato de la máscara es una lista separada por comas de nombres de campos completamente calificados, por ejemplo: notificationCategorySubscriptions,languageTag.
  • EMAIL: La dirección de correo electrónico de tu contacto. Este campo debe coincidir con la dirección de correo electrónico asociada con el CONTACT_ID que incluyas en la solicitud.
  • NOTIFICATION_CATEGORY_1 y NOTIFICATION_CATEGORY_2: opcional. Las categorías de notificación actualizadas para las que quieres que reciba el contacto. Este valor puede ser cualquiera de las siguientes opciones: ALL, BILLING, LEGAL, PRODUCT_UPDATES, SECURITY, SUSPENSION y TECHNICAL.

    Para obtener una lista de contactos recomendados de cada categoría, consulta Identifica contactos en esta página.

  • LANGUAGE: El código de idioma de notificación preferido del contacto. Puedes incluir el código de idioma de cualquiera de los idiomas compatibles.

Solicitud:

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

Cuerpo de la solicitud:

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

Para enviar tu solicitud, expande una de estas opciones:

Deberías recibir una respuesta JSON similar a la que se muestra a continuación:

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

Borra un contacto

Para borrar un conacto, haz lo siguiente:

Console

  1. En Cloud Console, ve a la página Contactos esenciales.

    Ir a la página Contactos esenciales

  2. Asegúrate de que el nombre de tu proyecto, organización o carpeta aparezca en el selector de proyectos en la parte superior de la página. El selector de proyectos te indica para qué proyecto, organización o carpeta administras los contactos.

  3. Junto a Ver por, selecciona Contacto.

  4. Haz clic en junto a esa dirección de correo electrónico del contacto que deseas borrar. En el cuadro de diálogo, confirma que deseas borrar el contacto.

REST

Para borrar un contacto, usa el método contacts.delete de la API de contactos esenciales.

Antes de usar cualquiera de los datos de solicitud que aparecen a continuación, realiza los siguientes reemplazos:

  • RESOURCE_TYPE: El tipo de recurso para el que deseas generar una lista de contactos. Usa el valor projects, folders o organizations.
  • RESOURCE_ID: El proyecto ID de la carpeta, la organización o el proyecto de Google Cloud.
  • CONTACT_ID: El ID numérico de tu contacto. Para ver los ID de todos los contactos de tu proyecto, organización o carpeta, Enumera tus contactos.

Solicitud:

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

Para enviar tu solicitud, expande una de estas opciones:

Si la solicitud se realiza de forma correcta, el cuerpo de la respuesta estará vacío.

Administra contactos por categoría

En Cloud Console, también puedes administrar los contactos por categoría en la pestaña Categoría de la página Contactos esenciales.

Para agregar, cambiar o borrar los contactos asignados a una sola categoría, haz lo siguiente:

  1. En Cloud Console, ve a la página Contactos esenciales.

    Ir a la página Contactos esenciales

  2. Asegúrate de que el nombre de tu proyecto, organización o carpeta aparezca en el selector de proyectos en la parte superior de la página. El selector de proyectos te indica para qué proyecto, organización o carpeta administras los contactos.

  3. Junto a Ver por, selecciona Categoría.

  4. Haz clic en en la misma fila de la categoría cuyos contactos deseas administrar.

  5. Administra los contactos asignados a la categoría:

    • Para agregar un contacto nuevo, haz clic en Agregar contacto y, luego, sigue los pasos para agregar un contacto que se describe en esta página.
    • Para cambiar la categoría a la que se asigna un contacto, haz clic en junto al contacto cuya categoría deseas cambiar. Luego, selecciona las categorías de notificación que quieras en el menú desplegable Categorías de notificación y haz clic en Guardar.

    • Para borrar un contacto, haz clic en junto a la dirección de correo electrónico de ese contacto.

¿Qué sigue?