알림 연락처 관리

콘솔

1. Google Cloud 콘솔에서 필수 연락처 페이지로 이동합니다.

   필수 연락처 페이지로 이동

2. 프로젝트, 폴더 또는 조직의 이름이 페이지 상단의 리소스 선택기에 표시되는지 확인합니다. 리소스 선택기는 현재 연락처를 관리 중인 프로젝트, 폴더 또는 조직을 알려줍니다.

3. 카테고리별로 연락처를 나열하려면 카테고리를 선택합니다. 연락처를 알파벳 순으로 나열하려면 연락처를 선택합니다.

gcloud

1. In the Google Cloud console, activate Cloud Shell.

   Activate Cloud Shell

   At the bottom of the Google 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: Google Cloud 프로젝트, 조직, 폴더 ID입니다. 프로젝트 ID는 my-project 같은 영숫자 문자열입니다. 폴더 및 조직 ID는 123456789012와 같은 숫자입니다.

   또는 리소스 유형이나 ID를 지정하지 않으면 gcloud CLI가 현재 프로젝트의 연락처를 나열합니다.

   응답은 다음 예시와 유사합니다.

   ---
   email: [email protected]
   languageTag: en-US
   name: projects/my-projects/contacts/1
   notificationCategorySubscriptions:
   - ALL
   ---
   email: [email protected]
   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, notification-category-unspecified 값 중 하나가 포함될 수 있습니다. all 값을 선택하면 모든 카테고리에 대한 연락처가 나열됩니다.
   • RESOURCE_TYPE: 연락처를 계산할 리소스 유형입니다. project, folder, organization 값을 사용합니다.
   • RESOURCE_ID: Google Cloud 프로젝트, 조직, 폴더 ID입니다. 프로젝트 ID는 my-project 같은 영숫자 문자열입니다. 폴더 및 조직 ID는 123456789012와 같은 숫자입니다.

   리소스 유형 및 ID를 지정하지 않으면 gcloud CLI가 현재 프로젝트의 연락처를 나열합니다.

   응답에 모든 연락처 및 리소스에 대해 상속된 연락처가 나열됩니다.

   ---
   email: [email protected]
   languageTag: en-US
   name: projects/my-projects/contacts/1
   notificationCategorySubscriptions:
   - ALL
   ---
   email: [email protected]
   languageTag: en-US
   name: projects/my-projects/contacts/2
   notificationCategorySubscriptions:
   - BILLING
   ---
   email: [email protected]
   languageTag: en-US
   name: organizations/my-organization/contacts/1
   notificationCategorySubscriptions:
   - ALL
   ---
   

REST

Essential Contacts REST API를 사용하면 리소스에 정의된 연락처를 나열하거나 리소스의 모든 연락처 및 상속된 연락처를 나열할 수 있습니다.

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

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
  

$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
  

{
  "contacts": [
    {
      "name": "projects/my-projects/contacts/1",
      "email": "[email protected]",
      "notificationCategorySubscriptions": [
        "ALL"
      ],
      "languageTag": "en-US"
    },
    {
      "name": "projects/my-projects/contacts/2",
      "email": "[email protected]",
      "notificationCategorySubscriptions": [
        "BILLING"
      ],
      "languageTag": "en-US"
    }
  ]
}

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

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

$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": "[email protected]",
      "notificationCategorySubscriptions": [
        "ALL"
      ],
      "languageTag": "en-US"
    },
    {
      "name": "projects/my-projects/contacts/2",
      "email": "[email protected]",
      "notificationCategorySubscriptions": [
        "BILLING"
      ],
      "languageTag": "en-US"
    },
    {
      "name": "organizations/my-organization/contacts/1",
      "email": "[email protected]",
      "notificationCategorySubscriptions": [
        "ALL"
      ],
      "languageTag": "en-US"
    }
  ]
}

콘솔

1. Google Cloud 콘솔에서 필수 연락처 페이지로 이동합니다.

   필수 연락처 페이지로 이동

2. 프로젝트, 폴더 또는 조직의 이름이 페이지 상단의 리소스 선택기에 표시되는지 확인합니다. 리소스 선택기는 현재 연락처를 관리 중인 프로젝트, 폴더 또는 조직을 알려줍니다.

3. person_add 연락처 추가를 클릭합니다.

   

4. 이메일 및 이메일 확인 필드에 연락처의 이메일 주소를 입력합니다.

