通知の連絡先の管理

Cloud Billing などの多くの Google Cloud サービスは、Google Cloud ユーザーと重要な情報を共有するために通知を送信します。デフォルトでは、これらの通知は特定の Identity and Access Management（IAM）のロールを持つメンバーに送信されます。エッセンシャルコンタクトを使用する場合、独自の連絡先リストを指定することで、通知を受け取るユーザーをカスタマイズできます。

始める前に

Essential Contacts API を有効にします。

API を有効にする

必要なロール

連絡先を管理するために必要な権限を取得するには、連絡先が割り当てられているプロジェクト、フォルダ、組織に対し、次の IAM ロールを付与するように管理者に依頼してください。

連絡先を表示するには: 重要な連絡先の閲覧者（roles/essentialcontacts.viewer）
連絡先を表示、編集、削除、作成するには: 重要な連絡先の管理者（roles/essentialcontacts.admin）

ロールの付与の詳細については、アクセスの管理をご覧ください。

これらの事前定義ロールには、連絡先の管理に必要な権限が含まれています。必要な権限を正確に表示するには、[必要な権限] セクションを展開します。

必要な権限

連絡先を表示するには:
- essentialcontacts.contacts.get
- essentialcontacts.contacts.list
連絡先を編集、削除、作成するには:
- essentialcontacts.contacts.create
- essentialcontacts.contacts.delete
- essentialcontcts.contacts.update

カスタムロールや他の事前定義ロールを使用して、これらの権限を取得することもできます。

通知のカテゴリ

連絡先は、複数の通知カテゴリに割り当てることができます。カテゴリに連絡先を追加しない場合、そのカテゴリの通知はメンバーの IAM ロールに基づいて選択されるフォールバックの連絡先に送信されます。適切な担当者がプロジェクト、フォルダ、組織への通知を受け取れるように、フォールバックの連絡先を使用せずに、カスタムの連絡先を追加することをおすすめします。

個人とグループの両方を連絡先として追加できます。人事異動の影響を減らすため、グループを連絡先として追加し、それらのグループのメンバーを管理して、通知を受け取る従業員を決定することをおすすめします。この方法によって、常にアクティブな従業員に通知が送られるようになります。

通知のカテゴリ、フォールバックの連絡先、おすすめの連絡先については、次の表をご覧ください。特定のカテゴリに連絡先を割り当てない場合、通知はフォールバックの連絡先に送信されます。

カテゴリ	説明	例	フォールバックの連絡先	推奨される連絡先
All	他のすべてのカテゴリからのすべての通知	該当なし	該当なし	多数の可能性がある通知のルーティングやロギングを担当する従業員または自動システム
課金	課金とお支払いの通知	料金の更新、エラー、クレジット	請求先アカウント管理者（`roles/billing.admin`）	財務部門の従業員と、Google Cloud の使用に関する予算、計画、会計の管理など、Google との財務関係を管理する従業員
法務	法令遵守の通知	適用措置、法令遵守、行政通達	請求先アカウント管理者（`roles/billing.admin`）	顧問弁護士、コンプライアンス管理者、政府関係のスペシャリスト、その他の関連する専門家
プロダクトの更新情報	Google プロダクトの変更点	新しいバージョン、プロダクトの利用条件の更新、サポートの終了	プロジェクト所有者（`roles/owner`）	Google のプロダクトおよびサービスの変更に関するタイムリーな情報を活用できるプロダクトマネージャー、アーキテクト、エンジニア
セキュリティ	セキュリティ / プライバシーの問題に関する通知	脆弱性、データインシデント、攻撃	組織管理者（`roles/resourcemanager.organizationAdmin`）	IT セキュリティ、運用上のセキュリティ、企業および顧客データの保護とビジネスの継続性の確保を担当するその他の従業員
停止	即時アカウントおよびプロジェクト停止に関連する通知	Apigee の評価のコンプライアンス、著作権侵害、コインマイニング	プロジェクト所有者（`roles/owner`）	IT インフラストラクチャとビジネスアプリケーションの維持および稼働に早急に対応する従業員
技術	技術イベントとその他の運用の問題	Logging の構成エラー、データ損失防止の更新、Actions on Google のステータス	プロジェクト所有者（`roles/owner`）	IT プロフェッショナル、信頼性エンジニア、管理者、オンコールリスト、および、IT アセットをより適切に管理し、障害を回避するために、現在および将来の技術イベントや問題を把握する必要がある他の従業員
技術的なインシデント	プレミアムサポートのお客様の場合、サービス停止通知の技術カテゴリのサブカテゴリ	予期せぬサービス停止、サービスの問題	該当なし	IT プロフェッショナル、信頼性エンジニア、管理者、オンコールリスト、およびサービスの停止に対応する必要がある他の従業員

