Gerir contactos essenciais

Esta página descreve os métodos disponíveis para ver, adicionar, modificar ou remover contactos essenciais e configurar categorias de notificações para os mesmos.

Se for um administrador da organização, pode gerir os seus contactos essenciais através da Google Cloud consola, da CLI do Google Cloud ou da API REST. Siga as práticas recomendadas para gerir os contactos essenciais.

Se for um contacto essencial, peça ao administrador para lhe enviar um email de teste para verificar a receção da categoria de notificação específica. Se não estiver a receber notificações, verifique o seguinte:

  • Verifique a pasta de spam ou lixo do seu email.
  • Verifique se o endereço de email registado como contacto está correto e pode receber emails externos.
  • Certifique-se de que as suas informações de contacto estão atribuídas às categorias de notificação relevantes.

Antes de começar

Para receber notificações, o contacto tem de poder receber emails da Google.

Se quiser gerir contactos através da CLI gcloud ou da API REST, ative a API Essential Contacts. Se só quiser gerir os contactos através da Google Cloud consola, não precisa de ativar a API.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the API

Funções necessárias

Para receber as autorizações de que precisa para gerir contactos, peça ao seu administrador que lhe conceda as seguintes funções da IAM no projeto, na pasta ou na organização onde o contacto está atribuído:

Para mais informações sobre a atribuição de funções, consulte o artigo Faça a gestão do acesso a projetos, pastas e organizações.

Estas funções predefinidas contêm as autorizações necessárias para gerir contactos. Para ver as autorizações exatas que são necessárias, expanda a secção Autorizações necessárias:

Autorizações necessárias

As seguintes autorizações são necessárias para gerir contactos:

  • Para ver os contactos:
    • essentialcontacts.contacts.get
    • essentialcontacts.contacts.list
  • Para editar, eliminar e criar contactos:
    • essentialcontacts.contacts.create
    • essentialcontacts.contacts.delete
    • essentialcontacts.contacts.update

Também pode conseguir estas autorizações com funções personalizadas ou outras funções predefinidas.

Ver contactos

Os recursos secundários, que se referem a pastas e projetos, herdam contactos dos respetivos antecessores, que podem ser organizações e outras pastas. Quando visualiza contactos de um recurso secundário, também pode ver os contactos herdados do respetivo ancestral se tiver as autorizações correspondentes para o ancestral. Para obter esta capacidade, adquira uma função no recurso principal que inclua as autorizações necessárias para ver contactos. Quando vê contactos de uma organização ou de uma pasta de nível superior, não vê contactos dos respetivos recursos secundários.

Para ver a lista de todos os contactos essenciais no seu projeto, pasta ou organização, faça o seguinte:

