Muitas ofertas do Google Cloud, como o Cloud Billing, enviam notificações para e compartilhar informações importantes com os usuários do Google Cloud. Por padrão, essas notificações são enviadas para membros com determinados papéis de gerenciamento de identidade e acesso (IAM). Com os contatos essenciais, você pode personalizar quem recebe notificações fornecendo sua própria lista de contatos.
Antes de começar
Ative a Essential Contacts API.
Funções exigidas
Para ter as permissões necessárias para gerenciar contatos, peça ao administrador para conceder a você os seguintes papéis do IAM o projeto, a pasta ou a organização a que o contato foi atribuído :
-
Para ver contatos:
Leitor de contatos essenciais (
roles/essentialcontacts.viewer
) -
Para ver, editar, excluir e criar contatos:
Administrador de contatos essenciais (
roles/essentialcontacts.admin
)
Para mais informações sobre como conceder papéis, consulte Gerenciar acesso.
Esses papéis predefinidos têm as permissões necessárias para gerenciar contatos. Para conferir as permissões exatas necessárias, expanda a seção Permissões necessárias:
Permissões necessárias
As seguintes permissões são necessárias para gerenciar contatos:
-
Para ver contatos:
-
essentialcontacts.contacts.get
-
essentialcontacts.contacts.list
-
-
Para editar, excluir e criar contatos:
-
essentialcontacts.contacts.create
-
essentialcontacts.contacts.delete
-
essentialcontcts.contacts.update
-
Essas permissões também podem ser concedidas com funções personalizadas ou outros papéis predefinidos.
Categorias de notificação
Você pode atribuir contatos a várias categorias de notificação. Se você não adicionar um contato para uma categoria, as notificações nessa categoria vão para o contato substituto, que é selecionada com base nas papéis do IAM. Recomendamos adicionar contatos personalizados, sem depender de contatos substitutos, para ajudar a garantir que as pessoas corretas recebem notificações sobre seu projeto, pasta ou organização.
Você pode adicionar pessoas e grupos como contatos. Para reduzir o impacto de mudanças na equipe, recomendamos adicionar grupos como contatos e gerenciar a associação a esses grupos para determinar quem recebe as notificações. Isso ajuda a garantir que as notificações sejam sempre enviadas aos funcionários ativos.
Consulte a tabela a seguir para saber mais sobre as categorias de notificações. substitutos e contatos recomendados. Se você não atribuir um contato determinada categoria, as notificações são enviadas para o contato substituto.
Categoria | Descrição | Exemplos | Contato de reserva | Contato recomendado |
---|---|---|---|---|
Todos | Todas as notificações de todas as outras categorias | N/A | N/A | pessoas ou sistemas automatizados responsáveis por rotear ou registrar um grande número de notificações |
Faturamento | Notificações de faturamento e pagamento | Atualizações de preço, erros e créditos | Administrador da conta de faturamento (roles/billing.admin ) |
Equipe de departamento financeiro e pessoas que gerenciam sua relação financeira com o Google, incluindo pessoas que gerenciam orçamentos, planejamento e contas relacionadas ao uso do Google Cloud |
Jurídico | Notificações de conformidade legal | Ações de restrição, conformidade regulatória, notificações do governo | Administrador da conta de faturamento (roles/billing.admin ) |
Conselho jurídico, gerentes de compliance, especialistas em relações governamentais e outros profissionais do gênero |
Atualizações do produto | Mudanças nos produtos do Google | Novas versões, atualizações de termos do produto, suspensões | Proprietário do projeto (roles/owner ) |
Gerentes de produtos, arquitetos e engenheiros que podem se beneficiar de informações oportunas sobre mudanças em produtos e serviços do Google |
Segurança | Notificações de problemas de segurança/privacidade | Vulnerabilidades, incidentes de dados e ataques | Administrador da organização (roles/resourcemanager.organizationAdmin ) |
Segurança de TI, as operações e de outras pessoas cuja função é proteger os dados da empresa e dos clientes e garantir a continuidade dos negócios |
Suspensão | Notificações relacionadas à suspensão imediata da conta e do projeto | Conformidade de avaliação da Apigee, violações de direitos autorais e mineração de moedas | Proprietário do projeto (roles/owner ) |
Pessoas imediatamente responsáveis por manter a infraestrutura de TI e os aplicativos comerciais funcionando |
Técnico | Eventos técnicos e outros problemas operacionais | Erros de configuração do Logging, atualizações da Prevenção contra perda de dados e status do Actions on Google | Proprietário do projeto (roles/owner ) |
Profissionais de TI, engenheiros de confiabilidade, administradores, listas de plantão e outras pessoas que precisam saber sobre eventos técnicos atuais e futuros e problemas para gerenciar melhor seus ativos de TI e evitar interrupções |
Idiomas compatíveis
Nos Contatos essenciais, cada contato tem uma configuração de idioma preferencial. Os criadores de notificações podem consultar essa configuração ao enviar notificações.
Quando você adiciona um contato no console do Google Cloud, configura automaticamente o idioma preferido do contato com base na do criador de conteúdo configurações de idioma preferenciais. Ao adicionar um contato usando a API, você configura manualmente o idioma de preferência do contato usando um código de idioma. Esse código pode ser qualquer um dos idiomas compatíveis com os contatos essenciais.
Práticas recomendadas para atribuir contatos
Você pode atribuir contatos no nível do projeto, da pasta ou da organização.
Os contatos são herdados por meio da hierarquia de recursos do Google Cloud. Como resultado, se você adicionar um contato no nível da organização, eles receberão notificações sobre a organização e sobre todas as pastas e projetos na organização. Da mesma forma, se você adicionar um contato no nível da pasta, eles receberão notificações sobre a pasta e todos os projetos e pastas dentro dela.
O local a que você decide atribuir contatos depende da estrutura da organização. No entanto, geralmente recomendamos atribuir contatos nos seguintes níveis, com base na respectiva categoria de notificação:
Nível recomendado | Categoria da notificação |
---|---|
Nível da organização |
|
Nível de pasta/projeto |
|
1 O nível de atribuição dos contatos de segurança depende dos seus práticas de segurança específicas da organização. Por exemplo, se um projeto individual são responsáveis pela segurança dos próprios projetos, você atribui e contatos de segurança no nível do projeto. No entanto, se um grupo em toda a organização gerencia a segurança de todos os projetos, você atribui seus contatos de segurança em no nível da organização.
2 Os contatos da categoria técnica recebem um grande número de e-mails notificações. Atribua esses contatos na pasta ou no projeto para ativar para processar o fluxo de notificações recebidas.
Limitar os domínios permitidos para contatos
Para restringir os domínios de endereços de e-mail que os novos contatos podem ter, defina o
restrição de política da organização
constraints/essentialcontacts.allowedContactDomains
: Atual
contatos não são afetados por essa restrição.
Para aprender a definir restrições de políticas da organização, consulte Restrições da política da organização.
Como listar contatos
Para listar todos os contatos do seu projeto, pasta ou organização, faça o seguinte:
Console
No console do Google Cloud, acesse a página Contatos essenciais.
Verifique se o nome do projeto, da pasta ou da organização aparece seletor de recursos na parte superior da página. O seletor de recursos informa o que projeto, pasta ou organização da qual você está gerenciando contatos no momento.
Para listar os contatos por categoria, selecione Categoria. Para listar os contatos em ordem alfabética, selecione Contatos.
gcloud
-
No Console do Google Cloud, ative o Cloud Shell.
Na parte inferior do Console do Google Cloud, uma sessão do Cloud Shell é iniciada e exibe um prompt de linha de comando. O Cloud Shell é um ambiente shell com a CLI do Google Cloud já instalada e com valores já definidos para o projeto atual. A inicialização da sessão pode levar alguns segundos.
-
Com a Google Cloud CLI, é possível listar os contatos definidos no
um recurso ou listar todos os contatos e contatos herdados de um recurso.
Como listar contatos definidos em um recurso
Para visualizar os contatos que foram definidos em um projeto, uma pasta ou um organização, use o
gcloud essential-contacts list
comando:gcloud essential-contacts list --RESOURCE_TYPE="RESOURCE_ID"
Substitua os seguintes valores:
RESOURCE_TYPE
: o tipo de recurso para o qual você quer listar os contatos. Use o valorproject
,folder
ouorganization
.RESOURCE_ID
: seu projeto do Google Cloud, a organização ou o ID da pasta. Os IDs do projeto são strings alfanuméricas, comomy-project
. Os códigos de pastas e organizações são numéricos, como123456789012
.
Como alternativa, se você não especificar um tipo ou ID de recurso, o A CLI gcloud lista os contatos do projeto atual.
A resposta é semelhante a:
--- 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 ---
Como listar contatos e contatos herdados
Os recursos filhos (pastas e projetos) herdam os contatos dos ancestrais (organizações e outras pastas). Se quiser listar todos os contatos e contatos herdados de um recurso, use a Comando
gcloud essential-contacts compute
:gcloud essential-contacts compute --notification-categories="NOTIFICATION_CATEGORY" \ --RESOURCE_TYPE="RESOURCE_ID"
Substitua os seguintes valores:
Antes de usar algum dos dados de solicitação abaixo, faça as substituições a seguir:
NOTIFICATION_CATEGORIES
: uma lista separada por vírgulas dos categorias de notificação para as quais você quer computar contatos. A lista pode conter qualquer um destes valores:all
,billing
,legal
,product-updates
,security
,suspension
,technical
, enotification-category-unspecified
. Como escolher um valor de listasall
contatos de todas as categorias.RESOURCE_TYPE
: o tipo de recurso para os qual você quer calcular os contatos. Use o valorproject
,folder
ouorganization
.RESOURCE_ID
: seu projeto do Google Cloud, a organização ou o ID da pasta. Os IDs do projeto são strings alfanuméricas, comomy-project
. Os códigos de pastas e organizações são numéricos, como123456789012
.
Se você não especificar um tipo e ID de recurso, a CLI gcloud lista os contatos do projeto atual.
A resposta lista todos os contatos e os contatos herdados do 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
Com a API REST do Essential Contacts, é possível listar os contatos definido em um recurso ou listar todos os contatos e contatos herdados de um recurso.
Como listar contatos definidos em um recurso
Para visualizar os contatos que foram definidos em um projeto, uma pasta ou um
organização, use o contacts.list
da API Essential Contacts
.
Antes de usar algum dos dados de solicitação abaixo, faça as substituições a seguir:
RESOURCE_TYPE
: o tipo de recurso para o qual você quer listar os contatos. Use o valorprojects
,folders
ouorganizations
.RESOURCE_ID
: seu projeto do Google Cloud, a organização ou o ID da pasta. Os IDs do projeto são strings alfanuméricas, comomy-project
. Os códigos de pastas e organizações são numéricos, como123456789012
.PAGE_SIZE
: opcional. O número de contatos a serem incluídos na resposta. O valor padrão é 50, e o valor máximo é 100. Se o número de contatos for maior que o tamanho da página, a resposta conterá um token de paginação que pode ser usado para recuperar a próxima página de resultados.NEXT_PAGE_TOKEN
: opcional. O token de paginação retornado em uma resposta anterior usando esse método. Se especificada, a lista de contatos começa onde a resposta anterior foi finalizada.
Solicitação:
GET essentialcontacts.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/contacts?pageSize=PAGE_SIZE&pageToken=NEXT_PAGE_TOKEN
Para enviar a solicitação, expanda uma destas opções:
curl (Linux, macOS ou Cloud Shell)
Execute o seguinte 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)
execute o seguinte 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
Depois de enviar a solicitação, você receberá uma resposta JSON semelhante a esta:
{ "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" } ] }
Como listar contatos e contatos herdados
Os recursos filhos (pastas e projetos) herdam os contatos dos ancestrais
(organizações e outras pastas). Se quiser listar todos os contatos e
contatos herdados de um recurso, use o método contacts.compute
da API Corees Contacts.
Antes de usar algum dos dados de solicitação abaixo, faça as substituições a seguir:
RESOURCE_TYPE
: o tipo de recurso para os qual você quer calcular os contatos. Use o valorprojects
,folders
ouorganizations
.RESOURCE_ID
: seu projeto do Google Cloud, a organização ou o ID da pasta. Os IDs do projeto são strings alfanuméricas, comomy-project
. Os códigos de pastas e organizações são numéricos, como123456789012
.NOTIFICATION_CATEGORY
: as categorias de notificações para as quais você quer calcular contatos. Você pode repetir esse campo para listar contatos de várias categorias de notificação. ONOTIFICATION_CATEGORY
pode ser qualquer um dos seguintes valores: valores:ALL
,BILLING
,LEGAL
,PRODUCT_UPDATES
,SECURITY
,SUSPENSION
,TECHNICAL
, eNOTIFICATION_CATEGORY_UNSPECIFIED
. Como escolher um valor de listasALL
contatos de todas as categorias.PAGE_SIZE
: opcional. O número de contatos a serem incluídos na resposta. O valor padrão é 50, e o valor máximo é 100. Se o número de contatos for maior que o tamanho da página, a resposta conterá um token de paginação que pode ser usado para recuperar a próxima página de resultados.NEXT_PAGE_TOKEN
: opcional. O token de paginação retornado em uma resposta anterior usando esse método. Se especificada, a lista de contatos começa onde a resposta anterior foi finalizada.
Solicitação:
GET essentialcontacts.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/contacts:compute?notificationCategories=NOTIFICATION_CATEGORY&pageSize=PAGE_SIZE&pageToken=NEXT_PAGE_TOKEN
Para enviar a solicitação, expanda uma destas opções:
curl (Linux, macOS ou Cloud Shell)
execute o seguinte 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)
execute o seguinte 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
A resposta lista todos os contatos e os contatos herdados do 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" } ] }
Como gerenciar contatos essenciais individuais
Você pode adicionar contatos, removê-los ou atribuir categorias de notificação a eles na página Contatos essenciais no console do Google Cloud ou usando a API REST.
Como adicionar um contato
Para adicionar um contato, faça o seguinte:
Console
No console do Google Cloud, acesse a página Contatos essenciais.
Verifique se o nome do projeto, da pasta ou da organização aparece seletor de recursos na parte superior da página. O seletor de recursos informa o que projeto, pasta ou organização da qual você está gerenciando contatos no momento.
Clique em
Adicionar contato.Nos campos E-mail e Confirmar e-mail, insira o endereço de e-mail do contato.
No menu suspenso Categorias de notificação, selecione as categorias de notificação das quais você quer que o contato receba comunicações. Para ver uma lista de categorias de notificação e contatos recomendados, consulte Como identificar contatos nesta página.
Clique em Salvar.
gcloud
-
No Console do Google Cloud, ative o Cloud Shell.
Na parte inferior do Console do Google Cloud, uma sessão do Cloud Shell é iniciada e exibe um prompt de linha de comando. O Cloud Shell é um ambiente shell com a CLI do Google Cloud já instalada e com valores já definidos para o projeto atual. A inicialização da sessão pode levar alguns segundos.
Para adicionar um novo contato, use o comando gcloud Essentials-contacts create:
gcloud essential-contacts create --email="EMAIL" \ --notification-categories="NOTIFICATION_CATEGORIES" \ --language="LANGUAGE" \ --RESOURCE_TYPE="RESOURCE_ID"
Substitua os seguintes valores:
EMAIL
: o endereço de e-mail do seu contato. Não é possível alterar esse campo depois de criar o contato.NOTIFICATION_CATEGORIES
: uma lista separada por vírgulas dos as categorias de notificação que você quer que o contato receba. comunicações. A lista pode conter qualquer um destes valores:all
,billing
,legal
eproduct-updates
.security
,suspension
,technical
, incidentes técnicos enotification-category-unspecified
. Como escolher um valor de listasall
contatos de todas as categorias.Para consultar uma lista de contatos recomendados para cada categoria, consulte Identificação de contatos nesta página.
LANGUAGE
: o código do idioma do contato idioma de notificação de sua preferência. Você pode incluir o código de idioma de qualquer um idiomas compatíveis.RESOURCE_TYPE
: o tipo de recurso que você quer criar um contato. Use o valorproject
,folder
ouorganization
RESOURCE_ID
: seu projeto do Google Cloud. organização ou ID da pasta. Os IDs de projeto são strings alfanuméricas, comomy-project
: Os códigos de pastas e organizações são numéricos, como123456789012
.
Se você não especificar um tipo e ID de recurso, a CLI gcloud cria um contato no projeto atual.
Se o comando for bem-sucedido, nenhuma resposta será retornada.
REST
Para adicionar um novo contato, use o método contacts.create
da API
Essential Contacts.
Antes de usar algum dos dados de solicitação abaixo, faça as substituições a seguir:
RESOURCE_TYPE
: o tipo de recurso que você quer criar um contato. Use o valorprojects
,folders
ouorganizations
.RESOURCE_ID
: seu projeto do Google Cloud, a organização ou o ID da pasta. Os IDs do projeto são strings alfanuméricas, comomy-project
. Os códigos de pastas e organizações são numéricos, como123456789012
.EMAIL
: o endereço de e-mail do seu contato. Não é possível alterar esse campo depois de criar o contato.NOTIFICATION_CATEGORY_1
eNOTIFICATION_CATEGORY_2
: as categorias de notificação das quais você quer que o contato receba comunicações. Esse valor pode ser qualquer um destes:ALL
,BILLING
,LEGAL
,PRODUCT_UPDATES
,SECURITY
,SUSPENSION
,TECHNICAL
.Se quiser ver uma lista de contatos recomendados para cada categoria, consulte Como identificar contatos nesta página.
LANGUAGE
: o código para o idioma de notificação preferencial do contato. É possível incluir o código de um dos idiomas compatíveis.
Solicitação:
POST essentialcontacts.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/contacts
Corpo da solicitação:
{ "email": "EMAIL", "notificationCategorySubscriptions": [ "NOTIFICATION_CATEGORY_1", "NOTIFICATION_CATEGORY_2" ], "languageTag": "LANGUAGE" }
Para enviar a solicitação, expanda uma destas opções:
Depois de enviar a solicitação, você receberá uma resposta JSON semelhante a esta:
{ "name": "projects/my-project/contacts/3", "email": "my-new-contact@example.com", "notificationCategorySubscriptions": [ "SUSPENSION", "TECHNICAL" ], "languageTag": "en" }
Como alterar um contato
Para alterar as categorias atribuídas a um contato, faça o seguinte:
Console
No console do Google Cloud, acesse a página Contatos essenciais.
Verifique se o nome do projeto, da pasta ou da organização aparece seletor de recursos na parte superior da página. O seletor de recursos informa o que projeto, pasta ou organização da qual você está gerenciando contatos no momento.
Ao lado de Visualizar por, selecione Contato.
Clique em
ao lado do contato cuja categoria você quer alterar.Selecione as categorias de notificação que você quer no menu suspenso Categorias de notificação e clique em Salvar.
gcloud
-
No Console do Google Cloud, ative o Cloud Shell.
Na parte inferior do Console do Google Cloud, uma sessão do Cloud Shell é iniciada e exibe um prompt de linha de comando. O Cloud Shell é um ambiente shell com a CLI do Google Cloud já instalada e com valores já definidos para o projeto atual. A inicialização da sessão pode levar alguns segundos.
Para atualizar um contato existente, use o comando gcloud Essentials-contacts update:
gcloud essential-contacts update CONTACT_ID \ --notification-categories="NOTIFICATION_CATEGORIES" \ --language="LANGUAGE" --RESOURCE_TYPE="RESOURCE_ID"
Substitua os seguintes valores:
CONTACT_ID
: o ID numérico do contato que você quer atualizar. Para ver os IDs de todos os contatos no seu projeto, pasta ou organização, liste seus contatos. O ID numérico é tudo o que aparece depoiscontacts
no nome do contato.NOTIFICATION_CATEGORIES
: uma lista separada por vírgulas dos as novas categorias de notificação que você quer que o contato receba comunicações. Esta lista substituirá a atual de notificações categorias.A lista pode conter qualquer um destes valores:
all
,billing
,legal
,product-updates
,security
,suspension
,technical
, incidentes técnicos enotification-category-unspecified
. Como escolher um valor de listasall
contatos de todas as categorias.Para consultar uma lista de contatos recomendados para cada categoria, consulte Identificação de contatos nesta página.
LANGUAGE
: o código do idioma do contato idioma de notificação de sua preferência. Você pode incluir o código de idioma de qualquer um idiomas compatíveis.RESOURCE_TYPE
: o tipo de recurso que o contato é definido. Use o valorproject
,folder
ouorganization
.RESOURCE_ID
: o ID do projeto do Google Cloud; organização ou pasta em que o contato é definido. Os IDs de projeto são strings alfanuméricas, comomy-project
. Os IDs de pastas e organizações são numérico, como123456789012
.
Se você não especificar um tipo e ID de recurso, a CLI gcloud atualiza o contato com o ID especificado no projeto atual. Se não houver contato com o ID especificado, a CLI gcloud retornará um erro.
Se o comando for bem-sucedido, nenhuma resposta será retornada.
REST
Para alterar as assinaturas de notificação ou o idioma preferido de um contato
existente, use o método contacts.patch
da API Essential
Contacts.
Antes de usar algum dos dados de solicitação abaixo, faça as substituições a seguir:
RESOURCE_TYPE
: o tipo de recurso para o qual você quer listar os contatos. Use o valorprojects
,folders
ouorganizations
.RESOURCE_ID
: seu projeto do Google Cloud, a organização ou o ID da pasta. Os IDs do projeto são strings alfanuméricas, comomy-project
. Os códigos de pastas e organizações são numéricos, como123456789012
.CONTACT_ID
: o ID numérico do contato que você quer atualizar. Para ver os IDs de todos os contatos no seu projeto, pasta ou organização, liste seus contatos. O ID numérico é tudo o que aparece depoiscontacts
no nome do contato.UPDATE_MASK
: opcional. Uma máscara que descreve os campos do contato que você alterou. O formato da máscara é uma lista separada por vírgulas de nomes de campos totalmente qualificados, por exemplo:notificationCategorySubscriptions,languageTag
.EMAIL
: o endereço de e-mail do seu contato. Este campo precisa corresponder ao endereço de e-mail associado ao CONTACT_ID que você inclui na solicitação.NOTIFICATION_CATEGORY_1
eNOTIFICATION_CATEGORY_2
: opcional. As categorias de notificação atualizadas que você quer que o contato receba. Este valor pode ser qualquer um dos seguintes:ALL
,BILLING
,LEGAL
,PRODUCT_UPDATES
,SECURITY
,SUSPENSION
,TECHNICAL
.Se quiser ver uma lista de contatos recomendados para cada categoria, consulte Como identificar contatos nesta página.
LANGUAGE
: o código para o idioma de notificação preferencial do contato. É possível incluir o código de um dos idiomas compatíveis.
Solicitação:
PATCH essentialcontacts.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/contacts/CONTACT_ID?updateMask="UPDATE_MASK"
Corpo da solicitação:
{ "name": "RESOURCE_TYPE/RESOURCE_ID/contact/CONTACT_ID", "email": "EMAIL", "notificationCategorySubscriptions": [ "NOTIFICATION_CATEGORY_1", "NOTIFICATION_CATEGORY_2" ], "languageTag": "LANGUAGE" }
Para enviar a solicitação, expanda uma destas opções:
Depois de enviar a solicitação, você receberá uma resposta JSON semelhante a esta:
{ "name": "projects/my-project/contacts/2", "email": "my-new-contact@example.com", "notificationCategorySubscriptions": [ "ALL" ], "languageTag": "en" }
Como excluir um contato
Para excluir um contato, faça o seguinte:
Console
No console do Google Cloud, acesse a página Contatos essenciais.
Verifique se o nome do projeto, da pasta ou da organização aparece seletor de recursos na parte superior da página. O seletor de recursos informa o que projeto, pasta ou organização da qual você está gerenciando contatos no momento.
Ao lado de Visualizar por, selecione Contato.
Clique em .
ao lado do o endereço de e-mail do contato que você quer excluir. Depois, na caixa de diálogo, confirme em que você quer excluir o contato.
gcloud
-
No Console do Google Cloud, ative o Cloud Shell.
Na parte inferior do Console do Google Cloud, uma sessão do Cloud Shell é iniciada e exibe um prompt de linha de comando. O Cloud Shell é um ambiente shell com a CLI do Google Cloud já instalada e com valores já definidos para o projeto atual. A inicialização da sessão pode levar alguns segundos.
Para excluir um contato existente, use o comando gcloud Essentials-contacts delete:
gcloud essential-contacts delete CONTACT_ID \ --RESOURCE_TYPE="RESOURCE_ID"
Substitua os seguintes valores:
CONTACT_ID
: o ID numérico do contato que você quer excluir. Para ver os IDs de todos os contatos no seu projeto, pasta ou organização, liste seus contatos. O ID numérico é tudo o que aparece depoiscontacts
no nome do contato.RESOURCE_TYPE
: o tipo de recurso que o contato é definido. Use o valorproject
,folder
ouorganization
.RESOURCE_ID
: o ID do projeto do Google Cloud; organização ou pasta em que o contato é definido. Os IDs de projeto são strings alfanuméricas, comomy-project
. Os IDs de pastas e organizações são numérico, como123456789012
.
Se você não especificar um tipo e ID de recurso, a CLI gcloud exclui o contato com o ID especificado no projeto atual. Se não houver contato com o ID especificado, a CLI gcloud retornará um erro.
Se o comando for bem-sucedido, nenhuma resposta será retornada.
REST
Para excluir um contato, use o método contacts.delete
da API
Essential Contacts.
Antes de usar algum dos dados de solicitação abaixo, faça as substituições a seguir:
RESOURCE_TYPE
: o tipo de recurso para o qual você quer listar os contatos. Use o valorprojects
,folders
ouorganizations
.RESOURCE_ID
: seu projeto do Google Cloud, a organização ou o ID da pasta. Os IDs do projeto são strings alfanuméricas, comomy-project
. Os códigos de pastas e organizações são numéricos, como123456789012
.CONTACT_ID
: o ID numérico do contato. Para ver os códigos de todos os contatos no seu projeto, pasta ou organização, liste seus contatos.
Solicitação:
DELETE essentialcontacts.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/contacts/CONTACT_ID
Para enviar a solicitação, expanda uma destas opções:
Se a solicitação for bem-sucedida, o corpo da resposta estará vazio.
Como gerenciar contatos por categoria
No console do Google Cloud, também é possível gerenciar contatos por categoria acessar a guia Categoria na página Contatos essenciais.
Para adicionar, alterar ou excluir os contatos atribuídos a uma única categoria, faça o seguinte:
No console do Google Cloud, acesse a página Contatos essenciais.
Verifique se o nome do projeto, da pasta ou da organização aparece seletor de recursos na parte superior da página. O seletor de recursos informa o que projeto, pasta ou organização da qual você está gerenciando contatos no momento.
Ao lado de Visualizar por, selecione Categoria.
Clique em
na mesma linha da categoria com os contatos que você quer gerenciar.Gerencie os contatos atribuídos à categoria:
- Para adicionar um novo contato, clique em Adicionar contato e siga as etapas para adicionar um contato descrito nesta página.
Para alterar a categoria a que um contato é atribuído, clique em
ao lado do contato cuja categoria você quer alterar. Em seguida, selecione as categorias de notificação que você quer no menu suspenso Categorias de notificação e clique em Salvar.Para excluir um contato, clique em
ao lado do endereço de e-mail do contato.
Como verificar transmissões de e-mail
Você pode enviar um e-mail de teste aos contatos em cada categoria para verificar se os contas de e-mail possam receber e-mails do Google Cloud.
Para enviar um e-mail de teste aos contatos em uma categoria específica, faça o seguinte:
No console do Google Cloud, acesse a página Contatos essenciais.
Verifique se o nome do projeto, da pasta ou da organização aparece seletor de recursos na parte superior da página. O seletor de recursos mostra projeto, pasta ou organização da qual você está gerenciando contatos no momento.
Ao lado de Visualizar por, selecione Categoria.
Clique em .
na mesma linha como a categoria cujos contatos você deseja enviar e-mails de teste.Marque as caixas de seleção ao lado dos contatos para os quais você quer enviar e-mails.
Clique em Enviar. Um e-mail de teste é enviado para os contatos selecionados.
Comunicar-se com cada contato para garantir que eles receberam um e-mail de teste de gcp-essential-contacts-noreply@google.com.
Como gerenciar contatos com o Terraform
O Terraform pode ser usado para gerenciar seus contatos de notificação. Os contatos têm seguinte formato na linguagem do Terraform:
resource "google_essential_contacts_contact" "contact" { parent = "RESOURCE_TYPE/RESOURCE_ID" email = "EMAIL" language_tag = "LANGUAGE" notification_category_subscriptions = NOTIFICATION_CATEGORIES }
Ao criar um contato, substitua os seguintes valores:
RESOURCE_TYPE
: o tipo de recurso para o qual você quer listar os contatos. Use o valorprojects
,folders
ouorganizations
.RESOURCE_ID
: seu projeto do Google Cloud, a organização ou o ID da pasta. Os IDs do projeto são strings alfanuméricas, comomy-project
. Os códigos de pastas e organizações são numéricos, como123456789012
.EMAIL
: o endereço de e-mail do seu contato. Não é possível alterar esse campo depois de criar o contato.LANGUAGE
: opcional. O código do idioma do idioma de notificação preferido do contato. Você pode incluir o código do idioma de qualquer um dos idiomas compatíveis.NOTIFICATION_CATEGORIES
: uma matriz da notificação. sobre as quais o contato deve receber comunicações. Por exemplo,["BILLING", "LEGAL"]
.Essa matriz pode conter qualquer um destes valores:
ALL
,BILLING
,LEGAL
,PRODUCT_UPDATES
,SECURITY
,SUSPENSION
eTECHNICAL
.Se quiser ver uma lista de contatos recomendados para cada categoria, consulte Como identificar contatos nesta página.
Para adicionar, modificar ou remover um contato, adicionar, modificar ou remover um recurso de contato no arquivo de configuração do Terraform.
Para mais detalhes, consulte a Documentação dos contatos essenciais do Terraform (em inglês).
A seguir
- Saiba como associar um domínio a um projeto para fins de verificação.
- Entenda como gerenciar suas preferências de notificação.