Administración de contactos para las notificaciones

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

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 Essential Contacts API.

Habilita la API

Roles requeridos

Para obtener los permisos que necesitas para administrar contactos, pídele a tu administrador que te otorgue las siguientes funciones de IAM en el proyecto, la carpeta o la organización donde se asigna el contacto:

  • Para ver los contactos: Visualizador de contactos esenciales (roles/essentialcontacts.viewer)
  • Para ver, editar, borrar y crear contactos, sigue estos pasos: Administrador de contactos esenciales (roles/essentialcontacts.admin)

Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso.

Estas funciones predefinidas contienen los permisos necesarios para administrar contactos. Para ver los permisos exactos que son necesarios, expande la sección Permisos requeridos:

Permisos necesarios

  • Para ver los contactos, haz lo siguiente:
    • essentialcontacts.contacts.get
    • essentialcontacts.contacts.list
  • Para editar, borrar y crear contactos, haz lo siguiente:
    • essentialcontacts.contacts.create
    • essentialcontacts.contacts.delete
    • essentialcontcts.contacts.update

También puedes obtener estos permisos con roles personalizados o con otros roles predefinidos.

Categorías de notificación

Puedes asignar contactos a varias categorías de notificaciones. Si no agregas un contacto a una categoría, las notificaciones de esa categoría se envían al contacto de resguardo, que se selecciona en función de tus funciones de IAM de miembros. Recomendamos agregar contactos personalizados y no depender de contactos de resguardo para garantizar que las personas correctas reciban notificaciones de tu proyecto, organización o carpeta.

Puedes agregar personas y grupos como contactos. Para reducir el impacto de los cambios en el personal, recomendamos agregar grupos 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 lleguen a los empleados activos.

Revisa la siguiente tabla para obtener información sobre las categorías de notificaciones, los contactos alternativos y los contactos recomendados. Si no asignas un contacto a una categoría determinada, se envían notificaciones al contacto de resguardo.

Categoría Descripción Ejemplos Contacto de resguardo Contacto recomendado
Todas Todas las notificaciones de las otras categorías No disponible No disponible Personas o sistemas automatizados que son responsables de enrutar o registrar una gran cantidad de notificaciones
Facturación Notificaciones de facturación y pagos Actualizaciones de precios, errores y 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 Notificaciones de cumplimiento 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 productos Cambios en los productos de Google 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 Notificaciones sobre problemas de seguridad o privacidad Vulnerabilidades, incidentes de datos y ataques 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
Suspension Notificaciones relacionadas con la suspensión inmediata de la cuenta y el proyecto Cumplimiento de la evaluación de Apigee, incumplimientos de los derechos de autor y minería de criptomonedas Propietario del proyecto (roles/owner) Personas directamente responsables de mantener en funcionamiento la infraestructura de TI y las aplicaciones empresariales
Beneficios técnicos Eventos técnicos y otros problemas operativos Registra los errores de configuración, las actualizaciones de prevención de pérdida de datos y el estado de Actions on Google Propietario del proyecto (roles/owner) Profesionales de TI, ingenieros de confiabilidad, administradores, listas de turnos y otras personas que necesitan conocer eventos y problemas técnicos actuales y futuros para administrar mejor tus recursos de TI y evitar interrupciones
Incidentes técnicos Para los clientes de Asistencia premium, una subcategoría de la categoría Técnica para las notificaciones de interrupciones Interrupciones no planificadas, problemas con el servicio No disponible Profesionales de TI, ingenieros de confiabilidad, administradores, listas de turnos y otras personas que necesitan reaccionar ante interrupciones

Lenguajes compatibles

En Contactos esenciales, cada contacto tiene una configuración de idioma preferida. Los creadores de notificaciones pueden hacer referencia a este parámetro de configuración cuando envían notificaciones.

Cuando agregas un contacto en Google Cloud Console, Google Cloud Console configura automáticamente el idioma preferido del contacto según la configuración de idioma preferido del creador del contacto. 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.

Prácticas recomendadas para 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
  • Suspension
  • Técnica2

1 El nivel en el que asignas 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 de proyecto. Sin embargo, si un grupo de toda la organización administra la seguridad de todos los proyectos, debes asignar tus contactos de seguridad a nivel de la organización.

2 Los contactos de categoría técnica reciben una gran cantidad de notificaciones por correo electrónico. Asigna estos contactos a nivel de carpeta o de proyecto para que puedan procesar el flujo de notificación entrante.

