Administrar contactos esenciales

Console

1. En la consola de Trusted 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 de la página. El selector de recursos te permite seleccionar el proyecto, la carpeta o la organización desde los que deseas ver los Contactos esenciales.

3. Junto a Ver por, puedes elegir una de las siguientes opciones:

   • Para ver la lista de contactos por categoría, selecciona Categoría.
   • Para ver la lista de contactos en orden alfabético, selecciona Contacto.

gcloud

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

   Activate Cloud Shell

   At the bottom of the Trusted 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 todos los contactos y los contactos heredados de un recurso.

   Enumera los contactos definidos en un recurso

   Para ver los contactos esenciales definidos en un proyecto, organización o carpeta específicos, usa el comando gcloud essential-contacts list:

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

   Reemplaza lo siguiente:

   • RESOURCE_TYPE: Es el tipo de recurso del que deseas generar una lista de contactos. Usa el valor project, folder o organization.
   • RESOURCE_ID: Tu Trusted Cloud proyecto, organización o ID de carpeta. Los IDs de proyecto son cadenas alfanuméricas, como my-project. Los IDs de carpeta y organización son numéricos, como 123456789012.

   Como alternativa, si no especificas un tipo o ID de recurso, gcloud CLI mostrará una lista de los contactos del proyecto actual.

   La respuesta es similar al siguiente ejemplo:

   ---
   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 contactos y contactos heredados

   Si deseas enumerar todos los contactos de un recurso y sus contactos heredados de un principal, debes tener un rol en el recurso principal que incluya los permisos requeridos para ver los contactos. Luego, usa el comando gcloud essential-contacts compute:

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

   Reemplaza lo siguiente:

   • NOTIFICATION_CATEGORY: Es una lista separada por comas de las categorías de notificaciones para las que deseas ver los contactos. La lista puede contener cualquiera de los siguientes valores:

     • billing
     • legal
     • product-updates
     • security
     • suspension
     • technical
     • all
     • notification-category-unspecified

     Para obtener más información, consulta Categorías de notificaciones.

   • RESOURCE_TYPE: Es el tipo de recurso del que deseas ver los contactos. Usa el valor project, folder o organization.

   • RESOURCE_ID: Tu Trusted Cloud proyecto, organización o ID de carpeta. 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 mostrará los contactos del proyecto actual.

   La respuesta es similar al siguiente ejemplo:

   ---
   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 definidos en un recurso o todos los contactos y contactos heredados de un recurso.

Enumera los contactos definidos en un recurso

Para ver los contactos definidos en un proyecto, una carpeta o una organización específicos, usa el método contacts.list de la API de Essential Contacts.

Request:

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

Reemplaza lo siguiente:

• RESOURCE_TYPE: Es el tipo de recurso del que deseas generar una lista de contactos. Usa el valor projects, folders o organizations.
• RESOURCE_ID: Tu Trusted Cloud proyecto, organización o ID de carpeta. Los IDs de proyecto son cadenas 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.

Para enviar tu solicitud, expande una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Establece la variable de entorno GOOGLE_APPLICATION_CREDENTIALS en la ruta de acceso a la clave privada de tu cuenta de servicio. Luego, realiza la solicitud:

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)

Establece la variable de entorno GOOGLE_APPLICATION_CREDENTIALS en la ruta de acceso a la clave privada de tu cuenta de servicio. Luego, realiza la solicitud:

$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 al siguiente ejemplo:

{
  "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 contactos y contactos heredados

Si deseas enumerar todos los contactos de un recurso y sus contactos heredados de un principal, debes tener un rol en el recurso principal que incluya los permisos requeridos para ver los contactos. Luego, usa el método contacts.compute de la API de Essential Contacts.

Request:

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

Reemplaza lo siguiente:

• RESOURCE_TYPE: Es el tipo de recurso del que deseas ver los contactos. Usa el valor projects, folders o organizations.
• RESOURCE_ID: Tu Trusted Cloud proyecto, organización o ID de carpeta. Los IDs de proyecto son cadenas alfanuméricas, como my-project. Los IDs de carpeta y organización son numéricos, como 123456789012.

• NOTIFICATION_CATEGORY: Es la categoría de notificación de la que deseas ver los contactos. Puedes repetir este campo para enumerar los contactos de varias categorías de notificación. Puede tomar cualquiera de los siguientes valores:

  • BILLING
  • LEGAL
  • PRODUCT_UPDATES
  • SECURITY
  • SUSPENSION
  • TECHNICAL
  • ALL
  • NOTIFICATION_CATEGORY_UNSPECIFIED

  Para obtener más información, consulta Categorías de notificaciones.

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

Para enviar tu solicitud, expande una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Establece la variable de entorno GOOGLE_APPLICATION_CREDENTIALS en la ruta de acceso a la clave privada de tu cuenta de servicio. Luego, realiza la solicitud:

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)

