Gestisci i contatti fondamentali

Console

1. Nella console Trusted Cloud , vai alla pagina Contatti fondamentali.

   Vai alla pagina Contatti fondamentali

2. Assicurati che il nome del progetto, della cartella o dell'organizzazione venga visualizzato nel selettore di risorse della pagina. Il selettore di risorse consente di selezionare il progetto, la cartella o l'organizzazione da cui vuoi visualizzare i contatti essenziali.

3. Accanto a Visualizza per, puoi scegliere una delle seguenti opzioni:

   • Per visualizzare l'elenco dei contatti per categoria, seleziona Categoria.
   • Per visualizzare l'elenco dei contatti in ordine alfabetico, seleziona Contatto.

gcloud

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

   Activate Cloud Shell

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

2. Con Google Cloud CLI, puoi elencare i contatti definiti in una risorsa o elencare tutti i contatti e i contatti ereditati per una risorsa.

   Elenca i contatti definiti in una risorsa

   Per visualizzare i contatti fondamentali definiti in un progetto, una cartella o un'organizzazione specifici, utilizza il comando gcloud essential-contacts list:

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

   Sostituisci quanto segue:

   • RESOURCE_TYPE: il tipo di risorsa da cui vuoi elencare i contatti. Utilizza il valore project, folder o organization.
   • RESOURCE_ID: il tuo Trusted Cloud progetto, organizzazione o ID cartella. Gli ID progetto sono stringhe alfanumeriche, comemy-project. Gli ID cartella e organizzazione sono numerici, ad esempio 123456789012.

   In alternativa, se non specifichi un tipo o un ID risorsa, la gcloud CLI elenca i contatti del progetto corrente.

   La risposta è simile al seguente esempio:

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

   Elenco contatti e contatti ereditati

   Se vuoi elencare tutti i contatti di una risorsa e i relativi contatti ereditati da un elemento principale, devi disporre di un ruolo nella risorsa principale che includa le autorizzazioni richieste per visualizzare i contatti. Quindi, utilizza il comando gcloud essential-contacts compute:

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

   Sostituisci quanto segue:

   • NOTIFICATION_CATEGORY: un elenco separato da virgole delle categorie di notifiche per le quali vuoi visualizzare i contatti. L'elenco può contenere uno qualsiasi dei seguenti valori:

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

     Per saperne di più, consulta Categorie di notifiche.

   • RESOURCE_TYPE: il tipo di risorsa da cui vuoi visualizzare i contatti. Utilizza il valore project, folder o organization.

   • RESOURCE_ID: il tuo Trusted Cloud progetto, organizzazione o ID cartella. Gli ID progetto sono stringhe alfanumeriche, comemy-project. Gli ID cartella e organizzazione sono numerici, ad esempio 123456789012.

   Se non specifichi un tipo e un ID risorsa, la gcloud CLI elenca i contatti per il progetto corrente.

   La risposta è simile al seguente esempio:

   ---
   email: my-contact-1@example.com
   languageTag: en-US
   name: projects/my-projects/contacts/1
   notificationCategorySubscriptions:
   - ALL
   ---
   email: my-contact-2@example.com
   languageTag: en-US
   name: projects/my-projects/contacts/2
   notificationCategorySubscriptions:
   - BILLING
   ---
   email: my-organization-contact@example.com
   languageTag: en-US
   name: organizations/my-organization/contacts/1
   notificationCategorySubscriptions:
   - ALL
   ---
   

REST

Con l'API REST Essential Contacts, puoi elencare i contatti definiti in una risorsa o tutti i contatti e i contatti ereditati per una risorsa.

Elenca i contatti definiti in una risorsa

Per visualizzare i contatti definiti in un progetto, una cartella o un'organizzazione specifici, utilizza il metodo contacts.list dell'API Essential Contacts.

Richiesta:

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

Sostituisci quanto segue:

