Gerenciar contatos essenciais

Console

1. No console Trusted Cloud , acesse a página Contatos essenciais.

   Acessar a página "Contatos essenciais"

2. Certifique-se de que o nome do projeto, da pasta ou da organização apareça no seletor de recursos da página. Com o seletor de recursos, você pode escolher o projeto, a pasta ou a organização em que quer ver os contatos essenciais.

3. Ao lado de Visualizar por, escolha uma das seguintes opções:

   • Para ver a lista de contatos por categoria, selecione Categoria.
   • Para ver a lista de contatos em ordem alfabética, selecione Contato.

gcloud

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

   Activate Cloud Shell

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

2. Com a Google Cloud CLI, é possível listar os contatos definidos em um recurso ou todos os contatos e contatos herdados de um recurso.

   Listar contatos definidos em um recurso

   Para conferir os contatos essenciais definidos em um projeto, pasta ou organização específica, use o comando gcloud essential-contacts list:

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

   Substitua:

   • RESOURCE_TYPE: o tipo de recurso de que você quer listar os contatos. Use o valor project, folder ou organization.
   • RESOURCE_ID: seu Trusted Cloud projeto, organização ou ID da pasta. Os IDs do projeto são strings alfanuméricas, como my-project. Os IDs de pastas e organizações são numéricos, como 123456789012.

   Como alternativa, se você não especificar um tipo ou ID de recurso, a CLI gcloud vai listar os contatos do projeto atual.

   A resposta será 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
   ---
   

   Listar contatos e contatos herdados

   Se quiser listar todos os contatos de um recurso e os contatos herdados de um ancestral, você precisa ter uma função no recurso ancestral que inclua as permissões necessárias para visualizar contatos. Em seguida, use o comando gcloud essential-contacts compute:

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

   Substitua:

   • NOTIFICATION_CATEGORY: uma lista separada por vírgulas das categorias de notificação para as quais você quer ver contatos. 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 Categorias de notificações.

   • RESOURCE_TYPE: o tipo de recurso de que você quer ver os contatos. Use o valor project, folder ou organization.

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

   Se você não especificar um tipo e um ID de recurso, a CLI gcloud vai listar os contatos do projeto atual.

   A resposta será 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
   ---
   

REST

Com a API REST Essential Contacts, é possível listar os contatos definidos em um recurso ou todos os contatos e contatos herdados de um recurso.

Listar contatos definidos em um recurso

Para conferir os contatos definidos em um projeto, pasta ou organização específica, use o método contacts.list da API Essential Contacts.

Request:

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

Substitua:

• RESOURCE_TYPE: o tipo de recurso de que você quer listar os contatos. Use o valor projects, folders ou organizations.
• RESOURCE_ID: seu Trusted Cloud projeto, organização ou ID da pasta. Os IDs do projeto são strings alfanuméricas, como my-project. Os IDs de pastas e organizações são numéricos, como 123456789012.
• 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 vai 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.

Para enviar a solicitação, expanda uma destas opções:

curl (Linux, macOS ou Cloud Shell)

Defina a variável de ambiente GOOGLE_APPLICATION_CREDENTIALS como o caminho da chave privada da conta de serviço. Em seguida, faça a solicitação:

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 como o caminho da chave privada da conta de serviço. Em seguida, faça a solicitação:

$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ê vai receber uma resposta JSON semelhante a este 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"
    }
  ]
}

Listar contatos e contatos herdados

Se quiser listar todos os contatos de um recurso e os contatos herdados de um ancestral, você precisa ter uma função no recurso ancestral que inclua as permissões necessárias para visualizar contatos. Em seguida, use o método contacts.compute da API Essential Contacts.

Request:

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

Substitua:

• RESOURCE_TYPE: o tipo de recurso de que você quer ver os contatos. Use o valor projects, folders ou organizations.
• RESOURCE_ID: seu Trusted Cloud projeto, organização ou ID da pasta. Os IDs do projeto são strings alfanuméricas, como my-project. Os IDs de pastas e organizações são numéricos, como 123456789012.

• NOTIFICATION_CATEGORY: a categoria de notificação de que você quer ver os contatos. Você pode repetir esse campo para listar contatos de várias categorias de notificação. Ele pode ter qualquer um dos seguintes valores:

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

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

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

Para enviar a solicitação, expanda uma destas opções:

curl (Linux, macOS ou Cloud Shell)

Defina a variável de ambiente GOOGLE_APPLICATION_CREDENTIALS como o caminho da chave privada da conta de serviço. Em seguida, faça a solicitação:

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 como o caminho da chave privada da conta de serviço. Em seguida, faça a solicitação:

$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 a solicitação, você vai receber uma resposta JSON semelhante a este 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"
    }
  ]
}

Console

1. No console Trusted Cloud , acesse a página Contatos essenciais.

   Acessar a página "Contatos essenciais"

2. Certifique-se de que o nome do projeto, da pasta ou da organização apareça no seletor de recursos da página. Com o seletor de recursos, você pode escolher o projeto, a pasta ou a organização em que quer adicionar Contatos essenciais.

3. Clique em person_add Adicionar contato.

   

4. Nos campos E-mail e Confirmar e-mail, insira o endereço de e-mail do contato que você quer adicionar.

5. No menu suspenso Categorias de notificação, selecione as categorias sobre as quais você quer que o contato receba notificações.

   Para ver uma lista de categorias de notificação e contatos recomendados, consulte Categorias de notificação.

6. Clique em Salvar.

gcloud

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

   Activate Cloud Shell

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

2. Adicione um novo contato com o comando gcloud essential-contacts create:

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

   Substitua:

   • EMAIL: o endereço de e-mail do contato que você quer adicionar. Não é possível mudar esse campo depois de criar o contato.
   • NOTIFICATION_CATEGORY: uma lista separada por vírgulas das categorias de notificações que você quer que o contato receba. 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ção e contatos recomendados, consulte Categorias de notificação.
   • 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.
   • RESOURCE_TYPE: o tipo de recurso para o qual você quer criar um contato. Use o valor project, folder ou organization.
   • RESOURCE_ID: seu Trusted Cloud projeto, organização ou ID da pasta. Os IDs do projeto são strings alfanuméricas, como my-project. Os IDs de pastas e organizações são numéricos, como 123456789012.

   Se você não especificar um tipo e um ID de recurso, a CLI gcloud vai criar um contato no projeto atual.

   Se o comando for bem-sucedido, você não vai receber nenhuma resposta.

REST

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

Request:

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

Substitua:

• RESOURCE_TYPE: o tipo de recurso para o qual você quer criar um contato. Use o valor projects, folders ou organizations.
• RESOURCE_ID: seu Trusted Cloud projeto, organização ou ID da pasta. Os IDs do projeto são strings alfanuméricas, como my-project. Os IDs de pastas e organizações são numéricos, como 123456789012.
• 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 e NOTIFICATION_CATEGORY_2: as categorias de notificação que você quer que o contato receba. Para adicionar mais categorias de notificação, inclua mais desses 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ção e contatos recomendados, consulte Categorias de notificação.

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

Para enviar a solicitação, expanda uma destas opções:

curl (Linux, macOS ou Cloud Shell)

Defina a variável de ambiente GOOGLE_APPLICATION_CREDENTIALS como o caminho da chave privada da conta de serviço. Em seguida, salve o corpo da solicitação em um arquivo JSON chamado request.json e faça a solicitação:

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)

Defina a variável de ambiente GOOGLE_APPLICATION_CREDENTIALS como o caminho da chave privada da conta de serviço. Em seguida, salve o corpo da solicitação em um arquivo JSON chamado request.json e faça a solicitação:

$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
  

Depois de enviar a solicitação, você vai receber uma resposta JSON semelhante a este exemplo:

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

Console

1. No console Trusted Cloud , acesse a página Contatos essenciais.

   Acessar a página "Contatos essenciais"

2. Certifique-se de que o nome do projeto, da pasta ou da organização apareça no seletor de recursos da página. Com o seletor de recursos, você pode escolher o projeto, a pasta ou a organização em que quer gerenciar os contatos essenciais.

3. Ao lado de Visualizar por, selecione Contato.

   

4. Clique em Editar edit ao lado do contato cuja categoria de notificação você quer mudar.

   

5. Selecione as categorias de notificação que você quer modificar no menu suspenso Categorias de notificação e clique em Salvar.

Quando você gerencia contatos no console Trusted Cloud , o console Trusted Cloud configura automaticamente o idioma preferido com base nas configurações de idioma preferido do criador desse contato. Para mais informações, consulte Idiomas compatíveis.

gcloud

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

   Activate Cloud Shell

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

