Wichtige Kontakte verwalten

Auf dieser Seite werden die verfügbaren Methoden zum Aufrufen, Hinzufügen, Ändern oder Entfernen wichtiger Kontakte und zum Konfigurieren von Benachrichtigungskategorien für diese Kontakte beschrieben.

Als Organisationsadministrator können Sie Ihre wichtigen Kontakte über die Trusted Cloud -Konsole, die Google Cloud CLI oder die REST API verwalten. Best Practices für die Verwaltung von wichtigen Kontakten

Wenn Sie ein wichtiger Kontakt sind, bitten Sie Ihren Administrator, Ihnen eine Test-E-Mail zu senden, um den Empfang zu bestätigen. Wenn Sie keine Benachrichtigungen erhalten, prüfen Sie Folgendes:

  • Sehen Sie in Ihrem Spam- oder Junk-Ordner nach.
  • Prüfen Sie, ob die als Kontakt registrierte E‑Mail-Adresse korrekt ist und externe E‑Mails empfangen kann.
  • Ihre Kontaktdaten müssen den entsprechenden Benachrichtigungskategorien zugewiesen sein.

Hinweise

Damit der Kontakt Benachrichtigungen erhalten kann, muss er E‑Mails von Google empfangen können.

Wenn Sie Kontakte mit der gcloud CLI oder der REST API verwalten möchten, aktivieren Sie die Essential Contacts API. Wenn Sie Kontakte nur über die Trusted Cloud -Konsole verwalten möchten, müssen Sie die API nicht aktivieren.

Enable the API

Erforderliche Rollen

Um die Berechtigungen zu erhalten, die Sie zum Verwalten von Kontakten benötigen, bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen für das Projekt, den Ordner oder die Organisation zuzuweisen, dem der Kontakt zugewiesen ist:

Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Diese vordefinierten Rollen enthalten die Berechtigungen, die zum Verwalten von Kontakten erforderlich sind. Erweitern Sie den Abschnitt Erforderliche Berechtigungen, um die erforderlichen Berechtigungen anzuzeigen:

Erforderliche Berechtigungen

Die folgenden Berechtigungen sind erforderlich, um Kontakte zu verwalten:

  • So rufen Sie Kontakte auf:
    • essentialcontacts.contacts.get
    • essentialcontacts.contacts.list
  • So bearbeiten, löschen und erstellen Sie Kontakte:
    • essentialcontacts.contacts.create
    • essentialcontacts.contacts.delete
    • essentialcontacts.contacts.update

Sie können diese Berechtigungen auch mit benutzerdefinierten Rollen oder anderen vordefinierten Rollen erhalten.

Kontakte ansehen

Untergeordnete Ressourcen, die sich auf Ordner und Projekte beziehen, übernehmen Kontakte von ihren Ancestors, die Organisationen und andere Ordner sein können. Wenn Sie Kontakte aus einer untergeordneten Ressource aufrufen, können Sie auch Kontakte sehen, die von ihrem Ancestor übernommen wurden, sofern Sie die entsprechenden Berechtigungen für den Ancestor haben. Dazu benötigen Sie eine Rolle für die Ancestor-Ressource, die die erforderlichen Berechtigungen zum Ansehen von Kontakten enthält. Wenn Sie Kontakte aus einer Organisation oder einem Ordner der obersten Ebene aufrufen, werden keine Kontakte aus den untergeordneten Ressourcen angezeigt.

So rufen Sie die Liste aller wichtigen Kontakte in Ihrem Projekt, Ordner oder Ihrer Organisation auf:

Console

  1. Rufen Sie in der Trusted Cloud Console die Seite Wichtige Kontakte auf.

    Zur Seite „Wichtige Kontakte“

  2. Prüfen Sie, ob der Name Ihres Projekts, Ihres Ordners oder Ihrer Organisation in der Ressourcenauswahl der Seite angezeigt wird. Mit der Ressourcenauswahl können Sie das Projekt, den Ordner oder die Organisation auswählen, für die Sie wichtige Kontakte aufrufen möchten.

  3. Neben Anzeigen nach können Sie eine der folgenden Optionen auswählen:

    • Wenn Sie die Liste der Kontakte nach Kategorie aufrufen möchten, wählen Sie Kategorie aus.
    • Wenn Sie die Liste der Kontakte alphabetisch aufrufen möchten, wählen Sie Kontakt aus.

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. Mit der Google Cloud CLI können Sie entweder die Kontakte auflisten, die für eine Ressource definiert sind, oder alle Kontakte und geerbten Kontakte für eine Ressource auflisten.

    Kontakte auflisten, die für eine Ressource definiert sind

    Verwenden Sie den Befehl gcloud essential-contacts list, um die für ein bestimmtes Projekt, einen Ordner oder eine Organisation definierten wichtigen Kontakte aufzurufen:

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

    Ersetzen Sie Folgendes:

    • RESOURCE_TYPE: Der Ressourcentyp, für den Sie Kontakte auflisten möchten. Verwenden Sie den Wert project, folder oder organization.
    • RESOURCE_ID: Die ID Ihres Trusted Cloud Projekts, Ihrer Organisation oder Ihres Ordners. Projekt-IDs sind alphanumerische Strings, wie my-project. Ordner- und Organisations-IDs sind numerisch, z. B. 123456789012.

    Wenn Sie keinen Ressourcentyp oder keine ID angeben, werden in der gcloud CLI Kontakte aus dem aktuellen Projekt aufgeführt.

    Die Antwort ähnelt diesem Beispiel:

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

    Kontakte und übernommene Kontakte auflisten

    Wenn Sie alle Kontakte einer Ressource und die übernommenen Kontakte eines Ancestors auflisten möchten, benötigen Sie eine Rolle für die Ancestor-Ressource, die die erforderlichen Berechtigungen zum Anzeigen von Kontakten enthält. Verwenden Sie dann den Befehl gcloud essential-contacts compute:

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

    Ersetzen Sie Folgendes:

    • NOTIFICATION_CATEGORY: Eine durch Kommas getrennte Liste der Benachrichtigungskategorien, für die Sie Kontakte aufrufen möchten. Die Liste kann einen der folgenden Werte enthalten:

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

      Weitere Informationen finden Sie unter Benachrichtigungskategorien.

    • RESOURCE_TYPE: Der Ressourcentyp, für den Sie Kontakte aufrufen möchten. Verwenden Sie den Wert project, folder oder organization.

    • RESOURCE_ID: Die ID Ihres Trusted Cloud Projekts, Ihrer Organisation oder Ihres Ordners. Projekt-IDs sind alphanumerische Strings, wie my-project. Ordner- und Organisations-IDs sind numerisch, z. B. 123456789012.

    Wenn Sie keinen Ressourcentyp und keine ID angeben, werden in der gcloud CLI Kontakte für das aktuelle Projekt aufgeführt.

    Die Antwort ähnelt diesem Beispiel:

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

    Mit der REST API für wichtige Kontakte können Sie entweder die Kontakte auflisten, die für eine Ressource definiert sind, oder alle Kontakte und übernommenen Kontakte für eine Ressource.

    Kontakte auflisten, die für eine Ressource definiert sind

    Verwenden Sie die Methode contacts.list der Essential Contacts API, um die Kontakte aufzurufen, die für ein bestimmtes Projekt, einen Ordner oder eine Organisation definiert wurden.

    Request:

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

    Ersetzen Sie Folgendes:

    • RESOURCE_TYPE: Der Ressourcentyp, für den Sie Kontakte auflisten möchten. Verwenden Sie den Wert projects, folders oder organizations.
    • RESOURCE_ID: Die ID Ihres Trusted Cloud Projekts, Ihrer Organisation oder Ihres Ordners. Projekt-IDs sind alphanumerische Strings, wie my-project. Ordner- und Organisations-IDs sind numerisch, z. B. 123456789012.
    • PAGE_SIZE: Optional. Die Anzahl der Kontakte, die in der Antwort enthalten sein sollen. Der Standardwert ist 50 und der Höchstwert 100. Wenn die Anzahl der Kontakte die Seitengröße überschreitet, enthält die Antwort ein Paginierungstoken, mit dem Sie die nächste Ergebnisseite abrufen können.
    • NEXT_PAGE_TOKEN: Optional. Das Paginierungstoken, das in einer früheren Antwort von dieser Methode zurückgegeben wurde. Wenn angegeben, beginnt die Liste der Kontakte an der Stelle, an der die vorherige Antwort beendet wurde.

    Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

    curl (Linux, macOS oder Cloud Shell)

    Legen Sie für die Umgebungsvariable GOOGLE_APPLICATION_CREDENTIALS den Pfad zur privaten Schlüsseldatei des Dienstkontos fest. Stellen Sie dann die Anfrage: 

    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)

    Legen Sie für die Umgebungsvariable GOOGLE_APPLICATION_CREDENTIALS den Pfad zur privaten Schlüsseldatei des Dienstkontos fest. Stellen Sie dann die Anfrage: 

    $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

    Nachdem Sie die Anfrage gesendet haben, erhalten Sie eine JSON-Antwort ähnlich dem folgenden Beispiel:

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

    Kontakte und übernommene Kontakte auflisten

    Wenn Sie alle Kontakte einer Ressource und die übernommenen Kontakte eines Ancestors auflisten möchten, benötigen Sie eine Rolle für die Ancestor-Ressource, die die erforderlichen Berechtigungen zum Anzeigen von Kontakten enthält. Verwenden Sie dann die Methode contacts.compute der Essential Contacts API.

    Request:

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

    Ersetzen Sie Folgendes:

    • RESOURCE_TYPE: Der Ressourcentyp, für den Sie Kontakte aufrufen möchten. Verwenden Sie den Wert projects, folders oder organizations.
    • RESOURCE_ID: Die ID Ihres Trusted Cloud Projekts, Ihrer Organisation oder Ihres Ordners. Projekt-IDs sind alphanumerische Strings, wie my-project. Ordner- und Organisations-IDs sind numerisch, z. B. 123456789012.

    • NOTIFICATION_CATEGORY: Die Benachrichtigungskategorie, für die Sie Kontakte aufrufen möchten. Sie können dieses Feld wiederholen, um Kontakte aus mehreren Benachrichtigungskategorien aufzulisten. Es kann einen der folgenden Werte annehmen:

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

      Weitere Informationen finden Sie unter Benachrichtigungskategorien.

    • PAGE_SIZE: Optional. Die Anzahl der Kontakte, die in der Antwort enthalten sein sollen. Der Standardwert ist 50 und der Höchstwert 100. Wenn die Anzahl der Kontakte die Seitengröße überschreitet, enthält die Antwort ein Paginierungstoken, mit dem Sie die nächste Ergebnisseite abrufen können.

    • NEXT_PAGE_TOKEN: Optional. Das Paginierungstoken, das in einer früheren Antwort von dieser Methode zurückgegeben wurde. Wenn angegeben, beginnt die Liste der Kontakte an der Stelle, an der die vorherige Antwort beendet wurde.

    Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

    curl (Linux, macOS oder Cloud Shell)

    Legen Sie für die Umgebungsvariable GOOGLE_APPLICATION_CREDENTIALS den Pfad zur privaten Schlüsseldatei des Dienstkontos fest. Stellen Sie dann die Anfrage: 

    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)

    Legen Sie für die Umgebungsvariable GOOGLE_APPLICATION_CREDENTIALS den Pfad zur privaten Schlüsseldatei des Dienstkontos fest. Stellen Sie dann die Anfrage: 

    $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

    Nachdem Sie die Anfrage gesendet haben, erhalten Sie eine JSON-Antwort ähnlich dem folgenden Beispiel:

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