5. 알림 카테고리 드롭다운 메뉴에서 연락처에 알림을 제공하려는 알림 카테고리를 선택합니다. 알림 카테고리 및 권장 연락처 목록을 보려면 이 페이지에서 연락처 식별을 참조하세요.

6. 저장을 클릭합니다.

gcloud

1. In the Google Cloud console, activate Cloud Shell.

   Activate Cloud Shell

   At the bottom of the Google 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_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는 123456789012와 같은 숫자입니다.

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

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

REST

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

아래의 요청 데이터를 사용하기 전에 다음을 바꿉니다.

• RESOURCE_TYPE: 연락처를 만들려는 리소스 유형입니다. projects, folders, organizations 값을 사용합니다.
• RESOURCE_ID: Google Cloud 프로젝트, 조직, 폴더 ID입니다. 프로젝트 ID는 my-project 같은 영숫자 문자열입니다. 폴더 및 조직 ID는 123456789012와 같은 숫자입니다.
• EMAIL: 연락처의 이메일 주소입니다. 연락처를 만든 후에는 이 필드를 변경할 수 없습니다.

• NOTIFICATION_CATEGORY_1 및 NOTIFICATION_CATEGORY_2: 연락처에 알림을 제공하려는 알림 카테고리입니다. 이 값은 ALL, BILLING, LEGAL, PRODUCT_UPDATES, SECURITY, SUSPENSION, TECHNICAL 중 하나일 수 있습니다.

  각 카테고리의 권장 연락처 목록은 이 페이지에서 연락처 식별을 참조하세요.

• LANGUAGE: 연락처의 기본 알림 언어에 대한 언어 코드입니다. 모든 지원되는 언어에 대한 언어 코드를 포함할 수 있습니다.

요청:

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

요청 본문:

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

요청을 보내려면 다음 옵션 중 하나를 펼칩니다.

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
  

$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": "[email protected]",
  "notificationCategorySubscriptions": [
    "SUSPENSION",
    "TECHNICAL"
  ],
  "languageTag": "en"
}

콘솔

1. Google Cloud 콘솔에서 필수 연락처 페이지로 이동합니다.

   필수 연락처 페이지로 이동

2. 프로젝트, 폴더 또는 조직의 이름이 페이지 상단의 리소스 선택기에 표시되는지 확인합니다. 리소스 선택기는 현재 연락처를 관리 중인 프로젝트, 폴더 또는 조직을 알려줍니다.

3. 보기 기준 옆에서 연락처를 선택합니다.

   

4. 카테고리를 변경하려는 연락처 옆에서 edit를 클릭합니다.

   

5. 알림 카테고리 드롭다운 메뉴에서 원하는 알림 카테고리를 선택하고 저장을 클릭합니다.

gcloud

1. In the Google Cloud console, activate Cloud Shell.

   Activate Cloud Shell

   At the bottom of the Google 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_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는 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는 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 중 하나일 수 있습니다.

  각 카테고리의 권장 연락처 목록은 이 페이지에서 연락처 식별을 참조하세요.

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

$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": "[email protected]",
  "notificationCategorySubscriptions": [
    "ALL"
  ],
  "languageTag": "en"
}

콘솔

1. Google Cloud 콘솔에서 필수 연락처 페이지로 이동합니다.

   필수 연락처 페이지로 이동

2. 프로젝트, 폴더 또는 조직의 이름이 페이지 상단의 리소스 선택기에 표시되는지 확인합니다. 리소스 선택기는 현재 연락처를 관리 중인 프로젝트, 폴더 또는 조직을 알려줍니다.

3. 보기 기준 옆에서 연락처를 선택합니다.

   

4. 삭제하려는 연락처의 이메일 주소 옆에서 delete를 클릭합니다. 대화상자에서 연락처를 삭제할지 확인합니다.

   

gcloud

1. In the Google Cloud console, activate Cloud Shell.

   Activate Cloud Shell

   At the bottom of the Google 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: 연락처가 정의된 Google Cloud 프로젝트, 조직, 또는 폴더의 ID입니다. 프로젝트 ID는 my-project 같은 영숫자 문자열입니다. 폴더 및 조직 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는 123456789012와 같은 숫자입니다.
• CONTACT_ID: 연락처의 숫자 ID입니다. 프로젝트, 폴더, 조직에 있는 모든 연락처의 ID를 보려면 연락처 목록을 표시합니다.

요청:

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

요청을 보내려면 다음 옵션 중 하나를 펼칩니다.

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
  

$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
  

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