重要な連絡先を管理

コンソール

1. Trusted Cloud コンソールで、[重要な連絡先] ページに移動します。

   [エッセンシャル コンタクト] ページに移動

2. プロジェクト、フォルダ、または組織の名前が、ページのリソース セレクタに表示されていることを確認します。リソース セレクタを使用すると、重要な連絡先を表示するプロジェクト、フォルダ、組織を選択できます。

3. [表示] の横で、次のいずれかのオプションを選択できます。

   • 連絡先をカテゴリ別に一覧表示するには、[カテゴリ] を選択します。
   • 連絡先をアルファベット順で一覧表示するには、[連絡先] を選択します。

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

   リソースに定義された連絡先を一覧表示する

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

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

   次のように置き換えます。

   • RESOURCE_TYPE: 連絡先を一覧表示するリソースタイプ。値 project、folder、または organization を使用します。
   • RESOURCE_ID: Trusted 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_CATEGORY: 連絡先を表示する通知カテゴリのカンマ区切りリスト。リストには次のいずれかの値を含めることができます。

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

     詳細については、通知カテゴリをご覧ください。

   • RESOURCE_TYPE: 連絡先を表示するリソースタイプ。値 project、folder、または organization を使用します。

   • RESOURCE_ID: Trusted 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 メソッドを使用します。

Request からのメールのデータを読み取ります。

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

次のように置き換えます。

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

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

curl（Linux、macOS、Cloud Shell）

GOOGLE_APPLICATION_CREDENTIALS 環境変数をサービス アカウントの秘密鍵パスに設定します。次に、リクエストを行います。

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）

GOOGLE_APPLICATION_CREDENTIALS 環境変数をサービス アカウントの秘密鍵パスに設定します。次に、リクエストを行います。

$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 メソッドを使用します。

Request からのメールのデータを読み取ります。

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

次のように置き換えます。

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

• NOTIFICATION_CATEGORY: 連絡先を表示する通知カテゴリ。このフィールドを繰り返し使用することで、複数の通知カテゴリの連絡先を一覧表示できます。次のいずれかの値が設定されます。

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

  詳細については、通知カテゴリをご覧ください。

• PAGE_SIZE: 省略可。レスポンスに含める連絡先の数。デフォルト値は 50、最大値は 100 です。連絡先の数がページサイズより大きい場合、レスポンスにページ設定トークンが含まれます。このトークンを使用して、結果の次のページを取得できます。

• NEXT_PAGE_TOKEN: 省略可。以前のレスポンスでこのメソッドから返されたページ設定トークン。指定すると、前のレスポンスが終了した時点から連絡先のリストが開始されます。

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

curl（Linux、macOS、Cloud Shell）

GOOGLE_APPLICATION_CREDENTIALS 環境変数をサービス アカウントの秘密鍵パスに設定します。次に、リクエストを行います。

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）

GOOGLE_APPLICATION_CREDENTIALS 環境変数をサービス アカウントの秘密鍵パスに設定します。次に、リクエストを行います。

$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

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

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

コンソール

1. Trusted Cloud コンソールで、[重要な連絡先] ページに移動します。

   [エッセンシャル コンタクト] ページに移動

2. プロジェクト、フォルダ、または組織の名前が、ページのリソース セレクタに表示されていることを確認します。リソース セレクタを使用すると、重要な連絡先を追加するプロジェクト、フォルダ、組織を選択できます。

3. person_add [連絡先に追加] をクリックします。

   

4. [メール] フィールドと [メールの確認] フィールドに、追加する連絡先のメールアドレスを入力します。

5. [通知のカテゴリ] プルダウン メニューから、通知を受け取る連絡先のカテゴリを選択します。

   通知カテゴリと推奨される連絡先のリストについては、通知カテゴリをご覧ください。

6. [保存] をクリックします。

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. gcloud essential-contacts create コマンドを使用して新しい連絡先を追加します。

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

   次のように置き換えます。

   • EMAIL: 追加する連絡先のメールアドレス。連絡先を作成した後にこのフィールドを変更することはできません。
   • NOTIFICATION_CATEGORY: 連絡先が通知を受け取るカテゴリのカンマ区切りのリスト。リストには、次のいずれかの値を含めることができます。
     • billing
     • legal
     • product-updates
     • security
     • suspension
     • technical
     • all
     • notification-category-unspecified
     通知カテゴリと推奨される連絡先のリストについては、通知カテゴリをご覧ください。
   • LANGUAGE: 連絡先の優先通知言語の言語コード。サポートされている言語の任意の言語コードを含めることができます。
   • RESOURCE_TYPE: 連絡先を作成するリソースタイプ。値 project、folder、または organization を使用します。
   • RESOURCE_ID: Trusted Cloud プロジェクト、組織、またはフォルダ ID。プロジェクト ID は英数字からなる文字列です（例: my-project）。フォルダ ID と組織 ID は数値です（例: 123456789012）。

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

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

REST

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

Request からのメールのデータを読み取ります。

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

Request body:

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

次のように置き換えます。