サポートされている言語

エッセンシャルコンタクトでは、各連絡先に優先言語が設定されています。通知作成者は、通知の送信時にこの設定を参照できます。

Cloud Console で連絡先を追加すると、Cloud Console は連絡先作成者の優先言語設定に基づいて連絡先の設定言語を自動的に構成します。API を使用して連絡先を追加する場合は、言語コードを使用して連絡先の設定言語を手動で構成します。この言語コードは、エッセンシャルコンタクトでサポートされているすべての言語を参照できます。

サポートされている言語

言語	言語コード
アフリカーンス語	af
アルバニア語	sq
アムハラ語	am
アラビア語	ar
アラビア語（エジプト）	ar-EG
アルメニア語	hy
アゼルバイジャン語	az
バスク語	eu
ベラルーシ語	be
ベンガル語	bn
ボスニア語	bs
ブルガリア語	bg
ビルマ語	my
カタロニア語	ca
中国語	zh
中国語（香港）	zh-HK
中国語（台湾）	zh-TW
クロアチア語	hr
チェコ語	cs
デンマーク語	da
オランダ語	nl
英語	en
英語（オーストラリア）	en-AU
英語（イギリス）	en-GB
英語（アメリカ）	en-US
エストニア語	et
フィリピン語	fil
フィンランド語	fi
フランス語	fr
フランス語（カナダ）	fr-CA
ガリシア語	gl
ドイツ語	de
ジョージア語	ka
ギリシャ語	el
グジャラト語	gu
ヘブライ語	iw
ヒンディー語	hi
ハンガリー語	hu
アイスランド語	is
インドネシア語	id
アイルランド語	ga
イタリア語	it
日本語	ja
ジャワ語	jv
カンナダ語	kn
カザフ語	kk
クメール語	km
韓国語	ko
キルギス語	ky
ラオ語	lo
ラトビア語	lv
リトアニア語	lt
マケドニア語	mk
マレー語	ms
マラヤーラム語	ml
マラーティー語	mr
モンゴル語	mn
ネパール語	ne
ノルウェー語	no
パシュト語	ps
ペルシャ語	fa
ポーランド語	pl
ポルトガル語	pt
ポルトガル語（ブラジル）	pt-BR
ポルトガル語（ポルトガル）	pt-PT
パンジャブ語	pa
ルーマニア語	ro
ロシア語	ru
セルビア語	sr
シンド語	sd
シンハラ語	si
スロバキア語	sk
スロベニア語	sl
ソマリ語	so
スペイン語	es
スペイン語（ラテンアメリカ）	es-419
スワヒリ語	sw
スウェーデン語	sv
タミル語	ta
テルグ語	te
タイ語	th
トルコ語	tr
トルクメン語	tk
ウクライナ語	uk
ウルドゥー語	ur
ウズベク語	uz
ベトナム語	vi
ウェールズ語	cy
ズールー語	zu

連絡先の割り当てに関するベストプラクティス

連絡先は、プロジェクト、フォルダ、または組織レベルで割り当てることができます。

連絡先は Google Cloud リソース階層から継承されます。その結果、組織レベルで連絡先を追加すると、その組織と、組織内のすべてのフォルダとプロジェクトへの通知を受け取ります。同様に、フォルダレベルで連絡先を追加すると、そのフォルダと、フォルダ内のすべてのフォルダとプロジェクトへの通知を受け取ります。

連絡先を割り当てる場所は、組織構造によって異なります。ただし通常は、通知カテゴリに基づいて、次のレベルで連絡先を割り当てることをおすすめします。

推奨レベル	通知のカテゴリ
組織レベル	課金法務セキュリティ¹
フォルダ / プロジェクトレベル	すべてプロダクトの更新情報セキュリティ¹ 停止技術 ²