Kontakt hinzufügen

So fügen Sie einen Kontakt hinzu:

Console

  1. Rufen Sie in der Trusted Cloud Console die Seite Wichtige Kontakte auf.

    Zur Seite „Wichtige Kontakte“

  2. Prüfen Sie, ob der Name Ihres Projekts, Ihres Ordners oder Ihrer Organisation in der Ressourcenauswahl der Seite angezeigt wird. Mit der Ressourcenauswahl können Sie das Projekt, den Ordner oder die Organisation auswählen, aus dem Sie wichtige Kontakte hinzufügen möchten.

  3. Klicken Sie auf Kontakt hinzufügen.

    Ein Screenshot, auf dem die Option zum Hinzufügen eines Kontakts auf der Seite „Wichtige Kontakte“ hervorgehoben ist.

  4. Geben Sie die E‑Mail-Adresse des Kontakts, den Sie hinzufügen möchten, in die Felder E‑Mail und E‑Mail-Adresse bestätigen ein.

  5. Wählen Sie im Drop-down-Menü Benachrichtigungskategorien die Kategorien aus, für die der Kontakt Benachrichtigungen erhalten soll.

    Eine Liste der Benachrichtigungskategorien und empfohlenen Kontakte finden Sie unter Benachrichtigungskategorien.

  6. Klicken Sie auf Speichern.

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. So fügen Sie einen neuen Kontakt mit dem Befehl gcloud essential-contacts create hinzu:

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

    Ersetzen Sie Folgendes:

    • EMAIL: die E-Mail-Adresse des Kontakts, den Sie hinzufügen möchten. Sie können dieses Feld nicht mehr ändern, nachdem Sie den Kontakt erstellt haben.
    • NOTIFICATION_CATEGORY: Eine durch Kommas getrennte Liste der Kategorien, für die der Kontakt Benachrichtigungen erhalten soll. Die Liste kann einen der folgenden Werte enthalten:
      • billing
      • legal
      • product-updates
      • security
      • suspension
      • technical
      • all
      • notification-category-unspecified
      Eine Liste der Benachrichtigungskategorien und empfohlenen Kontakte finden Sie unter Benachrichtigungskategorien.
    • LANGUAGE: Der Sprachcode für die bevorzugte Benachrichtigungssprache Ihres Kontakts. Sie können den Sprachcode aller unterstützten Sprachen einfügen.
    • RESOURCE_TYPE: Der Ressourcentyp, für den Sie einen Kontakt erstellen möchten. Verwenden Sie den Wert project, folder oder organization.
    • RESOURCE_ID: Die ID Ihres Trusted Cloud Projekts, Ihrer Organisation oder Ihres Ordners. Projekt-IDs sind alphanumerische Strings, wie my-project. Ordner- und Organisations-IDs sind numerisch, z. B. 123456789012.

    Wenn Sie keinen Ressourcentyp und keine ID angeben, erstellt die gcloud CLI einen Kontakt im aktuellen Projekt.

    Wenn der Befehl erfolgreich ist, erhalten Sie keine Antwort.

    3. REST

    Verwenden Sie zum Hinzufügen eines neuen Kontakts die Methode contacts.create der Essential Contacts API.

    Request:

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

    Anfragetext:

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

    Ersetzen Sie Folgendes:

    • RESOURCE_TYPE: Der Ressourcentyp, für den Sie einen Kontakt erstellen möchten. Verwenden Sie den Wert projects, folders oder organizations.
    • RESOURCE_ID: Die ID Ihres Trusted Cloud Projekts, Ihrer Organisation oder Ihres Ordners. Projekt-IDs sind alphanumerische Strings, wie my-project. Ordner- und Organisations-IDs sind numerisch, z. B. 123456789012.
    • EMAIL: die E-Mail-Adresse Ihres Kontakts. Sie können dieses Feld nicht mehr ändern, nachdem Sie den Kontakt erstellt haben.

    • NOTIFICATION_CATEGORY_1 und NOTIFICATION_CATEGORY_2: Die Kategorien, für die der Kontakt Benachrichtigungen erhalten soll. Sie können weitere Benachrichtigungskategorien hinzufügen, indem Sie weitere dieser Werte einfügen. Die Liste kann einen oder mehrere der folgenden Werte enthalten:

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

      Eine Liste der Benachrichtigungskategorien und empfohlenen Kontakte finden Sie unter Benachrichtigungskategorien.

    • LANGUAGE: Der Sprachcode für die bevorzugte Benachrichtigungssprache Ihres Kontakts. Sie können den Sprachcode aller unterstützten Sprachen einfügen.

    Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

    Nachdem Sie die Anfrage gesendet haben, erhalten Sie eine JSON-Antwort ähnlich dem folgenden Beispiel:

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