Consola

  1. Na Google Cloud consola, aceda à página Contactos essenciais.

    Aceda à página Contactos essenciais

  2. Certifique-se de que o nome do seu projeto, pasta ou organização aparece no seletor de recursos da página. O seletor de recursos permite-lhe selecionar o projeto, a pasta ou a organização a partir dos quais quer ver os contactos essenciais.

  3. Junto a Ver por, pode escolher uma das seguintes opções:

    • Para ver a lista de contactos por categoria, selecione Categoria.
    • Para ver a lista de contactos por ordem alfabética, selecione 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. Com a CLI gcloud, pode listar os contactos definidos num recurso ou listar todos os contactos e contactos herdados de um recurso.

    Listar contactos definidos num recurso

    Para ver os contactos essenciais definidos num projeto, numa pasta ou numa organização específicos, use o comando gcloud essential-contacts list:

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

    Substitua o seguinte:

    • RESOURCE_TYPE: o tipo de recurso a partir do qual quer listar os contactos. Use o valor project, folder ou organization.
    • RESOURCE_ID: o ID do seu Google Cloud projeto, organização ou pasta. Os IDs dos projetos são strings alfanuméricas, como my-project. Os IDs das pastas e das organizações são numéricos, como 123456789012.

    Em alternativa, se não especificar um tipo ou um ID de recurso, a CLI gcloud lista os contactos do projeto atual.

    A resposta é semelhante ao seguinte exemplo:

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

    Liste contactos e contactos herdados

    Se quiser listar todos os contactos de um recurso e os respetivos contactos herdados de um antepassado, tem de ter uma função no recurso antepassado que inclua as autorizações necessárias para ver contactos. Em seguida, use o comando gcloud essential-contacts compute:

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

    Substitua o seguinte:

    • NOTIFICATION_CATEGORY: uma lista separada por vírgulas das categorias de notificação para as quais quer ver contactos. A lista pode conter qualquer um dos seguintes valores:

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

      Para mais informações, consulte o artigo Categorias de notificações.

    • RESOURCE_TYPE: o tipo de recurso a partir do qual quer ver os contactos. Use o valor project, folder ou organization.

    • RESOURCE_ID: o ID do seu Google Cloud projeto, organização ou pasta. Os IDs dos projetos são strings alfanuméricas, como my-project. Os IDs das pastas e das organizações são numéricos, como 123456789012.

    Se não especificar um tipo de recurso e um ID, a CLI gcloud apresenta uma lista de contactos para o projeto atual.

    A resposta é semelhante ao seguinte exemplo:

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

    3. REST

    Com a API REST de contactos essenciais, pode listar os contactos definidos num recurso ou listar todos os contactos e contactos herdados de um recurso.

    Listar contactos definidos num recurso

    Para ver os contactos definidos num projeto, numa pasta ou numa organização específicos, use o método contacts.list da API Essential Contacts.

    Pedido:

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

    Substitua o seguinte:

    • RESOURCE_TYPE: o tipo de recurso a partir do qual quer listar os contactos. Use o valor projects, folders ou organizations.
    • RESOURCE_ID: o ID do seu Google Cloud projeto, organização ou pasta. Os IDs dos projetos são strings alfanuméricas, como my-project. Os IDs das pastas e das organizações são numéricos, como 123456789012.
    • PAGE_SIZE: opcional. O número de contactos a incluir na resposta. O valor predefinido é 50 e o valor máximo é 100. Se o número de contactos for superior ao tamanho da página, a resposta contém um token de paginação que pode usar para obter a página seguinte de resultados.
    • NEXT_PAGE_TOKEN: opcional. O token de paginação devolvido numa resposta anterior deste método. Se for especificado, a lista de contactos começa onde a resposta anterior terminou.

    Para enviar o seu pedido, expanda uma destas opções:

    curl (Linux, macOS ou Cloud Shell)

    Defina a variável de ambiente GOOGLE_APPLICATION_CREDENTIALS para o caminho da chave privada da sua conta de serviço. Em seguida, faça o pedido: 

    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)

    Defina a variável de ambiente GOOGLE_APPLICATION_CREDENTIALS para o caminho da chave privada da sua conta de serviço. Em seguida, faça o pedido: 

    $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

    Depois de enviar o pedido, recebe uma resposta JSON semelhante ao seguinte exemplo:

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

    Liste contactos e contactos herdados

    Se quiser listar todos os contactos de um recurso e os respetivos contactos herdados de um antepassado, tem de ter uma função no recurso antepassado que inclua as autorizações necessárias para ver contactos. Em seguida, use o método contacts.compute da API Essential Contacts.

    Pedido:

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

    Substitua o seguinte:

    • RESOURCE_TYPE: o tipo de recurso a partir do qual quer ver os contactos. Use o valor projects, folders ou organizations.
    • RESOURCE_ID: o ID do seu Google Cloud projeto, organização ou pasta. Os IDs dos projetos são strings alfanuméricas, como my-project. Os IDs das pastas e das organizações são numéricos, como 123456789012.

    • NOTIFICATION_CATEGORY: a categoria de notificações a partir da qual quer ver os contactos. Pode repetir este campo para listar contactos de várias categorias de notificações. Pode assumir qualquer um dos seguintes valores:

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

      Para mais informações, consulte o artigo Categorias de notificações.

    • PAGE_SIZE: opcional. O número de contactos a incluir na resposta. O valor predefinido é 50 e o valor máximo é 100. Se o número de contactos for superior ao tamanho da página, a resposta contém um token de paginação que pode usar para obter a página seguinte de resultados.

    • NEXT_PAGE_TOKEN: opcional. O token de paginação devolvido numa resposta anterior deste método. Se for especificado, a lista de contactos começa onde a resposta anterior terminou.

    Para enviar o seu pedido, expanda uma destas opções:

    curl (Linux, macOS ou Cloud Shell)

    Defina a variável de ambiente GOOGLE_APPLICATION_CREDENTIALS para o caminho da chave privada da sua conta de serviço. Em seguida, faça o pedido: 

    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)

    Defina a variável de ambiente GOOGLE_APPLICATION_CREDENTIALS para o caminho da chave privada da sua conta de serviço. Em seguida, faça o pedido: 

    $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

    Depois de enviar o pedido, recebe uma resposta JSON semelhante ao seguinte exemplo:

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

