Mengelola kontak untuk notifikasi

Banyak layanan Google Cloud, seperti Penagihan Cloud, mengirim notifikasi untuk membagikan informasi penting kepada pengguna Google Cloud. Secara default, notifikasi ini dikirim kepada anggota yang memiliki peran Identity and Access Management (IAM) tertentu. Dengan Kontak Penting, Anda dapat menyesuaikan siapa yang akan menerima notifikasi dengan memberikan daftar kontak Anda sendiri.

Penting: Tidak semua layanan Google Cloud menggunakan Kontak Penting untuk mengirim notifikasi. Oleh karena itu, beberapa notifikasi Google Cloud mungkin tidak terkirim ke kontak kustom yang Anda konfigurasi.

Sebelum memulai

Aktifkan Essential Contacts API.

Mengaktifkan API

Catatan: Jika hanya ingin mengelola kontak melalui Konsol Google Cloud, Anda tidak perlu mengaktifkan API.

Peran yang diperlukan

Untuk mendapatkan izin yang diperlukan untuk mengelola kontak, minta administrator untuk memberi Anda peran IAM berikut pada project, folder, atau organisasi tempat kontak ditetapkan:

• Untuk melihat kontak: Viewer Essential Contacts (roles/essentialcontacts.viewer)
• Untuk melihat, mengedit, menghapus, dan membuat kontak: Admin Kontak Penting (roles/essentialcontacts.admin)

Untuk mengetahui informasi selengkapnya tentang pemberian peran, lihat Mengelola akses.

Peran yang telah ditetapkan ini berisi izin yang diperlukan untuk mengelola kontak. Untuk melihat izin yang benar-benar diperlukan, perluas bagian Izin yang diperlukan:

Izin yang diperlukan

Izin berikut diperlukan untuk mengelola kontak:

• Untuk melihat kontak:
  • essentialcontacts.contacts.get
  • essentialcontacts.contacts.list
• Untuk mengedit, menghapus, dan membuat kontak:
  • essentialcontacts.contacts.create
  • essentialcontacts.contacts.delete
  • essentialcontcts.contacts.update

Anda mung juga bisa mendapatkan izin ini dengan peran khusus atau peran bawaanlainnya.

Kategori notifikasi

Anda dapat menetapkan kontak ke beberapa kategori notifikasi. Jika Anda tidak menambahkan kontak ke suatu kategori, notifikasi dalam kategori tersebut akan dikirim ke kontak penggantian, yang dipilih berdasarkan peran IAM anggota Anda. Sebaiknya tambahkan kontak kustom, dan jangan mengandalkan kontak penggantian, untuk membantu memastikan bahwa orang yang tepat menerima notifikasi untuk project, folder, atau organisasi Anda.

Anda dapat menambahkan individu dan grup sebagai kontak. Untuk mengurangi dampak perubahan personel, sebaiknya tambahkan grup sebagai kontak, lalu kelola keanggotaan grup tersebut untuk menentukan siapa yang akan menerima notifikasi. Praktik ini membantu memastikan bahwa notifikasi selalu ditujukan kepada karyawan aktif.

Catatan: Untuk menerima notifikasi, kontak harus dapat menerima email dari Google.

Tinjau tabel berikut untuk mempelajari kategori notifikasi, kontak penggantian, dan kontak yang direkomendasikan. Jika Anda tidak menetapkan kontak ke kategori tertentu, notifikasi akan dikirim ke kontak penggantian.

Kategori	Deskripsi	Contoh	Kontak penggantian	Kontak yang direkomendasikan
Semua	Semua notifikasi dari setiap kategori lainnya	T/A	T/A	Orang atau sistem otomatis yang bertanggung jawab untuk merutekan atau mencatat sejumlah besar notifikasi yang berpotensi
Penagihan	Notifikasi penagihan dan pembayaran	Pembaruan harga, error, dan kredit	Administrator Akun Penagihan (roles/billing.admin)	Staf departemen keuangan dan orang-orang yang mengelola hubungan keuangan Anda dengan Google, termasuk orang yang mengelola anggaran, perencanaan, dan akun yang terkait dengan penggunaan Google Cloud
Legal	Notifikasi kepatuhan hukum	Tindakan penegakan, kepatuhan terhadap peraturan, dan pemberitahuan dari pemerintah	Administrator Akun Penagihan (roles/billing.admin)	Penasihat hukum, manajer kepatuhan, pakar hubungan pemerintah, dan profesional terkait lainnya
Update produk	Perubahan pada produk Google	Versi baru, pembaruan persyaratan produk, penghentian layanan	Pemilik Project (roles/owner)	Product manager, arsitek, dan engineer yang dapat memanfaatkan informasi yang tepat waktu tentang perubahan pada produk dan layanan Google
Keamanan	Notifikasi masalah keamanan/privasi	Kerentanan, insiden data, dan serangan	Administrator Organisasi (roles/resourcemanager.organizationAdmin)	Keamanan IT, keamanan operasi, dan orang lain yang tugasnya mengamankan data perusahaan dan pelanggan Anda serta memastikan kelangsungan bisnis
Penangguhan	Notifikasi yang berkaitan dengan penangguhan akun langsung dan project	Kepatuhan terhadap evaluasi Apigee, pelanggaran hak cipta, dan penambangan koin	Pemilik Project (roles/owner)	Orang yang langsung bertanggung jawab untuk menjaga infrastruktur IT dan aplikasi bisnis Anda tetap aktif dan berjalan
Teknis	Peristiwa teknis dan masalah operasional lainnya	Mencatat error konfigurasi, update pencegahan kebocoran data, dan status Actions on Google	Pemilik Project (roles/owner)	Profesional IT, engineer keandalan, admin, on-call list, dan orang lain yang perlu mengetahui peristiwa serta masalah teknis saat ini dan yang akan datang agar dapat mengelola aset IT Anda dengan lebih baik serta menghindari gangguan
Insiden Teknis	Untuk pelanggan Dukungan Premium, subkategori dari kategori Teknis untuk notifikasi pemadaman layanan	Pemadaman layanan yang tidak direncanakan, masalah layanan	T/A	Profesional IT, engineer keandalan, admin, on-call list, dan orang lain yang perlu bereaksi terhadap pemadaman layanan

