ניהול אנשי הקשר החיוניים

המסוף

1. במסוף Cloud de Confiance , פותחים את הדף Essential Contacts.

   כניסה לדף Essential Contacts

2. מוודאים ששם הפרויקט, התיקייה או הארגון מופיע בבורר המשאבים שבדף. בכלי לבחירת משאבים אפשר לבחור את הפרויקט, התיקייה או הארגון שמהם רוצים לראות את אנשי הקשר החיוניים.

3. לצד תצוגה לפי, אפשר לבחור באחת מהאפשרויות הבאות:

   • כדי לראות את רשימת אנשי הקשר בחלוקה לקטגוריות, לוחצים על Category.
   • כדי לראות את רשימת אנשי הקשר לפי סדר האלף-בית, לוחצים על Contact.

gcloud

1. במסוף Cloud de Confiance , מפעילים את Cloud Shell.

   הפעלת Cloud Shell

   בחלק התחתון של Cloud de Confiance המסוף יתחיל סשן של Cloud Shell ותופיע הודעה של שורת הפקודה. Cloud Shell היא סביבת מעטפת שבה ה-CLI של Google Cloud מותקן ומוגדרים ערכים לפרויקט הקיים. הסשן יופעל תוך כמה שניות.

2. באמצעות Google Cloud CLI, אפשר להציג רשימה של אנשי הקשר שמוגדרים במשאב, או רשימה של כל אנשי הקשר ואנשי הקשר שעברו בירושה במשאב.

   הצגת רשימה של אנשי קשר שהוגדרו במשאב

   כדי לראות את אנשי הקשר החיוניים שהוגדרו בפרויקט, בתיקייה או בארגון ספציפיים, משתמשים בפקודה gcloud essential-contacts list:

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

   מחליפים את מה שכתוב בשדות הבאים:

   • ‫RESOURCE_TYPE: סוג המשאב שרוצים להציג את אנשי הקשר שלו. אפשר להשתמש ב-project, ב-folder או ב-organization.
   • ‫RESOURCE_ID: מספר הפרויקט, מזהה הארגון או מזהה התיקייה ב- Cloud de Confiance . מספרי פרויקטים, מזהי תיקיות ומזהי ארגונים מכילים רק ספרות, למשל 123456789012. בפרויקטים, צריך להשתמש במספר הפרויקט, שהוא מספר. אין תמיכה במזהי פרויקטים אלפאנומריים.

   לחלופין, אם לא מציינים סוג או מזהה של משאב, ה-CLI של gcloud מציג רשימה של אנשי קשר מהפרויקט הנוכחי.

   התגובה אמורה להיראות כך:

   ---
   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: מספר הפרויקט, מזהה הארגון או מזהה התיקייה ב- Cloud de Confiance . מספרי פרויקטים, מזהי תיקיות ומזהי ארגונים מכילים רק ספרות, למשל 123456789012. בפרויקטים, צריך להשתמש במספר הפרויקט, שהוא מספר. אין תמיכה במזהי פרויקטים אלפאנומריים.

   אם לא מציינים סוג משאב ומזהה, CLI של gcloud מציג רשימה של אנשי הקשר של הפרויקט הנוכחי.

   התגובה אמורה להיראות כך:

   ---
   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 API בארכיטקטורת REST, אתם יכולים לראות את רשימת אנשי הקשר שמוגדרים במשאב או את כל אנשי הקשר ואנשי הקשר שמוגדרים בירושה במשאב.

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

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_CATEGORY&pageSize=PAGE_SIZE&pageToken=NEXT_PAGE_TOKEN" | Select-Object -Expand Content