Asignando contactos para notificaciones de interrupciones y cortes

Si eres cliente de Asistencia premium, puedes asignar contactos para recibir notificaciones de interrupciones y interrupciones a través de la subcategoría Incidentes técnicos. Esto te permite dirigir notificaciones de interrupción de alto impacto a los contactos que necesitan enfocarse en interrupciones, sin la distracción de otras notificaciones técnicas.

Para asegurarte de que se envíen las notificaciones a los contactos adecuados, ten en cuenta el siguiente comportamiento de herencia cuando asignes contactos a la subcategoría Incidentes técnicos:

  • Si asignas un contacto de incidentes técnicos a un proyecto o carpeta, las notificaciones de interrupción solo se enviarán a:

    • El contacto Incidentes técnicos del proyecto o carpeta
    • Contactos de incidentes técnicos heredados de la organización o carpeta superior

  • Si no asignas un contacto de incidentes técnicos en un proyecto o carpeta, las notificaciones de interrupción se envían solo a:

    • El contacto Técnico del proyecto o carpeta
    • Contactos de incidentes técnicos heredados de la organización o carpeta superior

  • Si no se asigna o hereda un contacto del incidente técnico, no se envían notificaciones de interrupción.

Limita los dominios permitidos para los contactos

Para restringir los dominios de las direcciones de correo electrónico que pueden tener los contactos nuevos, establece la restricción de la política de la organización constraints/essentialcontacts.allowedContactDomains. Los contactos existentes no se ven afectados por esta restricción.

Para obtener información sobre cómo establecer restricciones de las políticas de la organización, consulta Restricciones de las políticas de la organización.

Enumera contactos

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

Consola

  1. En Google 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 recursos en la parte superior de la página. El selector de recursos te indica para qué proyecto, organización o carpeta administras actualmente contactos.

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

gcloud CLI

Con Google Cloud CLI, puedes enumerar los contactos que se definen en un recurso o enumerar todos los contactos y los contactos heredados para un recurso.

Enumera los contactos definidos en un recurso

Para ver los contactos que se definieron en un proyecto, una carpeta o una organización en particular, usa el comando gcloud essential-contacts list:

gcloud essential-contacts list --RESOURCE_TYPE="RESOURCE_ID"

Reemplaza los siguientes valores:

  • RESOURCE_TYPE: El tipo de recurso para el que deseas generar una lista de contactos. Usa el valor project, folder o organization.
  • RESOURCE_ID: El proyecto ID de la carpeta, la organización o el proyecto de Google Cloud. Los ID de proyecto son strings alfanuméricas, como my-project. Los ID de carpeta y organización son numéricos, como 123456789012.

Como alternativa, si no especificas un tipo de recurso o ID, la CLI de gcloud enumera los contactos para el proyecto actual.

La respuesta es similar al ejemplo a continuación:

---
email: my-contact-1@example.com
languageTag: en-US
name: projects/my-projects/contacts/1
notificationCategorySubscriptions:
- ALL
---
email: my-contact-2@example.com
languageTag: en-US
name: projects/my-projects/contacts/2
notificationCategorySubscriptions:
- BILLING
---

Enumera los contactos y los 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 los contactos heredados para un recurso, usa el comando gcloud essential-contacts compute:

gcloud essential-contacts compute --notification-categories="NOTIFICATION_CATEGORY" \
  --RESOURCE_TYPE="RESOURCE_ID"

Reemplaza los siguientes valores:

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

  • NOTIFICATION_CATEGORIES: Una lista separada por comas de las categorías de notificaciones para las que deseas calcular los contactos. La lista puede contener cualquiera de los siguientes valores: all, billing, legal, product-updates, security, suspension, technical, technical-incidents y notification-category-unspecified. Si eliges un valor de all, se enumerarán los contactos de todas las categorías.
  • RESOURCE_TYPE: El tipo de recurso para el que quieres calcular los contactos. Usa el valor project, folder o organization.
  • RESOURCE_ID: El proyecto ID de la carpeta, la organización o el proyecto de Google Cloud. Los ID de proyecto son strings alfanuméricas, como my-project. Los ID de carpeta y organización son numéricos, como 123456789012.

Si no especificas un tipo de recurso y un ID, la CLI de gcloud enumera los contactos para el proyecto actual.

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

