Mengelola Kontak Penting

Halaman ini menjelaskan metode yang tersedia untuk melihat, menambahkan, mengubah, atau menghapus Kontak Penting dan mengonfigurasi kategori notifikasi untuk mereka.

Jika Anda adalah Admin Organisasi, Anda dapat mengelola Kontak Penting menggunakan konsol Trusted Cloud , Google Cloud CLI, atau REST API. Ikuti praktik terbaik untuk mengelola Kontak Penting.

Jika Anda adalah kontak penting, minta administrator Anda untuk mengirimkan email percobaan untuk memverifikasi penerimaan untuk kategori notifikasi tertentu. Jika Anda tidak menerima notifikasi, verifikasi hal berikut:

  • Periksa folder spam atau sampah email Anda.
  • Pastikan alamat email yang terdaftar sebagai kontak sudah benar dan dapat menerima email eksternal.
  • Pastikan informasi kontak Anda ditetapkan ke kategori notifikasi yang relevan.

Sebelum memulai

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

Jika Anda ingin mengelola kontak menggunakan gcloud CLI atau REST API, aktifkan Essential Contacts API. Jika hanya ingin mengelola kontak menggunakan konsol Trusted Cloud , Anda tidak perlu mengaktifkan API.

Enable the 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 mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.

Peran bawaan ini berisi izin yang diperlukan untuk mengelola kontak. Untuk melihat izin yang benar-benar diperlukan, luaskan 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
    • essentialcontacts.contacts.update

Anda mungkin juga bisa mendapatkan izin ini dengan peran khusus atau peran bawaan lainnya.

Melihat kontak

Resource turunan, yang merujuk ke folder dan project, mewarisi kontak dari turunan induknya, yang dapat berupa organisasi dan folder lainnya. Saat melihat kontak dari resource turunan, Anda juga dapat melihat kontak yang diwarisi dari turunannya jika Anda memiliki izin yang sesuai untuk turunan tersebut. Untuk mendapatkan kemampuan ini, dapatkan peran pada resource induk yang mencakup izin yang diperlukan untuk melihat kontak. Saat Anda melihat kontak dari organisasi atau folder tingkat teratas, Anda tidak melihat kontak dari resource turunannya.

Untuk melihat daftar semua Kontak Penting di project, folder, atau organisasi Anda, lakukan hal berikut:

Konsol

  1. Di konsol Trusted Cloud , buka halaman Kontak Penting.

    Buka halaman Kontak Penting

  2. Pastikan nama project, folder, atau organisasi Anda muncul di pemilih resource halaman. Pemilih resource memungkinkan Anda memilih project, folder, atau organisasi tempat Anda ingin melihat Kontak Penting.

  3. Di samping Lihat menurut, Anda dapat memilih salah satu opsi berikut:

    • Untuk melihat daftar kontak menurut kategori, pilih Kategori.
    • Untuk melihat daftar kontak menurut abjad, pilih Kontak.

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. Dengan Google Cloud CLI, Anda dapat mencantumkan kontak yang ditentukan pada resource atau mencantumkan semua kontak dan kontak yang diwariskan untuk resource.

    Mencantumkan kontak yang ditentukan pada resource

    Untuk melihat Kontak Penting yang ditentukan di project, folder, atau organisasi tertentu, gunakan perintah gcloud essential-contacts list:

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

    Ganti kode berikut:

    • RESOURCE_TYPE: jenis resource yang ingin Anda cantumkan kontaknya. Gunakan nilai project, folder, atau organization.
    • RESOURCE_ID: ID Trusted Cloud project, organisasi, atau folder Anda. Project ID adalah 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 dari project saat ini.

    Responsnya mirip dengan contoh berikut:

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

    Mencantumkan kontak dan kontak yang diwariskan

    Jika ingin mencantumkan semua kontak dari resource dan kontak yang diwariskan dari ancestor, Anda harus memiliki peran di resource ancestor yang mencakup izin yang diperlukan untuk melihat kontak. Kemudian, gunakan perintah gcloud essential-contacts compute:

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

    Ganti kode berikut:

    • NOTIFICATION_CATEGORY: daftar yang dipisahkan koma untuk kategori notifikasi yang ingin Anda lihat kontaknya. Daftar dapat berisi salah satu nilai berikut:

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

      Untuk mengetahui informasi selengkapnya, lihat Kategori notifikasi.

    • RESOURCE_TYPE: jenis resource yang kontaknya ingin Anda lihat. Gunakan nilai project, folder, atau organization.

    • RESOURCE_ID: ID Trusted Cloud project, organisasi, atau folder 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 mencantumkan kontak untuk project saat ini.

    Responsnya mirip dengan contoh berikut:

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

    3. REST

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

    Mencantumkan kontak yang ditentukan pada resource

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

    Permintaan:

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

    Ganti kode berikut:

    • RESOURCE_TYPE: jenis resource yang ingin Anda cantumkan kontaknya. Gunakan nilai projects, folders, atau organizations.
    • RESOURCE_ID: ID Trusted Cloud project, organisasi, atau folder Anda. Project ID adalah string alfanumerik, seperti my-project. Folder dan ID organisasi berupa numerik, seperti 123456789012.
    • PAGE_SIZE: Opsional. Jumlah kontak yang akan disertakan dalam respons. Nilai defaultnya adalah 50, dan nilai maksimumnya 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 yang ditampilkan dalam respons sebelumnya dari metode ini. Jika ditentukan, daftar kontak dimulai dari tempat respons sebelumnya berakhir.

    Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

    curl (Linux, macOS, atau Cloud Shell)

    Tetapkan variabel lingkungan GOOGLE_APPLICATION_CREDENTIALS ke jalur kunci pribadi akun layanan Anda. Kemudian, buat permintaan: 

    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)

    Tetapkan variabel lingkungan GOOGLE_APPLICATION_CREDENTIALS ke jalur kunci pribadi akun layanan Anda. Kemudian, buat permintaan: 

    $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 contoh berikut:

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

    Mencantumkan kontak dan kontak yang diwariskan

    Jika ingin mencantumkan semua kontak dari resource dan kontak yang diwariskan dari ancestor, Anda harus memiliki peran di resource ancestor yang mencakup izin yang diperlukan untuk melihat kontak. Kemudian, gunakan metode contacts.compute Essential Contacts API.

    Permintaan:

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

    Ganti kode berikut:

    • RESOURCE_TYPE: jenis resource yang kontaknya ingin Anda lihat. Gunakan nilai projects, folders, atau organizations.
    • RESOURCE_ID: ID Trusted Cloud project, organisasi, atau folder Anda. Project ID adalah string alfanumerik, seperti my-project. Folder dan ID organisasi berupa numerik, seperti 123456789012.

    • NOTIFICATION_CATEGORY: kategori notifikasi yang ingin Anda lihat kontaknya. Anda dapat mengulangi kolom ini untuk mencantumkan kontak dari beberapa kategori notifikasi. Dapat menggunakan salah satu nilai berikut:

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

      Untuk mengetahui informasi selengkapnya, lihat Kategori notifikasi.

    • PAGE_SIZE: Opsional. Jumlah kontak yang akan disertakan dalam respons. Nilai defaultnya adalah 50, dan nilai maksimumnya 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 yang ditampilkan dalam respons sebelumnya dari metode ini. Jika ditentukan, daftar kontak dimulai dari tempat respons sebelumnya berakhir.

    Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

    curl (Linux, macOS, atau Cloud Shell)

    Tetapkan variabel lingkungan GOOGLE_APPLICATION_CREDENTIALS ke jalur kunci pribadi akun layanan Anda. Kemudian, buat permintaan: 

    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)

    Tetapkan variabel lingkungan GOOGLE_APPLICATION_CREDENTIALS ke jalur kunci pribadi akun layanan Anda. Kemudian, buat permintaan: 

    $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

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

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

Tambahkan kontak

Untuk menambahkan kontak, lakukan langkah-langkah berikut:

Konsol

  1. Di konsol Trusted Cloud , buka halaman Kontak Penting.

    Buka halaman Kontak Penting

  2. Pastikan nama project, folder, atau organisasi Anda muncul di pemilih resource halaman. Pemilih resource memungkinkan Anda memilih project, folder, atau organisasi tempat Anda ingin menambahkan Kontak Penting.

  3. Klik Tambahkan kontak.

    Screenshot yang menandai opsi untuk menambahkan kontak dari halaman Kontak Penting.

  4. Di kolom Email dan Confirm email, masukkan alamat email kontak yang ingin Anda tambahkan.

  5. Dari menu drop-down Notification categories, pilih kategori yang Anda inginkan untuk notifikasi yang diterima kontak.

    Untuk mengetahui daftar kategori notifikasi dan kontak yang direkomendasikan, lihat Kategori notifikasi.

  6. Klik Simpan.

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. Tambahkan kontak baru dengan perintah gcloud essential-contacts create:

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

    Ganti kode berikut:

    • EMAIL: alamat email kontak yang ingin Anda tambahkan. Anda tidak dapat mengubah kolom ini setelah membuat kontak.
    • NOTIFICATION_CATEGORY: daftar yang dipisahkan koma dari kategori yang Anda inginkan agar kontak menerima notifikasi. Daftar dapat berisi salah satu nilai berikut:
      • billing
      • legal
      • product-updates
      • security
      • suspension
      • technical
      • all
      • notification-category-unspecified
      Untuk mengetahui daftar kategori notifikasi dan kontak yang direkomendasikan, lihat Kategori notifikasi.
    • LANGUAGE: kode bahasa untuk bahasa notifikasi pilihan kontak Anda. Anda dapat menyertakan kode bahasa bahasa yang didukung.
    • RESOURCE_TYPE: jenis resource yang ingin Anda buat kontaknya. Gunakan nilai project, folder, atau organization.
    • RESOURCE_ID: ID Trusted Cloud project, organisasi, atau folder 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, Anda tidak akan menerima respons apa pun.

    3. REST

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

    Permintaan:

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

    Isi permintaan:

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

    Ganti kode berikut:

    • RESOURCE_TYPE: jenis resource yang ingin Anda buat kontaknya. Gunakan nilai projects, folders, atau organizations.
    • RESOURCE_ID: ID Trusted Cloud project, organisasi, atau folder Anda. Project ID adalah 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 yang Anda inginkan untuk notifikasi yang diterima kontak. Anda dapat menambahkan lebih banyak kategori notifikasi dengan menyertakan lebih banyak nilai ini. Daftar dapat mengambil satu atau beberapa nilai berikut:

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

      Untuk mengetahui daftar kategori notifikasi dan kontak yang direkomendasikan, lihat Kategori notifikasi.

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

    Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

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

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

Mengubah informasi kontak

Anda dapat mengubah kategori notifikasi atau bahasa pilihan untuk kontak, tetapi Anda tidak dapat mengubah alamat email kontak. Jika alamat email kontak berubah, tambahkan kontak baru dengan alamat email yang telah diperbarui dan hapus kontak lama.

Untuk mengubah kategori notifikasi yang ditetapkan ke kontak atau bahasa pilihan mereka, lakukan hal berikut:

Konsol

  1. Di konsol Trusted Cloud , buka halaman Kontak Penting.

    Buka halaman Kontak Penting

  2. Pastikan nama project, folder, atau organisasi Anda muncul di pemilih resource halaman. Pemilih resource memungkinkan Anda memilih project, folder, atau organisasi tempat Anda ingin mengelola Kontak Penting.

  3. Di samping Lihat menurut, pilih Kontak.

    Screenshot yang menandai opsi untuk memilih Kontak dari halaman Kontak Penting.

  4. Klik Edit di samping kontak yang kategori notifikasinya ingin Anda ubah.

    Screenshot yang menandai opsi untuk mengedit kontak dari halaman Kontak Penting.

  5. Pilih kategori notifikasi yang ingin Anda ubah dari menu drop-down Notification categories, lalu klik Simpan.