Kontaktdaten ändern

Sie können die Benachrichtigungskategorien oder die bevorzugte Sprache für einen Kontakt ändern, aber nicht die E-Mail-Adresse eines Kontakts. Wenn sich die E-Mail-Adresse eines Kontakts ändert, fügen Sie einen neuen Kontakt mit der aktualisierten E-Mail-Adresse hinzu und löschen Sie den alten Kontakt.

So ändern Sie die einem Kontakt zugewiesenen Benachrichtigungskategorien oder die bevorzugte Sprache:

Console

  1. Rufen Sie in der Trusted Cloud Console die Seite Wichtige Kontakte auf.

    Zur Seite „Wichtige Kontakte“

  2. Prüfen Sie, ob der Name Ihres Projekts, Ihres Ordners oder Ihrer Organisation in der Ressourcenauswahl der Seite angezeigt wird. Mit der Ressourcenauswahl können Sie das Projekt, den Ordner oder die Organisation auswählen, aus der Sie wichtige Kontakte verwalten möchten.

  3. Wählen Sie neben Anzeigen nach die Option Kontakt aus.

    Ein Screenshot, auf dem die Option zum Auswählen eines Kontakts auf der Seite „Wichtige Kontakte“ hervorgehoben ist.

  4. Klicken Sie neben dem Kontakt, dessen Benachrichtigungskategorie Sie ändern möchten, auf Bearbeiten .

    Ein Screenshot, auf dem die Option zum Bearbeiten eines Kontakts auf der Seite „Wichtige Kontakte“ hervorgehoben ist.

  5. Wählen Sie im Drop-down-Menü Benachrichtigungskategorien die Benachrichtigungskategorien aus, die Sie ändern möchten, und klicken Sie auf Speichern.