Bahasa yang didukung

Di Kontak Penting, setiap kontak memiliki setelan bahasa pilihan. Pembuat notifikasi dapat merujuk setelan ini saat mengirim notifikasi.

Saat Anda menambahkan kontak di Konsol Google Cloud, konsol Google Cloud akan otomatis mengonfigurasi bahasa pilihan kontak berdasarkan setelan bahasa pilihan kontak kreator. Saat menambahkan kontak menggunakan API, Anda akan mengonfigurasi bahasa pilihan kontak secara manual menggunakan kode bahasa. Kode bahasa ini dapat merujuk ke bahasa apa pun yang didukung oleh Kontak Penting.

Bahasa yang didukung

Pemodelan bahasa	Kode bahasa
Afrika	af
Albania	sq
Amhara	am
Arab	ar
Arab (Mesir)	ar-EG
Armenia	hy
Azerbaijani	az
Basque	eu
Belarusia	be
Bengali	bn
Bosnia	bs
Bulgaria	bg
Burma	my
Catalan	ca
China	zh
China (Hong Kong)	zh-HK
China (Taiwan)	zh-TW
Kroasia	jam
Ceko	cs
Denmark	da
Belanda	nl
Inggris	en
Inggris (Australia)	en-AU
Inggris (Britania)	en-GB
Inggris (AS)	en-US
Estonia	et
Filipina	fil
Suomi	fi
French	fr
Bahasa Prancis (Kanada)	fr-CA
Galisia	gl
German	de
Gerogia	ka
Yunani	el
Gujarati	gu
Ibrani	iw
Hindi	hai
Hungaria	hu
Islan	is
Indonesian	id
Irlandia	ga
Italian	it
Japanese	ja
Jawa	jv
Kannada	kn
Kazak	kk
Khmer	km
Korean	ko
Kyrgyz	ky
Laos	lo
Latvia	lv
Lituania	lt
Makedonia	mk
Melayu	md
Malayalam	ml
Marathi	mr
Mongolia	mn
Nepal	ne
Norwegia	tidak ada
Pashto	ps
Persia	fa
Polski	pl
Portugis	pt
Portugis (Brasil)	pt-BR
Portugis (Portugal)	pt-PT
Punjabi	pa
Rumania	ro
Russian	ru
Serbia	sr
Sindhi	sd
Sinhala	si
Slovakia	sk
Slovenia	sl
Somali	so
Spanish	es
Spanyol (Amerika Latin)	es-419
Swahili	sw
Swensk	sv
Tamil	ta
Telugu	te
Thai	th
Turki	tr
Turkmen	tk
Ukraina	uk
Urdu	ur
Uzbekistan	uz
Vietnam	vi
Wales	cy
Zulu	zu

Praktik terbaik untuk menetapkan kontak

Anda dapat menetapkan kontak di tingkat project, folder, atau organisasi.

Kontak diwarisi melalui hierarki resource Google Cloud. Akibatnya, jika Anda menambahkan kontak di tingkat organisasi, mereka akan menerima notifikasi untuk organisasi serta semua folder dan project di organisasi. Demikian pula, jika Anda menambahkan kontak di level folder, kontak tersebut akan menerima notifikasi untuk folder dan semua folder serta project dalam folder tersebut.

Catatan: Anda hanya dapat melihat kontak yang diwarisi dari ancestor resource jika dapat melihat kontak untuk ancestor tersebut. Untuk mendapatkan kemampuan ini, Anda memerlukan peran pada ancestor yang menyertakan izin yang diperlukan, seperti peran Essential Contacts Viewer (roles/essentialcontacts.viewer).

Tempat Anda memutuskan untuk menetapkan kontak bergantung pada struktur organisasi. Namun, kami biasanya menyarankan Anda untuk menetapkan kontak pada tingkat berikut, berdasarkan kategori notifikasinya:

Level yang direkomendasikan	Kategori notifikasi
Tingkat organisasi	Penagihan Legal Keamanan^1
Tingkat folder/project	Semua Update produk Keamanan^1 Penangguhan Teknis^2

¹ Tingkat yang digunakan untuk menetapkan kontak keamanan bergantung pada praktik keamanan spesifik organisasi Anda. Misalnya, jika setiap pemilik project bertanggung jawab atas keamanan project mereka sendiri, Anda harus menetapkan kontak keamanan Anda di level project. Namun, jika grup di seluruh organisasi mengelola keamanan untuk semua project, Anda harus menetapkan kontak keamanan di tingkat organisasi.

