필수 연락처 관리

콘솔

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는 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는 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는 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는 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는 123456789012와 같은 숫자입니다.

   리소스 유형과 ID를 지정하지 않으면 gcloud CLI가 현재 프로젝트에 연락처를 만듭니다.

   명령어가 성공하면 응답이 수신되지 않습니다.

REST

새 연락처를 추가하려면 Essential Contacts API의 contacts.create 메서드를 사용합니다.

Request의 이메일 데이터를 읽습니다.

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

요청 본문:

{
  "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는 123456789012와 같은 숫자입니다.
• EMAIL: 연락처의 이메일 주소입니다. 연락처를 만든 후에는 이 필드를 변경할 수 없습니다.

• NOTIFICATION_CATEGORY_1 및 NOTIFICATION_CATEGORY_2: 연락처에 알림을 제공하려는 카테고리입니다. 이러한 값을 더 많이 포함하여 알림 카테고리를 추가할 수 있습니다. 목록은 다음 값 중 하나 이상을 사용할 수 있습니다.

  • 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는 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"

요청 본문:

{
  "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는 123456789012와 같은 숫자입니다.
• CONTACT_ID: 업데이트하려는 연락처의 숫자 ID입니다. 프로젝트, 폴더, 조직에 있는 모든 연락처의 ID를 보려면 연락처를 확인합니다. 숫자 ID는 연락처 이름에서 contacts 다음에 오는 전체 값입니다.
• UPDATE_MASK: 선택사항. 변경하려는 연락처 필드를 설명하는 마스크입니다. 마스크 형식은 쉼표로 구분된 정규화된 필드 이름 목록입니다(예: notificationCategorySubscriptions,languageTag).
• EMAIL: 연락처의 이메일 주소입니다. 이 필드는 요청에 포함하는 CONTACT_ID와 연결된 이메일 주소와 일치해야 합니다.

• NOTIFICATION_CATEGORY_1 및 NOTIFICATION_CATEGORY_2: 선택사항. 연락처에 알림을 제공하려는 업데이트된 카테고리입니다. 이러한 값을 더 많이 포함하여 알림 카테고리를 추가할 수 있습니다. 목록은 다음 값 중 하나 이상을 사용할 수 있습니다.

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

요청이 성공하면 응답 본문이 비어 있습니다.