{
  "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. נכנסים לדף Essential Contacts במסוף Cloud de Confiance .

   כניסה לדף Essential Contacts

2. מוודאים ששם הפרויקט, התיקייה או הארגון מופיע בבורר המשאבים שבדף. בכלי לבחירת משאבים אפשר לבחור את הפרויקט, התיקייה או הארגון שמהם רוצים להוסיף אנשי קשר חיוניים.

3. לוחצים על person_add Add contact.

   

4. מקלידים את כתובת האימייל של איש הקשר שרוצים להוסיף בשדות Email ו-Confirm email.

5. בתפריט הנפתח Notification categories בוחרים אילו קטגוריות של התראות איש הקשר יקבל.

   רשימה של קטגוריות התראות ואנשי קשר מומלצים מופיעה במאמר קטגוריות של התראות.

6. לוחצים על Save.

gcloud

1. במסוף Cloud de Confiance , מפעילים את Cloud Shell.

   הפעלת Cloud Shell

   בחלק התחתון של Cloud de Confiance המסוף יתחיל סשן של Cloud Shell ותופיע הודעה של שורת הפקודה. Cloud Shell היא סביבת מעטפת שבה ה-CLI של Google Cloud מותקן ומוגדרים ערכים לפרויקט הקיים. הסשן יופעל תוך כמה שניות.

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: מספר Cloud de Confiance הפרויקט, מזהה הארגון או מזהה התיקייה. מספרי פרויקטים, מזהי תיקיות ומזהי ארגונים מכילים רק ספרות, למשל 123456789012. בפרויקטים, צריך להשתמש במספר הפרויקט. אין תמיכה במזהי פרויקטים אלפאנומריים.

   אם לא מציינים מזהה וסוג משאב, gcloud CLI יוצר איש קשר בפרויקט הנוכחי.

   אם הפקודה מצליחה, לא מקבלים תגובה.

REST

כדי להוסיף איש קשר חדש, משתמשים בשיטה contacts.create של Essential Contacts API.

בקשה:

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: מספר הפרויקט, מזהה הארגון או מזהה התיקייה ב- Cloud de Confiance . מספרי פרויקטים, מזהי תיקיות ומזהי ארגונים מכילים רק ספרות, למשל 123456789012. בפרויקטים, צריך להשתמש במספר הפרויקט, שהוא מספר. אין תמיכה במזהי פרויקטים אלפאנומריים.
• EMAIL: כתובת האימייל של איש הקשר. אי אפשר לשנות את השדה הזה אחרי שיוצרים את איש הקשר.

• ‫NOTIFICATION_CATEGORY_1 ו-NOTIFICATION_CATEGORY_2: הקטגוריות שרוצים שאנשי הקשר יקבלו עבורן התראות. כדי להוסיף עוד קטגוריות של התראות, צריך לכלול עוד מהערכים האלה. הרשימה יכולה לכלול אחד או יותר מהערכים הבאים:

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

  רשימה של קטגוריות התראות ואנשי קשר מומלצים מופיעה במאמר קטגוריות של התראות.

• ‫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": "my-new-contact@example.com",
  "notificationCategorySubscriptions": [
    "SUSPENSION",
    "TECHNICAL"
  ],
  "languageTag": "en"
}

המסוף

1. נכנסים לדף Essential Contacts במסוף Cloud de Confiance .

   כניסה לדף Essential Contacts

2. מוודאים ששם הפרויקט, התיקייה או הארגון מופיע בבורר המשאבים שבדף. בכלי לבחירת משאבים אפשר לבחור את הפרויקט, התיקייה או הארגון שמהם רוצים לנהל את אנשי הקשר החיוניים.

3. לצד תצוגה לפי, בוחרים באפשרות איש קשר.

   

4. לוחצים על עריכה edit לצד איש הקשר שרוצים לשנות את קטגוריית ההתראות שלו.

   

5. בוחרים את קטגוריות ההתראות שרוצים לשנות מהתפריט הנפתח קטגוריות של התראות ולוחצים על שמירה.

כשמנהלים אנשי קשר דרך מסוף Cloud de Confiance , המסוף Cloud de Confiance קובע אוטומטית את השפה המועדפת של איש הקשר על סמך הגדרות השפה המועדפת של יוצר איש הקשר. מידע נוסף זמין במאמר שפות נתמכות.

gcloud

1. במסוף Cloud de Confiance , מפעילים את Cloud Shell.

   הפעלת Cloud Shell

   בחלק התחתון של Cloud de Confiance המסוף יתחיל סשן של Cloud Shell ותופיע הודעה של שורת הפקודה. Cloud Shell היא סביבת מעטפת שבה ה-CLI של Google Cloud מותקן ומוגדרים ערכים לפרויקט הקיים. הסשן יופעל תוך כמה שניות.

2. כדי לעדכן איש קשר קיים, משתמשים בפקודה gcloud essential-contacts update:

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

   מחליפים את מה שכתוב בשדות הבאים:

   • ‫CONTACT_ID: המזהה המספרי של איש הקשר שרוצים לעדכן. כדי לראות את המזהים של כל אנשי הקשר בפרויקט, בתיקייה או בארגון, צופים באנשי הקשר. המזהה המספרי הוא הערך המלא אחרי contacts בשם של איש הקשר.
   • ‫NOTIFICATION_CATEGORY: רשימה מופרדת בפסיקים של הקטגוריות החדשות שרוצים שהאיש הקשר יקבל לגביהן התראות. הרשימה הזו מחליפה את הרשימה הקיימת של קטגוריות ההתראות.

     הרשימה יכולה להכיל כל אחד מהערכים הבאים:

     • billing
     • legal
     • product-updates
     • security
     • suspension
     • technical
     • all
     • notification-category-unspecified
     רשימה של קטגוריות התראות ואנשי קשר מומלצים מופיעה במאמר בנושא קטגוריות של התראות.
   • ‫LANGUAGE: קוד השפה של שפת ההתראות המועדפת של איש הקשר. אפשר לכלול את קוד השפה של כל אחת מהשפות הנתמכות.
   • ‫RESOURCE_TYPE: סוג המשאב שרוצים לשנות בו את פרטי הקשר. אפשר להשתמש בערך project,‏ folder או organization.
   • ‫RESOURCE_ID: מספר Cloud de Confiance הפרויקט, מזהה הארגון או מזהה התיקייה. מספרי פרויקטים, מזהי תיקיות ומזהי ארגונים מכילים רק ספרות, למשל 123456789012. בפרויקטים, צריך להשתמש במספר הפרויקט. אין תמיכה במזהי פרויקטים אלפאנומריים.

   אם לא מציינים סוג משאב ומזהה, ה-CLI של gcloud מעדכן את איש הקשר עם המזהה שצוין בפרויקט הנוכחי. אם לא קיים איש קשר עם המזהה שצוין, ה-CLI של gcloud מחזיר שגיאה.

   אם הפקודה מצליחה, לא מקבלים תגובה.