² Kontak kategori teknis menerima notifikasi email dalam jumlah besar. Tetapkan kontak ini pada level folder atau project agar dapat memproses alur notifikasi yang masuk.

Menetapkan kontak untuk notifikasi gangguan dan pemadaman

Pratinjau

Produk atau fitur ini tunduk pada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum di Persyaratan Khusus Layanan. Produk dan fitur pra-GA tersedia "sebagaimana adanya" dan mungkin memiliki dukungan terbatas. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

Jika Anda adalah pelanggan Dukungan Premium, Anda dapat menetapkan kontak untuk menerima notifikasi pemadaman dan gangguan melalui subkategori Insiden Teknis. Hal ini memungkinkan Anda mengarahkan notifikasi pemadaman layanan berdampak tinggi kepada kontak yang perlu berfokus pada pemadaman, tanpa terganggu oleh notifikasi teknis lainnya.

Untuk memastikan notifikasi dikirim ke kontak yang tepat, perhatikan perilaku pewarisan berikut saat Anda menetapkan kontak ke subkategori Insiden Teknis:

• Jika Anda menetapkan kontak Insiden Teknis di project atau folder, notifikasi pemadaman hanya akan dikirim ke:

  • Project atau folder kontak Technical Incidents
  • Kontak Technical Incidents turunan dari organisasi atau folder induk

• Jika Anda tidak menetapkan kontak Insiden Teknis di project atau folder, notifikasi pemadaman hanya akan dikirim ke:

  • Kontak Teknis project atau folder
  • Kontak Technical Incidents turunan dari organisasi atau folder induk

• Jika kontak Insiden Teknis tidak ditetapkan atau diwariskan, dan tidak ada kontak Teknis yang ditetapkan, notifikasi pemadaman layanan tidak akan dikirim

Membatasi domain yang diizinkan untuk kontak

Untuk membatasi domain alamat email yang dapat dimiliki kontak baru, tetapkan batasan kebijakan organisasi constraints/essentialcontacts.allowedContactDomains. Kontak yang ada tidak akan terpengaruh oleh batasan ini.

Untuk mempelajari cara menetapkan batasan kebijakan organisasi, lihat Batasan kebijakan organisasi.

Mencantumkan kontak

Untuk menampilkan daftar semua kontak di project, folder, atau organisasi Anda, lakukan langkah berikut:

Konsol

1. Di konsol Google Cloud, buka halaman Kontak penting.

   Buka halaman Kontak penting

2. Pastikan nama project, folder, atau organisasi Anda muncul di pemilih resource di bagian atas halaman. Pemilih resource memberi tahu Anda project, folder, atau organisasi yang saat ini Anda kelola kontaknya.

3. Untuk mencantumkan kontak menurut kategori, pilih Kategori. Untuk menampilkan daftar kontak menurut abjad, pilih Contacts.

   Catatan: Jika melihat kontak untuk resource turunan (folder atau project) yang mewarisi kontak dari ancestornya (organisasi atau folder lainnya), Anda akan melihat kontak yang diwarisi untuk ancestor yang memiliki izin untuk melihat kontak yang Anda miliki.
   Catatan: Saat melihat kontak untuk organisasi atau folder, Anda tidak akan melihat kontak untuk resource turunannya.

gcloud

1. Di konsol Google Cloud, aktifkan Cloud Shell.

   Aktifkan Cloud Shell

   Di bagian bawah Google Cloud Console, Cloud Shell sesi akan terbuka dan menampilkan perintah command line. Cloud Shell adalah lingkungan shell dengan Google Cloud CLI yang sudah terinstal, dan dengan nilai yang sudah ditetapkan untuk project Anda saat ini. Diperlukan waktu beberapa detik untuk melakukan inisialisasi sesi.