Saat Anda mengelola kontak dari konsol Trusted Cloud , konsol Trusted Cloud akan mengonfigurasi bahasa pilihan kontak secara otomatis berdasarkan setelan bahasa pilihan pembuat kontak. Untuk mengetahui informasi selengkapnya, lihat Bahasa yang didukung.

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. Perbarui kontak yang ada dengan perintah gcloud essential-contacts update:

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

    Ganti kode berikut:

    • CONTACT_ID: ID numerik kontak yang ingin Anda perbarui. Untuk melihat ID semua kontak di project, folder, atau organisasi Anda, lihat kontak Anda. ID numerik adalah seluruh nilai setelah contacts di nama kontak.
    • NOTIFICATION_CATEGORY: daftar yang dipisahkan koma dari kategori baru yang Anda inginkan untuk menerima notifikasi kontak. Daftar ini menggantikan daftar kategori notifikasi yang ada.

      Daftar dapat berisi salah satu nilai berikut:

      • billing
      • legal
      • product-updates
      • security
      • suspension
      • technical
      • all
      • notification-category-unspecified
      Untuk mengetahui daftar kategori notifikasi dan kontak yang direkomendasikan, lihat Kategori notifikasi.
    • LANGUAGE: kode bahasa untuk bahasa notifikasi pilihan kontak Anda. Anda dapat menyertakan kode bahasa bahasa yang didukung.
    • RESOURCE_TYPE: jenis resource tempat Anda ingin mengubah informasi kontak. Gunakan nilai project, folder, atau organization.
    • RESOURCE_ID: ID Trusted Cloud project, organisasi, atau folder tempat kontak ditentukan. 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 memperbarui kontak dengan ID yang ditentukan dalam project saat ini. Jika tidak ada kontak dengan ID yang ditentukan, gcloud CLI akan menampilkan error.

    Jika perintah berhasil, Anda tidak akan menerima respons apa pun.

    3. REST

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

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

    Ganti kode berikut:

    • RESOURCE_TYPE: jenis resource tempat Anda ingin mengubah informasi kontak. Gunakan nilai projects, folders, atau organizations.
    • RESOURCE_ID: ID Trusted Cloud project, organisasi, atau folder Anda. Project ID adalah 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, lihat kontak Anda. ID numerik adalah seluruh nilai setelah contacts dalam nama kontak.
    • UPDATE_MASK: Opsional. Masker yang menjelaskan kolom kontak yang ingin Anda ubah. Format untuk mask adalah daftar nama kolom yang sepenuhnya memenuhi syarat yang dipisahkan koma, 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 yang diperbarui yang Anda inginkan untuk notifikasi yang diterima kontak. Anda dapat menambahkan kategori notifikasi lainnya dengan menyertakan lebih banyak nilai ini. Daftar dapat menggunakan satu atau beberapa nilai berikut:

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

      Untuk mengetahui daftar kategori notifikasi dan kontak yang direkomendasikan, lihat Kategori notifikasi.

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

    Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

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

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

Menghapus kontak

Untuk menghapus kontak, lakukan langkah-langkah berikut:

Konsol

  1. Di konsol Trusted Cloud , buka halaman Kontak Penting.

    Buka halaman Kontak Penting

  2. Pastikan nama project, folder, atau organisasi Anda muncul di pemilih resource halaman. Pemilih resource memungkinkan Anda memilih project, folder, atau organisasi tempat Anda ingin menghapus Kontak Penting.

  3. Di samping Lihat menurut, pilih Kontak.

    Screenshot yang menandai opsi untuk memilih Kontak dari halaman Kontak Penting.

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

    Screenshot yang menandai opsi untuk menghapus kontak dari halaman Kontak Penting.

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. Hapus kontak yang ada dengan perintah gcloud essential-contacts delete:

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

    Ganti kode berikut:

    • CONTACT_ID: ID numerik kontak yang ingin Anda hapus. Untuk melihat ID semua kontak di project, folder, atau organisasi Anda, lihat kontak Anda. ID numerik adalah seluruh nilai setelah contacts dalam nama kontak.
    • RESOURCE_TYPE: jenis resource tempat kontak ditentukan. Gunakan nilai project, folder, atau organization.
    • RESOURCE_ID: ID Trusted Cloud project, organisasi, atau folder tempat kontak ditentukan. 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 menghapus kontak dengan ID yang ditentukan dalam project saat ini. Jika tidak ada kontak dengan ID yang ditentukan, gcloud CLI akan menampilkan error.

    Jika perintah berhasil, Anda tidak akan menerima respons apa pun.

    3. REST

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

    Permintaan:

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

    Ganti kode berikut:

    • RESOURCE_TYPE: jenis resource tempat kontak ditentukan. Gunakan nilai projects, folders, atau organizations.
    • RESOURCE_ID: ID Trusted Cloud project, organisasi, atau folder Anda. Project ID adalah string alfanumerik, seperti my-project. Folder dan ID organisasi berupa numerik, seperti 123456789012.
    • CONTACT_ID: ID numerik kontak yang ingin Anda hapus. Untuk melihat ID semua kontak di project, folder, atau organisasi Anda, lihat kontak Anda. ID numerik adalah seluruh nilai setelah contacts dalam nama kontak.

    Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

    Jika permintaan berhasil, isi respons akan kosong.