• RESOURCE_TYPE: il tipo di risorsa da cui vuoi elencare i contatti. Utilizza il valore projects, folders o organizations.
• RESOURCE_ID: il tuo Trusted Cloud progetto, organizzazione o ID cartella. Gli ID progetto sono stringhe alfanumeriche, comemy-project. Gli ID cartella e organizzazione sono numerici, ad esempio 123456789012.
• PAGE_SIZE: (Facoltativo) Il numero di contatti da includere nella risposta. Il valore predefinito è 50 e il valore massimo è 100. Se il numero di contatti è maggiore della dimensione della pagina, la risposta contiene un token di paginazione che puoi utilizzare per recuperare la pagina successiva dei risultati.
• NEXT_PAGE_TOKEN: (Facoltativo) Il token di impaginazione restituito in una risposta precedente da questo metodo. Se specificato, l'elenco dei contatti inizia dal punto in cui è terminata la risposta precedente.

Per inviare la richiesta, espandi una di queste opzioni:

curl (Linux, macOS o Cloud Shell)

Imposta la variabile di ambiente GOOGLE_APPLICATION_CREDENTIALS sul percorso della chiave privata del account di servizio. Poi, esegui la richiesta:

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)

Imposta la variabile di ambiente GOOGLE_APPLICATION_CREDENTIALS sul percorso della chiave privata del account di servizio. Poi, esegui la richiesta:

$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
  

Dopo aver inviato la richiesta, riceverai una risposta JSON simile alla seguente:

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

Elenco contatti e contatti ereditati

Se vuoi elencare tutti i contatti di una risorsa e i relativi contatti ereditati da un elemento principale, devi disporre di un ruolo nella risorsa principale che includa le autorizzazioni richieste per visualizzare i contatti. Poi utilizza il metodo contacts.compute dell'API Essential Contacts.

Richiesta:

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

Sostituisci quanto segue:

• RESOURCE_TYPE: il tipo di risorsa da cui vuoi visualizzare i contatti. Utilizza il valore projects, folders o organizations.
• RESOURCE_ID: il tuo Trusted Cloud progetto, organizzazione o ID cartella. Gli ID progetto sono stringhe alfanumeriche, comemy-project. Gli ID cartella e organizzazione sono numerici, ad esempio 123456789012.

• NOTIFICATION_CATEGORY: la categoria di notifica da cui vuoi visualizzare i contatti. Puoi ripetere questo campo per elencare i contatti di più categorie di notifiche. Può assumere uno qualsiasi dei seguenti valori:

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

  Per saperne di più, consulta Categorie di notifiche.

• PAGE_SIZE: (Facoltativo) Il numero di contatti da includere nella risposta. Il valore predefinito è 50 e il valore massimo è 100. Se il numero di contatti è maggiore della dimensione della pagina, la risposta contiene un token di paginazione che puoi utilizzare per recuperare la pagina successiva dei risultati.

• NEXT_PAGE_TOKEN: (Facoltativo) Il token di impaginazione restituito in una risposta precedente da questo metodo. Se specificato, l'elenco dei contatti inizia dal punto in cui è terminata la risposta precedente.

Per inviare la richiesta, espandi una di queste opzioni:

curl (Linux, macOS o Cloud Shell)

Imposta la variabile di ambiente GOOGLE_APPLICATION_CREDENTIALS sul percorso della chiave privata del account di servizio. Poi, invia la richiesta:

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)

Imposta la variabile di ambiente GOOGLE_APPLICATION_CREDENTIALS sul percorso della chiave privata del account di servizio. Poi, invia la richiesta:

$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

Dopo aver inviato la richiesta, riceverai una risposta JSON simile alla seguente:

{
  "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. Nella console Trusted Cloud , vai alla pagina Contatti fondamentali.

   Vai alla pagina Contatti fondamentali

2. Assicurati che il nome del progetto, della cartella o dell'organizzazione venga visualizzato nel selettore di risorse della pagina. Il selettore di risorse ti consente di selezionare il progetto, la cartella o l'organizzazione da cui vuoi aggiungere i contatti essenziali.

3. Fai clic su person_add Aggiungi contatto.

   

4. Nei campi Email e Conferma email, inserisci l'indirizzo email del contatto che vuoi aggiungere.

5. Nel menu a discesa Categorie di notifica, seleziona le categorie per cui il contatto deve ricevere le notifiche.

   Per un elenco delle categorie di notifica e dei contatti consigliati, vedi Categorie di notifica.

6. Fai clic su Salva.

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. Aggiungere un nuovo contatto con il comando gcloud essential-contacts create:

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

   Sostituisci quanto segue:

   • EMAIL: l'indirizzo email del contatto che vuoi aggiungere. Non puoi modificare questo campo dopo aver creato il contatto.
   • NOTIFICATION_CATEGORY: un elenco separato da virgole delle categorie per le quali vuoi che il contatto riceva le notifiche. L'elenco può contenere uno qualsiasi dei seguenti valori:
     • billing
     • legal
     • product-updates
     • security
     • suspension
     • technical
     • all
     • notification-category-unspecified
     Per un elenco delle categorie di notifica e dei contatti consigliati, vedi Categorie di notifica.
   • LANGUAGE: il codice lingua per la lingua di notifica preferita del tuo contatto. Puoi includere il codice lingua di una qualsiasi delle lingue supportate.
   • RESOURCE_TYPE: il tipo di risorsa per cui vuoi creare un contatto. Utilizza il valore project, folder o organization.
   • RESOURCE_ID: il tuo Trusted Cloud progetto, organizzazione o ID cartella. Gli ID progetto sono stringhe alfanumeriche, come my-project. Gli ID cartella e organizzazione sono numerici, ad esempio 123456789012.

   Se non specifichi un tipo e un ID risorsa, gcloud CLI crea un contatto nel progetto corrente.

   Se il comando ha esito positivo, non ricevi alcuna risposta.

REST

Per aggiungere un nuovo contatto, utilizza il metodo contacts.create dell'API Essential Contacts.

Richiesta:

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

Corpo della richiesta:

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

Sostituisci quanto segue:

• RESOURCE_TYPE: il tipo di risorsa per cui vuoi creare un contatto. Utilizza il valore projects, folders o organizations.
• RESOURCE_ID: il tuo Trusted Cloud progetto, organizzazione o ID cartella. Gli ID progetto sono stringhe alfanumeriche, comemy-project. Gli ID cartella e organizzazione sono numerici, ad esempio 123456789012.
• EMAIL: l'indirizzo email del tuo contatto. Non puoi modificare questo campo dopo aver creato il contatto.

• NOTIFICATION_CATEGORY_1 e NOTIFICATION_CATEGORY_2: le categorie per cui vuoi che il contatto riceva le notifiche. Puoi aggiungere altre categorie di notifiche includendo altri valori. L'elenco può assumere uno o più dei seguenti valori:

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

  Per un elenco delle categorie di notifica e dei contatti consigliati, vedi Categorie di notifica.

• LANGUAGE: il codice lingua per la lingua di notifica preferita del tuo contatto. Puoi includere il codice lingua di una qualsiasi delle lingue supportate.

Per inviare la richiesta, espandi una di queste opzioni:

curl (Linux, macOS o Cloud Shell)

Imposta la variabile di ambiente GOOGLE_APPLICATION_CREDENTIALS sul percorso della chiave privata del account di servizio. Poi, salva il corpo della richiesta in un file JSON denominato request.json ed esegui la richiesta:

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)

Imposta la variabile di ambiente GOOGLE_APPLICATION_CREDENTIALS sul percorso della chiave privata del account di servizio. Poi, salva il corpo della richiesta in un file JSON denominato request.json ed esegui la richiesta:

$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
  

Dopo aver inviato la richiesta, riceverai una risposta JSON simile alla seguente:

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

Console

1. Nella console Trusted Cloud , vai alla pagina Contatti fondamentali.

   Vai alla pagina Contatti fondamentali

2. Assicurati che il nome del progetto, della cartella o dell'organizzazione venga visualizzato nel selettore di risorse della pagina. Il selettore di risorse consente di selezionare il progetto, la cartella o l'organizzazione da cui vuoi gestire i contatti essenziali.

3. Accanto a Visualizza per, seleziona Contatto.

   