2. Dengan Google Cloud CLI, Anda dapat mencantumkan kontak yang ditentukan pada resource, atau mencantumkan semua kontak dan kontak yang diwarisi untuk resource.

   Mencantumkan kontak yang ditentukan pada resource

   Untuk melihat kontak yang telah ditetapkan di project, folder, atau organisasi tertentu, gunakan perintah gcloud essential-contacts list:

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

   Ganti nilai berikut:

   • RESOURCE_TYPE: Jenis resource yang ingin Anda cantumkan kontaknya. Gunakan nilai project, folder, atau organization.
   • RESOURCE_ID: Project, organisasi, atau ID folder Google Cloud Anda. ID project berupa string alfanumerik, seperti my-project. Folder dan ID organisasi berupa numerik, seperti 123456789012.

   Atau, jika Anda tidak menentukan jenis atau ID resource, gcloud CLI akan mencantumkan kontak untuk project saat ini.

   Responsnya mirip dengan hal berikut ini:

   ---
   email: [e-mail]
   languageTag: en-US
   name: projects/my-projects/contacts/1
   notificationCategorySubscriptions:
   - ALL
   ---
   email: [e-mail]
   languageTag: en-US
   name: projects/my-projects/contacts/2
   notificationCategorySubscriptions:
   - BILLING
   ---
   

   Mencantumkan kontak dan kontak yang diwarisi

   Resource turunan (folder dan project) mewarisi kontak dari ancestornya (organisasi dan folder lainnya). Jika Anda ingin mencantumkan semua kontak dan kontak turunan untuk suatu resource, gunakan perintah gcloud essential-contacts compute:

   Catatan: Anda hanya dapat melihat kontak yang diwarisi dari ancestor resource jika dapat melihat kontak untuk ancestor tersebut. Untuk mendapatkan kemampuan ini, Anda memerlukan peran pada ancestor yang menyertakan izin yang diperlukan, seperti peran Essential Contacts Viewer (roles/essentialcontacts.viewer).

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

   Ganti nilai berikut:

   Sebelum menggunakan salah satu data permintaan di bawah, lakukan penggantian berikut:

   • NOTIFICATION_CATEGORIES: Daftar yang dipisahkan koma dari kategori notifikasi yang kontaknya ingin Anda hitung. Daftar ini dapat berisi salah satu nilai berikut: all, billing, legal, product-updates, security, suspension, technical, technical-incidents , dan notification-category-unspecified. Memilih nilai all akan mencantumkan kontak untuk semua kategori.
   • RESOURCE_TYPE: Jenis resource yang ingin Anda hitung kontaknya. Gunakan nilai project, folder, atau organization.
   • RESOURCE_ID: Project, organisasi, atau ID folder Google Cloud Anda. ID project berupa string alfanumerik, seperti my-project. Folder dan ID organisasi berupa numerik, seperti 123456789012.

   Jika Anda tidak menentukan jenis dan ID resource, gcloud CLI akan mencantumkan kontak untuk project saat ini.

   Responsnya mencantumkan semua kontak dan kontak yang diwariskan untuk resource:

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

REST

Dengan Essential Contacts REST API, Anda dapat mencantumkan kontak yang ditentukan pada resource, atau mencantumkan semua kontak dan kontak yang diwarisi untuk resource.

Mencantumkan kontak yang ditentukan pada resource

Untuk melihat kontak yang telah ditentukan di project, folder, atau organisasi tertentu, gunakan metode contacts.list Essential Contacts API.

Sebelum menggunakan salah satu data permintaan di bawah, lakukan penggantian berikut:

• RESOURCE_TYPE: Jenis resource yang ingin Anda cantumkan kontaknya. Gunakan nilai projects, folders, atau organizations.
• RESOURCE_ID: Project, organisasi, atau ID folder Google Cloud Anda. ID project berupa string alfanumerik, seperti my-project. Folder dan ID organisasi berupa numerik, seperti 123456789012.
• PAGE_SIZE: Opsional. Jumlah kontak yang disertakan dalam respons. Nilai default adalah 50, dan nilai maksimum adalah 100. Jika jumlah kontak lebih besar dari ukuran halaman, respons akan berisi token penomoran halaman yang dapat Anda gunakan untuk mengambil halaman hasil berikutnya.
• NEXT_PAGE_TOKEN: Opsional. Token penomoran halaman ditampilkan dalam respons sebelumnya dari metode ini. Jika ditentukan, daftar kontak akan dimulai dari akhir respons sebelumnya.

Permintaan:

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

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

curl (Linux, macOS, atau Cloud Shell)

Catatan: Pastikan Anda telah menetapkan variabel lingkungan GOOGLE_APPLICATION_CREDENTIALS ke jalur kunci pribadi akun layanan.

Jalankan perintah berikut:

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)

Catatan: Pastikan Anda telah menetapkan variabel lingkungan GOOGLE_APPLICATION_CREDENTIALS ke jalur kunci pribadi akun layanan.

Jalankan perintah berikut:

$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
  

Setelah mengirim permintaan, Anda akan menerima respons JSON yang mirip dengan yang berikut ini:

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

Mencantumkan kontak dan kontak yang diwarisi

Resource turunan (folder dan project) mewarisi kontak dari ancestornya (organisasi dan folder lainnya). Jika Anda ingin mencantumkan semua kontak dan kontak yang diwarisi untuk suatu resource, gunakan metode contacts.compute Essential Contacts API.

Catatan: Anda hanya dapat melihat kontak yang diwarisi dari ancestor resource jika dapat melihat kontak untuk ancestor tersebut. Untuk mendapatkan kemampuan ini, Anda memerlukan peran pada ancestor yang menyertakan izin yang diperlukan, seperti peran Essential Contacts Viewer (roles/essentialcontacts.viewer).

Sebelum menggunakan salah satu data permintaan di bawah, lakukan penggantian berikut:

• RESOURCE_TYPE: Jenis resource yang ingin Anda hitung kontaknya. Gunakan nilai projects, folders, atau organizations.
• RESOURCE_ID: Project, organisasi, atau ID folder Google Cloud Anda. ID project berupa string alfanumerik, seperti my-project. Folder dan ID organisasi berupa numerik, seperti 123456789012.
• NOTIFICATION_CATEGORY: Kategori notifikasi yang ingin Anda hitung kontaknya. Anda dapat mengulangi kolom ini guna mencantumkan kontak untuk beberapa kategori notifikasi. NOTIFICATION_CATEGORY dapat berupa salah satu nilai berikut: ALL, BILLING, LEGAL, PRODUCT_UPDATES, SECURITY, SUSPENSION, TECHNICAL, TECHNICAL_INCIDENTS, dan NOTIFICATION_CATEGORY_UNSPECIFIED. Memilih nilai ALL akan mencantumkan kontak untuk semua kategori.
• PAGE_SIZE: Opsional. Jumlah kontak yang disertakan dalam respons. Nilai default adalah 50, dan nilai maksimum adalah 100. Jika jumlah kontak lebih besar dari ukuran halaman, respons akan berisi token penomoran halaman yang dapat Anda gunakan untuk mengambil halaman hasil berikutnya.
• NEXT_PAGE_TOKEN: Opsional. Token penomoran halaman ditampilkan dalam respons sebelumnya dari metode ini. Jika ditentukan, daftar kontak akan dimulai dari akhir respons sebelumnya.

