יצירת סשן העלאה להעלאת תוכן של פריט. לפריטים שקטנים מ-100KB, קל יותר להטמיע את התוכן inline בתוך בקשת index.
כדי להפעיל את ה-API הזה, נדרש חשבון אדמין או חשבון שירות. חשבון השירות שבו נעשה שימוש הוא זה שרשום ברשימת ההיתרים במקור הנתונים המתאים.
בקשת HTTP
POST https://cloudsearch.googleapis.com/v1/indexing/{name=datasources/*/items/*}:upload
כתובת ה-URL משתמשת בתחביר של Transcoding של gRPC.
פרמטרים של נתיב
| פרמטרים | |
|---|---|
name | 
                
                   
 השם של הפריט שרוצים להתחיל להעלות. הפורמט: datasources/{sourceId}/items/{itemId}. האורך המקסימלי הוא 1,536 בייטים.  | 
              
גוף הבקשה
גוף הבקשה מכיל נתונים במבנה הבא:
| ייצוג ב-JSON | 
|---|
{
  "connectorName": string,
  "debugOptions": {
    object ( | 
                
| שדות | |
|---|---|
connectorName | 
                  
                     
 השם של המחבר שמבצע את הקריאה הזו. פורמט: datasources/{sourceId}/connectors/{id}  | 
                
debugOptions | 
                  
                     
 אפשרויות נפוצות לניפוי באגים.  | 
                
גוף התשובה
אם הפעולה מצליחה, גוף התגובה מכיל מופע של UploadItemRef.
היקפי הרשאה
נדרש אחד מהיקפי ההרשאות הבאים של OAuth:
https://www.googleapis.com/auth/cloud_search.indexinghttps://www.googleapis.com/auth/cloud_search
מידע נוסף זמין במדריך ההרשאות.