---
email: my-contact-1@example.com
languageTag: en-US
name: projects/my-projects/contacts/1
notificationCategorySubscriptions:
- ALL
---
email: my-contact-2@example.com
languageTag: en-US
name: projects/my-projects/contacts/2
notificationCategorySubscriptions:
- BILLING
---
email: my-organization-contact@example.com
languageTag: en-US
name: organizations/my-organization/contacts/1
notificationCategorySubscriptions:
- ALL
---

REST

Con la API de REST de Essential Contacts, puedes enumerar los contactos que se definen en un recurso o enumerar todos los contactos y los contactos heredados de un recurso.

Enumera los contactos definidos en un recurso

Para ver los contactos que se definieron en un proyecto, una carpeta o una organización en particular, usa el método contacts.list de la API de Essentials Contacts.

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. Los ID de proyecto son strings alfanuméricas, como my-project. Los ID de carpeta y organización son numéricos, como 123456789012.
  • 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/v1/RESOURCE_TYPE/RESOURCE_ID/contacts?pageSize=PAGE_SIZE&pageToken=NEXT_PAGE_TOKEN

Para enviar tu solicitud, expande una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Ejecuta el siguiente comando: 

curl -X GET \
-H "Authorization: Bearer "$(gcloud auth application-default print-access-token) \
https://essentialcontacts.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/contacts?pageSize=PAGE_SIZE&pageToken=NEXT_PAGE_TOKEN

PowerShell (Windows)

Ejecuta el siguiente comando: 

$cred = gcloud auth application-default print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
  -Method GET `
  -Headers $headers `
  -Uri "https://essentialcontacts.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/contacts?pageSize=PAGE_SIZE&pageToken=NEXT_PAGE_TOKEN" | Select-Object -Expand Content

Después de enviar la solicitud, recibirás una respuesta JSON similar a la siguiente: 

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

Enumera los contactos y los 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. Los ID de proyecto son strings alfanuméricas, como my-project. Los ID de carpeta y organización son numéricos, como 123456789012.
  • 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. NOTIFICATION_CATEGORY puede ser cualquiera de los siguientes valores: ALL, BILLING, LEGAL, PRODUCT_UPDATES, SECURITY, SUSPENSION, TECHNICAL, TECHNICAL_INCIDENTS y NOTIFICATION_CATEGORY_UNSPECIFIED. Si eliges un valor de ALL, se enumerará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/v1/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:

curl (Linux, macOS o Cloud Shell)

Ejecuta el siguiente comando: 

curl -X GET \
-H "Authorization: Bearer "$(gcloud auth application-default print-access-token) \
https://essentialcontacts.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/contacts:compute?notificationCategories=NOTIFICATION_CATEGORY&pageSize=PAGE_SIZE&pageToken=NEXT_PAGE_TOKEN

PowerShell (Windows)

Ejecuta el siguiente comando: 

$cred = gcloud auth application-default print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
  -Method GET `
  -Headers $headers `
  -Uri "https://essentialcontacts.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/contacts:compute?notificationCategories=NOTIFICATION_CATEGORIES&pageSize=PAGE_SIZE&pageToken=NEXT_PAGE_TOKEN" | Select-Object -Expand Content

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@example.com",
      "notificationCategorySubscriptions": [
        "ALL"
      ],
      "languageTag": "en-US"
    },
    {
      "name": "projects/my-projects/contacts/2",
      "email": "my-project-contact-2@example.com",
      "notificationCategorySubscriptions": [
        "BILLING"
      ],
      "languageTag": "en-US"
    },
    {
      "name": "organizations/my-organization/contacts/1",
      "email": "my-organization-contact@example.com",
      "notificationCategorySubscriptions": [
        "ALL"
      ],
      "languageTag": "en-US"
    }
  ]
}

Cómo administrar contactos esenciales individuales

Puedes agregar contactos, quitarlos o asignarles categorías de notificaciones en la página Contactos esenciales de Google Cloud Console o mediante la API de REST.

Agrega un contacto

Para agregar un contacto, haz lo siguiente:

Consola

  1. En Google 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 recursos en la parte superior de la página. El selector de recursos te indica para qué proyecto, organización o carpeta administras actualmente 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. Haz clic en Guardar.

gcloud CLI

Para agregar un contacto nuevo, usa el comando gcloud essential-contacts create:

gcloud essential-contacts create --email="EMAIL" \
  --notification-categories="NOTIFICATION_CATEGORIES" \
  --language="LANGUAGE"
  --RESOURCE_TYPE="RESOURCE_ID"

