Kontakte für Benachrichtigungen verwalten

Viele Google Cloud-Dienste wie Cloud Billing senden Benachrichtigungen, um wichtige Informationen mit Google Cloud-Nutzern zu teilen. Standardmäßig werden diese Benachrichtigungen an Mitglieder mit bestimmten IAM-Rollen (Identity and Access Management) gesendet. Mit „Wichtige Kontakte“ können Sie anpassen, wer Benachrichtigungen erhält. Stellen Sie dazu eine eigene Liste von Kontakten bereit.

Hinweis

Aktivieren Sie die Essential Contacts API.

Aktivieren Sie die API

Erforderliche Berechtigungen

Welche Berechtigungen Sie benötigen, um die wichtigen Kontakte zu nutzen, hängt davon ab, was Sie tun möchten.

Berechtigungen zum Aufrufen von Kontakten

Sie benötigen eine Rolle mit den folgenden Berechtigungen, um Kontakte anzusehen:

essentialcontacts.contacts.get
essentialcontacts.contacts.list

Bitten Sie Ihren Administrator, Ihnen die Rolle „Essential Contacts Viewer“ (roles/essentialContacts.viewer) zuzuweisen, um diese Berechtigungen zu erhalten und dem Prinzip der geringsten Berechtigung zu folgen.

Alternativ kann Ihr Administrator Ihnen eine andere Rolle mit den erforderlichen Berechtigungen zuweisen, z. B. eine benutzerdefinierte Rolle oder eine vordefinierte Rolle mit mehr Berechtigungen.

Diese Rollen müssen für das Projekt, den Ordner oder die Organisation zugewiesen werden, dem/der der Kontakt zugewiesen ist.

Berechtigungen zum Verwalten von Kontakten

Zum Bearbeiten, Löschen und Erstellen von Kontakten benötigen Sie eine Rolle mit den folgenden Berechtigungen:

essentialcontacts.contacts.get
essentialcontacts.contacts.list
essentialcontacts.contacts.create
essentialcontacts.contacts.delete
essentialcontacts.contacts.update

Bitten Sie Ihren Administrator, Ihnen die Rolle „Essential Contacts Admin“ (roles/essentialContacts.admin) zuzuweisen, um diese Berechtigungen zu erhalten und dem Prinzip der geringsten Berechtigung zu folgen.

Alternativ kann Ihr Administrator Ihnen eine andere Rolle mit den erforderlichen Berechtigungen zuweisen, z. B. eine benutzerdefinierte Rolle oder eine vordefinierte Rolle mit mehr Berechtigungen.

Diese Rollen müssen für das Projekt, den Ordner oder die Organisation zugewiesen werden, dem/der der Kontakt zugewiesen ist.

Benachrichtigungskategorien

Es gibt verschiedene Benachrichtigungskategorien, denen Sie Kontakte zuweisen können. Wenn Sie keinen Kontakt für eine Kategorie hinzufügen, werden Benachrichtigungen in dieser Kategorie an den Standardkontakt gesendet, der basierend auf den IAM-Rollen Ihrer Mitglieder ausgewählt wird. Wir empfehlen, benutzerdefinierte Kontakte hinzuzufügen und sich nicht auf Standardkontakte zu verlassen, damit die richtigen Personen Benachrichtigungen für Ihr Projekt, Ihren Ordner oder Ihre Organisation erhalten.

Sie können Einzelpersonen und Google-Gruppen als Kontakte hinzufügen. Um die Auswirkungen von Personalwechsel zu reduzieren, empfehlen wir, Google-Gruppen als Kontakte hinzuzufügen und dann die Mitgliedschaft dieser Gruppen zu verwalten, um zu bestimmen, wer Benachrichtigungen erhält. Diese Vorgehensweise trägt dazu bei, dass Benachrichtigungen immer an aktive Mitarbeiter gesendet werden.

In der folgenden Tabelle finden Sie Informationen zu den Kategorien der Benachrichtigungen, zum Standardkontakt und dem empfohlenen Kontakt. Anhand dieser Informationen können Sie geeignete Kontakte für jede Kategorie auswählen.

