Administración de contactos para las notificaciones

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

Enable the Essential Contacts API.

Enable the API

Roles obligatorios

Para obtener los permisos que necesitas para administrar contactos, pídele a tu administrador que te otorgue los siguientes roles de IAM en el proyecto, la carpeta o la organización a la que está asignado el contacto:

Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

Estos roles predefinidos contienen los permisos necesarios para administrar los contactos. Para ver los permisos exactos que son necesarios, expande la sección Permisos requeridos:

Permisos necesarios

Se requieren los siguientes permisos para administrar los contactos:

  • 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
    • essentialcontacts.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 en esa categoría van al contacto de resguardo, que se selecciona según las funciones de IAM de tus miembros. Recomendamos agregar contactos personalizados y no depender de los contactos de resguardo para garantizar que las personas correctas reciban notificaciones para tu proyecto, organización o carpeta.

Puedes agregar personas y grupos como contactos. Para reducir el impacto de los cambios del 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 vayan a 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, las notificaciones se envían al contacto de resguardo.

Categoría Descripción Ejemplos Contacto de resguardo Contacto recomendado
Todos Todas las notificaciones de las otras categorías N/A N/A Personas o sistemas automatizados responsables de enrutar o registrar una cantidad potencialmente grande 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 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 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
Técnico Eventos técnicos y otros problemas operativos Errores de configuración de registros, actualizaciones de la prevención de pérdida de datos y estado de Acciones en Google 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 eventos y problemas técnicos actuales y futuros para administrar mejor tus recursos de TI y evitar 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 la consola de Google Cloud, esta 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.

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

1 El nivel en el que asignas 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.

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

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

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:

Console

  1. En la consola de Google Cloud, 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 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.

gcloud

  1. In the Google Cloud console, activate Cloud Shell.

    Activate Cloud Shell

    At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.

  2. Con Google Cloud CLI, puedes enumerar los contactos definidos en un recurso o enumerar todos los contactos y los contactos heredados de un recurso.

    Cómo enumerar los contactos definidos en un recurso

    Para ver los contactos que se definieron en un proyecto, organización o carpeta, 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 IDs de carpeta y organización son numéricos, como 123456789012.

    Como alternativa, si no especificas un tipo de recurso o un ID, gcloud CLI muestra una lista de 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
    ---
    

    Cómo 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 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: Es una lista separada por comas de las categorías de notificaciones para las que quieres calcular contactos. La lista puede contener 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.
    • 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 IDs de carpeta y organización son numéricos, como 123456789012.

    Si no especificas un tipo de recurso y un ID, gcloud CLI enumera 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 Contactos esenciales, puedes enumerar los contactos que se definen en un recurso o enumerar todos los contactos y contactos heredados de un recurso.

Cómo enumerar los contactos definidos en un recurso

Para ver los contactos que se definieron 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. Los ID de proyecto son strings alfanuméricas, como my-project. Los IDs 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"
    }
  ]
}

Cómo 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. Los ID de proyecto son strings alfanuméricas, como my-project. Los IDs 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. 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/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 la consola de Google Cloud o mediante la API de REST.

Agrega un contacto

Para agregar un contacto, haz lo siguiente:

Console

  1. En la consola de Google Cloud, 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 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. Haz clic en Guardar.

gcloud

  1. In the Google Cloud console, activate Cloud Shell.

    Activate Cloud Shell

    At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.

  2. 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: Es 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 mostrará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: Es 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 para el que deseas crear un contacto. Usa el valor project, folder o organization.
    • RESOURCE_ID: El ID de la organización, carpeta y proyecto de Google Cloud. Los IDs de proyecto son cadenas alfanuméricas, como my-project. Los IDs de carpeta y organización son numéricos, como 123456789012.

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

    Si el comando se completa correctamente, no se muestra 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: Es 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 IDs 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 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/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:

Console

  1. En la consola de Google Cloud, 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 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.

gcloud

  1. In the Google Cloud console, activate Cloud Shell.

    Activate Cloud Shell

    At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.

  2. 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 IDs 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: Es una lista separada por comas de las categorías de notificaciones nuevas 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 mostrará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: Es 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 la que se define el contacto. Los IDs de proyecto son cadenas alfanuméricas, como my-project. Los IDs de carpeta y organización son numéricos, como 123456789012.

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

    Si el comando se completa correctamente, no se muestra 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 IDs de carpeta y organización son numéricos, como 123456789012.
  • CONTACT_ID: Es el ID numérico del contacto que deseas actualizar. Para ver los IDs 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 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/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:

Console

  1. En la consola de Google Cloud, 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 los 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

  1. In the Google Cloud console, activate Cloud Shell.

    Activate Cloud Shell

    At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.

  2. 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: Es el ID numérico del contacto que deseas borrar. Para ver los IDs 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 la que se define el contacto. Los IDs de proyecto son cadenas alfanuméricas, como my-project. Los IDs de carpeta y organización son numéricos, como 123456789012.

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

    Si el comando se completa correctamente, no se muestra 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 IDs 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 la consola de Google Cloud, 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 la consola de Google Cloud, 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 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.

Cómo verificar 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 la consola de Google Cloud, 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 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 que reciban correos electrónicos de prueba.

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

  6. Haz 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 haya 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 notificaciones. Los contactos tienen el siguiente formato en el lenguaje de Terraform:

resource "google_essential_contacts_contact" "contact" {
  parent = "RESOURCE_TYPE/RESOURCE_ID"
  email = "EMAIL"
  language_tag = "LANGUAGE"
  notification_category_subscriptions = NOTIFICATION_CATEGORIES
}

Cuando crees 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 IDs 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 Es el código de idioma de notificación preferido del contacto. Puedes incluir el código de idioma de cualquiera de los idiomas compatibles.
  • NOTIFICATION_CATEGORIES: Es un array de las categorías de notificaciones para las que deseas que el contacto reciba comunicaciones. Por ejemplo, ["BILLING", "LEGAL"].

    Este array puede contener cualquiera de los siguientes valores: 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.

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?