- בקשת HTTP
- פרמטרים של נתיב
- גוף הבקשה
- גוף התשובה
- היקפי הרשאות
- בקשה
- CreateSlideRequest
- LayoutReference
- פריסה מוגדרת מראש
- LayoutPlaceholderIdמיפוי
- CreateFormsRequest
- PageElementProperties
- CreateTableRequest
- InsertTextRequest
- InsertTableRowsRequest
- InsertTableColumnRequest
- DeleteTableRowRequest
- DeleteTableColumnRequest
- החלפת AllTextRequest
- קריטריון מחרוזת משנה
- DeleteObjectRequest
- UpdatePageElementTransformRequest
- ApplyMode
- UpdateSlidesPositionRequest
- DeleteTextRequest
- טווח
- סוג
- CreateImageRequest
- CreateVideoRequest
- CreateSheetsChartRequest
- LinkingMode
- CreateLineRequest
- קטגוריה
- RefreshSheetsChartRequest
- UpdateFormsPropertiesRequest
- UpdateImagePropertiesRequest
- UpdateVideoPropertiesRequest
- עדכון דף המאפיינים
- UpdateTableCellPropertiesRequest
- TableRange
- UpdateLinePropertiesRequest
- CreateParagraphbulletsRequest
- bulletGlyphPreset
- החלפת AllStylesWithImageRequest
- החלפת שיטה
- שיטת החלפה של תמונה
- DuplicateObjectRequest
- UpdateTextStyleRequest
- החלפה של כל הצורות ב-SheetsChartRequest
- LinkingMode
- DeleteParagraphbulletsRequest
- UpdateParagraphStyleRequest
- UpdateTableBorderPropertiesRequest
- BorderPosition
- UpdateTableColumnPropertiesRequest
- UpdateTableRowPropertiesRequest
- MergeTableCellsRequest
- UnmergeTableCellsRequest
- GroupObjectsRequest
- UngroupObjectsRequest
- UpdatePageElementAltTextRequest
- החלפת תמונה
- UpdateSlidePropertiesRequest
- UpdatePageElementsZOrderRequest
- ZOrderOperation
- UpdateLineCategoryRequest
- RerouteLineRequest
- WriteControl
- תגובה
- CreateSlideResponse
- CreateצורResponse
- CreateTableResponse
- החלפת AllTextResponse
- CreateImageResponse
- CreateVideoResponse
- CreateSheetsChartResponse
- CreateLineResponse
- החלפת AllStylesWithImageResponse
- DuplicateObjectResponse
- החלפה של כל הצורות עם SheetsChartResponse
- GroupObjectsResponse
- רוצים לנסות?
רלוונטי לעדכון אחד או יותר במצגת.
כל request
מאומת לפני היישום. אם בקשה כלשהי אינה חוקית, הבקשה כולה תיכשל ושום דבר לא ייושם.
בקשות מסוימות כוללות replies
כדי לספק לך מידע על אופן היישום שלהן. אין צורך להחזיר מידע לגבי בקשות אחרות. כל אחת מהן מחזירה תשובה ריקה. סדר התשובות תואם לזה של הבקשות.
לדוגמה, נניח שאתם קוראים ל-batUpdate עם ארבעה עדכונים, ורק השלישי מחזיר מידע. התשובה תהיה שתי תשובות ריקות: התשובה לבקשה השלישית ותשובה ריקה נוספת, בסדר הזה.
מאחר שמשתמשים אחרים עשויים לערוך את המצגת, ייתכן שהמצגת לא תשקף במדויק את השינויים שערכתם: ייתכן שהשינויים שביצעת ישתנו ביחס לשינויים של שותפי עריכה. אם אין שותפי עריכה, המצגת אמורה לשקף את השינויים. בכל מקרה, העדכונים בבקשה שלך יוחלו יחד באופן אוטומטי.
בקשת HTTP
POST https://slides.googleapis.com/v1/presentations/{presentationId}:batchUpdate
כתובת ה-URL כוללת תחביר של קידוד gRPC.
פרמטרים של נתיב
פרמטרים | |
---|---|
presentationId |
המצגת שעליה העדכונים יחולו. |
גוף הבקשה
גוף הבקשה מכיל נתונים במבנה הבא:
ייצוג JSON |
---|
{ "requests": [ { object ( |
שדות | |
---|---|
requests[] |
רשימת עדכונים למצגת. |
writeControl |
מספקת שליטה על אופן הביצוע של בקשות לכתיבה. |
גוף התשובה
הודעת תגובה מעדכון אצווה.
אם התגובה הצליחה, גוף התגובה מכיל נתונים עם המבנה הבא:
ייצוג JSON |
---|
{ "presentationId": string, "replies": [ { object ( |
שדות | |
---|---|
presentationId |
המצגת שעליה הוחלו העדכונים. |
replies[] |
התשובה לעדכונים. הפעולה הזו ממפהת 1:1 את העדכונים, אם כי התשובות לבקשות מסוימות עשויות להיות ריקות. |
writeControl |
פקד הכתיבה המעודכן לאחר החלת הבקשה. |
היקפי הרשאה
מחייב אחד מהיקפי ההרשאות הבאים של OAuth:
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.file
https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/presentations
https://www.googleapis.com/auth/spreadsheets
https://www.googleapis.com/auth/spreadsheets.readonly
למידע נוסף, ניתן לעיין במדריך ההרשאה.
שליטה בכתיבה
מספקת שליטה על אופן הביצוע של בקשות לכתיבה.
ייצוג JSON |
---|
{ "requiredRevisionId": string } |
שדות | |
---|---|
requiredRevisionId |
כאשר מוחזר מזהה תיקון נדרש בתגובה, הוא מציין את מזהה התיקון של המסמך לאחר החלת הבקשה. |