Gestionar contactos esenciales

Consola

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

   Ve a la página Contactos esenciales

2. Comprueba que el nombre de tu proyecto, carpeta u organización aparece en el selector de recursos de la página. El selector de recursos te permite seleccionar el proyecto, la carpeta o la organización de la que quieras 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 por orden alfabético, selecciona 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. Con la CLI de Google Cloud, puedes enumerar los contactos definidos en un recurso o enumerar todos los contactos y los contactos heredados de un recurso.

   Lista de contactos definidos en un recurso

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

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

   Haz los cambios siguientes:

   • RESOURCE_TYPE: el tipo de recurso del que quieres obtener la lista de contactos. Usa el valor project, folder o organization.
   • RESOURCE_ID: tu Google Cloud proyecto, organización o ID de carpeta. Los IDs de proyecto son cadenas alfanuméricas, como my-project. Los IDs de carpetas y organizaciones son numéricos, como 123456789012.

   Si no especifica un tipo o un ID de recurso, la CLI de gcloud 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
   ---
   

   Lista de contactos y contactos heredados

   Si quieres enumerar todos los contactos de un recurso y sus contactos heredados de un recurso antecesor, debes tener un rol en el recurso antecesor que incluya los permisos necesarios para ver los contactos. A continuación, usa el comando gcloud essential-contacts compute:

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

   Haz los cambios siguientes:

   • NOTIFICATION_CATEGORY: lista separada por comas de las categorías de notificaciones de las que quieres 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: el tipo de recurso del que quieres ver los contactos. Usa el valor project, folder o organization.

   • RESOURCE_ID: tu Google Cloud proyecto, organización o ID de carpeta. Los IDs de proyecto son cadenas alfanuméricas, como my-project. Los IDs de carpetas y organizaciones son numéricos, como 123456789012.

   Si no especifica un tipo de recurso y un ID, la CLI de gcloud 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 REST Essential Contacts, puedes enumerar los contactos definidos en un recurso o enumerar todos los contactos y los contactos heredados de un recurso.

Lista de 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 Essential Contacts.

Solicitud:

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

Haz los cambios siguientes:

• RESOURCE_TYPE: el tipo de recurso del que quieres obtener la lista de contactos. Usa el valor projects, folders o organizations.
• RESOURCE_ID: tu Google Cloud proyecto, organización o ID de carpeta. Los IDs de proyecto son cadenas alfanuméricas, como my-project. Los IDs de carpetas y organizaciones son numéricos, como 123456789012.
• PAGE_SIZE: opcional. Número de contactos que se incluirán en la respuesta. El valor predeterminado es 50 y el máximo es 100. Si el número de contactos es superior al tamaño de la página, la respuesta contiene un token de paginación que puedes usar para obtener la siguiente página de resultados.
• NEXT_PAGE_TOKEN: opcional. El token de paginación devuelto en una respuesta anterior de este método. Si se especifica, la lista de contactos empieza donde terminó la respuesta anterior.

Para enviar tu solicitud, despliega una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Define la variable de entorno GOOGLE_APPLICATION_CREDENTIALS en la ruta de la clave privada de tu cuenta de servicio. A continuación, haz 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)

Define la variable de entorno GOOGLE_APPLICATION_CREDENTIALS en la ruta de la clave privada de tu cuenta de servicio. A continuación, haz 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 a la del 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"
    }
  ]
}

Lista de contactos y contactos heredados

Si quieres enumerar todos los contactos de un recurso y sus contactos heredados de un recurso antecesor, debes tener un rol en el recurso antecesor que incluya los permisos necesarios para ver los contactos. A continuación, usa el método contacts.compute de la API Essential Contacts.

Solicitud:

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

Haz los cambios siguientes:

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

• NOTIFICATION_CATEGORY: la categoría de notificación de la que quieres ver los contactos. Puedes repetir este campo para enumerar los contactos de varias categorías de notificaciones. Puede adoptar 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. Número de contactos que se incluirán en la respuesta. El valor predeterminado es 50 y el máximo es 100. Si el número de contactos es superior al tamaño de la página, la respuesta contiene un token de paginación que puedes usar para obtener la siguiente página de resultados.

• NEXT_PAGE_TOKEN: opcional. El token de paginación devuelto en una respuesta anterior de este método. Si se especifica, la lista de contactos empieza donde terminó la respuesta anterior.

Para enviar tu solicitud, despliega una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Define la variable de entorno GOOGLE_APPLICATION_CREDENTIALS en la ruta de la clave privada de tu cuenta de servicio. A continuación, haz 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)

Define la variable de entorno GOOGLE_APPLICATION_CREDENTIALS en la ruta de la clave privada de tu cuenta de servicio. A continuación, haz 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 a la del 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"
    }
  ]
}