¹ セキュリティの連絡先を割り当てるレベルは、組織固有のセキュリティ対策によって異なります。たとえば、個々のプロジェクトオーナーがそれぞれのプロジェクトのセキュリティを担当する場合は、プロジェクトレベルでセキュリティの連絡先を割り当てます。ただし、組織全体のグループがすべてのプロジェクトのセキュリティを管理している場合は、セキュリティの連絡先を組織レベルで割り当てます。

² 技術カテゴリの連絡先は多数のメール通知を受け取ります。フォルダまたはプロジェクトレベルでこれらの連絡先を割り当てると、受信通知フローの処理が可能になります。

サービスの停止と中断の通知の連絡先の割り当て

プレミアムサポートのお客様の場合、技術インシデントのサブカテゴリを通じて、サービス停止と中断の通知を受け取る連絡先を割り当てることができます。これにより、他の技術的な通知に気を取られることなく、サービス停止に注意を集中する必要がある連絡先に、影響の大きなサービス停止の通知を送信できます。

通知が適切な連絡先に送信されるようにするには、技術インシデントサブカテゴリに連絡先を割り当てる際に、次の継承の動作に留意してください。

プロジェクトまたはフォルダに技術インシデントの連絡先を割り当てると、サービス停止の通知は次の連絡先にのみ送信されます。
- プロジェクトまたはフォルダの技術インシデントの連絡先
- 親組織またはフォルダから継承された技術インシデントの連絡先
プロジェクトまたはフォルダに技術インシデントの連絡先を割り当てない場合、サービス停止の通知は次の場合にのみ送信されます。
- プロジェクトまたはフォルダの技術連絡先
- 親組織またはフォルダから継承された技術インシデントの連絡先
技術的なインシデントの連絡先が割り当てや継承が行われない場合、サービス停止の通知は送信されません

連絡先に許可されたドメインの制限

新しい連絡先に含めることができるメールアドレスのドメインを制限するには、組織のポリシーの制約 constraints/essentialcontacts.allowedContactDomains を設定します。既存の連絡先はこの制約の影響を受けません。

組織のポリシーの制約を設定する方法については、組織のポリシーの制約をご覧ください。

連絡先の一覧表示

プロジェクト、フォルダ、組織内のすべての連絡先を一覧表示するには、次のようにします。

Console

Cloud Console で、[エッセンシャルコンタクト] ページに移動します。

[エッセンシャルコンタクト] ページに移動
プロジェクト、フォルダ、または組織の名前が、ページの上部にあるリソースセレクタに表示されていることを確認します。リソースセレクタは、現在どのプロジェクト、フォルダ、組織の連絡先を管理しているかを示します。
連絡先をカテゴリ別に一覧表示するには、[カテゴリ] を選択します。連絡先をアルファベット順に一覧表示するには、[連絡先] を選択します。
注: 祖先（組織または他のフォルダ）から連絡先を継承する子リソース（フォルダまたはプロジェクト）の連絡先を表示している場合、連絡先を表示する権限を付与したすべての祖先の継承された連絡先が表示されます。
注: 組織またはフォルダの連絡先を表示する場合、その子リソースの連絡先は表示されません。

gcloud

Google Cloud CLI を使用すると、リソースに定義されている連絡先を一覧表示するか、リソースのすべての連絡先と継承された連絡先を一覧表示できます。

リソースで定義された連絡先の一覧表示

特定のプロジェクト、フォルダ、または組織に定義された連絡先を表示するには、gcloud essential-contacts list コマンドを使用します。

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

次の値を置き換えます。

RESOURCE_TYPE: 連絡先を一覧表示するリソースタイプ。値 project、folder、または organization を使用します。
RESOURCE_ID: Google Cloud プロジェクト、組織、またはフォルダ ID。プロジェクト ID は英数字からなる文字列です（例: my-project）。フォルダ ID と組織 ID は数値です（例: 123456789012）。

または、リソースタイプや ID を指定しない場合、gcloud CLI では現在のプロジェクトの連絡先が一覧表示されます。

レスポンスは次の例のようになります。

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

連絡先と継承された連絡先の一覧表示

子リソース（フォルダとプロジェクト）は、祖先（組織や他のフォルダ）から連絡先を継承します。リソースのすべての連絡先と継承された連絡先を一覧表示するには、gcloud essential-contacts compute コマンドを使用します。

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

次の値を置き換えます。