2. Atualize um contato com o comando gcloud essential-contacts update:

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

   Substitua:

   • 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, confira seus contatos. O ID numérico é todo o valor depois de contacts no nome do contato.
   • NOTIFICATION_CATEGORY: uma lista separada por vírgulas das novas categorias de notificações que você quer que o contato receba. Essa lista substitui a lista atual de categorias de notificação.

     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ção e contatos recomendados, consulte Categorias de notificação.
   • 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.
   • RESOURCE_TYPE: o tipo de recurso em que você quer modificar as dados de contato. Use o valor project, folder ou organization.
   • RESOURCE_ID: o ID do projeto, da organização ou da pasta Trusted Cloud em que o contato está definido. Os IDs do projeto são strings alfanuméricas, como my-project. Os IDs de pastas e organizações são numéricos, como 123456789012.

   Se você não especificar um tipo e um ID de recurso, a CLI gcloud vai atualizar o contato com o ID especificado no projeto atual. Se não houver um contato com o ID especificado, a CLI gcloud vai retornar um erro.

   Se o comando for bem-sucedido, você não vai receber nenhuma resposta.

REST

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

Request:

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

Substitua:

• RESOURCE_TYPE: o tipo de recurso em que você quer modificar as dados de contato. Use o valor projects, folders ou organizations.
• RESOURCE_ID: seu Trusted Cloud projeto, organização ou ID da pasta. Os IDs do projeto são strings alfanuméricas, como my-project. Os IDs de pastas e organizações são numéricos, como 123456789012.
• 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, confira seus contatos. O ID numérico é todo o valor após contacts no nome do contato.
• UPDATE_MASK: opcional. Uma máscara que descreve os campos do contato que você quer mudar. 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 e NOTIFICATION_CATEGORY_2: opcional. As categorias atualizadas que você quer que o contato receba notificações. Para adicionar mais categorias de notificação, inclua mais desses 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ção e contatos recomendados, consulte Categorias de notificação.

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

Para enviar a solicitação, expanda uma destas opções:

curl (Linux, macOS ou Cloud Shell)

Defina a variável de ambiente GOOGLE_APPLICATION_CREDENTIALS como o caminho da chave privada da conta de serviço. Em seguida, salve o corpo da solicitação em um arquivo JSON chamado request.json e faça a solicitação:

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)

Defina a variável de ambiente GOOGLE_APPLICATION_CREDENTIALS como o caminho da chave privada da conta de serviço. Em seguida, salve o corpo da solicitação em um arquivo JSON chamado request.json e faça a solicitação:

$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
  

Depois de enviar a solicitação, você vai receber uma resposta JSON semelhante a este exemplo:

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

Console

1. No console Trusted Cloud , acesse a página Contatos essenciais.

   Acessar a página "Contatos essenciais"

2. Certifique-se de que o nome do projeto, da pasta ou da organização apareça no seletor de recursos da página. Com o seletor de recursos, você pode selecionar o projeto, a pasta ou a organização de que quer excluir os contatos essenciais.

3. Ao lado de Visualizar por, selecione Contato.

   

4. Clique em Excluir delete ao lado do endereço de e-mail do contato que você quer excluir. Na caixa de diálogo, confirme a exclusão do contato.

   

gcloud

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

   Activate Cloud Shell

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

2. Exclua um contato usando o comando gcloud essential-contacts delete:

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

   Substitua:

   • 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, confira seus contatos. O ID numérico é todo o valor depois de contacts no nome do contato.
   • RESOURCE_TYPE: o tipo de recurso em que o contato está definido. Use o valor project, folder ou organization.
   • RESOURCE_ID: o ID do projeto, da organização ou da pasta Trusted Cloud em que o contato está definido. Os IDs do projeto são strings alfanuméricas, como my-project. Os IDs de pastas e organizações são numéricos, como 123456789012.

   Se você não especificar um tipo e um ID de recurso, a CLI gcloud vai excluir o contato com o ID especificado no projeto atual. Se não houver um contato com o ID especificado, a CLI gcloud vai retornar um erro.

   Se o comando for bem-sucedido, você não vai receber nenhuma resposta.

REST

Para excluir um contato, use o método contacts.delete da API Essential Contacts.

Request:

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

Substitua:

• RESOURCE_TYPE: o tipo de recurso em que o contato está definido. Use o valor projects, folders ou organizations.
• RESOURCE_ID: seu Trusted Cloud projeto, organização ou ID da pasta. Os IDs do projeto são strings alfanuméricas, como my-project. Os IDs de pastas e organizações são numéricos, como 123456789012.
• 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, acesse seus contatos. O ID numérico é todo o valor após contacts no nome do contato.

Para enviar a solicitação, expanda uma destas opções:

curl (Linux, macOS ou Cloud Shell)

Defina a variável de ambiente GOOGLE_APPLICATION_CREDENTIALS como o caminho da chave privada da conta de serviço. Em seguida, faça a solicitação:

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)

Defina a variável de ambiente GOOGLE_APPLICATION_CREDENTIALS como o caminho da chave privada da conta de serviço. Em seguida, faça a solicitação:

$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
  

Se a solicitação for bem-sucedida, o corpo da resposta estará vazio.