4. Fai clic su Modifica edit accanto al contatto di cui vuoi modificare la categoria di notifiche.

   

5. Seleziona le categorie di notifica che vuoi modificare dal menu a discesa Categorie di notifica e fai clic su Salva.

Quando gestisci i contatti dalla console Trusted Cloud , la console Trusted Cloud configura automaticamente la lingua preferita del contatto in base alle impostazioni della lingua preferita del creatore del contatto. Per ulteriori informazioni, vedi Lingue supportate.

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. Aggiorna un contatto esistente con il comando gcloud essential-contacts update:

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

   Sostituisci quanto segue:

   • CONTACT_ID: l'ID numerico del contatto che vuoi aggiornare. Per visualizzare gli ID di tutti i contatti nel tuo progetto, nella tua cartella o nella tua organizzazione, visualizza i tuoi contatti. L'ID numerico è l'intero valore dopo contacts nel nome del contatto.
   • NOTIFICATION_CATEGORY: un elenco separato da virgole delle nuove categorie per le quali vuoi che il contatto riceva le notifiche. Questo elenco sostituisce l'elenco esistente di categorie di notifiche.

     L'elenco può contenere uno qualsiasi dei seguenti valori:

     • billing
     • legal
     • product-updates
     • security
     • suspension
     • technical
     • all
     • notification-category-unspecified
     Per un elenco delle categorie di notifica e dei contatti consigliati, vedi Categorie di notifica.
   • LANGUAGE: il codice lingua per la lingua di notifica preferita del tuo contatto. Puoi includere il codice lingua di una qualsiasi delle lingue supportate.
   • RESOURCE_TYPE: il tipo di risorsa in cui vuoi modificare le informazioni di contatto. Utilizza il valore project, folder o organization.
   • RESOURCE_ID: l'ID del Trusted Cloud progetto, dell'organizzazione o della cartella in cui è definito il contatto. Gli ID progetto sono stringhe alfanumeriche, come my-project. Gli ID cartella e organizzazione sono numerici, ad esempio 123456789012.

   Se non specifichi un tipo e un ID risorsa, l'gcloud CLI aggiorna il contatto con l'ID specificato nel progetto corrente. Se non esiste alcun contatto con l'ID specificato, la gcloud CLI restituisce un errore.

   Se il comando ha esito positivo, non ricevi alcuna risposta.

REST

Per modificare le categorie di notifica o la lingua preferita di un contatto esistente, utilizza il metodo contacts.patch dell'API Essential Contacts.

Richiesta:

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

Corpo della richiesta:

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

Sostituisci quanto segue:

• RESOURCE_TYPE: il tipo di risorsa in cui vuoi modificare i dati di contatto. Utilizza il valore projects, folders o organizations.
• RESOURCE_ID: il tuo Trusted Cloud progetto, organizzazione o ID cartella. Gli ID progetto sono stringhe alfanumeriche, comemy-project. Gli ID cartella e organizzazione sono numerici, ad esempio 123456789012.
• CONTACT_ID: l'ID numerico del contatto che vuoi aggiornare. Per visualizzare gli ID di tutti i contatti nel tuo progetto, nella tua cartella o nella tua organizzazione, visualizza i tuoi contatti. L'ID numerico è l'intero valore dopo contacts nel nome del contatto.
• UPDATE_MASK: (Facoltativo) Una maschera che descrive i campi del contatto che vuoi modificare. Il formato della maschera è un elenco separato da virgole di nomi completi dei campi, ad esempio notificationCategorySubscriptions,languageTag.
• EMAIL: l'indirizzo email del tuo contatto. Questo campo deve corrispondere all'indirizzo email associato al CONTACT_ID che includi nella richiesta.

• NOTIFICATION_CATEGORY_1 e NOTIFICATION_CATEGORY_2: facoltativo. Le categorie aggiornate per le quali vuoi che il contatto riceva le notifiche. Puoi aggiungere altre categorie di notifiche includendo più valori. L'elenco può assumere uno o più dei seguenti valori:

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

  Per un elenco delle categorie di notifica e dei contatti consigliati, vedi Categorie di notifica.