Category	Beschreibung	Standardkontakt	Empfohlener Kontakt
Alle	Alle Benachrichtigungen zur Ressource	–	Personen oder automatisierte Systeme, die für Routing- oder Logging-Benachrichtigungen zuständig sind
Abrechnung	Abrechnungs- und Zahlungsbenachrichtigungen, Preisaktualisierungen, Fehler, Gutschriften	Rechnungskontoadministrator (`roles/billing.admin`)	Mitarbeiter der Finanzabteilung und Personen, die Ihre finanzielle Beziehung zu Google verwalten, einschließlich Personen, die Budgets, Planungen und Konten im Zusammenhang mit der Nutzung der Google Cloud verwalten
Rechtsabteilung	Erzwingungsmaßnahmen, gesetzliche Vorschriften, behördliche Bekanntmachungen	Rechnungskontoadministrator (`roles/billing.admin`)	Rechtsberatung, Compliance-Manager, Experten in Regierungsfragen und andere Fachleute
Produktaktualisierungen	Neue Versionen, Aktualisierungen der Produktbedingungen, Produkteinstellungen	Projektinhaber (`roles/owner`)	Produktmanager, Architekten und Entwickler, die von zeitnahen Informationen über Änderungen an Google-Produkten und -Diensten profitieren können
Security	Sicherheits-/Datenschutzprobleme, Benachrichtigungen und Sicherheitslücken	Administrator der Organisation (`roles/resourcemanager.organizationAdmin`)	IT-Sicherheit, Betriebssicherheit und andere Personen, deren Aufgabe es ist, Ihre Unternehmens- und Kundendaten zu schützen und die Geschäftskontinuität zu gewährleisten
Sperrung	Benachrichtigungen zur unmittelbaren Kontosperrung	Projektinhaber (`roles/owner`)	Personen, die unmittelbar dafür verantwortlich sind, dass Ihre IT-Infrastruktur und Geschäftsanwendungen funktionsfähig sind
Technisch	Unterbrechungen, Fehler, Programmfehler und andere technische Probleme	Projektinhaber (`roles/owner`)	IT-Experten, Zuverlässigkeitsentwickler, Administratoren, Bereitschaftslisten und andere Personen, die aktuelle und zukünftige technische Probleme und Ereignisse kennen, die dazu führen können, dass Ihre IT-Assets nicht ordnungsgemäß funktionieren

Unterstützte Sprachen

In „Essential Contacts“ (Wichtige Kontakte) ist für jeden Kontakt die bevorzugte Spracheinstellung festgelegt. Benachrichtigungsersteller können beim Senden von Benachrichtigungen auf diese Einstellung verweisen.

Wenn Sie einen Kontakt in der Cloud Console hinzufügen, konfiguriert die Cloud Console automatisch die bevorzugte Sprache des Kontakts basierend auf den bevorzugten Spracheinstellungen des Kontakterstellers. Wenn Sie einen Kontakt über die API hinzufügen, konfigurieren Sie die bevorzugte Sprache des Kontakts mit einem Sprachcode manuell. Der Sprachcode kann sich auf alle Sprachen beziehen, die von „Wichtige Kontakte“ unterstützt werden.

Unterstützte Sprachen

Sprache	Sprachcode
Afrikaans	af
Albanisch	sq
Amharisch	am
Arabisch	ar
Arabisch (Ägypten)	ar-EG
Armenisch	hy
Aserbaidschanisch	az
Baskisch	eu
Weißrussisch	be
Bengalisch	bn
Bosnisch	bs
Bulgarisch	bg
Burmesisch	my
Katalanisch	ca
Chinesisch	zh
Chinesisch (Hongkong)	zh-HK
Chinesisch (Taiwan)	zh-TW
Kroatisch	hr
Tschechisch	cs
Dänisch	da
Niederländisch	nl
Englisch	en
Englisch (Australien)	en-AU
Englisch (Vereinigtes Königreich)	en-GB
Englisch (USA)	en-US
Estnisch	et
Filipino	fil
Finnisch	fi
Französisch	fr
Französisch (Kanada)	fr-CA
Galicisch	gl
Deutsch	de
Georgisch	ka
Griechisch	el
Gujarati	gu
Hebräisch	iw
Hindi	hi
Ungarisch	hu
Isländisch	ist
Indonesisch	id
Irisch	ga
Italienisch	it
Japanisch	ja
Javanisch	jv
Kannada	kn
Kasachisch	kk
Khmer	km
Koreanisch	ko
Kirgisisch	ky
Laotisch	lo
Lettisch	lv
Litauisch	lt
Mazedonisch	mk
Malaiisch	ms
Malajaman	ml
Marathi	mr
Mongolisch	mn
Nepalesisch	ne
Norwegisch	no
Paschtunisch	ps
Persisch	fa
Polnisch	pl
Portugiesisch	pt
Portugiesisch (Brasilien)	pt-BR
Portugiesisch (Portugal)	pt-PT
Panjabi	pa
Rumänisch	ro
Russisch	ru
Serbisch	sr
Sindhi	sd
Singhalesisch	si
Slowakisch	sk
Slowenisch	sl
Somali	so
Spanisch	es
Spanisch (Lateinamerika)	es-419
Swahili	sw
Schwedisch	sv
Tamilisch	ta
Telugu	te
Thai	th
Türkisch	tr
Turkmenisch	tk
Ukrainisch	uk
Urdu	ur
Usbekisch	uz
Vietnamesisch	vi
Walisisch	cy
Zulu	zu