Adicionar um contacto

Para adicionar um contacto, faça o seguinte:

Consola

  1. Na Google Cloud consola, aceda à página Contactos essenciais.

    Aceda à página Contactos essenciais

  2. Certifique-se de que o nome do seu projeto, pasta ou organização aparece no seletor de recursos da página. O seletor de recursos permite-lhe selecionar o projeto, a pasta ou a organização a partir dos quais quer adicionar contactos essenciais.

  3. Clique em Adicionar contacto.

    Uma captura de ecrã que realça a opção para adicionar um contacto a partir da página Contactos essenciais.

  4. Nos campos Email e Confirmar email, introduza o endereço de email do contacto que quer adicionar.

  5. No menu pendente Categorias de notificações, selecione as categorias para as quais quer que o contacto receba notificações.

    Para ver uma lista de categorias de notificações e contactos recomendados, consulte o artigo Categorias de notificações.

  6. Clique em 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. Adicione um novo contacto com o comando gcloud essential-contacts create:

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

    Substitua o seguinte:

    • EMAIL: o endereço de email do contacto que quer adicionar. Não pode alterar este campo depois de criar o contacto.
    • NOTIFICATION_CATEGORY: uma lista separada por vírgulas das categorias para as quais quer que o contacto receba notificações. A lista pode conter qualquer um dos seguintes valores:
      • billing
      • legal
      • product-updates
      • security
      • suspension
      • technical
      • all
      • notification-category-unspecified
      Para ver uma lista de categorias de notificações e contactos recomendados, consulte Categorias de notificações.
    • LANGUAGE: o código do idioma do idioma de notificação preferido do seu contacto. Pode incluir o código do idioma de qualquer um dos idiomas suportados.
    • RESOURCE_TYPE: o tipo de recurso para o qual quer criar um contacto. Use o valor project, folder ou organization.
    • RESOURCE_ID: o ID do seu Google Cloud projeto, organização ou pasta. Os IDs dos projetos são strings alfanuméricas, como my-project. Os IDs das pastas e das organizações são numéricos, como 123456789012.

    Se não especificar um tipo de recurso e um ID, a CLI gcloud cria um contacto no projeto atual.

    Se o comando for bem-sucedido, não recebe nenhuma resposta.

    3. REST

    Para adicionar um novo contacto, use o método contacts.create da API Essential Contacts.

    Pedido:

    POST essentialcontacts.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/contacts

    Corpo do pedido:

    {
  "email": "EMAIL",
  "notificationCategorySubscriptions": [
    "NOTIFICATION_CATEGORY_1",
    "NOTIFICATION_CATEGORY_2"
  ],
  "languageTag": "LANGUAGE"
}

    Substitua o seguinte:

    • RESOURCE_TYPE: o tipo de recurso para o qual quer criar um contacto. Use o valor projects, folders ou organizations.
    • RESOURCE_ID: o ID do seu Google Cloud projeto, organização ou pasta. Os IDs dos projetos são strings alfanuméricas, como my-project. Os IDs das pastas e das organizações são numéricos, como 123456789012.
    • EMAIL: o endereço de email do seu contacto. Não pode alterar este campo depois de criar o contacto.

    • NOTIFICATION_CATEGORY_1 e NOTIFICATION_CATEGORY_2: as categorias para as quais quer que o contacto receba notificações. Pode adicionar mais categorias de notificação incluindo mais destes valores. A lista pode ter um ou mais dos seguintes valores:

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

      Para ver uma lista de categorias de notificações e contactos recomendados, consulte o artigo Categorias de notificações.

    • LANGUAGE: o código do idioma do idioma de notificação preferido do seu contacto. Pode incluir o código de idioma de qualquer um dos idiomas suportados.

    Para enviar o seu pedido, expanda uma destas opções:

    Depois de enviar o pedido, recebe uma resposta JSON semelhante ao seguinte exemplo:

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

Modifique as informações de contacto

