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 נעשה שימוש בתחביר המרת קידוד של 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

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