後述のリクエストのデータを使用する前に、次のように置き換えます。

NOTIFICATION_CATEGORIES: 連絡先を算定する通知のカテゴリのカンマ区切りリスト。リストには、all、billing、legal、product-updates、security、suspension、technical、technical-incidents、notification-category-unspecified の値のいずれかを含めることができます。値 all を指定すると、すべてのカテゴリの連絡先が一覧表示されます。
RESOURCE_TYPE: 連絡先を算定するリソースタイプ。値 project、folder、または organization を使用します。
RESOURCE_ID: Google Cloud プロジェクト、組織、またはフォルダ ID。プロジェクト ID は英数字からなる文字列です（例: my-project）。フォルダ ID と組織 ID は数値です（例: 123456789012）。

リソースタイプや ID を指定しない場合、gcloud CLI では現在のプロジェクトの連絡先が一覧表示されます。

レスポンスには、そのリソースのすべての連絡先と継承された連絡先が一覧表示されます。

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

Essential Contacts REST API を使用すると、リソースに定義されている連絡先を一覧表示するか、リソースのすべての連絡先と継承された連絡先を一覧表示できます。

リソースで定義された連絡先の一覧表示

特定のプロジェクト、フォルダ、または組織に定義された連絡先を表示するには、Essential Contacts API の contacts.list メソッドを使用します。

後述のリクエストのデータを使用する前に、次のように置き換えます。

RESOURCE_TYPE: 連絡先を一覧表示するリソースタイプ。値 projects、folders、または organizations を使用します。
RESOURCE_ID: Google Cloud プロジェクト、組織、またはフォルダ ID。プロジェクト ID は英数字からなる文字列です（例: my-project）。フォルダ ID と組織 ID は数値です（例: 123456789012）。
PAGE_SIZE: 省略可。レスポンスに含める連絡先の数。デフォルト値は 50、最大値は 100 です。連絡先の数がページサイズより大きい場合、レスポンスにページ設定トークンが含まれます。このトークンを使用して、結果の次のページを取得できます。
NEXT_PAGE_TOKEN: 省略可。以前のレスポンスでこのメソッドから返されたページ設定トークン。指定すると、前のレスポンスが終了した時点から連絡先のリストが開始されます。

リクエスト:

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

リクエストを送信するには、次のいずれかのオプションを展開します。

curl（Linux、macOS、Cloud Shell）

次のコマンドを実行します。

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）

次のコマンドを実行します。

$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

リクエストを送信すると、次のような JSON レスポンスが返されます。

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

連絡先と継承された連絡先の一覧表示

子リソース（フォルダとプロジェクト）は、祖先（組織や他のフォルダ）から連絡先を継承します。リソースのすべての連絡先と継承された連絡先を一覧表示するには、Essential Contacts API の contacts.compute メソッドを使用します。

後述のリクエストのデータを使用する前に、次のように置き換えます。

RESOURCE_TYPE: 連絡先を算定するリソースタイプ。値 projects、folders、または organizations を使用します。
RESOURCE_ID: Google Cloud プロジェクト、組織、またはフォルダ ID。プロジェクト ID は英数字からなる文字列です（例: my-project）。フォルダ ID と組織 ID は数値です（例: 123456789012）。
NOTIFICATION_CATEGORY: 連絡先を算定する通知のカテゴリ。このフィールドを繰り返し使用することで、複数の通知カテゴリの連絡先を一覧表示できます。NOTIFICATION_CATEGORY は、次のいずれかの値になります: ALL、BILLING、LEGAL、PRODUCT_UPDATES、SECURITY、SUSPENSION、TECHNICAL、TECHNICAL_INCIDENTS、NOTIFICATION_CATEGORY_UNSPECIFIED。値 ALL を指定すると、すべてのカテゴリの連絡先が一覧表示されます。
PAGE_SIZE: 省略可。レスポンスに含める連絡先の数。デフォルト値は 50、最大値は 100 です。連絡先の数がページサイズより大きい場合、レスポンスにページ設定トークンが含まれます。このトークンを使用して、結果の次のページを取得できます。
NEXT_PAGE_TOKEN: 省略可。以前のレスポンスでこのメソッドから返されたページ設定トークン。指定すると、前のレスポンスが終了した時点から連絡先のリストが開始されます。

リクエスト:

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

リクエストを送信するには、次のいずれかのオプションを展開します。