Pode alterar as categorias de notificação ou o idioma preferido de um contacto, mas não pode alterar o endereço de email de um contacto. Se o endereço de email de um contacto mudar, adicione um novo contacto com o endereço de email atualizado e elimine o contacto antigo.

Para alterar as categorias de notificação atribuídas a um contacto ou o respetivo idioma preferido, faça o seguinte:

Consola

  1. Na Google Cloud consola, aceda à página Contactos essenciais.

    Aceda à página Contactos essenciais

  2. Certifique-se de que o nome do seu projeto, pasta ou organização aparece no seletor de recursos da página. O seletor de recursos permite-lhe selecionar o projeto, a pasta ou a organização a partir dos quais quer gerir os contactos essenciais.

  3. Junto a Ver por, selecione Contacto.

    Uma captura de ecrã que realça a opção para selecionar Contacto na página Contactos essenciais.

  4. Clique em Editar junto ao contacto cuja categoria de notificação quer alterar.

    Uma captura de ecrã que realça a opção para editar um contacto na página Contactos essenciais.

  5. Selecione as categorias de notificações que quer modificar no menu pendente Categorias de notificações e clique em Guardar.

Quando gere contactos a partir da Google Cloud consola, a Google Cloud consola configura automaticamente o idioma preferido do contacto com base nas definições de idioma preferido do criador do contacto. Para mais informações, consulte o artigo Idiomas suportados.

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. Atualize um contacto existente com o comando gcloud essential-contacts update:

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

    Substitua o seguinte:

    • CONTACT_ID: o ID numérico do contacto que quer atualizar. Para ver os IDs de todos os contactos no seu projeto, pasta ou organização, veja os seus contactos. O ID numérico é o valor completo após contacts no nome do contacto.
    • NOTIFICATION_CATEGORY: uma lista separada por vírgulas das novas categorias para as quais quer que o contacto receba notificações. Esta lista substitui a lista existente de categorias de notificações.

      A lista pode conter qualquer um dos seguintes valores:

      • billing
      • legal
      • product-updates
      • security
      • suspension
      • technical
      • all
      • notification-category-unspecified
      Para ver uma lista de categorias de notificações e contactos recomendados, consulte Categorias de notificações.
    • LANGUAGE: o código do idioma do idioma de notificação preferido do seu contacto. Pode incluir o código do idioma de qualquer um dos idiomas suportados.
    • RESOURCE_TYPE: o tipo de recurso onde quer modificar as informações de contacto. Use o valor project, folder ou organization.
    • RESOURCE_ID: o ID do Google Cloud projeto, da organização ou da pasta onde o contacto está definido. Os IDs dos projetos são strings alfanuméricas, como my-project. Os IDs das pastas e das organizações são numéricos, como 123456789012.

    Se não especificar um tipo de recurso e um ID, a CLI gcloud atualiza o contacto com o ID especificado no projeto atual. Se não existir nenhum contacto com o ID especificado, a CLI gcloud devolve um erro.

    Se o comando for bem-sucedido, não recebe nenhuma resposta.

    3. REST

    Para alterar as categorias de notificação ou o idioma preferido de um contacto existente, use o método contacts.patch da API Essential Contacts.

    Pedido:

    PATCH essentialcontacts.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/contacts/CONTACT_ID?updateMask="UPDATE_MASK"

    Corpo do pedido:

    {
  "name": "RESOURCE_TYPE/RESOURCE_ID/contact/CONTACT_ID",
  "email": "EMAIL",
  "notificationCategorySubscriptions": [
    "NOTIFICATION_CATEGORY_1",
    "NOTIFICATION_CATEGORY_2"
  ],
  "languageTag": "LANGUAGE"
}

    Substitua o seguinte:

    • RESOURCE_TYPE: o tipo de recurso no qual quer modificar as informações de contacto. Use o valor projects, folders ou organizations.
    • RESOURCE_ID: o ID do seu Google Cloud projeto, organização ou pasta. Os IDs dos projetos são strings alfanuméricas, como my-project. Os IDs das pastas e das organizações são numéricos, como 123456789012.
    • CONTACT_ID: o ID numérico do contacto que quer atualizar. Para ver os IDs de todos os contactos no seu projeto, pasta ou organização, veja os seus contactos. O ID numérico é o valor completo após contacts no nome do contacto.
    • UPDATE_MASK: opcional. Uma máscara que descreve os campos do contacto que quer alterar. O formato da máscara é uma lista separada por vírgulas de nomes totalmente qualificados de campos, por exemplo, notificationCategorySubscriptions,languageTag.
    • EMAIL: o endereço de email do seu contacto. Este campo tem de corresponder ao endereço de email associado ao CONTACT_ID que inclui no pedido.

    • NOTIFICATION_CATEGORY_1 e NOTIFICATION_CATEGORY_2: opcional. As categorias atualizadas para as quais quer que o contacto receba notificações. Pode adicionar mais categorias de notificações incluindo mais destes valores. A lista pode assumir um ou mais dos seguintes valores:

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

      Para ver uma lista de categorias de notificações e contactos recomendados, consulte o artigo Categorias de notificações.

    • LANGUAGE: o código do idioma do idioma de notificação preferido do contacto. Pode incluir o código de idioma de qualquer um dos idiomas suportados.

    Para enviar o seu pedido, expanda uma destas opções:

    Depois de enviar o pedido, recebe uma resposta JSON semelhante ao seguinte exemplo:

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

