Method: media.upload

• בקשת HTTP
• פרמטרים של נתיב
• גוף הבקשה
• גוף התשובה
  • ייצוג JSON
• היקפי ההרשאות
• רוצים לנסות?

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

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

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

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