Permintaan:

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

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

curl (Linux, macOS, atau Cloud Shell)

Catatan: Pastikan Anda telah menetapkan variabel lingkungan GOOGLE_APPLICATION_CREDENTIALS ke jalur kunci pribadi akun layanan.

Jalankan perintah berikut:

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)

Catatan: Pastikan Anda telah menetapkan variabel lingkungan GOOGLE_APPLICATION_CREDENTIALS ke jalur kunci pribadi akun layanan.

Jalankan perintah berikut:

$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

Responsnya mencantumkan semua kontak dan kontak yang diwariskan untuk resource:

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

Mengelola setiap kontak penting

Anda dapat menambahkan kontak, menghapusnya, atau menetapkan kategori notifikasi untuk kontak tersebut di halaman Kontak penting di Konsol Google Cloud, atau dengan menggunakan REST API.

Catatan: Untuk menerima notifikasi, kontak harus dapat menerima email dari Google.

Menambahkan kontak

Untuk menambahkan kontak, ikuti langkah-langkah berikut:

Konsol

1. Di konsol Google Cloud, buka halaman Kontak penting.

   Buka halaman Kontak penting

2. Pastikan nama project, folder, atau organisasi Anda muncul di pemilih resource di bagian atas halaman. Pemilih resource memberi tahu Anda project, folder, atau organisasi yang saat ini Anda kelola kontaknya.

3. Klik Tambahkan kontak.

   

4. Di kolom Email dan Confirm email, masukkan alamat email kontak tersebut.

5. Dari menu drop-down Notification category, pilih kategori notifikasi yang Anda inginkan untuk menerima komunikasi dari kontak. Untuk daftar kategori notifikasi dan kontak yang direkomendasikan, lihat Mengidentifikasi kontak di halaman ini.

6. Klik Simpan.

gcloud

1. Di konsol Google Cloud, aktifkan Cloud Shell.

   Aktifkan Cloud Shell

   Di bagian bawah Google Cloud Console, Cloud Shell sesi akan terbuka dan menampilkan perintah command line. Cloud Shell adalah lingkungan shell dengan Google Cloud CLI yang sudah terinstal, dan dengan nilai yang sudah ditetapkan untuk project Anda saat ini. Diperlukan waktu beberapa detik untuk melakukan inisialisasi sesi.

2. Untuk menambahkan kontak baru, gunakan perintah gcloud Essentials-contacts create:

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

   Ganti nilai berikut:

   • EMAIL: Alamat email kontak Anda. Anda tidak dapat mengubah kolom ini setelah membuat kontak.
   • NOTIFICATION_CATEGORIES: Daftar yang dipisahkan koma dari kategori notifikasi yang pesannya ingin diterima oleh kontak. Daftar ini dapat berisi salah satu nilai berikut: all, billing, legal, product-updates, security, suspension, technical, insiden teknis , dan notification-category-unspecified. Memilih nilai all akan mencantumkan kontak untuk semua kategori.

     Untuk daftar kontak yang direkomendasikan untuk setiap kategori, lihat Mengidentifikasi kontak di halaman ini.

   • LANGUAGE: Kode bahasa untuk bahasa notifikasi pilihan kontak Anda. Anda dapat menyertakan kode bahasa dari bahasa yang didukung.
   • RESOURCE_TYPE: Jenis resource yang ingin Anda buatkan kontak. Gunakan nilai project, folder, atau organization.
   • RESOURCE_ID: Project, organisasi, atau ID folder Google Cloud Anda. Project ID adalah string alfanumerik, seperti my-project. Folder dan ID organisasi berupa numerik, seperti 123456789012.

   Jika Anda tidak menentukan jenis dan ID resource, gcloud CLI akan membuat kontak di project saat ini.

   Jika perintah berhasil, tidak ada respons yang ditampilkan.

REST

Untuk menambahkan kontak baru, gunakan metode contacts.create Essential Contacts API.

Sebelum menggunakan salah satu data permintaan di bawah, lakukan penggantian berikut:

• RESOURCE_TYPE: Jenis resource yang ingin Anda buat kontaknya. Gunakan nilai projects, folders, atau organizations.
• RESOURCE_ID: Project, organisasi, atau ID folder Google Cloud Anda. ID project berupa string alfanumerik, seperti my-project. Folder dan ID organisasi berupa numerik, seperti 123456789012.
• EMAIL: Alamat email kontak Anda. Anda tidak dapat mengubah kolom ini setelah membuat kontak.