Festlegen, wo Kontakte zugewiesen werden sollen

Sie können Kontakte auf Projekt-, Ordner- oder Organisationsebene zuweisen.

Kontakte werden über die Google Cloud-Ressourcenhierarchie übernommen. Wenn Sie also einen Kontakt auf Organisationsebene hinzufügen, erhält er Benachrichtigungen für die Organisation und für alle Ordner und Projekte in der Organisation. Wenn Sie einen Kontakt auf Ordnerebene hinzufügen, erhält er Benachrichtigungen für den entsprechenden Ordner und für alle Ordner und Projekte in diesem Ordner.

Wo Sie Kontakte zuweisen, hängt von der Struktur Ihres Unternehmens ab. Wir empfehlen in der Regel, Kontakte je nach Benachrichtigungskategorie auf folgenden Ebenen zuzuweisen:

Empfohlene Ebene	Benachrichtigungskategorie
Organisationsebene	Abrechnung Rechtsabteilung Sicherheit¹
Ordner-/Projektebene	Alle Produktaktualisierungen Sicherheit¹ Sperrung Technisch

¹ Die Ebene, auf der Sie Sicherheitskontakte zuweisen sollten, hängt von den spezifischen Sicherheitspraktiken Ihres Unternehmens ab. Wenn zum Beispiel die einzelnen Projekteigentümer die Sicherheit für ihre eigenen Projekte übernehmen, weisen Sie Ihre Sicherheitskontakte auf Projektebene zu. Wenn jedoch eine organisationsweite Gruppe die Sicherheit für alle Projekte verwaltet, weisen Sie Ihre Sicherheitskontakte auf Organisationsebene zu.

Kontakte auflisten

So listen Sie alle Kontakte in Ihrem Projekt, Ordner oder Ihrer Organisation auf:

Console

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

Zur Seite „Wichtige Kontakte“
Achten Sie darauf, dass der Name Ihres Projekts, Ihres Ordners oder Ihrer Organisation in der Projektauswahl oben auf der Seite angezeigt wird. Die Projektauswahl gibt an, für welches Projekt, welcher Ordner oder welche Organisation Sie derzeit Kontakte verwalten.
Um die Kontakte nach Kategorie aufzulisten, wählen Sie Kategorie aus. Wählen Sie Kontakte aus, um die Kontakte alphabetisch aufzulisten.
Hinweis: Wenn Sie Kontakte für eine untergeordnete Ressource (Ordner oder Projekt) aufrufen, die Kontakte von ihren Ancestors (Organisationen oder andere Ordner) übernimmt, sehen Sie die übernommenen Kontakte für alle Ancestors, für die Sie die Berechtigung zum Anzeigen der Kontakte haben.
Hinweis: Wenn Sie Kontakte für eine Organisation oder einen Ordner aufrufen, sehen Sie keine Kontakte für ihre untergeordneten Ressourcen.

REST

Kontakte auflisten

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 festgelegt wurden.

Bevor Sie die unten aufgeführten Daten für eine Anfrage verwenden, nehmen Sie folgende Ersetzungen vor:

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 Google Cloud-Projekts, Ihrer Organisation oder Ihres Ordners.
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.

Anfrage

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

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

curl (Linux, macOS oder Cloud Shell)

Führen Sie diesen Befehl aus:

curl -X GET \
-H "Authorization: Bearer "$(gcloud auth application-default print-access-token) \
https://essentialcontacts.googleapis.com/v1alpha1/RESOURCE_TYPE/RESOURCE_ID/contacts?pageSize=PAGE_SIZE&pageToken=NEXT_PAGE_TOKEN

PowerShell (Windows)