Wenn Sie Kontakte über die Trusted Cloud Konsole verwalten, konfiguriert die Trusted Cloud Konsole automatisch die bevorzugte Sprache des Kontakts basierend auf den bevorzugten Spracheinstellungen des Kontakterstellers. Weitere Informationen finden Sie unter Unterstützte Sprachen.

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. So aktualisieren Sie einen vorhandenen Kontakt mit dem Befehl gcloud essential-contacts update:

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

    Ersetzen Sie Folgendes:

    • CONTACT_ID: Die numerische ID des Kontakts, den Sie aktualisieren möchten. Wenn Sie die IDs aller Kontakte in Ihrem Projekt, Ordner oder Ihrer Organisation aufrufen möchten, sehen Sie sich Ihre Kontakte an. Die numerische ID ist der gesamte Wert nach contacts im Namen des Kontakts.
    • NOTIFICATION_CATEGORY: Eine durch Kommas getrennte Liste der neuen Kategorien, für die der Kontakt Benachrichtigungen erhalten soll. Diese Liste ersetzt die vorhandene Liste der Benachrichtigungskategorien.

      Die Liste kann einen der folgenden Werte enthalten:

      • billing
      • legal
      • product-updates
      • security
      • suspension
      • technical
      • all
      • notification-category-unspecified
      Eine Liste der Benachrichtigungskategorien und empfohlenen Kontakte finden Sie unter Benachrichtigungskategorien.
    • LANGUAGE: Der Sprachcode für die bevorzugte Benachrichtigungssprache Ihres Kontakts. Sie können den Sprachcode aller unterstützten Sprachen einfügen.
    • RESOURCE_TYPE: Der Ressourcentyp, für den Sie Kontaktinformationen ändern möchten. Verwenden Sie den Wert project, folder oder organization.
    • RESOURCE_ID: Die ID des Trusted CloudProjekts, der Organisation oder des Ordners, in dem der Kontakt definiert ist. Projekt-IDs sind alphanumerische Strings, wie my-project. Ordner- und Organisations-IDs sind numerisch, z. B. 123456789012.

    Wenn Sie keinen Ressourcentyp und keine ID angeben, aktualisiert die gcloud CLI den Kontakt mit der angegebenen ID im aktuellen Projekt. Wenn kein Kontakt mit der angegebenen ID vorhanden ist, gibt die gcloud CLI einen Fehler zurück.

    Wenn der Befehl erfolgreich ist, erhalten Sie keine Antwort.

    3. REST

    Verwenden Sie die Methode contacts.patch der Essential Contacts API, um die Benachrichtigungskategorien oder die bevorzugte Sprache eines vorhandenen Kontakts zu ändern.

    Request:

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

    Anfragetext:

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

    Ersetzen Sie Folgendes:

    • RESOURCE_TYPE: Der Ressourcentyp, für den Sie Kontaktinformationen ändern möchten. Verwenden Sie den Wert projects, folders oder organizations.
    • RESOURCE_ID: Die ID Ihres Trusted Cloud Projekts, Ihrer Organisation oder Ihres Ordners. Projekt-IDs sind alphanumerische Strings, wie my-project. Ordner- und Organisations-IDs sind numerisch, z. B. 123456789012.
    • CONTACT_ID: Die numerische ID des Kontakts, den Sie aktualisieren möchten. Wenn Sie die IDs aller Kontakte in Ihrem Projekt, Ordner oder Ihrer Organisation aufrufen möchten, sehen Sie sich Ihre Kontakte an. Die numerische ID ist der gesamte Wert nach contacts im Namen des Kontakts.
    • UPDATE_MASK: Optional. Eine Maske, die angibt, welche Felder des Kontakts Sie ändern möchten. Das Format für die Maske ist eine durch Kommas getrennte Liste vollständig qualifizierter Feldnamen, z. B. notificationCategorySubscriptions,languageTag.
    • EMAIL: die E-Mail-Adresse Ihres Kontakts. Dieses Feld muss mit der E-Mail-Adresse übereinstimmen, die mit der Anfrage in CONTACT_ID verknüpft ist.

    • NOTIFICATION_CATEGORY_1 und NOTIFICATION_CATEGORY_2: Optional. Die aktualisierten Kategorien, für die der Kontakt Benachrichtigungen erhalten soll. Sie können weitere Benachrichtigungskategorien hinzufügen, indem Sie weitere dieser Werte einfügen. Die Liste kann einen oder mehrere der folgenden Werte enthalten:

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

      Eine Liste der Benachrichtigungskategorien und empfohlenen Kontakte finden Sie unter Benachrichtigungskategorien.

    • LANGUAGE: Der Sprachcode für die bevorzugte Benachrichtigungssprache des Kontakts. Sie können den Sprachcode aller unterstützten Sprachen einfügen.

    Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

    Nachdem Sie die Anfrage gesendet haben, erhalten Sie eine JSON-Antwort ähnlich dem folgenden Beispiel:

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