• NOTIFICATION_CATEGORY_1 dan NOTIFICATION_CATEGORY_2: Kategori notifikasi yang Anda inginkan untuk menerima komunikasi dari kontak. Nilai ini dapat berupa salah satu dari hal berikut: ALL, BILLING, LEGAL, PRODUCT_UPDATES, SECURITY, SUSPENSION, TECHNICAL, TECHNICAL_INCIDENTS.

  Untuk daftar kontak yang direkomendasikan untuk setiap kategori, lihat Mengidentifikasi kontak di halaman ini.

• LANGUAGE: Kode bahasa untuk bahasa notifikasi pilihan kontak Anda. Anda dapat menyertakan kode bahasa dari bahasa yang didukung apa pun.

Permintaan:

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

Isi permintaan:

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

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

curl (Linux, macOS, atau Cloud Shell)

Catatan: Pastikan Anda telah menetapkan variabel lingkungan GOOGLE_APPLICATION_CREDENTIALS ke jalur kunci pribadi akun layanan.

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

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)

Catatan: Pastikan Anda telah menetapkan variabel lingkungan GOOGLE_APPLICATION_CREDENTIALS ke jalur kunci pribadi akun layanan.

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

$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
  

Setelah mengirim permintaan, Anda akan menerima respons JSON yang mirip dengan yang berikut ini:

{
  "name": "projects/my-project/contacts/3",
  "email": "[e-mail]",
  "notificationCategorySubscriptions": [
    "SUSPENSION",
    "TECHNICAL"
  ],
  "languageTag": "en"
}

Mengubah kontak

Untuk mengubah kategori yang ditetapkan ke kontak, lakukan hal berikut:

Catatan: Anda tidak dapat mengubah alamat email kontak. Untuk mengubah alamat email, tambahkan kontak baru dengan alamat email yang telah diperbarui, lalu hapus kontak lama.

Konsol

1. Di konsol Google Cloud, buka halaman Kontak penting.

   Buka halaman Kontak penting

2. Pastikan nama project, folder, atau organisasi Anda muncul di pemilih resource di bagian atas halaman. Pemilih resource memberi tahu Anda project, folder, atau organisasi yang saat ini Anda kelola kontaknya.

3. Di samping Lihat menurut, pilih Kontak.

   

4. Klik di samping kontak yang kategorinya ingin Anda ubah.

   

5. Pilih kategori notifikasi yang Anda inginkan dari menu drop-down Notification category, lalu klik Save.

gcloud

1. Di konsol Google Cloud, aktifkan Cloud Shell.

   Aktifkan Cloud Shell

   Di bagian bawah Google Cloud Console, Cloud Shell sesi akan terbuka dan menampilkan perintah command line. Cloud Shell adalah lingkungan shell dengan Google Cloud CLI yang sudah terinstal, dan dengan nilai yang sudah ditetapkan untuk project Anda saat ini. Diperlukan waktu beberapa detik untuk melakukan inisialisasi sesi.

2. Untuk memperbarui kontak yang ada, gunakan perintah gcloud important-contacts update:

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

   Ganti nilai berikut:

   • CONTACT_ID: ID numerik kontak yang ingin Anda perbarui. Untuk melihat ID semua kontak di project, folder, atau organisasi Anda, cantumkan kontak Anda. ID numerik adalah semuanya setelah contacts dalam nama kontak.
   • NOTIFICATION_CATEGORIES: Daftar yang dipisahkan koma dari kategori notifikasi baru yang informasinya ingin Anda terima dari kontak. Daftar ini akan menggantikan daftar kategori notifikasi yang ada.

     Daftar ini dapat berisi salah satu nilai berikut: all, billing, legal, product-updates, security, suspension, technical, insiden teknis , dan notification-category-unspecified. Memilih nilai all akan mencantumkan kontak untuk semua kategori.

     Untuk daftar kontak yang direkomendasikan untuk setiap kategori, lihat Mengidentifikasi kontak di halaman ini.

   • LANGUAGE: Kode bahasa untuk bahasa notifikasi pilihan kontak Anda. Anda dapat menyertakan kode bahasa dari bahasa yang didukung.
   • RESOURCE_TYPE: Jenis resource tempat kontak ditetapkan. Gunakan nilai project, folder, atau organization.
   • RESOURCE_ID: ID project, organisasi, atau folder Google Cloud tempat kontak ditentukan. Project ID adalah string alfanumerik, seperti my-project. ID folder dan organisasi bersifat numerik, seperti 123456789012.

   Jika Anda tidak menentukan jenis dan ID resource, gcloud CLI akan memperbarui kontak dengan ID yang ditentukan dalam project saat ini. Jika kontak dengan ID yang ditentukan tidak ada, gcloud CLI akan menampilkan error.

   Jika perintah berhasil, tidak ada respons yang ditampilkan.

REST

Untuk mengubah langganan notifikasi atau bahasa pilihan dari kontak yang sudah ada, gunakan metode contacts.patch Essential Contacts API.

Sebelum menggunakan salah satu data permintaan di bawah, lakukan penggantian berikut:

• RESOURCE_TYPE: Jenis resource yang ingin Anda cantumkan kontaknya. Gunakan nilai projects, folders, atau organizations.
• RESOURCE_ID: Project, organisasi, atau ID folder Google Cloud Anda. ID project berupa string alfanumerik, seperti my-project. Folder dan ID organisasi berupa numerik, seperti 123456789012.
• CONTACT_ID: ID numerik kontak yang ingin Anda perbarui. Untuk melihat ID semua kontak di project, folder, atau organisasi Anda, cantumkan kontak Anda. ID numerik adalah semuanya setelah contacts dalam nama kontak.
• UPDATE_MASK: Opsional. {i>Mask<i} yang menjelaskan {i>field<i} mana dari kontak yang telah Anda ubah. Format untuk mask adalah daftar yang dipisahkan koma yang berisi nama kolom yang sepenuhnya memenuhi syarat, misalnya: notificationCategorySubscriptions,languageTag.
• EMAIL: Alamat email kontak Anda. Kolom ini harus cocok dengan alamat email yang terkait dengan CONTACT_ID yang Anda sertakan dalam permintaan.

• NOTIFICATION_CATEGORY_1 dan NOTIFICATION_CATEGORY_2: Opsional. Kategori notifikasi terbaru yang komunikasinya ingin Anda terima dari kontak. Nilai ini dapat berupa salah satu dari hal berikut: ALL, BILLING, LEGAL, PRODUCT_UPDATES, SECURITY, SUSPENSION, TECHNICAL, TECHNICAL_INCIDENTS.

  Untuk daftar kontak yang direkomendasikan untuk setiap kategori, lihat Mengidentifikasi kontak di halaman ini.

• LANGUAGE: Kode bahasa untuk bahasa notifikasi pilihan kontak. Anda dapat menyertakan kode bahasa dari bahasa yang didukung apa pun.

Permintaan:

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

Isi permintaan:

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

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

curl (Linux, macOS, atau Cloud Shell)

Catatan: Pastikan Anda telah menetapkan variabel lingkungan GOOGLE_APPLICATION_CREDENTIALS ke jalur kunci pribadi akun layanan.

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

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)

Catatan: Pastikan Anda telah menetapkan variabel lingkungan GOOGLE_APPLICATION_CREDENTIALS ke jalur kunci pribadi akun layanan.

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

$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
  

Setelah mengirim permintaan, Anda akan menerima respons JSON yang mirip dengan yang berikut ini:

{
  "name": "projects/my-project/contacts/2",
  "email": "[e-mail]",
  "notificationCategorySubscriptions": [
    "ALL"
  ],
  "languageTag": "en"
}

Menghapus kontak

Untuk menghapus kontak, lakukan langkah-langkah berikut:

Konsol

1. Di konsol Google Cloud, buka halaman Kontak penting.

   Buka halaman Kontak penting

2. Pastikan nama project, folder, atau organisasi Anda muncul di pemilih resource di bagian atas halaman. Pemilih resource memberi tahu Anda project, folder, atau organisasi yang saat ini Anda kelola kontaknya.

3. Di samping Lihat menurut, pilih Kontak.

   

4. Klik di samping alamat email kontak yang ingin dihapus. Kemudian, dalam dialog, konfirmasi bahwa Anda ingin menghapus kontak.

   

gcloud

1. Di konsol Google Cloud, aktifkan Cloud Shell.

   Aktifkan Cloud Shell

   Di bagian bawah Google Cloud Console, Cloud Shell sesi akan terbuka dan menampilkan perintah command line. Cloud Shell adalah lingkungan shell dengan Google Cloud CLI yang sudah terinstal, dan dengan nilai yang sudah ditetapkan untuk project Anda saat ini. Diperlukan waktu beberapa detik untuk melakukan inisialisasi sesi.

2. Untuk menghapus kontak yang ada, gunakan perintah gcloud important-contacts delete:

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

   Ganti nilai berikut:

   • CONTACT_ID: ID numerik kontak yang ingin Anda hapus. Untuk melihat ID semua kontak di project, folder, atau organisasi Anda, cantumkan kontak Anda. ID numerik adalah semuanya setelah contacts dalam nama kontak.
   • RESOURCE_TYPE: Jenis resource tempat kontak ditetapkan. Gunakan nilai project, folder, atau organization.
   • RESOURCE_ID: ID project, organisasi, atau folder Google Cloud tempat kontak ditentukan. Project ID adalah string alfanumerik, seperti my-project. ID folder dan organisasi bersifat numerik, seperti 123456789012.

   Jika Anda tidak menentukan jenis dan ID resource, gcloud CLI akan menghapus kontak dengan ID yang ditentukan dalam project saat ini. Jika kontak dengan ID yang ditentukan tidak ada, gcloud CLI akan menampilkan error.

   Jika perintah berhasil, tidak ada respons yang ditampilkan.

REST

Untuk menghapus kontak, gunakan metode contacts.delete Essential Contacts API.

Sebelum menggunakan salah satu data permintaan di bawah, lakukan penggantian berikut:

• RESOURCE_TYPE: Jenis resource yang ingin Anda cantumkan kontaknya. Gunakan nilai projects, folders, atau organizations.
• RESOURCE_ID: Project, organisasi, atau ID folder Google Cloud Anda. ID project berupa string alfanumerik, seperti my-project. Folder dan ID organisasi berupa numerik, seperti 123456789012.
• CONTACT_ID: ID numerik kontak Anda. Untuk melihat ID semua kontak dalam project, folder, atau organisasi Anda, cantumkan kontak Anda.

Permintaan:

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

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

curl (Linux, macOS, atau Cloud Shell)

Catatan: Pastikan Anda telah menetapkan variabel lingkungan GOOGLE_APPLICATION_CREDENTIALS ke jalur kunci pribadi akun layanan.