curl（Linux、macOS、Cloud Shell）

次のコマンドを実行します。

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）

次のコマンドを実行します。

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

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

レスポンスには、そのリソースのすべての連絡先と継承された連絡先が一覧表示されます。

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

個々のエッセンシャルコンタクトの管理

連絡先の追加、削除、通知カテゴリの割り当ては、Cloud Console の [エッセンシャルコンタクト] ページを使用するか、REST API を使用して行います。

連絡先の追加

連絡先を追加する手順は次のとおりです。

Console

Cloud Console で、[エッセンシャルコンタクト] ページに移動します。

[エッセンシャルコンタクト] ページに移動
プロジェクト、フォルダ、または組織の名前が、ページの上部にあるリソースセレクタに表示されていることを確認します。リソースセレクタは、現在どのプロジェクト、フォルダ、組織の連絡先を管理しているかを示します。
[連絡先に追加] をクリックします。
[メール] フィールドと [メールの確認] フィールドに、連絡先のメールアドレスを入力します。
[通知のカテゴリ] プルダウンメニューから、通知を受け取る連絡先の通知カテゴリを選択します。通知カテゴリと推奨される連絡先のリストについては、このページの連絡先を特定するをご覧ください。
[保存] をクリックします。

gcloud

新しい連絡先を追加するには、gcloud essential-contacts create コマンドを使用します。

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

次の値を置き換えます。

EMAIL: 連絡先のメールアドレス。連絡先を作成した後にこのフィールドを変更することはできません。
NOTIFICATION_CATEGORIES: 連絡先が通知を受け取る通知カテゴリのカンマ区切りのリスト。リストには、all、billing、legal、product-updates、security、suspension、technical、technical-incidents、notification-category-unspecified の値のいずれかを含めることができます。値 all を指定すると、すべてのカテゴリの連絡先が一覧表示されます。

各カテゴリの推奨される連絡先のリストについては、このページの連絡先を特定するをご覧ください。
LANGUAGE: 連絡先の優先通知言語の言語コード。サポートされている言語の任意の言語コードを含めることができます。
RESOURCE_TYPE: 連絡先を作成するリソースタイプ。値 project、folder、または organization を使用します。
RESOURCE_ID: Google Cloud プロジェクト、組織、またはフォルダ ID。プロジェクト ID は英数字からなる文字列です（例: my-project）。フォルダ ID と組織 ID は数値です（例: 123456789012）。

リソースタイプや ID を指定しない場合、gcloud CLI は、現在のプロジェクトに連絡先を作成します。

コマンドが成功した場合、レスポンスは返されません。

REST

新しい連絡先を追加するには、Essential Contacts API の contacts.create メソッドを使用します。

後述のリクエストのデータを使用する前に、次のように置き換えます。

RESOURCE_TYPE: 連絡先を作成するリソースタイプ。値 projects、folders、または organizations を使用します。
RESOURCE_ID: Google Cloud プロジェクト、組織、またはフォルダ ID。プロジェクト ID は英数字からなる文字列です（例: my-project）。フォルダ ID と組織 ID は数値です（例: 123456789012）。
EMAIL: 連絡先のメールアドレス。連絡先を作成した後にこのフィールドを変更することはできません。
NOTIFICATION_CATEGORY_1 と NOTIFICATION_CATEGORY_2: 通知を受け取る連絡先の通知カテゴリ。この値は、ALL、BILLING、LEGAL、PRODUCT_UPDATES、SECURITY、SUSPENSION、TECHNICAL、TECHNICAL_INCIDENTS のいずれかになります。

各カテゴリの推奨される連絡先のリストについては、このページの連絡先を特定するをご覧ください。
LANGUAGE: 連絡先の優先通知言語の言語コード。サポートされている言語の任意の言語コードを含めることができます。

リクエスト:

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

リクエストの本文:

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

リクエストを送信するには、次のいずれかのオプションを展開します。

curl（Linux、macOS、Cloud Shell）

リクエスト本文を request.json という名前のファイルに保存して、次のコマンドを実行します。

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）

リクエスト本文を request.json という名前のファイルに保存して、次のコマンドを実行します。

$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

リクエストを送信すると、次のような JSON レスポンスが返されます。

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

連絡先の変更

連絡先が割り当てられるカテゴリを変更するには、以下の手順を行います。