Kontakte löschen

So löschen Sie einen Kontakt:

Console

  1. Rufen Sie in der Trusted Cloud Console die Seite Wichtige Kontakte auf.

    Zur Seite „Wichtige Kontakte“

  2. Prüfen Sie, ob der Name Ihres Projekts, Ihres Ordners oder Ihrer Organisation in der Ressourcenauswahl der Seite angezeigt wird. Mit der Ressourcenauswahl können Sie das Projekt, den Ordner oder die Organisation auswählen, aus der Sie wichtige Kontakte löschen möchten.

  3. Wählen Sie neben Anzeigen nach die Option Kontakt aus.

    Ein Screenshot, auf dem die Option zum Auswählen eines Kontakts auf der Seite „Wichtige Kontakte“ hervorgehoben ist.

  4. Klicken Sie neben der E-Mail-Adresse des Kontakts, den Sie löschen möchten, auf Löschen . Bestätigen Sie im Dialogfeld, dass Sie den Kontakt löschen möchten.

    Ein Screenshot, auf dem die Option zum Löschen eines Kontakts auf der Seite „Wichtige Kontakte“ hervorgehoben ist.

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. Löschen Sie einen vorhandenen Kontakt mit dem Befehl gcloud essential-contacts delete:

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

    Ersetzen Sie Folgendes:

    • CONTACT_ID: Die numerische ID des Kontakts, den Sie löschen möchten. Wenn Sie die IDs aller Kontakte in Ihrem Projekt, Ordner oder Ihrer Organisation aufrufen möchten, sehen Sie sich Ihre Kontakte an. Die numerische ID ist der gesamte Wert nach contacts im Namen des Kontakts.
    • RESOURCE_TYPE: Der Ressourcentyp, für den der Kontakt definiert ist. Verwenden Sie den Wert project, folder oder organization.
    • RESOURCE_ID: Die ID des Trusted CloudProjekts, der Organisation oder des Ordners, in dem der Kontakt definiert ist. Projekt-IDs sind alphanumerische Strings, wie my-project. Ordner- und Organisations-IDs sind numerisch, z. B. 123456789012.

    Wenn Sie keinen Ressourcentyp und keine ID angeben, löscht die gcloud CLI den Kontakt mit der angegebenen ID im aktuellen Projekt. Wenn kein Kontakt mit der angegebenen ID vorhanden ist, gibt die gcloud CLI einen Fehler zurück.

    Wenn der Befehl erfolgreich ist, erhalten Sie keine Antwort.

    3. REST

    Verwenden Sie die Methode contacts.delete der App „Wichtige Kontakte“, um einen Kontakt zu löschen.

    Request:

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

    Ersetzen Sie Folgendes:

    • RESOURCE_TYPE: Der Ressourcentyp, für den der Kontakt definiert ist. Verwenden Sie den Wert projects, folders oder organizations.
    • RESOURCE_ID: Die ID Ihres Trusted Cloud Projekts, Ihrer Organisation oder Ihres Ordners. Projekt-IDs sind alphanumerische Strings, wie my-project. Ordner- und Organisations-IDs sind numerisch, z. B. 123456789012.
    • CONTACT_ID: Die numerische ID des Kontakts, den Sie löschen möchten. Wenn Sie die IDs aller Kontakte in Ihrem Projekt, Ordner oder Ihrer Organisation aufrufen möchten, rufen Sie Ihre Kontakte auf. Die numerische ID ist der gesamte Wert nach contacts im Namen des Kontakts.

    Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

    Wenn die Anfrage erfolgreich ist, ist der Antworttext leer.