Führen Sie diesen Befehl aus:

$cred = gcloud auth application-default print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
  -Method GET `
  -Headers $headers `
  -Uri "https://essentialcontacts.googleapis.com/v1alpha1/RESOURCE_TYPE/RESOURCE_ID/contacts?pageSize=PAGE_SIZE&pageToken=NEXT_PAGE_TOKEN" | Select-Object -Expand Content

Sie müssten in etwa folgende JSON-Antwort erhalten:

{
  "contacts": [
    {
      "name": "projects/my-projects/contacts/1",
      "email": "my-contact-1@my-domain.com",
      "notificationCategorySubscriptions": [
        "ALL"
      ],
      "languageTag": "en-US"
    },
    {
      "name": "projects/my-projects/contacts/2",
      "email": "my-contact-2@my-domain.com",
      "notificationCategorySubscriptions": [
        "BILLING"
      ],
      "languageTag": "en-US"
    }
  ]
}

Kontakte und übernommene Kontakte auflisten

Untergeordnete Ressourcen (Ordner und Projekte) übernehmen Kontakte von ihren Ancestors (Organisationen und anderen Ordnern). Wenn Sie alle Kontakte und übernommenen Kontakte für eine Ressource auflisten möchten, verwenden Sie die Methode contacts.compute der Essential Contacts API.

Bevor Sie die unten aufgeführten Daten für eine Anfrage verwenden, nehmen Sie folgende Ersetzungen vor:

RESOURCE_TYPE: Der Ressourcentyp, für den Sie Kontakte berechnen möchten. Verwenden Sie den Wert projects, folders oder organizations.
RESOURCE_ID: Die ID Ihres Google Cloud-Projekts, Ihrer Organisation oder Ihres Ordners.
NOTIFICATION_CATEGORY: Die Benachrichtigungskategorien, für die Kontakte berechnet werden sollen. Sie können dieses Feld wiederholen, um Kontakte für mehrere Benachrichtigungskategorien aufzulisten. NOTIFICATION_CATEGORY kann einer der folgenden Werte sein: ALL, BILLING, LEGAL, PRODUCT_UPDATES, SECURITY, SUSPENSION, TECHNICAL und NOTIFICATION_CATEGORY_UNSPECIFIED. Wenn Sie den Wert ALL auswählen, werden Kontakte für alle Kategorien aufgelistet.
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.

Anfrage

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

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

curl (Linux, macOS oder Cloud Shell)

Führen Sie diesen Befehl aus:

curl -X GET \
-H "Authorization: Bearer "$(gcloud auth application-default print-access-token) \
https://essentialcontacts.googleapis.com/v1alpha1/RESOURCE_TYPE/RESOURCE_ID/contacts:compute?notificationCategories=NOTIFICATION_CATEGORY&pageSize=PAGE_SIZE&pageToken=NEXT_PAGE_TOKEN

PowerShell (Windows)

Führen Sie diesen Befehl aus:

$cred = gcloud auth application-default print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
  -Method GET `
  -Headers $headers `
  -Uri "https://essentialcontacts.googleapis.com/v1alpha1/RESOURCE_TYPE/RESOURCE_ID/contacts:compute?notificationCategories=NOTIFICATION_CATEGORIES&pageSize=PAGE_SIZE&pageToken=NEXT_PAGE_TOKEN" | Select-Object -Expand Content

In der Antwort werden alle Kontakte und übernommenen Kontakte für die Ressource aufgelistet:

{
  "contacts": [
    {
      "name": "projects/my-projects/contacts/1",
      "email": "my-project-contact-1@my-domain.com",
      "notificationCategorySubscriptions": [
        "ALL"
      ],
      "languageTag": "en-US"
    },
    {
      "name": "projects/my-projects/contacts/2",
      "email": "my-project-contact-2@my-domain.com",
      "notificationCategorySubscriptions": [
        "BILLING"
      ],
      "languageTag": "en-US"
    },
    {
      "name": "organizations/my-organization/contacts/1",
      "email": "my-organization-contact@my-domain.com",
      "notificationCategorySubscriptions": [
        "ALL"
      ],
      "languageTag": "en-US"
    }
  ]
}

Einzelne Kontakte verwalten

Sie können einzelne Kontakte auf der Seite Wichtige Kontakte in der Cloud Console oder mithilfe der REST API verwalten.

Kontakte hinzufügen

So fügen Sie einen Kontakt hinzu:

Console

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

