- בקשת HTTP
- פרמטרים של נתיב
- גוף הבקשה
- גוף התשובה
- היקפי ההרשאות
- שליחת בקשה
- ReplaceAllTextRequest
- SubstringMatchCriteria
- TabsCriteria
- InsertTextRequest
- מיקום
- EndOfSegmentLocation
- UpdateTextStyleRequest
- CreateParagraphBulletsRequest
- BulletGlyphPreset
- DeleteParagraphBulletsRequest
- CreateNamedRangeRequest
- DeleteNamedRangeRequest
- UpdateParagraphStyleRequest
- DeleteContentRangeRequest
- InsertInlineImageRequest
- InsertTableRequest
- InsertTableRowRequest
- TableCellLocation
- InsertTableColumnRequest
- DeleteTableRowRequest
- DeleteTableColumnRequest
- InsertPageBreakRequest
- DeletePositionedObjectRequest
- UpdateTableColumnPropertiesRequest
- UpdateTableCellStyleRequest
- TableRange
- UpdateTableRowStyleRequest
- ReplaceImageRequest
- ImageReplaceMethod
- UpdateDocumentStyleRequest
- MergeTableCellsRequest
- UnmergeTableCellsRequest
- CreateHeaderRequest
- HeaderFooterType
- CreateFooterRequest
- CreateFootnoteRequest
- ReplaceNamedRangeContentRequest
- UpdateSectionStyleRequest
- InsertSectionBreakRequest
- DeleteHeaderRequest
- DeleteFooterRequest
- PinTableHeaderRowsRequest
- WriteControl
- תגובה
- ReplaceAllTextResponse
- CreateNamedRangeResponse
- InsertInlineImageResponse
- InsertInlineSheetsChartResponse
- CreateHeaderResponse
- CreateFooterResponse
- CreateFootnoteResponse
- רוצים לנסות?
החלת עדכון אחד או יותר במסמך.
כל request
מאומת לפני היישום. אם בקשה כלשהי אינה חוקית, הבקשה כולה תיכשל ולא יושם שום דבר.
בבקשות מסוימות יש replies
כדי לספק מידע על אופן היישום שלהן. בקשות אחרות לא צריכות להחזיר מידע. כל אחת מהן תחזיר תשובה ריקה. סדר התשובות תואם לסדר הבקשות.
לדוגמה, נניח שקוראים ל-batchUpdate עם ארבעה עדכונים, ורק השלישי מחזיר מידע. התשובה תכלול שתי תשובות ריקות, תשובה לבקשה השלישית ותשובה ריקה נוספת, בסדר הזה.
מכיוון שיכול להיות שמשתמשים אחרים עורכים את המסמך, יכול להיות שהמסמך לא משקף בדיוק את השינויים שביצעת. ייתכן שהשינויים שביצעת ישתנו בהתאם לשינויים של שותפי העריכה. אם אין שותפי עריכה, המסמך אמור לשקף את השינויים שביצעתם. בכל מקרה, העדכונים בבקשה שלך יחולו יחד באופן אטומי.
בקשת HTTP
POST https://docs.googleapis.com/v1/documents/{documentId}:batchUpdate
בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של gRPC.
פרמטרים של נתיב
פרמטרים | |
---|---|
documentId |
המזהה של המסמך שצריך לעדכן. |
גוף הבקשה
גוף הבקשה מכיל נתונים במבנה הבא:
ייצוג JSON |
---|
{ "requests": [ { object ( |
שדות | |
---|---|
requests[] |
רשימת העדכונים שיש להחיל על המסמך. |
writeControl |
התפקיד הזה מאפשר לשלוט באופן הביצוע של בקשות לכתיבה. |
גוף התשובה
הודעת תשובה מבקשת של documents.batchUpdate
.
אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכלול נתונים במבנה הבא:
ייצוג JSON |
---|
{ "documentId": string, "replies": [ { object ( |
שדות | |
---|---|
documentId |
המזהה של המסמך שעליו הוחלו העדכונים. |
replies[] |
התשובה לעדכונים. המערכת ממפה 1:1 עם העדכונים, אבל יכול להיות שהתשובות לחלק מהבקשות יהיו ריקות. |
writeControl |
בקרת הכתיבה המעודכנת אחרי החלת הבקשה. |
היקפי ההרשאות
נדרש אחד מהיקפי ההרשאות הבאים של OAuth:
https://www.googleapis.com/auth/documents
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.file
מידע נוסף זמין במדריך להרשאות.
WriteControl
התפקיד הזה מאפשר לשלוט באופן הביצוע של בקשות לכתיבה.
ייצוג JSON |
---|
{ // Union field |
שדות | |
---|---|
שדה איחוד control . המדיניות הזו קובעת את הגרסה הקודמת של המסמך שצריך לכתוב בו, ואיך הבקשה צריכה להתנהג אם הגרסה הזו היא לא הגרסה הנוכחית של המסמך. אם לא צוין אף אחד מהשדות, העדכונים יוחלו על הגרסה האחרונה. control יכול להיות רק אחת מהאפשרויות הבאות: |
|
requiredRevisionId |
הערך האופציונלי כשבתשובה מוחזר מזהה גרסה קודמת, הוא מציין את מזהה הגרסה הקודמת של המסמך לאחר החלת הבקשה. |
targetRevisionId |
היעד האופציונלי אם התרחשו שינויים של שותפי עריכה לאחר קריאת המסמך באמצעות ה-API, השינויים שנוצרו על ידי בקשת הכתיבה יחולו על השינויים של שותפי העריכה. התוצאה תהיה גרסה חדשה של המסמך שכוללת גם את השינויים של שותפי העריכה וגם את השינויים בבקשה, כששרת Docs יפתור שינויים מתנגשים. כשמשתמשים במזהה גרסת יעד, אפשר להתייחס ללקוח ה-API כשותף עריכה נוסף של המסמך. מזהה גרסת היעד יכול לשמש רק לצורך כתיבה בגרסאות האחרונות של מסמך. אם גרסת היעד נמצאת רחוק מדי לפני הגרסה האחרונה, הבקשה לא תעובד ותחזיר שגיאת בקשה שגויה מסוג 400. יש לנסות לשלוח את הבקשה שוב לאחר אחזור הגרסה האחרונה של המסמך. ברוב המקרים, מזהה הגרסה תקף לשימוש כגרסת יעד למשך כמה דקות אחרי קריאתה. עם זאת, במסמכים שעורכים לעיתים קרובות, החלון הזה עשוי להיות קצר יותר. |