Console

Cloud Console で、[エッセンシャルコンタクト] ページに移動します。

[エッセンシャルコンタクト] ページに移動
プロジェクト、フォルダ、または組織の名前が、ページの上部にあるリソースセレクタに表示されていることを確認します。リソースセレクタは、現在どのプロジェクト、フォルダ、組織の連絡先を管理しているかを示します。
[表示] の横にある [連絡先] を選択します。
変更するカテゴリの連絡先の横にあるをクリックします。
[通知のカテゴリ] プルダウンメニューで、目的の通知カテゴリを選択し、[保存] をクリックします。

gcloud

既存の連絡先を更新するには、gcloud essential-contacts update コマンドを使用します。

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

次の値を置き換えます。

CONTACT_ID: 更新する連絡先の数値 ID。プロジェクト、フォルダ、組織内のすべての連絡先の ID を表示するには、連絡先を一覧表示してください。数値 ID は、連絡先の名前の contacts より後の部分です。
NOTIFICATION_CATEGORIES: 連絡先が通知を受け取る新しい通知カテゴリのカンマ区切りのリスト。このリストにより、通知カテゴリの既存のリストが置き換えられます。

リストには、all、billing、legal、product-updates、security、suspension、technical、technical-incidents、notification-category-unspecified の値のいずれかを含めることができます。値 all を指定すると、すべてのカテゴリの連絡先が一覧表示されます。

各カテゴリの推奨される連絡先のリストについては、このページの連絡先を特定するをご覧ください。
LANGUAGE: 連絡先の優先通知言語の言語コード。サポートされている言語の任意の言語コードを含めることができます。
RESOURCE_TYPE: 連絡先が定義されているリソースタイプ。値 project、folder、または organization を使用します。
RESOURCE_ID: 連絡先が定義されている Google Cloud プロジェクト、組織、またはフォルダの ID。プロジェクト ID は英数字からなる文字列です（例: my-project）。フォルダ ID と組織 ID は数値です（例: 123456789012）。

リソースタイプや ID を指定しない場合、gcloud CLI は、現在のプロジェクトの指定された ID を持つ連絡先を更新します。指定された ID の連絡先が存在しない場合、gcloud CLI はエラーを返します。

コマンドが成功した場合、レスポンスは返されません。

REST

既存の連絡先の通知登録または設定言語を変更するには、Essential Contacts API の contacts.patch メソッドを使用します。

後述のリクエストのデータを使用する前に、次のように置き換えます。

RESOURCE_TYPE: 連絡先を一覧表示するリソースタイプ。値 projects、folders、または organizations を使用します。
RESOURCE_ID: Google Cloud プロジェクト、組織、またはフォルダ ID。プロジェクト ID は英数字からなる文字列です（例: my-project）。フォルダ ID と組織 ID は数値です（例: 123456789012）。
CONTACT_ID: 更新する連絡先の数値 ID。プロジェクト、フォルダ、組織内のすべての連絡先の ID を表示するには、連絡先を一覧表示してください。数値 ID は、連絡先の名前の contacts より後の部分です。
UPDATE_MASK: 省略可。どの連絡先のフィールドを変更したのかを記述するマスク。マスクの形式は、完全修飾されたフィールド名のカンマ区切りリストです（例: notificationCategorySubscriptions,languageTag）。
EMAIL: 連絡先のメールアドレス。このフィールドは、リクエストに含める CONTACT_ID に関連付けられたメールアドレスと一致する必要があります。
NOTIFICATION_CATEGORY_1、NOTIFICATION_CATEGORY_2: 省略可。連絡先に受け取りを希望する更新通知カテゴリ。この値は、ALL、BILLING、LEGAL、PRODUCT_UPDATES、SECURITY、SUSPENSION、TECHNICAL、TECHNICAL_INCIDENTS のいずれかになります。

各カテゴリの推奨される連絡先のリストについては、このページの連絡先を特定するをご覧ください。
LANGUAGE: 連絡先の優先通知言語の言語コード。サポートされている言語の任意の言語コードを含めることができます。

リクエスト:

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

リクエストの本文:

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

リクエストを送信するには、次のいずれかのオプションを展開します。

curl（Linux、macOS、Cloud Shell）

リクエスト本文を request.json という名前のファイルに保存して、次のコマンドを実行します。

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）