Zur Seite „Wichtige Kontakte“
Achten Sie darauf, dass der Name Ihres Projekts, Ihres Ordners oder Ihrer Organisation in der Projektauswahl oben auf der Seite angezeigt wird. Die Projektauswahl gibt an, für welches Projekt, welcher Ordner oder welche Organisation Sie derzeit Kontakte verwalten.
Klicken Sie auf Kontakt hinzufügen.
Geben Sie die E-Mail-Adresse des Kontakts in die Felder E-Mail und E-Mail bestätigen ein.
Wählen Sie im Drop-down-Menü Benachrichtigungskategorien die Benachrichtigungskategorien aus, für die der Kontakt Benachrichtigungen erhalten soll. Eine Liste der Benachrichtigungskategorien und empfohlenen Kontakte finden Sie auf dieser Seite unter Kontakte identifizieren.
Klicken Sie auf Speichern.

REST

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

Bevor Sie die unten aufgeführten Daten für eine Anfrage verwenden, nehmen Sie folgende Ersetzungen vor:

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 Google Cloud-Projekts, Ihrer Organisation oder Ihres Ordners.
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 Benachrichtigungskategorien, für die der Kontakt Benachrichtigungen erhalten soll. Folgende Werte sind möglich: ALL, BILLING, LEGAL, PRODUCT_UPDATES, SECURITY, SUSPENSION und TECHNICAL.

Eine Liste der empfohlenen Kontakte für jede Kategorie finden Sie unter Kontakte identifizieren auf dieser Seite.
LANGUAGE: Der Sprachcode für die bevorzugte Benachrichtigungssprache Ihres Kontakts. Sie können den Sprachcode aller unterstützten Sprachen einfügen.

Anfrage

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

Anfragetext:

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

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

curl (Linux, macOS oder Cloud Shell)

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:

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/v1alpha1/RESOURCE_TYPE/RESOURCE_ID/contacts

PowerShell (Windows)

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:

$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/v1alpha1/RESOURCE_TYPE/RESOURCE_ID/contacts" | Select-Object -Expand Content

Sie müssten in etwa folgende JSON-Antwort erhalten:

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

Kontakt ändern

So ändern Sie die Kategorien, denen ein Kontakt zugewiesen ist:

Console

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

Zur Seite „Wichtige Kontakte“
Achten Sie darauf, dass der Name Ihres Projekts, Ihres Ordners oder Ihrer Organisation in der Projektauswahl oben auf der Seite angezeigt wird. Die Projektauswahl gibt an, für welches Projekt, welcher Ordner oder welche Organisation Sie derzeit Kontakte verwalten.
Wählen Sie neben Anzeigen nach die Option Kontakt aus.
Klicken Sie neben dem Kontakt, dessen Kategorie Sie ändern möchten, auf .
Wählen Sie die gewünschten Benachrichtigungskategorien im Drop-down-Menü Benachrichtigungskategorien aus und klicken Sie auf Speichern.

REST

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

Bevor Sie die unten aufgeführten Daten für eine Anfrage verwenden, nehmen Sie folgende Ersetzungen vor:

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 Google Cloud-Projekts, Ihrer Organisation oder Ihres Ordners.
CONTACT_ID: Die numerische ID Ihres Kontakts. Wenn Sie die IDs aller Kontakte in Ihrem Projekt, Ordner oder Ihrer Organisation auflisten möchten, listen Sie Ihre Kontakte auf.
UPDATE_MASK: Optional. Eine Maske, die angibt, welche Felder des Kontakts Sie geändert haben. Das Format für die Maske ist eine durch Kommas getrennte Liste vollständig qualifizierter Feldnamen. Beispiel: 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 Benachrichtigungskategorien, für die der Kontakt Benachrichtigungen erhalten soll. Folgende Werte sind möglich: ALL, BILLING, LEGAL, PRODUCT_UPDATES, SECURITY, SUSPENSION und TECHNICAL.

Eine Liste der empfohlenen Kontakte für jede Kategorie finden Sie unter Kontakte identifizieren auf dieser Seite.
LANGUAGE: Der Sprachcode für die bevorzugte Benachrichtigungssprache des Kontakts. Sie können den Sprachcode aller unterstützten Sprachen einfügen.

Anfrage

PATCH essentialcontacts.googleapis.com/v1alpha1/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"
}

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

curl (Linux, macOS oder Cloud Shell)

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:

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/v1alpha1/RESOURCE_TYPE/RESOURCE_ID/contacts/CONTACT_ID?updateMask="UPDATE_MASK"

