Method: media.upload

העלאת מדיה להוספה לאינדקס.

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

  1. קוראים ל-indexing.datasources.items.upload עם שם הפריט כדי להתחיל סשן העלאה ולאחזר את UploadItemRef.
  2. קוראים ל-media.upload כדי להעלות את התוכן, כבקשת סטרימינג, באמצעות אותו שם משאב מ-UploadItemRef משלב 1.
  3. קוראים לפונקציה indexing.datasources.items.index כדי להוסיף את הפריט לאינדקס. מאכלסים את ItemContent באמצעות UploadItemRef משלב 1.

מידע נוסף זמין במאמר יצירת מחבר תוכן באמצעות ה-API ל-REST.

הערה: כדי להפעיל את ממשק ה-API הזה נדרש חשבון שירות.

בקשת HTTP

  • URI להעלאה, לבקשות העלאה של מדיה:
    POST https://cloudsearch.googleapis.com/upload/v1/media/{resourceName=**}
  • URI של מטא-נתונים, לבקשות של מטא-נתונים בלבד:
    POST https://cloudsearch.googleapis.com/v1/media/{resourceName=**}

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

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

פרמטרים
resourceName

string

השם של המדיה שמורדת. ReadRequest.resource_name.

גוף הבקשה

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

גוף התשובה

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

משאב מדיה.

ייצוג ב-JSON 
{
  "resourceName": string
}
שדות
resourceName

string

השם של משאב המדיה.

היקפי הרשאה

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

  • https://www.googleapis.com/auth/cloud_search.indexing
  • https://www.googleapis.com/auth/cloud_search

מידע נוסף זמין במדריך ההרשאות.