リクエスト本文を request.json という名前のファイルに保存して、次のコマンドを実行します。

$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

リクエストを送信すると、次のような JSON レスポンスが返されます。

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

連絡先の削除

連絡先を削除するには、次のようにします。

Console

Cloud Console で、[エッセンシャルコンタクト] ページに移動します。

[エッセンシャルコンタクト] ページに移動
プロジェクト、フォルダ、または組織の名前が、ページの上部にあるリソースセレクタに表示されていることを確認します。リソースセレクタは、現在どのプロジェクト、フォルダ、組織の連絡先を管理しているかを示します。
[表示] の横にある [連絡先] を選択します。
削除する連絡先のメールアドレスの横にあるをクリックします。ダイアログで、連絡先の削除を確定します。

gcloud

既存の連絡先を削除するには、gcloud essential-contacts delete コマンドを使用します。

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

次の値を置き換えます。

CONTACT_ID: 削除する連絡先の数値 ID。プロジェクト、フォルダ、組織内のすべての連絡先の ID を表示するには、連絡先を一覧表示してください。数値 ID は、連絡先の名前の contacts より後の部分です。
RESOURCE_TYPE: 連絡先が定義されているリソースタイプ。値 project、folder、または organization を使用します。
RESOURCE_ID: 連絡先が定義されている Google Cloud プロジェクト、組織、またはフォルダの ID。プロジェクト ID は英数字からなる文字列です（例: my-project）。フォルダ ID と組織 ID は数値です（例: 123456789012）。

リソースタイプや ID を指定しない場合、gcloud CLI は、現在のプロジェクトの指定された ID の連絡先を削除します。指定された ID の連絡先が存在しない場合、gcloud CLI はエラーを返します。

コマンドが成功した場合、レスポンスは返されません。

REST

連絡先を削除するには、Essential Contacts API の contacts.delete メソッドを使用します。

後述のリクエストのデータを使用する前に、次のように置き換えます。

RESOURCE_TYPE: 連絡先を一覧表示するリソースタイプ。値 projects、folders、または organizations を使用します。
RESOURCE_ID: Google Cloud プロジェクト、組織、またはフォルダ ID。プロジェクト ID は英数字からなる文字列です（例: my-project）。フォルダ ID と組織 ID は数値です（例: 123456789012）。
CONTACT_ID: 連絡先の数値 ID。プロジェクト、フォルダ、組織内のすべての連絡先の ID を表示するには、連絡先を一覧表示してください。

リクエスト:

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

リクエストを送信するには、次のいずれかのオプションを展開します。

curl（Linux、macOS、Cloud Shell）

次のコマンドを実行します。

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）

次のコマンドを実行します。

$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

リクエストが成功すると、レスポンスの本文は空になります。

カテゴリ別の連絡先の管理

Cloud Console では、[エッセンシャルコンタクト] ページの [カテゴリ] タブに移動して、カテゴリ別に連絡先を管理することもできます。

単一のカテゴリに割り当てられた連絡先を追加、変更、削除するには、次の操作を行います。

Cloud Console で、[エッセンシャルコンタクト] ページに移動します。

[エッセンシャルコンタクト] ページに移動
プロジェクト、フォルダ、または組織の名前が、ページの上部にあるリソースセレクタに表示されていることを確認します。リソースセレクタは、現在どのプロジェクト、フォルダ、組織の連絡先を管理しているかを示します。
[表示] の横にある [カテゴリ] を選択します。
管理する連絡先のカテゴリと同じ行のをクリックします。
カテゴリに割り当てられた連絡先を管理します。
- 新しい連絡先を追加するには、[連絡先の追加] をクリックし、このページで説明される連絡先を追加するの手順に従います。
- 連絡先が割り当てられたカテゴリを変更するには、変更するカテゴリの連絡先の横にあるをクリックします。次に、[通知のカテゴリ] プルダウンメニューから目的の通知カテゴリを選択し、[保存] をクリックします。
  
  注: 連絡先のメールアドレスは変更できません。メールアドレスを変更するには、更新されたメールアドレスで新しい連絡先を追加して、古い連絡先を削除します。
- 連絡先を削除するには、その連絡先のメールアドレスの横にあるをクリックします。

メール送信の確認

各カテゴリの連絡先にテストメールを送信して、メールアカウントが Google Cloud からのメールを受信できるかどうかを確認できます。