• LANGUAGE: il codice lingua per la lingua di notifica preferita del contatto. Puoi includere il codice lingua di una qualsiasi delle lingue supportate.

Per inviare la richiesta, espandi una di queste opzioni:

curl (Linux, macOS o Cloud Shell)

Imposta la variabile di ambiente GOOGLE_APPLICATION_CREDENTIALS sul percorso della chiave privata del account di servizio. Poi, salva il corpo della richiesta in un file JSON denominato request.json ed esegui la richiesta:

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)

Imposta la variabile di ambiente GOOGLE_APPLICATION_CREDENTIALS sul percorso della chiave privata del account di servizio. Poi, salva il corpo della richiesta in un file JSON denominato request.json ed esegui la richiesta:

$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
  

Dopo aver inviato la richiesta, riceverai una risposta JSON simile alla seguente:

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

Console

1. Nella console Trusted Cloud , vai alla pagina Contatti fondamentali.

   Vai alla pagina Contatti fondamentali

2. Assicurati che il nome del progetto, della cartella o dell'organizzazione venga visualizzato nel selettore di risorse della pagina. Il selettore di risorse ti consente di selezionare il progetto, la cartella o l'organizzazione da cui vuoi eliminare i contatti essenziali.

3. Accanto a Visualizza per, seleziona Contatto.

   

4. Fai clic su Elimina delete accanto all'indirizzo email del contatto che vuoi eliminare. Quindi, nella finestra di dialogo, conferma che vuoi eliminare il contatto.

   

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. Elimina un contatto esistente con il comando gcloud essential-contacts delete:

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

   Sostituisci quanto segue:

   • CONTACT_ID: l'ID numerico del contatto che vuoi eliminare. Per visualizzare gli ID di tutti i contatti nel tuo progetto, nella tua cartella o nella tua organizzazione, visualizza i tuoi contatti. L'ID numerico è l'intero valore dopo contacts nel nome del contatto.
   • RESOURCE_TYPE: il tipo di risorsa in cui è definito il contatto. Utilizza il valore project, folder o organization.
   • RESOURCE_ID: l'ID del Trusted Cloud progetto, dell'organizzazione o della cartella in cui è definito il contatto. Gli ID progetto sono stringhe alfanumeriche, come my-project. Gli ID cartella e organizzazione sono numerici, ad esempio 123456789012.

   Se non specifichi un tipo e un ID risorsa, la gcloud CLI elimina il contatto con l'ID specificato nel progetto corrente. Se non esiste alcun contatto con l'ID specificato, la gcloud CLI restituisce un errore.

   Se il comando ha esito positivo, non ricevi alcuna risposta.

REST

Per eliminare un contatto, utilizza il metodo contacts.delete dell'API Essential Contacts.

Richiesta:

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

Sostituisci quanto segue:

• RESOURCE_TYPE: il tipo di risorsa in cui è definito il contatto. Utilizza il valore projects, folders o organizations.
• RESOURCE_ID: il tuo Trusted Cloud progetto, organizzazione o ID cartella. Gli ID progetto sono stringhe alfanumeriche, comemy-project. Gli ID cartella e organizzazione sono numerici, ad esempio 123456789012.
• CONTACT_ID: l'ID numerico del contatto che vuoi eliminare. Per visualizzare gli ID di tutti i contatti nel tuo progetto, nella tua cartella o nella tua organizzazione, visualizza i tuoi contatti. L'ID numerico è l'intero valore dopo contacts nel nome del contatto.

Per inviare la richiesta, espandi una di queste opzioni:

curl (Linux, macOS o Cloud Shell)

Imposta la variabile di ambiente GOOGLE_APPLICATION_CREDENTIALS sul percorso della chiave privata del account di servizio. Poi, esegui la richiesta:

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)

Imposta la variabile di ambiente GOOGLE_APPLICATION_CREDENTIALS sul percorso della chiave privata del account di servizio. Poi, esegui la richiesta:

$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 la richiesta ha esito positivo, il corpo della risposta è vuoto.