Elimine um contacto

Para eliminar um contacto, faça o seguinte:

Consola

  1. Na Google Cloud consola, aceda à página Contactos essenciais.

    Aceda à página Contactos essenciais

  2. Certifique-se de que o nome do seu projeto, pasta ou organização aparece no seletor de recursos da página. O seletor de recursos permite-lhe selecionar o projeto, a pasta ou a organização a partir dos quais quer eliminar os contactos essenciais.

  3. Junto a Ver por, selecione Contacto.

    Uma captura de ecrã que realça a opção para selecionar Contacto na página Contactos essenciais.

  4. Clique em Eliminar junto ao endereço de email do contacto que quer eliminar. Em seguida, na caixa de diálogo, confirme que quer eliminar o contacto.

    Uma captura de ecrã que realça a opção para eliminar um contacto na página Contactos essenciais.

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. Elimine um contacto existente com o comando gcloud essential-contacts delete:

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

    Substitua o seguinte:

    • CONTACT_ID: o ID numérico do contacto que quer eliminar. Para ver os IDs de todos os contactos no seu projeto, pasta ou organização, veja os seus contactos. O ID numérico é o valor completo após contacts no nome do contacto.
    • RESOURCE_TYPE: o tipo de recurso no qual o contacto está definido. Use o valor project, folder ou organization.
    • RESOURCE_ID: o ID do Google Cloud projeto, da organização ou da pasta onde o contacto está definido. Os IDs dos projetos são strings alfanuméricas, como my-project. Os IDs das pastas e das organizações são numéricos, como 123456789012.

    Se não especificar um tipo de recurso e um ID, a CLI gcloud elimina o contacto com o ID especificado no projeto atual. Se não existir nenhum contacto com o ID especificado, a CLI gcloud devolve um erro.

    Se o comando for bem-sucedido, não recebe nenhuma resposta.

    3. REST

    Para eliminar um contacto, use o método contacts.delete da API Essential Contacts.

    Pedido:

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

    Substitua o seguinte:

    • RESOURCE_TYPE: o tipo de recurso no qual o contacto está definido. Use o valor projects, folders ou organizations.
    • RESOURCE_ID: o ID do seu Google Cloud projeto, organização ou pasta. Os IDs dos projetos são strings alfanuméricas, como my-project. Os IDs das pastas e das organizações são numéricos, como 123456789012.
    • CONTACT_ID: o ID numérico do contacto que quer eliminar. Para ver os IDs de todos os contactos no seu projeto, pasta ou organização, veja os seus contactos. O ID numérico é o valor completo após contacts no nome do contacto.

    Para enviar o seu pedido, expanda uma destas opções:

    Se o pedido for bem-sucedido, o corpo da resposta está vazio.

Faça a gestão dos contactos por categoria

Na Google Cloud consola, pode gerir os contactos por categoria de notificação acedendo ao separador Categoria na página Contactos essenciais.