Kontakte nach Kategorie verwalten

In der Trusted Cloud Console können Sie Kontakte nach Benachrichtigungskategorie verwalten. Rufen Sie dazu auf der Seite Wichtige Kontakte den Tab Kategorie auf.

Führen Sie folgende Schritte aus, um die einer einzelnen Benachrichtigungskategorie zugewiesenen Kontakte hinzuzufügen, zu ändern oder zu löschen:

  1. Rufen Sie in der Trusted Cloud Console die Seite Wichtige Kontakte auf.

    Zur Seite „Wichtige Kontakte“

  2. Prüfen Sie, ob der Name Ihres Projekts, Ihres Ordners oder Ihrer Organisation in der Ressourcenauswahl der Seite angezeigt wird. Mit der Ressourcenauswahl können Sie das Projekt, den Ordner oder die Organisation auswählen, aus der Sie wichtige Kontakte verwalten möchten.

  3. Wählen Sie neben Anzeigen nach die Option Kategorie aus.

    Ein Screenshot, auf dem die Option zum Auswählen einer Kategorie auf der Seite „Wichtige Kontakte“ hervorgehoben ist.

  4. Klicken Sie in der Zeile, in der Sie die Kontakte verwalten möchten, auf Bearbeiten .

    Ein Screenshot, auf dem die Option zum Bearbeiten eines Kontakts auf der Seite „Wichtige Kontakte“ hervorgehoben ist.

  5. So verwalten Sie die Kontakte, die der Benachrichtigungskategorie zugewiesen sind:

    • Klicken Sie zum Hinzufügen eines neuen Kontakts auf Kontakt hinzufügen und folgen Sie den Schritten zum Hinzufügen eines Kontakts.
    • Wenn Sie die Benachrichtigungskategorie ändern möchten, die einem Kontakt zugewiesen ist, klicken Sie neben dem Kontakt, dessen Kategorie Sie ändern möchten, auf Bearbeiten . Wählen Sie dann die gewünschten Benachrichtigungskategorien im Drop-down-Menü Benachrichtigungskategorien aus und klicken Sie auf Speichern.
    • Wenn Sie einen Kontakt löschen möchten, klicken Sie neben der E-Mail-Adresse des Kontakts auf Löschen.

Test-E-Mail senden, um den Empfang zu bestätigen

Sie können eine Test-E-Mail an Kontakte in jeder Kategorie senden, um zu prüfen, ob die E-Mail-Konten E-Mails von Trusted Cloud by S3NSempfangen können. Sie können pro Kategorie und Ressource maximal eine Test-E-Mail alle 24 Stunden an jeden Kontakt senden.

