Method: files.generateCseToken

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

בקשת HTTP

GET https://www.googleapis.com/drive/v3/files/generateCseToken

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

פרמטרים של שאילתה

פרמטרים
fileId

string

המזהה של הקובץ שעבורו צריך ליצור את ה-JWT. אם לא מספקים מזהה, המערכת יוצרת מזהה.
parent

string

המזהה של תיקיית ההורה הצפויה של הקובץ. הפרמטר הזה משמש ליצירת JWT לקובץ חדש של מנוע חיפוש בהתאמה אישית. אם מצוין הורה, המערכת תאחזר אותו, ואם ההורה הוא פריט באחסון שיתופי, המדיניות של האחסון השיתופי תשמש לקביעת רשימת בקרת הגישה (KACLS) שצריך להשתמש בה.

אי אפשר לציין גם fileId וגם parent באותה בקשה.

גוף הבקשה

גוף הבקשה צריך להיות ריק.

גוף התשובה

‫JWT ומטא-נתונים משויכים שמשמשים ליצירת קובצי CSE.

אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל נתונים במבנה הבא:

ייצוג ב-JSON 
{
  "fileId": string,
  "currentKaclsId": string,
  "currentKaclsName": string,
  "jwt": string,
  "kind": string
}
שדות
fileId

string

מזהה הקובץ שעבורו נוצר ה-JWT.
currentKaclsId

string (int64 format)

המזהה הנוכחי של שירות בקרת הגישה למפתחות (KACLS) שמשויך ל-JWT.
currentKaclsName

string

השם של רשימות KACL שאליהן מצביע המזהה של רשימות KACL שמוחזרות.
jwt

string

אסימון ה-JWT (‏JSON Web Token) החתום של הקובץ.
kind

string

פלט בלבד. מזהה את סוג המשאב. הערך: המחרוזת הקבועה "drive#generateCseTokenResponse".

היקפי הרשאות

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

  • https://www.googleapis.com/auth/docs
  • https://www.googleapis.com/auth/drive

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