Establece la variable de entorno GOOGLE_APPLICATION_CREDENTIALS en la ruta de acceso a la clave privada de tu cuenta de servicio. Luego, realiza la solicitud:

$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_CATEGORY&pageSize=PAGE_SIZE&pageToken=NEXT_PAGE_TOKEN" | Select-Object -Expand Content

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

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

Console

1. En la consola de Trusted 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 de la página. El selector de recursos te permite seleccionar el proyecto, la carpeta o la organización desde los que deseas agregar contactos esenciales.

3. Haz clic en person_add Agregar contacto.

   

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

5. En el menú desplegable Categorías de notificaciones, selecciona las categorías sobre las que deseas que el contacto reciba notificaciones.

   Para obtener una lista de categorías de notificaciones y contactos recomendados, consulta Categorías de notificaciones.

6. Haz clic en Guardar.

gcloud

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

   Activate Cloud Shell

   At the bottom of the Trusted 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. Agrega un contacto nuevo con el comando gcloud essential-contacts create:

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

   Reemplaza lo siguiente:

   • EMAIL: Es la dirección de correo electrónico del contacto que deseas agregar. No puedes cambiar este campo después de crear tu contacto.
   • NOTIFICATION_CATEGORY: Es una lista separada por comas de las categorías para las que deseas que el contacto reciba notificaciones. La lista puede contener cualquiera de los siguientes valores:
     • billing
     • legal
     • product-updates
     • security
     • suspension
     • technical
     • all
     • notification-category-unspecified
     Para obtener una lista de categorías de notificaciones y contactos recomendados, consulta Categorías de notificaciones.
   • 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: Tu Trusted Cloud proyecto, organización o ID de carpeta. 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 y un ID de recurso, gcloud CLI crea un contacto en el proyecto actual.

   Si el comando se ejecuta correctamente, no recibirás ninguna respuesta.

REST

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

Request:

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

Reemplaza lo siguiente:

• RESOURCE_TYPE: Es el tipo de recurso para el que deseas crear un contacto. Usa el valor projects, folders o organizations.
• RESOURCE_ID: Tu Trusted Cloud proyecto, organización o ID de carpeta. Los IDs de proyecto son cadenas 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 para las que deseas que el contacto reciba notificaciones. Puedes agregar más categorías de notificaciones si incluyes más de estos valores. La lista puede tomar uno o más de los siguientes valores:

  • BILLING
  • LEGAL
  • PRODUCT_UPDATES
  • SECURITY
  • SUSPENSION
  • TECHNICAL
  • ALL

  Para obtener una lista de categorías de notificaciones y contactos recomendados, consulta Categorías de notificaciones.

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

Para enviar tu solicitud, expande una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Establece la variable de entorno GOOGLE_APPLICATION_CREDENTIALS en la ruta de acceso a la clave privada de tu cuenta de servicio. Luego, guarda el cuerpo de la solicitud en un archivo JSON llamado request.json y realiza la solicitud:

curl -X POST \
-H "Authorization: Bearer "$(gcloud auth application-default print-access-token) \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
https://essentialcontacts.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/contacts
  

PowerShell (Windows)

Establece la variable de entorno GOOGLE_APPLICATION_CREDENTIALS en la ruta de acceso a la clave privada de tu cuenta de servicio. Luego, guarda el cuerpo de la solicitud en un archivo JSON llamado request.json y realiza la solicitud:

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