So senden Sie eine Test-E-Mail an Kontakte in einer bestimmten Benachrichtigungskategorie:

  1. Rufen Sie in der Trusted Cloud Console die Seite Wichtige Kontakte auf.

    Zur Seite „Wichtige Kontakte“

  2. Prüfen Sie, ob der Name Ihres Projekts, Ihres Ordners oder Ihrer Organisation in der Ressourcenauswahl der Seite angezeigt wird. Mit der Ressourcenauswahl können Sie das Projekt, den Ordner oder die Organisation auswählen, aus der Sie wichtige Kontakte verwalten möchten.

  3. Wählen Sie neben Anzeigen nach die Option Kategorie aus.

    Ein Screenshot, auf dem die Option zum Auswählen einer Kategorie auf der Seite „Wichtige Kontakte“ hervorgehoben ist.

  4. Klicken Sie in der Zeile der Benachrichtigungskategorie, an deren Kontakte Sie Test-E‑Mails senden möchten, auf Senden .

  5. Klicken Sie die Kästchen neben den Kontakten an, denen Sie E‑Mails senden möchten.

  6. Klicken Sie auf Senden. Das System sendet eine Test-E-Mail an die ausgewählten Kontakte.

  7. Bitten Sie jeden Kontakt, zu bestätigen, dass er die Test-E-Mail von gcp-essential-contacts-noreply@google.com erhalten hat.

Erweiterte Konfigurationen und Automatisierung einrichten

In diesem Abschnitt werden Optionen für die weitere Verwaltung Ihrer wichtigen Kontakte behandelt, darunter das Einschränken von Kontaktdomänen, die Verwendung von Infrastruktur als Code (Infrastructure as Code, IaC) mit Terraform zur Automatisierung und das Erstellen benutzerdefinierter Organisationsrichtlinien.

Zulässige Domains für Kontakte einschränken

Wenn Sie die E-Mail-Adressdomains einschränken möchten, die neue Kontakte haben können, legen Sie die Einschränkung der Organisationsrichtlinie constraints/essentialcontacts.allowedContactDomains fest. Vorhandene Kontakte sind von dieser Einschränkung nicht betroffen.

Informationen zum Festlegen von Einschränkungen für Organisationsrichtlinien finden Sie unter Organisationsrichtlinien erstellen und verwalten.

Kontakte mit Terraform verwalten

Sie können Terraform verwenden, um Ihre wichtigen Kontakte zu verwalten. Kontakte haben in der Terraform-Sprache das folgende Format:

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

Ersetzen Sie beim Verwalten eines Kontakts Folgendes:

  • RESOURCE_TYPE: Der Ressourcentyp, für den Sie den Kontakt verwalten möchten. Verwenden Sie den Wert projects, folders oder organizations.
  • RESOURCE_ID: Die ID Ihres Trusted Cloud by S3NS Projekts, Ihrer Organisation oder Ihres Ordners. Projekt-IDs sind alphanumerische Strings, wie my-project. Ordner- und Organisations-IDs sind numerisch, z. B. 123456789012.
  • EMAIL: die E-Mail-Adresse Ihres Kontakts. Sie können dieses Feld nicht mehr ändern, nachdem Sie den Kontakt erstellt haben.
  • LANGUAGE: Optional. Der Sprachcode für die bevorzugte Benachrichtigungssprache des Kontakts. Sie können den Sprachcode aller unterstützten Sprachen einfügen.

  • NOTIFICATION_CATEGORY: Ein Array der Kategorien, für die der Kontakt Benachrichtigungen erhalten soll, z. B. ["BILLING", "LEGAL"]. Dieses Array kann einen der folgenden Werte enthalten:

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

    Eine Liste der Benachrichtigungskategorien und empfohlenen Kontakte finden Sie unter Benachrichtigungskategorien.

Wenn Sie einen Kontakt hinzufügen, ändern oder entfernen möchten, fügen Sie eine Kontaktressource in Ihrer Terraform-Konfigurationsdatei hinzu, ändern oder entfernen Sie sie. Weitere Informationen finden Sie in der Dokumentation zu wichtigen Kontakten in Terraform.

Nächste Schritte