הפעלת זוג מפתחות להצפנה מצד הלקוח שהושבת. זוג המפתחות הופך שוב לפעיל עבור כל הזהויות המשויכות להצפנה מצד הלקוח.
אדמינים שמנהלים זהויות וצמדי מפתחות של משתמשים בארגון שלהם צריכים לאשר בקשות באמצעות חשבון שירות שיש לו הרשאת הענקת הרשאות גישה ברמת הדומיין להתחזות למשתמשים עם היקף ההרשאות https://www.googleapis.com/auth/gmail.settings.basic.
משתמשים שמנהלים את הזהויות ואת זוגות המפתחות שלהם צריכים להפעיל ולהגדיר הצפנה של מפתחות פיזיים כדי לשלוח בקשות.
בקשת HTTP
POST https://gmail.googleapis.com/gmail/v1/users/{userId}/settings/cse/keypairs/{keyPairId}:enable
כתובת ה-URL כתובה בתחביר של gRPC Transcoding.
פרמטרים של נתיב
| פרמטרים | |
|---|---|
userId |
כתובת האימייל הראשית של השולח. כדי לציין את המשתמש המאומת, אפשר להשתמש בערך המיוחד |
keyPairId |
המזהה של זוג המפתחות שרוצים להפעיל. |
גוף הבקשה
גוף הבקשה צריך להיות ריק.
גוף התשובה
אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל מופע של CseKeyPair.
היקפי הרשאות
נדרש אחד מהיקפי ההרשאות הבאים של OAuth:
https://www.googleapis.com/auth/gmail.settings.basichttps://www.googleapis.com/auth/gmail.settings.sharing
ניתן למצוא מידע נוסף כאן: OAuth 2.0 Overview.