• RESOURCE_TYPE: 連絡先を作成するリソースタイプ。値 projects、folders、または organizations を使用します。
• RESOURCE_ID: Trusted Cloud プロジェクト、組織、またはフォルダ ID。プロジェクト ID は英数字からなる文字列です（例: my-project）。フォルダ ID と組織 ID は数値です（例: 123456789012）。
• EMAIL: 連絡先のメールアドレス。連絡先を作成した後にこのフィールドを変更することはできません。

• NOTIFICATION_CATEGORY_1 と NOTIFICATION_CATEGORY_2: 通知を受け取る連絡先のカテゴリ。これらの値をさらに含めることで、通知カテゴリを追加できます。リストには、次の値の 1 つ以上を指定できます。

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

  通知カテゴリと推奨される連絡先のリストについては、通知カテゴリをご覧ください。

• LANGUAGE: 連絡先の優先通知言語の言語コード。サポートされている言語の任意の言語コードを含めることができます。

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

curl（Linux、macOS、Cloud Shell）

GOOGLE_APPLICATION_CREDENTIALS 環境変数をサービス アカウントの秘密鍵パスに設定します。次に、リクエスト本文を request.json という名前の 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）

GOOGLE_APPLICATION_CREDENTIALS 環境変数をサービス アカウントの秘密鍵パスに設定します。次に、リクエスト本文を request.json という名前の 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"
}

コンソール

1. Trusted Cloud コンソールで、[重要な連絡先] ページに移動します。

   [エッセンシャル コンタクト] ページに移動

2. プロジェクト、フォルダ、または組織の名前が、ページのリソース セレクタに表示されていることを確認します。リソース セレクタを使用すると、重要な連絡先を管理するプロジェクト、フォルダ、組織を選択できます。

3. [表示] の横にある [連絡先] を選択します。

   

4. 通知カテゴリを変更する連絡先の横にある 編集 edit をクリックします。

   

5. [通知のカテゴリ] プルダウン メニューで、変更する通知カテゴリを選択し、[保存] をクリックします。

Trusted Cloud コンソールから連絡先を管理すると、 Trusted Cloud コンソールは連絡先作成者の優先言語設定に基づいて連絡先の設定言語を自動的に構成します。詳細については、サポートされている言語をご覧ください。

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. gcloud essential-contacts update コマンドを使用して、既存の連絡先を更新します。

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

   次のように置き換えます。

   • CONTACT_ID: 更新する連絡先の数値 ID。プロジェクト、フォルダ、組織内のすべての連絡先の ID を表示するには、連絡先を表示します。数値 ID は、連絡先の名前の contacts より後の値全体です。
   • NOTIFICATION_CATEGORY: 連絡先が通知を受け取る新しいカテゴリのカンマ区切りのリスト。このリストは、通知カテゴリの既存のリストに代わるものです。

     リストには次のいずれかの値を含めることができます。

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

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

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

REST

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

Request からのメールのデータを読み取ります。

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

Request body:

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

次のように置き換えます。

• RESOURCE_TYPE: 連絡先情報を変更するリソースタイプ。値 projects、folders、または organizations を使用します。
• RESOURCE_ID: Trusted 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: 省略可。連絡先に受け取りを希望する更新カテゴリ。これらの値をさらに含めることで、通知カテゴリをさらに追加できます。リストには、次の値の 1 つ以上を指定できます。

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

  通知カテゴリと推奨される連絡先のリストについては、通知カテゴリをご覧ください。

• LANGUAGE: 連絡先の優先通知言語の言語コード。サポートされている言語の任意の言語コードを含めることができます。

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

curl（Linux、macOS、Cloud Shell）

GOOGLE_APPLICATION_CREDENTIALS 環境変数をサービス アカウントの秘密鍵パスに設定します。次に、リクエスト本文を request.json という名前の 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）

GOOGLE_APPLICATION_CREDENTIALS 環境変数をサービス アカウントの秘密鍵パスに設定します。次に、リクエスト本文を request.json という名前の 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"
}

コンソール

1. Trusted Cloud コンソールで、[重要な連絡先] ページに移動します。

   [エッセンシャル コンタクト] ページに移動

2. プロジェクト、フォルダ、または組織の名前が、ページのリソース セレクタに表示されていることを確認します。リソース セレクタを使用すると、重要な連絡先を削除するプロジェクト、フォルダ、組織を選択できます。

3. [表示] の横にある [連絡先] を選択します。

   

4. 削除する連絡先のメールアドレスの横にある [削除] delete をクリックします。ダイアログで、連絡先の削除を確定します。

   

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. 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: 連絡先が定義されている Trusted Cloudプロジェクト、組織、またはフォルダの ID。プロジェクト ID は英数字からなる文字列です（例: my-project）。フォルダ ID と組織 ID は数値です（例: 123456789012）。

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

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

REST

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

Request からのメールのデータを読み取ります。

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

次のように置き換えます。

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

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

curl（Linux、macOS、Cloud Shell）

GOOGLE_APPLICATION_CREDENTIALS 環境変数をサービス アカウントの秘密鍵パスに設定します。次に、リクエストを行います。

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）

GOOGLE_APPLICATION_CREDENTIALS 環境変数をサービス アカウントの秘密鍵パスに設定します。次に、リクエストを行います。

$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
  

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