Method: users.settings.cse.keypairs.create

יוצר ומעלה שרשרת אישורים של מפתח ציבורי ומטא-נתונים של מפתח פרטי ב-S/MIME של הצפנה מצד הלקוח עבור המשתמש המאומת.

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

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

בקשת HTTP

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

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

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

פרמטרים
userId

string

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

גוף הבקשה

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

גוף התשובה

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

היקפי הרשאות

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

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

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