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

Habilita la API

Funciones requeridas

A fin de obtener los permisos que necesitas para administrar los contactos, pídele al administrador que te otorgue las siguientes funciones de IAM en el proyecto, la carpeta o la organización en que se asignó el contacto:

  • Para ver los contactos: Visualizador de contactos esenciales (roles/essentialcontacts.viewer)
  • Para ver, editar, borrar y crear contactos, haz lo siguiente: 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 según tus funciones de IAM. Recomendamos agregar contactos personalizados y no depender de los contactos de resguardo para garantizar que las personas correctas reciban las notificaciones de tu organización, carpeta o proyecto.

Puedes agregar personas y grupos como contactos. A fin de reducir el impacto de los cambios de 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 se dirijan a los empleados activos.

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

Categoría Descripción Ejemplos Contacto de resguardo Contacto recomendado
Todos Todas las notificaciones de las demás categorías No disponible No disponible Personas o sistemas automatizados 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 producto 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
Security Notificaciones de 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
Suspensión Notificaciones relacionadas con la suspensión inmediata de la cuenta y del 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 Errores de configuración de registro, actualizaciones de prevención de pérdida de datos y 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 estar al tanto de los eventos 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 notificaciones de interrupción 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 a interrupciones

Lenguajes compatibles

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

Cuando agregas un contacto a Cloud Console, esta consola configura automáticamente el idioma de preferencia del contacto en función de su configuración de idioma preferida. 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
  • Suspensión
  • Técnicas2

1 El nivel al 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 en 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 proyecto para permitirles procesar el flujo de notificaciones entrantes.

Asignar contactos para notificaciones de interrupciones y interrupciones

Si eres cliente de la Asistencia premium, puedes asignar contactos para que reciban notificaciones de interrupciones y de interrupciones a través de la subcategoría Incidentes técnicos. Esto te permite dirigir las 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 las notificaciones se envíen 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 técnico de incidentes en un proyecto o una carpeta, las notificaciones de interrupción solo se envían a las siguientes ubicaciones:

    • Contacto de incidentes técnicos del proyecto o la carpeta
    • Contactos heredados de incidentes técnicos de la organización o carpeta superior
  • Si no asignas un contacto técnico de incidentes en un proyecto o una carpeta, las notificaciones de interrupción solo se envían a los siguientes destinos:

    • El contacto Técnico del proyecto o la carpeta
    • Contactos heredados de incidentes técnicos de la organización o carpeta superior
  • Si no se asigna o se hereda un contacto de incidente técnico, no se envían notificaciones de interrupción.

Limitar 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. Esta restricción no afecta a los contactos existentes.

Para aprender a establecer restricciones de las políticas de la organización, consulta la página sobre 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:

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 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

Con la CLI de Google Cloud, puedes enumerar los contactos que se definen en un recurso, o bien 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 una organización, carpeta o proyecto específico, 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.

De manera alternativa, si no especificas un tipo de recurso o un 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 contactos heredados de 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 enumeran los contactos para 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 muestra los contactos del 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 bien 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, organización o carpeta específicos, usa el método contacts.list de la API de Essential 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 de 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 enumeran los contactos para 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 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 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

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 notificaciones 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 enumeran los contactos para 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 quieres 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 correctamente, 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 quieres 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 y 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 de 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:

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 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

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 sigue a 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 enumeran los contactos para 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 en el que se define el contacto. Usa los valores project, folder o organization.

  • RESOURCE_ID: 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 correctamente, 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 sigue a 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 y 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 de 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:

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 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 diálogo, confirma que deseas borrar el contacto.

gcloud

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 sigue a contacts en el nombre del contacto.
  • RESOURCE_TYPE: El tipo de recurso en el que se define el contacto. Usa los valores project, folder o organization.
  • RESOURCE_ID: 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 correctamente, 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 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 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 las 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 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 actualmente los contactos.

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

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

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

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

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

Cómo administrar contactos con Terraform

Puede usar Terraform para administrar sus contactos de notificaciones. Los contactos tienen el siguiente formato en el lenguaje 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>
}

Cuando cree un contacto, reemplace 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 del contacto preferido Puedes incluir el código de idioma de cualquiera de los idiomas compatibles.
  • NOTIFICATION_CATEGORIES: Es un arreglo de las categorías de notificaciones por 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 y 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.

Si desea obtener más detalles, consulte la documentación de Contactos esenciales de Terraform.

¿Qué sigue?