Reemplaza los siguientes valores:

  • EMAIL: La dirección de correo electrónico de tu contacto. No puedes cambiar este campo después de crear tu contacto.

  • NOTIFICATION_CATEGORIES: Una lista separada por comas de las categorías de notificación para las que deseas que el contacto reciba comunicaciones. La lista puede contener cualquiera de los siguientes valores: all, billing, legal, product-updates, security, suspension, technical, technical-incidents y notification-category-unspecified. Si eliges un valor de all, se enumerarán los contactos de todas las categorías.

    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.

  • RESOURCE_TYPE: El tipo de recurso para el que deseas crear un contacto. Usa el valor project, folder o organization.

  • RESOURCE_ID: El proyecto ID de la carpeta, la organización o el proyecto de Google Cloud. Los ID de proyecto son strings alfanuméricas, como my-project. Los ID de carpeta y organización son numéricos, como 123456789012.

Si no especificas un tipo de recurso y un ID, la CLI de gcloud crea un contacto en el proyecto actual.

Si el comando se ejecuta de forma correcta, no se mostrará ninguna respuesta.

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 crear un contacto. Usa el valor projects, folders o organizations.
  • RESOURCE_ID: El proyecto ID de la carpeta, la organización o el proyecto de Google Cloud. Los ID de proyecto son strings alfanuméricas, como my-project. Los ID de carpeta y organización son numéricos, como 123456789012.
  • 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 los siguientes: ALL, BILLING, LEGAL, PRODUCT_UPDATES, SECURITY, SUSPENSION, TECHNICAL, TECHNICAL_INCIDENTS.

    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/v1/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:

Después de enviar la solicitud, recibirás una respuesta JSON similar a la siguiente: 

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

Cambia un contacto

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

Consola

  1. En Google 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 recursos en la parte superior de la página. El selector de recursos te indica para qué proyecto, organización o carpeta administras actualmente 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.

gcloud CLI

Para actualizar un contacto existente, usa el comando gcloud essential-contacts update:

gcloud essential-contacts update CONTACT_ID \
  --notification-categories="NOTIFICATION_CATEGORIES" \
  --language="LANGUAGE"
  --RESOURCE_TYPE="RESOURCE_ID"

Reemplaza los siguientes valores:

  • CONTACT_ID: El ID numérico del contacto que deseas actualizar. Para ver los ID de todos los contactos de tu proyecto, organización o carpeta, enumera tus contactos. El ID numérico es todo lo que se encuentra después de contacts en el nombre del contacto.

  • NOTIFICATION_CATEGORIES: Una lista separada por comas de las nuevas categorías de notificaciones para las que deseas que el contacto reciba comunicaciones. Esta lista reemplazará la lista existente de categorías de notificaciones.

    La lista puede contener cualquiera de los siguientes valores: all, billing, legal, product-updates, security, suspension, technical, technical-incidents y notification-category-unspecified. Si eliges un valor de all, se enumerarán los contactos de todas las categorías.

    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.

  • RESOURCE_TYPE: Es el tipo de recurso en el que se define el contacto. Usa el valor project, folder o organization.

  • RESOURCE_ID: Es el ID del proyecto, la organización o la carpeta de Google Cloud en el que se define el contacto. Los ID de proyecto son strings alfanuméricas, como my-project. Los ID de carpeta y organización son numéricos, como 123456789012.

Si no especificas un tipo de recurso y un ID, la CLI de gcloud actualiza el contacto con el ID especificado en el proyecto actual. Si no existe ningún contacto con el ID especificado, la CLI de gcloud muestra un error.

Si el comando se ejecuta de forma correcta, no se mostrará ninguna respuesta.

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. Los ID de proyecto son strings alfanuméricas, como my-project. Los ID de carpeta y organización son numéricos, como 123456789012.
  • CONTACT_ID: El ID numérico del contacto que deseas actualizar. Para ver los ID de todos los contactos de tu proyecto, organización o carpeta, enumera tus contactos. El ID numérico es todo lo que se encuentra después de contacts en el nombre del contacto.
  • 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 los siguientes: ALL, BILLING, LEGAL, PRODUCT_UPDATES, SECURITY, SUSPENSION, TECHNICAL o TECHNICAL_INCIDENTS.

    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/v1/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:

Después de enviar la solicitud, recibirás una respuesta JSON similar a la siguiente: 

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