特定のカテゴリの連絡先にテストメールを送信する方法は次のとおりです。

Cloud Console で、[エッセンシャルコンタクト] ページに移動します。

[エッセンシャルコンタクト] ページに移動
プロジェクト、フォルダ、または組織の名前が、ページの上部にあるリソースセレクタに表示されていることを確認します。リソースセレクタには、現在連絡先を管理しているプロジェクト、フォルダ、または組織が表示されます。
[表示] の横にある [カテゴリ] を選択します。
テストメールを配信する連絡先のカテゴリと同じ行のをクリックします。
メールを送信する連絡先の横にあるチェックボックスをオンにします。
[送信] をクリックします。選択した連絡先にテストメールが送信されます。

注: カテゴリごとおよびリソースごとに、各連絡先に 24 時間ごとに最大 1 つのテストメールを送信できます。
各連絡先と連絡を取り、gcp-essential-contacts-noreply@google.com からテストメールを受け取ったことを確認します。

Terraform を使用した連絡先の管理

Terraform を使用して、通知の連絡先を管理できます。連絡先は、Terraform 言語で次の形式になります。

resource "google_essential_contacts_contact" "contact" {
  provider = google-beta
  parent = "<var>RESOURCE_TYPE</var>/<var>RESOURCE_ID</var>"
  email = "<var>EMAIL</var>"
  language_tag = "<var>LANGUAGE</var>"
  notification_category_subscriptions = <var>NOTIFICATION_CATEGORIES</var>
}

連絡先を作成する際は、次の値を置き換えます。

RESOURCE_TYPE: 連絡先を一覧表示するリソースタイプ。値 projects、folders、または organizations を使用します。
RESOURCE_ID: Google Cloud プロジェクト、組織、またはフォルダ ID。プロジェクト ID は英数字からなる文字列です（例: my-project）。フォルダ ID と組織 ID は数値です（例: 123456789012）。
EMAIL: 連絡先のメールアドレス。連絡先を作成した後にこのフィールドを変更することはできません。
LANGUAGE: 省略可。連絡先の優先通知言語の言語コード。サポートされている言語の任意の言語コードを含めることができます。
NOTIFICATION_CATEGORIES: 通知を受け取る連絡先の通知カテゴリの配列。例: ["BILLING", "LEGAL"]

この配列には、ALL、BILLING、LEGAL、PRODUCT_UPDATES、SECURITY、SUSPENSION、TECHNICAL、TECHNICAL_INCIDENTS の値のいずれかを含めることができます。

各カテゴリの推奨される連絡先のリストについては、このページの連絡先を特定するをご覧ください。

連絡先を追加、変更、削除するには、Terraform 構成ファイルで連絡先リソースを追加、変更、削除します。

詳細については、Terraform のエッセンシャルコンタクトのドキュメントをご覧ください。

次のステップ

検証するためにドメインをプロジェクトに関連付ける方法について学習する。
通知設定の管理方法を確認する。

通知の連絡先の管理

始める前に

必要なロール

必要な権限

通知のカテゴリ

サポートされている言語

サポートされている言語

連絡先の割り当てに関するベスト プラクティス

サービスの停止と中断の通知の連絡先の割り当て

連絡先に許可されたドメインの制限

連絡先の一覧表示

Console

gcloud

リソースで定義された連絡先の一覧表示

連絡先と継承された連絡先の一覧表示

REST

リソースで定義された連絡先の一覧表示

curl（Linux、macOS、Cloud Shell）

PowerShell（Windows）

連絡先と継承された連絡先の一覧表示

curl（Linux、macOS、Cloud Shell）

PowerShell（Windows）

個々のエッセンシャル コンタクトの管理

連絡先の追加

Console

gcloud

REST

curl（Linux、macOS、Cloud Shell）

PowerShell（Windows）

連絡先の変更

Console

gcloud

REST

curl（Linux、macOS、Cloud Shell）

PowerShell（Windows）

連絡先の削除

Console

gcloud

REST

curl（Linux、macOS、Cloud Shell）

PowerShell（Windows）

カテゴリ別の連絡先の管理

メール送信の確認

Terraform を使用した連絡先の管理

次のステップ

連絡先の割り当てに関するベストプラクティス

個々のエッセンシャルコンタクトの管理