REST

כדי לשנות את קטגוריות ההתראות או את השפה המועדפת של איש קשר קיים, משתמשים בשיטה contacts.patch של Essential Contacts API.

בקשה:

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: מספר הפרויקט, מזהה הארגון או מזהה התיקייה ב- Cloud de Confiance . מספרי פרויקטים, מזהי תיקיות ומזהי ארגונים מכילים רק ספרות, למשל 123456789012. בפרויקטים, צריך להשתמש במספר הפרויקט, שהוא מספר. אין תמיכה במזהי פרויקטים אלפאנומריים.
• ‫CONTACT_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 -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": "my-new-contact@example.com",
  "notificationCategorySubscriptions": [
    "ALL"
  ],
  "languageTag": "en"
}

המסוף

1. נכנסים לדף Essential Contacts במסוף Cloud de Confiance .

   כניסה לדף Essential Contacts

2. מוודאים ששם הפרויקט, התיקייה או הארגון מופיע בבורר המשאבים שבדף. בכלי לבחירת משאבים אפשר לבחור את הפרויקט, התיקייה או הארגון שמהם רוצים למחוק אנשי קשר חיוניים.

3. לצד תצוגה לפי, בוחרים באפשרות איש קשר.

   

4. לוחצים על מחיקה delete לצד כתובת האימייל של איש הקשר שרוצים למחוק. בתיבת הדו-שיח, מאשרים שרוצים למחוק את איש הקשר.

   

gcloud

1. במסוף Cloud de Confiance , מפעילים את Cloud Shell.

   הפעלת Cloud Shell

   בחלק התחתון של Cloud de Confiance המסוף יתחיל סשן של Cloud Shell ותופיע הודעה של שורת הפקודה. Cloud Shell היא סביבת מעטפת שבה ה-CLI של Google Cloud מותקן ומוגדרים ערכים לפרויקט הקיים. הסשן יופעל תוך כמה שניות.

2. כדי למחוק איש קשר קיים, משתמשים בפקודה gcloud essential-contacts delete:

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

   מחליפים את מה שכתוב בשדות הבאים:

   • ‫CONTACT_ID: המזהה המספרי של איש הקשר שרוצים למחוק. כדי לראות את המזהים של כל אנשי הקשר בפרויקט, בתיקייה או בארגון, צופים באנשי הקשר. המזהה המספרי הוא הערך כולו אחרי contacts בשם של איש הקשר.
   • ‫RESOURCE_TYPE: סוג המשאב שבו מוגדר איש הקשר. אפשר להשתמש בערך project,‏ folder או organization.
   • ‫RESOURCE_ID: מספר Cloud de Confiance הפרויקט, מזהה הארגון או מזהה התיקייה. מספרי פרויקטים, מזהי תיקיות ומזהי ארגונים מכילים רק ספרות, למשל 123456789012. בפרויקטים, צריך להשתמש במספר הפרויקט. אין תמיכה במזהי פרויקטים אלפאנומריים.

   אם לא מציינים סוג ומזהה של משאב, CLI של gcloud מוחק את איש הקשר עם המזהה שצוין בפרויקט הנוכחי. אם לא קיים איש קשר עם המזהה שצוין, ה-CLI של gcloud מחזיר שגיאה.

   אם הפקודה מצליחה, לא מקבלים תגובה.

REST

כדי למחוק איש קשר, משתמשים בשיטה contacts.delete של Essential Contacts API.

בקשה:

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

מחליפים את מה שכתוב בשדות הבאים:

• ‫RESOURCE_TYPE: סוג המשאב שבו מוגדר איש הקשר. אפשר להשתמש ב-projects, ב-folders או ב-organizations.
• ‫RESOURCE_ID: מספר הפרויקט, מזהה הארגון או מזהה התיקייה ב- Cloud de Confiance . מספרי פרויקטים, מזהי תיקיות ומזהי ארגונים מכילים רק ספרות, למשל 123456789012. בפרויקטים, צריך להשתמש במספר הפרויקט, שהוא מספר. אין תמיכה במזהי פרויקטים אלפאנומריים.
• ‫CONTACT_ID: המזהה המספרי של איש הקשר שרוצים למחוק. כדי לראות את המזהים של כל אנשי הקשר בפרויקט, בתיקייה או בארגון, צופים באנשי הקשר. המזהה המספרי הוא כל הערך אחרי contacts בשם של איש הקשר.

כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:

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
  

אם הבקשה מצליחה, גוף התגובה ריק.