Para adicionar, alterar ou eliminar os contactos atribuídos a uma única categoria de notificação, faça o seguinte:

  1. Na Google Cloud consola, aceda à página Contactos essenciais.

    Aceda à página Contactos essenciais

  2. Certifique-se de que o nome do seu projeto, pasta ou organização aparece no seletor de recursos da página. O seletor de recursos permite-lhe selecionar o projeto, a pasta ou a organização a partir dos quais quer gerir os contactos essenciais.

  3. Junto a Ver por, selecione Categoria.

    Uma captura de ecrã que realça a opção para selecionar Categoria na página Contactos essenciais.

  4. Clique em Editar na mesma linha que a categoria cujos contactos quer gerir.

    Uma captura de ecrã que realça a opção para editar um contacto na página Contactos essenciais.

  5. Faça a gestão dos contactos atribuídos à categoria de notificação:

    • Para adicionar um novo contacto, clique em Adicionar contacto e siga os passos para adicionar um contacto.
    • Para alterar a categoria de notificação atribuída a um contacto, clique em Editar junto ao contacto cuja categoria quer alterar. Em seguida, selecione as categorias de notificação que quer no menu pendente Categorias de notificação e clique em Guardar.
    • Para eliminar um contacto, clique em Eliminar junto ao endereço de email do contacto.

Envie um email de teste para verificar a receção

Pode enviar um email de teste aos contactos em cada categoria para verificar se as contas de email conseguem receber emails de Google Cloud. Pode enviar um máximo de um email de teste a cada 24 horas a cada contacto em cada categoria e recurso.

Para enviar um email de teste a contactos numa categoria de notificação específica, faça o seguinte:

  1. Na Google Cloud consola, aceda à página Contactos essenciais.

    Aceda à página Contactos essenciais

  2. Certifique-se de que o nome do seu projeto, pasta ou organização aparece no seletor de recursos da página. O seletor de recursos permite-lhe selecionar o projeto, a pasta ou a organização a partir dos quais quer gerir os contactos essenciais.

  3. Junto a Ver por, selecione Categoria.

    Uma captura de ecrã que realça a opção para selecionar Categoria na página Contactos essenciais.

  4. Clique em Enviar na mesma linha que a categoria de notificação cujos contactos quer usar para enviar emails de teste.

  5. Selecione as caixas de verificação junto aos contactos aos quais quer enviar emails.

  6. Clique em Enviar. O sistema envia um email de teste aos contactos selecionados.

  7. Comunique com cada contacto para se certificar de que recebeu o email de teste de gcp-essential-contacts-noreply@google.com.

Defina configurações avançadas e automatização

Esta secção aborda opções para uma gestão mais aprofundada dos seus contactos essenciais, incluindo a restrição de domínios de contacto, a utilização de infraestrutura como código (IaC) com o Terraform para automatização e a criação de políticas de organização personalizadas.

Limite os domínios permitidos para contactos

Para restringir os domínios de endereços de email que os novos contactos podem ter, defina a restrição da política da organização constraints/essentialcontacts.allowedContactDomains. Os contactos existentes não são afetados por esta restrição.

Para saber como definir restrições de políticas de organização, consulte o artigo Criar e gerir políticas de organização.

Faça a gestão de contactos com o Terraform

Pode usar o Terraform para gerir os seus contactos essenciais. Os contactos têm o seguinte formato na linguagem Terraform:

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

Quando gere um contacto, substitua o seguinte:

  • RESOURCE_TYPE: o tipo de recurso onde quer gerir o contacto. Use o valor projects, folders ou organizations.
  • RESOURCE_ID: o ID do seu Google Cloud projeto, organização ou pasta. Os IDs dos projetos são strings alfanuméricas, como my-project. Os IDs das pastas e das organizações são numéricos, como 123456789012.
  • EMAIL: o endereço de email do seu contacto. Não pode alterar este campo depois de criar o contacto.
  • LANGUAGE: opcional. O código de idioma do idioma de notificação preferido do contacto. Pode incluir o código do idioma de qualquer um dos idiomas suportados.

  • NOTIFICATION_CATEGORY: uma matriz das categorias para as quais quer que o contacto receba notificações, como ["BILLING", "LEGAL"]. Esta matriz pode conter qualquer um dos seguintes valores:

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

    Para ver uma lista de categorias de notificações e contactos recomendados, consulte o artigo Categorias de notificações.

Para adicionar, modificar ou remover um contacto, adicione, modifique ou remova um recurso de contacto no ficheiro de configuração do Terraform. Para mais detalhes, consulte a documentação dos contactos essenciais do Terraform.

O que se segue?