PowerShell (Windows)

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:

$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/v1alpha1/RESOURCE_TYPE/RESOURCE_ID/contacts/CONTACT_ID?updateMask="UPDATE_MASK"" | Select-Object -Expand Content

Sie müssten in etwa folgende JSON-Antwort erhalten:

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

Kontakt löschen

So löschen Sie einen Kontakt:

Console

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

Zur Seite „Wichtige Kontakte“
Achten Sie darauf, dass der Name Ihres Projekts, Ihres Ordners oder Ihrer Organisation in der Projektauswahl oben auf der Seite angezeigt wird. Die Projektauswahl gibt an, für welches Projekt, welcher Ordner oder welche Organisation Sie derzeit Kontakte verwalten.
Wählen Sie neben Anzeigen nach die Option Kontakt aus.
Klicken Sie neben der E-Mail-Adresse des Kontakts, den Sie löschen möchten, auf . Bestätigen Sie im Dialogfeld, dass Sie den Kontakt löschen möchten.

REST

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

Bevor Sie die unten aufgeführten Daten für eine Anfrage verwenden, nehmen Sie folgende Ersetzungen vor:

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 Google Cloud-Projekts, Ihrer Organisation oder Ihres Ordners.
CONTACT_ID: Die numerische ID Ihres Kontakts. Wenn Sie die IDs aller Kontakte in Ihrem Projekt, Ordner oder Ihrer Organisation auflisten möchten, listen Sie Ihre Kontakte auf.

Anfrage

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

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

curl (Linux, macOS oder Cloud Shell)

Führen Sie diesen Befehl aus:

curl -X DELETE \
-H "Authorization: Bearer "$(gcloud auth application-default print-access-token) \
https://essentialcontacts.googleapis.com/v1alpha1/RESOURCE_TYPE/RESOURCE_ID/contacts/CONTACT_ID

PowerShell (Windows)

Führen Sie diesen Befehl aus:

$cred = gcloud auth application-default print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
  -Method DELETE `
  -Headers $headers `
  -Uri "https://essentialcontacts.googleapis.com/v1alpha1/RESOURCE_TYPE/RESOURCE_ID/contacts/CONTACT_ID" | Select-Object -Expand Content

Wenn die Anfrage erfolgreich ist, ist der Antworttext leer.

Kontakte nach Kategorie verwalten

In der Cloud Console können Sie Kontakte auch nach Kategorie verwalten. Wechseln Sie dazu auf der Seite Wichtige Kontakte zum Tab Kategorie.

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

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

Zur Seite „Wichtige Kontakte“
Achten Sie darauf, dass der Name Ihres Projekts, Ihres Ordners oder Ihrer Organisation in der Projektauswahl oben auf der Seite angezeigt wird. Die Projektauswahl gibt an, für welches Projekt, welcher Ordner oder welche Organisation Sie derzeit Kontakte verwalten.
Wählen Sie neben Anzeigen nach die Option Kategorie aus.
Klicken Sie in der Zeile, in der Sie die Kontakte verwalten möchten, auf .
So verwalten Sie die Kontakte, die der Kategorie zugewiesen sind:
- Klicken Sie zum Hinzufügen eines neuen Kontakts auf Kontakt hinzufügen und folgen Sie den Schritten zum Hinzufügen eines Kontakts, die auf dieser Seite beschrieben werden.
- Zum Ändern der Kategorie, der ein Kontakt zugewiesen ist, klicken Sie neben dem Kontakt, dessen Kategorie Sie ändern möchten, auf . Wählen Sie dann die gewünschten Benachrichtigungskategorien im Drop-down-Menü Benachrichtigungskategorien aus und klicken Sie auf Speichern.
  
  Hinweis: Die E-Mail-Adresse eines Kontakts kann nicht geändert werden. Sie können eine E-Mail-Adresse ändern. Fügen Sie dazu einen neuen Kontakt mit der aktualisierten E-Mail-Adresse hinzu und löschen Sie den alten Kontakt.
- Wenn Sie einen Kontakt löschen möchten, klicken Sie neben der E-Mail-Adresse des Kontakts auf .

Nächste Schritte

Weitere Informationen zum Verknüpfen einer Domain mit einem Projekt zu Verifizierungszwecken.
Weitere Informationen zum Verwalten Ihrer Benachrichtigungseinstellungen.