Consola

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

   Ve a la página Contactos esenciales

2. Comprueba que el nombre de tu proyecto, carpeta u organización aparece 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 quieras añadir contactos esenciales.

3. Haz clic en person_add Añadir contacto.

   

4. En los campos Correo y Confirmar correo, escribe la dirección de correo del contacto que quieras añadir.

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

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

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. Añade 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"

   Haz los cambios siguientes:

   • EMAIL: la dirección de correo del contacto que quieres añadir. No puedes cambiar este campo después de crear el contacto.
   • NOTIFICATION_CATEGORY: lista separada por comas de las categorías de las que quieres 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 ver una lista de categorías de notificaciones y contactos recomendados, consulta Categorías de notificaciones.
   • LANGUAGE: el código de idioma de la lengua de notificación preferida de tu contacto. Puede incluir el código de idioma de cualquiera de los idiomas admitidos.
   • RESOURCE_TYPE: el tipo de recurso para el que quieres crear un contacto. Usa el valor project, folder o organization.
   • RESOURCE_ID: tu Google Cloud proyecto, organización o ID de carpeta. Los IDs de proyecto son cadenas alfanuméricas, como my-project. Los IDs de carpetas y organizaciones 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 recibirás ninguna respuesta.

REST

Para añadir un contacto, usa el método contacts.create de la API Essential Contacts.

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

Haz los cambios siguientes:

• RESOURCE_TYPE: el tipo de recurso para el que quieres crear un contacto. Usa el valor projects, folders o organizations.
• RESOURCE_ID: tu Google Cloud proyecto, organización o ID de carpeta. Los IDs de proyecto son cadenas alfanuméricas, como my-project. Los IDs de carpetas y organizaciones son numéricos, como 123456789012.
• EMAIL: la dirección de correo de tu contacto. No puedes cambiar este campo después de crear el contacto.

• NOTIFICATION_CATEGORY_1 y NOTIFICATION_CATEGORY_2: las categorías de las que quieres que el contacto reciba notificaciones. Puedes añadir más categorías de notificaciones incluyendo más de estos valores. La lista puede tener uno o varios de los siguientes valores:

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

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

• LANGUAGE: el código de idioma de la lengua de notificación preferida de tu contacto. Puedes incluir el código de idioma de cualquiera de los idiomas admitidos.

Para enviar tu solicitud, despliega una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Define la variable de entorno GOOGLE_APPLICATION_CREDENTIALS en la ruta de la clave privada de tu cuenta de servicio. A continuación, guarda el cuerpo de la solicitud en un archivo JSON llamado request.json y haz 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)

Define la variable de entorno GOOGLE_APPLICATION_CREDENTIALS en la ruta de la clave privada de tu cuenta de servicio. A continuación, guarda el cuerpo de la solicitud en un archivo JSON llamado request.json y haz 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 a la del siguiente ejemplo:

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

Consola

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

   Ve a la página Contactos esenciales

2. Comprueba que el nombre de tu proyecto, carpeta u organización aparece 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 la que quieres gestionar 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 quieras cambiar.

   

5. En el menú desplegable Categorías de notificaciones, selecciona las categorías que quieras modificar y haz clic en Guardar.

Cuando gestionas contactos desde la consola de Google Cloud , la consola de Google Cloud configura automáticamente el idioma preferido del contacto en función de los ajustes de idioma preferido del creador del contacto. Para obtener más información, consulta la sección sobre los idiomas admitidos.

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. Actualiza un contacto con el comando gcloud essential-contacts update:

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

   Haz los cambios siguientes:

   • CONTACT_ID: el ID numérico del contacto que quieras actualizar. Para ver los IDs de todos los contactos de tu proyecto, carpeta u organización, consulta tus contactos. El ID numérico es el valor completo que aparece después de contacts en el nombre del contacto.
   • NOTIFICATION_CATEGORY: lista separada por comas de las nuevas categorías de las que quieres que el contacto reciba notificaciones. Esta lista sustituye a la lista de categorías de notificaciones actual.

     La lista puede contener cualquiera de los siguientes valores:

     • billing
     • legal
     • product-updates
     • security
     • suspension
     • technical
     • all
     • notification-category-unspecified
     Para ver una lista de categorías de notificaciones y contactos recomendados, consulta Categorías de notificaciones.
   • LANGUAGE: el código de idioma de la lengua de notificación preferida de tu contacto. Puede incluir el código de idioma de cualquiera de los idiomas admitidos.
   • RESOURCE_TYPE: el tipo de recurso en el que quieres modificar la información de contacto. Usa el valor project, folder o organization.
   • RESOURCE_ID: el ID del Google Cloud proyecto, la organización o la carpeta en la que se define el contacto. Los IDs de proyecto son cadenas alfanuméricas, como my-project. Los IDs de carpetas y organizaciones son numéricos, como 123456789012.

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

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