Invoke-WebRequest `
  -Method POST `
  -Headers $headers `
  -ContentType: "application/json; charset=utf-8" `
  -InFile request.json `
  -Uri "https://essentialcontacts.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/contacts" | Select-Object -Expand Content
  

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

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

Console

1. En la consola de Trusted 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 de la página. El selector de recursos te permite seleccionar el proyecto, la carpeta o la organización desde los que deseas administrar los contactos esenciales.

3. Junto a Ver por, selecciona Contacto.

   

4. Haz clic en Editar edit junto al contacto cuya categoría de notificación deseas cambiar.

   

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

Cuando administras contactos desde la consola de Trusted Cloud , la consola de Trusted Cloud configura automáticamente el idioma preferido del contacto según la configuración de idioma preferido del creador del contacto. Para obtener más información, consulta Idiomas admitidos.

gcloud

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

   Activate Cloud Shell

   At the bottom of the Trusted 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. Actualiza un contacto existente con el comando gcloud essential-contacts update:

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

   Reemplaza lo siguiente:

   • 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, consulta tus contactos. El ID numérico es todo el valor que se encuentra después de contacts en el nombre del contacto.
   • NOTIFICATION_CATEGORY: Es una lista separada por comas de las categorías nuevas para las que deseas que el contacto reciba notificaciones. Esta lista reemplaza la lista existente de categorías de notificaciones.

     La lista puede contener cualquiera de los siguientes valores:

     • billing
     • legal
     • product-updates
     • security
     • suspension
     • technical
     • all
     • notification-category-unspecified
     Para obtener una lista de categorías de notificaciones y contactos recomendados, consulta Categorías de notificaciones.
   • 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 deseas modificar la información de contacto. Usa el valor project, folder o organization.
   • RESOURCE_ID: Es el ID del proyecto, la organización o la carpeta de Trusted 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 y un ID de recurso, 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 devuelve un error.

   Si el comando se ejecuta correctamente, no recibirás ninguna respuesta.

REST

Para cambiar las categorías de notificación o el idioma preferido de un contacto existente, usa el método contacts.patch de la API de Essential Contacts.

Request:

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

Reemplaza lo siguiente:

• RESOURCE_TYPE: Es el tipo de recurso en el que deseas modificar la información de contacto. Usa el valor projects, folders o organizations.
• RESOURCE_ID: Tu Trusted Cloud proyecto, organización o ID de carpeta. Los IDs de proyecto son cadenas 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, consulta tus contactos. El ID numérico es todo el valor que se encuentra después de contacts en el nombre del contacto.
• UPDATE_MASK: Opcional Una máscara que describe qué campos del contacto deseas cambiar. 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 actualizadas para las que quieres que reciba notificaciones el contacto. Puedes agregar más categorías de notificaciones si incluyes más de estos valores. La lista puede tener uno o más de los siguientes valores:

  • BILLING
  • LEGAL
  • PRODUCT_UPDATES
  • SECURITY
  • SUSPENSION
  • TECHNICAL
  • ALL

  Para obtener una lista de categorías de notificaciones y contactos recomendados, consulta Categorías de notificaciones.

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

Para enviar tu solicitud, expande una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Establece la variable de entorno GOOGLE_APPLICATION_CREDENTIALS en la ruta de acceso a la clave privada de tu cuenta de servicio. Luego, guarda el cuerpo de la solicitud en un archivo JSON llamado request.json y realiza la solicitud:

curl -X PATCH \
-H "Authorization: Bearer "$(gcloud auth application-default print-access-token) \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
https://essentialcontacts.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/contacts/CONTACT_ID?updateMask="UPDATE_MASK"
  

PowerShell (Windows)

Establece la variable de entorno GOOGLE_APPLICATION_CREDENTIALS en la ruta de acceso a la clave privada de tu cuenta de servicio. Luego, guarda el cuerpo de la solicitud en un archivo JSON llamado request.json y realiza la solicitud:

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

Invoke-WebRequest `
  -Method PATCH `
  -Headers $headers `
  -ContentType: "application/json; charset=utf-8" `
  -InFile request.json `
  -Uri "https://essentialcontacts.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/contacts/CONTACT_ID?updateMask="UPDATE_MASK"" | Select-Object -Expand Content
  

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

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

Console

1. En la consola de Trusted 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 de la página. El selector de recursos te permite seleccionar el proyecto, la carpeta o la organización desde los que deseas borrar los contactos esenciales.

3. Junto a Ver por, selecciona Contacto.

   

4. Haz clic en Borrar delete 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 Trusted Cloud console, activate Cloud Shell.

   Activate Cloud Shell

   At the bottom of the Trusted 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. Borra un contacto existente con el comando gcloud essential-contacts delete:

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

   Reemplaza lo siguiente:

   • 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, consulta tus contactos. El ID numérico es todo el valor 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 Trusted 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 devuelve un error.

   Si el comando se ejecuta correctamente, no recibirás ninguna respuesta.

REST

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

Request:

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

Reemplaza lo siguiente:

• RESOURCE_TYPE: Es el tipo de recurso en el que se define el contacto. Usa el valor projects, folders o organizations.
• RESOURCE_ID: Tu Trusted Cloud proyecto, organización o ID de carpeta. Los IDs de proyecto son cadenas 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 borrar. Para ver los IDs de todos los contactos de tu proyecto, organización o carpeta, consulta tus contactos. El ID numérico es todo el valor que se encuentra después de contacts en el nombre del contacto.

Para enviar tu solicitud, expande una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Establece la variable de entorno GOOGLE_APPLICATION_CREDENTIALS en la ruta de acceso a la clave privada de tu cuenta de servicio. Luego, realiza la solicitud:

curl -X DELETE \
-H "Authorization: Bearer "$(gcloud auth application-default print-access-token) \
https://essentialcontacts.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/contacts/CONTACT_ID
  

PowerShell (Windows)

Establece la variable de entorno GOOGLE_APPLICATION_CREDENTIALS en la ruta de acceso a la clave privada de tu cuenta de servicio. Luego, realiza la solicitud:

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

Invoke-WebRequest `
  -Method DELETE `
  -Headers $headers `
  -Uri "https://essentialcontacts.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/contacts/CONTACT_ID" | Select-Object -Expand Content
  

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