Method: presentations.batchUpdate

הוספת עדכון אחד או יותר למצגת.

כל request מאומת לפני שהוא מוחל. אם בקשה כלשהי לא תהיה תקפה, הבקשה כולה תיכשל ולא יבוצעו שינויים.

בחלק מהבקשות מופיע הסמל replies כדי לספק לכם מידע על אופן ההחלה שלהן. לגבי בקשות אחרות, אין צורך להחזיר מידע, והן מחזירות תגובה ריקה. סדר התשובות זהה לסדר הבקשות.

לדוגמה, נניח שקוראים ל-batchUpdate עם ארבעה עדכונים, ורק השלישי מחזיר מידע. התשובה תכלול שתי תשובות ריקות: התשובה לבקשה השלישית, ועוד תשובה ריקה, בסדר הזה.

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

בקשת HTTP

POST https://slides.googleapis.com/v1/presentations/{presentationId}:batchUpdate

כתובת ה-URL כתובה בתחביר של gRPC Transcoding.

פרמטרים של נתיב

פרמטרים
presentationId

string

המצגת שרוצים להחיל עליה את העדכונים.

גוף הבקשה

גוף הבקשה מכיל נתונים במבנה הבא:

ייצוג JSON 
{
  "requests": [
    {
      object (Request)
    }
  ],
  "writeControl": {
    object (WriteControl)
  }
}
שדות
requests[]

object (Request)

רשימת העדכונים שרוצים להחיל על המצגת.
writeControl

object (WriteControl)

מאפשרת שליטה באופן הביצוע של בקשות כתיבה.

גוף התשובה

הודעת תשובה מחבילת עדכונים.

אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל נתונים במבנה הבא:

ייצוג JSON 
{
  "presentationId": string,
  "replies": [
    {
      object (Response)
    }
  ],
  "writeControl": {
    object (WriteControl)
  },
  "commentUpdateState": enum (CommentUpdateState)
}
שדות
presentationId

string

המצגת שהעדכונים הוחלו עליה.
replies[]

object (Response)

התשובה לעדכונים. המיפוי הזה הוא 1:1 עם העדכונים, אבל יכול להיות שהתשובות לחלק מהבקשות יהיו ריקות.
writeControl

object (WriteControl)

הרשאות הכתיבה המעודכנות אחרי שהבקשה מוחלת.
commentUpdateState

enum (CommentUpdateState)

האם עדכוני התגובות הוחלו בבקשת Batch.

היקפי הרשאות

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

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

WriteControl

מאפשרת שליטה באופן הביצוע של בקשות כתיבה.

ייצוג JSON 
{
  "requiredRevisionId": string
}
שדות
requiredRevisionId

string

ה-revision ID של המצגת שנדרש לבקשת הכתיבה. אם מציינים מזהה גרסה נדרש והוא לא תואם למזהה הגרסה הנוכחי של המצגת, הבקשה לא מטופלת ומוחזרת שגיאת בקשה שגויה (400).

כשמזהה תיקון נדרש מוחזר בתגובה, הוא מציין את מזהה התיקון של המסמך אחרי שהבקשה הוחלה.

CommentUpdateState

הסטטוס של עדכוני התגובות בבקשת Batch.

טיפוסים בני מנייה (enum)
COMMENT_UPDATE_STATE_UNSPECIFIED לא מצוין סטטוס העדכונים של התגובות.
NO_UPDATES_REQUESTED לא נשלחה בקשה לעדכוני תגובות בבקשת Batch.
ALL_SAVED כל העדכונים שביקשתם לתגובות בוצעו בבקשה באצווה.
ALL_FAILED_UNKNOWN_REASON כל העדכונים המבוקשים של התגובות נכשלו.