Borra un contacto

Para borrar un conacto, haz lo siguiente:

Consola

  1. En Google 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 recursos en la parte superior de la página. El selector de recursos te indica para qué proyecto, organización o carpeta administras actualmente contactos.

  3. Junto a Ver por, selecciona Contacto.

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

gcloud CLI

Para borrar un contacto existente, usa el comando gcloud essential-contacts delete:

gcloud essential-contacts delete CONTACT_ID \
  --RESOURCE_TYPE="RESOURCE_ID"

Reemplaza los siguientes valores:

  • CONTACT_ID: El ID numérico del contacto que deseas borrar Para ver los ID de todos los contactos de tu proyecto, organización o carpeta, enumera tus contactos. El ID numérico es todo lo que se encuentra después de contacts en el nombre del contacto.
  • RESOURCE_TYPE: Es el tipo de recurso en el que se define el contacto. Usa el valor project, folder o organization.
  • RESOURCE_ID: Es el ID del proyecto, la organización o la carpeta de Google Cloud en el que se define el contacto. Los ID de proyecto son strings alfanuméricas, como my-project. Los ID de carpeta y organización son numéricos, como 123456789012.

Si no especificas un tipo de recurso y un ID, la CLI de gcloud borra el contacto con el ID especificado en el proyecto actual. Si no existe ningún contacto con el ID especificado, la CLI de gcloud muestra un error.

Si el comando se ejecuta de forma correcta, no se mostrará ninguna respuesta.

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. Los ID de proyecto son strings alfanuméricas, como my-project. Los ID de carpeta y organización son numéricos, como 123456789012.
  • 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/v1/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 Google 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 Google 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 recursos en la parte superior de la página. El selector de recursos te indica para qué proyecto, organización o carpeta administras actualmente 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.

Verifica transmisiones de correo electrónico

Puedes enviar un correo electrónico de prueba a los contactos de cada categoría para verificar si las cuentas de correo electrónico pueden recibir correos electrónicos de Google Cloud.

Para enviar un correo electrónico de prueba a los contactos de una categoría específica, haz lo siguiente:

  1. En Google 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 recursos en la parte superior de la página. El selector de recursos muestra el proyecto, la carpeta o la organización para la que administras contactos actualmente.

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

  4. Haz clic en en la misma fila que la categoría cuyos contactos quieres enviar correos electrónicos de prueba.

  5. Selecciona las casillas de verificación junto a los contactos a los que deseas enviar los correos electrónicos.

  6. Haga clic en Enviar. Se enviará un correo electrónico de prueba a los contactos seleccionados.

  7. Comunícate con cada contacto para asegurarte de que hayan recibido un correo electrónico de prueba de gcp-essential-contacts-noreply@google.com.

Administra contactos con Terraform

Puedes usar Terraform para administrar tus contactos de notificación. Los contactos tienen el siguiente formato en el lenguaje de Terraform:

resource "google_essential_contacts_contact" "contact" {
  provider = google-beta
  parent = "<var>RESOURCE_TYPE</var>/<var>RESOURCE_ID</var>"
  email = "<var>EMAIL</var>"
  language_tag = "<var>LANGUAGE</var>"
  notification_category_subscriptions = <var>NOTIFICATION_CATEGORIES</var>
}

Al crear un contacto, reemplaza los siguientes valores:

  • 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. Los ID de proyecto son strings alfanuméricas, como my-project. Los ID de carpeta y organización son numéricos, como 123456789012.
  • EMAIL: La dirección de correo electrónico de tu contacto. No puedes cambiar este campo después de crear tu contacto.
  • LANGUAGE: Opcional El código de idioma del idioma de notificación preferido del contacto. Puedes incluir el código de idioma de cualquiera de los idiomas compatibles.

  • NOTIFICATION_CATEGORIES: Es un arreglo de las categorías de notificación para las que deseas que el contacto reciba comunicaciones. Por ejemplo, ["BILLING", "LEGAL"].

    Este arreglo puede contener cualquiera de los siguientes valores: ALL, BILLING, LEGAL, PRODUCT_UPDATES, SECURITY, SUSPENSION, TECHNICAL, TECHNICAL_INCIDENTS.

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

Para agregar, modificar o quitar un contacto, agrega, modifica o quita un recurso de contacto en tu archivo de configuración de Terraform.

Para obtener más detalles, consulta la documentación de contactos esenciales de Terraform.

¿Qué sigue?