REST

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

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

Haz los cambios siguientes:

• RESOURCE_TYPE: el tipo de recurso en el que quieras modificar la información de contacto. Usa el valor projects, folders o organizations.
• RESOURCE_ID: tu Google Cloud proyecto, organización o ID de carpeta. Los IDs de proyecto son cadenas alfanuméricas, como my-project. Los IDs de carpetas y organizaciones son numéricos, como 123456789012.
• CONTACT_ID: el ID numérico del contacto que quieras actualizar. Para ver los IDs de todos los contactos de tu proyecto, carpeta u organización, consulta tus contactos. El ID numérico es el valor completo que aparece después de contacts en el nombre del contacto.
• UPDATE_MASK: opcional. Una máscara que describe los campos del contacto que quieres cambiar. La máscara debe ser una lista de nombres completos de campos separados por comas. Por ejemplo, notificationCategorySubscriptions,languageTag.
• EMAIL: la dirección de correo de tu contacto. Este campo debe coincidir con la dirección de correo asociada al CONTACT_ID que incluyas en la solicitud.

• NOTIFICATION_CATEGORY_1 y NOTIFICATION_CATEGORY_2: opcionales. Las categorías actualizadas de las que quieres que el contacto reciba notificaciones. Puede añadir más categorías de notificaciones incluyendo más de estos valores. La lista puede incluir uno o varios de los siguientes valores:

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

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

• LANGUAGE: el código de idioma de la lengua de notificación preferida del contacto. Puedes incluir el código de idioma de cualquiera de los idiomas admitidos.

Para enviar tu solicitud, despliega una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Define la variable de entorno GOOGLE_APPLICATION_CREDENTIALS en la ruta de la clave privada de tu cuenta de servicio. A continuación, guarda el cuerpo de la solicitud en un archivo JSON llamado request.json y haz 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)

Define la variable de entorno GOOGLE_APPLICATION_CREDENTIALS en la ruta de la clave privada de tu cuenta de servicio. A continuación, guarda el cuerpo de la solicitud en un archivo JSON llamado request.json y haz 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 a la del siguiente ejemplo:

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

Consola

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

   Ve a la página Contactos esenciales

2. Comprueba que el nombre de tu proyecto, carpeta u organización aparece en el selector de recursos de la página. El selector de recursos te permite seleccionar el proyecto, la carpeta o la organización de los que quieras eliminar los contactos esenciales.

3. Junto a Ver por, selecciona Contacto.

   

4. Haz clic en Eliminar delete junto a la dirección de correo del contacto que quieras eliminar. A continuación, en el cuadro de diálogo, confirma que quieres eliminar 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 eliminar un contacto, usa el comando gcloud essential-contacts delete:

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

   Haz los cambios siguientes:

   • CONTACT_ID: el ID numérico del contacto que quieres eliminar. Para ver los IDs de todos los contactos de tu proyecto, carpeta u organización, consulta tus contactos. El ID numérico es el valor completo que aparece después de contacts en el nombre del contacto.
   • RESOURCE_TYPE: el tipo de recurso en el que se define el contacto. Usa el valor project, folder o organization.
   • RESOURCE_ID: el ID del Google Cloud proyecto, la organización o la carpeta en la que se define el contacto. Los IDs de proyecto son cadenas alfanuméricas, como my-project. Los IDs de carpetas y organizaciones son numéricos, como 123456789012.

   Si no especifica un tipo de recurso y un ID, la CLI de gcloud eliminará el contacto con el ID especificado en el proyecto actual. Si no existe ningún contacto con el ID especificado, la CLI de gcloud devuelve un error.

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

REST

Para eliminar un contacto, usa el método contacts.delete de la API Essential Contacts.

Solicitud:

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

Haz los cambios siguientes:

• RESOURCE_TYPE: el tipo de recurso en el que se define el contacto. Usa el valor projects, folders o organizations.
• RESOURCE_ID: tu Google Cloud proyecto, organización o ID de carpeta. Los IDs de proyecto son cadenas alfanuméricas, como my-project. Los IDs de carpetas y organizaciones son numéricos, como 123456789012.
• CONTACT_ID: el ID numérico del contacto que quieres eliminar. Para ver los IDs de todos los contactos de tu proyecto, carpeta u organización, consulta tus contactos. El ID numérico es el valor completo que aparece después de contacts en el nombre del contacto.

Para enviar tu solicitud, despliega una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Define la variable de entorno GOOGLE_APPLICATION_CREDENTIALS en la ruta de la clave privada de tu cuenta de servicio. A continuación, haz 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)

Define la variable de entorno GOOGLE_APPLICATION_CREDENTIALS en la ruta de la clave privada de tu cuenta de servicio. A continuación, haz 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 está vacío.