Jalankan perintah berikut:

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)

Catatan: Pastikan Anda telah menetapkan variabel lingkungan GOOGLE_APPLICATION_CREDENTIALS ke jalur kunci pribadi akun layanan.

Jalankan perintah berikut:

$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
  

Jika permintaan berhasil, isi respons akan kosong.

Mengelola kontak berdasarkan kategori

Di konsol Google Cloud, Anda juga dapat mengelola kontak berdasarkan kategori dengan membuka tab Kategori di halaman Kontak penting.

Untuk menambahkan, mengubah, atau menghapus kontak yang ditetapkan ke satu kategori, lakukan langkah berikut:

1. Di konsol Google Cloud, buka halaman Kontak penting.

   Buka halaman Kontak Penting

2. Pastikan nama project, folder, atau organisasi Anda muncul di pemilih resource di bagian atas halaman. Pemilih resource memberi tahu Anda project, folder, atau organisasi yang saat ini Anda kelola kontaknya.

3. Di samping Lihat menurut, pilih Kategori.

   

4. Klik di baris yang sama dengan kategori yang kontaknya ingin Anda kelola.

   

   

5. Mengelola kontak yang ditetapkan ke kategori:

   • Untuk menambahkan kontak baru, klik Tambahkan kontak, lalu ikuti langkah-langkah untuk menambahkan kontak yang dijelaskan di halaman ini.

   • Untuk mengubah kategori kontak yang ditetapkan, klik di samping kontak yang kategorinya ingin Anda ubah. Kemudian, pilih kategori notifikasi yang Anda inginkan dari menu drop-down Notification category dan klik Save.

     Catatan: Anda tidak dapat mengubah alamat email kontak. Untuk mengubah alamat email, tambahkan kontak baru dengan alamat email yang telah diperbarui dan hapus kontak lama.

   • Untuk menghapus kontak, klik di samping alamat email kontak tersebut.

Memverifikasi transmisi email

Anda dapat mengirim email uji ke kontak di setiap kategori untuk memverifikasi apakah akun email dapat menerima email dari Google Cloud.

Untuk mengirim email percobaan ke kontak dalam kategori tertentu, lakukan hal berikut:

1. Di konsol Google Cloud, buka halaman Kontak penting.

   Buka halaman Kontak Penting

2. Pastikan nama project, folder, atau organisasi Anda muncul di pemilih resource di bagian atas halaman. Pemilih resource menampilkan project, folder, atau organisasi yang kontaknya sedang Anda kelola.

3. Di samping Lihat menurut, pilih Kategori.

   

4. Klik di baris yang sama dengan kategori yang kontaknya ingin Anda kirimi email pengujian.

5. Pilih kotak centang di samping kontak yang ingin Anda kirimi email.

6. Klik Kirim. Email percobaan dikirim ke kontak yang dipilih.

   Catatan: Anda dapat mengirim maksimum satu email uji coba setiap 24 jam ke setiap kontak per kategori, dan per resource.

7. Berkomunikasilah dengan setiap kontak untuk memastikan mereka menerima email uji coba dari [e-mail].

Mengelola kontak dengan Terraform

Anda dapat menggunakan Terraform untuk mengelola kontak notifikasi. Kontak memiliki format berikut dalam bahasa Terraform:

resource "google_essential_contacts_contact" "contact" {
  parent = "RESOURCE_TYPE/RESOURCE_ID"
  email = "EMAIL"
  language_tag = "LANGUAGE"
  notification_category_subscriptions = NOTIFICATION_CATEGORIES
}

Saat membuat kontak, ganti nilai berikut:

• RESOURCE_TYPE: Jenis resource yang ingin Anda cantumkan kontaknya. Gunakan nilai projects, folders, atau organizations.
• RESOURCE_ID: Project, organisasi, atau ID folder Google Cloud Anda. ID project berupa string alfanumerik, seperti my-project. Folder dan ID organisasi berupa numerik, seperti 123456789012.
• EMAIL: Alamat email kontak Anda. Anda tidak dapat mengubah kolom ini setelah membuat kontak.
• LANGUAGE: Opsional. Kode bahasa untuk bahasa notifikasi pilihan kontak. Anda dapat menyertakan kode bahasa dari bahasa yang didukung.

• NOTIFICATION_CATEGORIES: Array kategori notifikasi yang Anda inginkan untuk menerima komunikasi dari kontak. Misalnya, ["BILLING", "LEGAL"].

  Array ini dapat berisi salah satu nilai berikut: ALL, BILLING, LEGAL, PRODUCT_UPDATES, SECURITY, SUSPENSION, TECHNICAL, TECHNICAL_INCIDENTS.

  Untuk daftar kontak yang direkomendasikan untuk setiap kategori, lihat Mengidentifikasi kontak di halaman ini.

Untuk menambah, mengubah, atau menghapus kontak, menambahkan, memodifikasi, atau menghapus resource kontak di file konfigurasi Terraform Anda.

Catatan: Untuk menerima notifikasi, kontak harus dapat menerima email dari Google.

Untuk mengetahui detail selengkapnya, lihat dokumentasi Terraform Essential Contacts.

Langkah selanjutnya

• Pelajari cara mengaitkan domain dengan project untuk tujuan verifikasi.
• Pahami cara mengelola preferensi notifikasi Anda.