Mengelola kontak menurut kategori

Di konsol Trusted Cloud , Anda dapat mengelola kontak menurut kategori notifikasi dengan membuka tab Kategori di halaman Kontak Penting.

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

  1. Di konsol Trusted Cloud , buka halaman Kontak Penting.

    Buka halaman Kontak Penting

  2. Pastikan nama project, folder, atau organisasi Anda muncul di pemilih resource halaman. Pemilih resource memungkinkan Anda memilih project, folder, atau organisasi tempat Anda ingin mengelola Kontak Penting.

  3. Di samping Tampilkan menurut, pilih Kategori.

    Screenshot yang menandai opsi untuk memilih Kategori dari halaman Kontak Penting.

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

    Screenshot yang menandai opsi untuk mengedit kontak dari halaman Kontak Penting.

  5. Mengelola kontak yang ditetapkan ke kategori notifikasi:

    • Untuk menambahkan kontak baru, klik Tambahkan kontak dan ikuti langkah-langkah untuk menambahkan kontak.
    • Untuk mengubah kategori notifikasi yang ditetapkan ke kontak, klik Edit di samping kontak yang kategorinya ingin Anda ubah. Kemudian, pilih kategori notifikasi yang Anda inginkan dari menu drop-down Notification categories, lalu klik Save.
    • Untuk menghapus kontak, klik Hapus di samping alamat email kontak.

Kirim email uji coba untuk memverifikasi penerimaan

Anda dapat mengirim email uji ke kontak di setiap kategori untuk memverifikasi apakah akun email dapat menerima email dari Trusted Cloud by S3NS. Anda dapat mengirim maksimum satu email uji setiap 24 jam kepada setiap kontak di setiap kategori dan resource.

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

  1. Di konsol Trusted Cloud , buka halaman Kontak Penting.

    Buka halaman Kontak Penting

  2. Pastikan nama project, folder, atau organisasi Anda muncul di pemilih resource halaman. Pemilih resource memungkinkan Anda memilih project, folder, atau organisasi tempat Anda ingin mengelola Kontak Penting.

  3. Di samping Tampilkan menurut, pilih Kategori.

    Screenshot yang menandai opsi untuk memilih Kategori dari halaman Kontak Penting.

  4. Klik Kirim di baris yang sama dengan kategori notifikasi yang kontaknya ingin Anda kirimi email uji coba.

  5. Centang kotak di samping kontak yang ingin Anda kirimi email.

  6. Klik Kirim. Sistem akan mengirimkan email uji ke kontak yang dipilih.

  7. Berkomunikasi dengan setiap kontak untuk memastikan mereka menerima email pengujian dari gcp-essential-contacts-noreply@google.com.

Menetapkan konfigurasi dan otomatisasi lanjutan

Bagian ini membahas opsi untuk pengelolaan lebih lanjut Kontak Penting Anda, termasuk membatasi domain kontak, menggunakan Infrastructure as Code (IaC) dengan Terraform untuk otomatisasi, dan membuat kebijakan organisasi kustom.

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 sudah ada tidak terpengaruh oleh batasan ini.

Untuk mempelajari cara menetapkan batasan kebijakan organisasi, lihat Membuat dan mengelola kebijakan organisasi.

Mengelola kontak dengan Terraform

Anda dapat menggunakan Terraform untuk mengelola Kontak Penting Anda. 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_CATEGORY]
}

Saat mengelola kontak, ganti yang berikut ini:

  • RESOURCE_TYPE: jenis resource tempat Anda ingin mengelola kontak. Gunakan nilai projects, folders, atau organizations.
  • RESOURCE_ID: ID Trusted Cloud by S3NS project, organisasi, atau folder Anda. Project ID adalah 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 salah satu bahasa yang didukung.

  • NOTIFICATION_CATEGORY: array kategori yang Anda inginkan untuk menerima notifikasi kontak, seperti ["BILLING", "LEGAL"]. Array ini dapat berisi salah satu nilai berikut:

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

    Untuk mengetahui daftar kategori notifikasi dan kontak yang direkomendasikan, lihat Kategori notifikasi.

Untuk menambahkan, mengubah, atau menghapus kontak, tambahkan, ubah, atau hapus resource kontak di file konfigurasi Terraform Anda. Untuk mengetahui detail selengkapnya, lihat dokumentasi Kontak Penting Terraform.

Langkah berikutnya