Method: presentations.batchUpdate

רלוונטי לעדכון אחד או יותר במצגת.

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

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

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

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

בקשת HTTP

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

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

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

פרמטרים
presentationId

string

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

גוף הבקשה

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

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

object (Request)

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

object (WriteControl)

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

גוף התשובה

הודעת תגובה מעדכון אצווה.

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

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

string

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

object (Response)

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

object (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

string

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

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