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