Method: users.settings.cse.identities.create

יוצר ומגדיר זהות להצפנה מצד הלקוח שמורשית לשלוח אימייל מחשבון המשתמש. ‫Google מפרסמת את אישור S/MIME בספרייה משותפת ברמת הדומיין, כדי שאנשים בארגון Google Workspace יוכלו להצפין ולשלוח אימייל לזהות.

אדמינים שמנהלים זהויות וצמדי מפתחות של משתמשים בארגון שלהם צריכים לאשר בקשות באמצעות חשבון שירות שיש לו הרשאת הענקת הרשאות גישה ברמת הדומיין להתחזות למשתמשים עם היקף ההרשאות https://www.googleapis.com/auth/gmail.settings.basic.

משתמשים שמנהלים את הזהויות ואת זוגות המפתחות שלהם צריכים להפעיל ולהגדיר הצפנה של מפתחות פיזיים כדי לשלוח בקשות.

בקשת HTTP

POST https://gmail.googleapis.com/gmail/v1/users/{userId}/settings/cse/identities

כתובת ה-URL כתובה בתחביר של gRPC Transcoding.

פרמטרים של נתיב

פרמטרים
userId

string

כתובת האימייל הראשית של השולח. כדי לציין את המשתמש המאומת, אפשר להשתמש בערך המיוחד me.

גוף הבקשה

גוף הבקשה מכיל מופע של CseIdentity.

גוף התשובה

אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל מופע חדש של CseIdentity.

היקפי הרשאות

נדרש אחד מהיקפי ההרשאות הבאים של OAuth:

  • https://www.googleapis.com/auth/gmail.settings.basic
  • https://www.googleapis.com/auth/gmail.settings.sharing

ניתן למצוא מידע נוסף כאן: OAuth 2.0 Overview.